🧬Traits System

Traits are modular behaviors you can add to any URT3D asset — including movement, rotation, animation, and interactivity. Learn how to use them and create your own.

📘 Looking for detailed implementation docs? This page gives you a high-level overview, but you can always dive deeper in the official SDK documentation on GitHub: urt3d-sdk_unity › Documentation

Traits are modular components that extend the functionality of a URT3D asset. Instead of relying on rigid inheritance or custom code for every new behavior, URT3D lets you add traits to assets as needed — much like attaching Unity components.

Each trait encapsulates a single capability: position, rotation, animation, interactivity, and more.

---

🔹 What Are Traits?

Traits are attached at the asset level. You can add them visually (via Inspector) or define them in a .urta file.

They are accessible via code like this:

var position = asset.GetTrait<TraitPosition3d>();
position?.SetValue(new Vector3(0, 1, 0));

Traits are also available inside MiniScript using GetTrait("TraitName").

---

🔹 Common Built-In Traits

TraitPosition3d Controls the world position of the asset.

position = asset.GetTrait<TraitPosition3d>();
position.SetValue(new Vector3(0, 2, 0));

TraitRotation3d Handles local or global rotation.

rotation = asset.GetTrait<TraitRotation3d>();
rotation.SetValue(new Vector3(0, 90, 0));

TraitScale3d Enables scaling via Vector3 or uniform float.

scale = asset.GetTrait<TraitScale3d>();
scale.SetValue(1.5f);

TraitAnimatable Plays, stops, or loops named animation clips embedded in the asset.

anim = asset.GetTrait<TraitAnimatable>();
anim.PlayAnimation("Idle", true);

TraitInteractable Exposes user interactions like clicks and hover events.

var interactable = asset.GetTrait<TraitInteractable>();
interactable.OnClicked += args => Debug.Log("Clicked!");

---

🔹 Custom Traits

You can create your own traits by subclassing the Trait base class.

public class TraitHealth : Trait
{
    public float CurrentHealth { get; set; }
    public void TakeDamage(float amount) { ... }
}

Traits integrate with the Inspector and can be saved into .urta files for reuse.

---

🔹 In MiniScript

Inside MiniScript, you can use traits like this:

position = GetTrait("Position3d")
position.SetValue(Vector3(0, 1, 0))

Use HasTrait() to check if a trait exists before calling it.

---

🔹 Why Traits Matter

• Traits reduce boilerplate setup • Traits are portable between assets • Traits keep asset behavior modular and composable • Traits are compatible with scripting and drag-and-drop workflows

---

💬 Need Help?

🗨️ Join our Discord creator community 📩 Email us at: [e-mail]