👨‍💻Unity Integration Guide

Learn how to bring .urta files into your Unity project, connect traits and scripts, generate App Keys, and troubleshoot common runtime issues.

📘 For deeper implementation details, check the SDK’s GitHub documentation: https://github.com/URT3D/urt3d-sdk_unity/blob/main/Documentation/index.md

Once the URT3D SDK is installed, this guide walks you through integrating .urta assets into your Unity project — with working scripts, inspector setup, and troubleshooting tips.

---

🔹 Step 1: Import a .urta File

After converting your model on urt3d.com:

1. Download the .urta file

2. Drag it into your Unity Project panel

3. Select the file — Unity will auto-link a Wrapper component and metadata

---

🔹 Step 2: Add the Asset to Your Scene

1. Drag the .urta from Project into the Hierarchy

2. The asset’s mesh (via Actor) will appear in the Scene

3. In the Inspector, you’ll see: • Trait list (if traits are defined) • Script list (if scripts are included) • SDK connection settings

Hit Play Mode to verify asset behavior.

---

🔹 Step 3: Generate Your App Key

To test remote runtime features:

1. Open URT3D Settings in the Unity sidebar

2. Log in with your URT3D credentials

3. Click Generate App Key

4. Copy the key to the SDK settings window in your scene

The App Key is required for remote asset resolution and multi-user experiences.

---

🔹 Step 4: Verify Trait Behavior

Each .urta asset may include traits like:

• Position3d • Rotation3d • Interactable • Animatable • Custom (user-defined)

Traits will show up in the Inspector under the asset and are accessible via:

pgsqlCopyEditvar wrapper = GetComponent<Wrapper>();
var asset = wrapper.Asset;
var anim = asset.GetTrait<TraitAnimatable>();
anim?.PlayAnimation("Idle", true);

---

🔹 Step 5: Test MiniScript Execution

If the .urta includes scripts:

• Click Play Mode

• Look for animations, movements, or logs

• Trigger events via custom UI or code:

  wrapper.TriggerCustomEvent("Jump");

Scripts are auto-executed based on their trigger type (OnLoad, OnUpdate, OnCustomEvent).

---

🔧 Common Issues

“Model doesn’t appear” → The asset may be too small or off-camera. Check the Position3d trait value.

“Traits not showing” → Not all .urta files include traits. Add them in the Builder or create them via code.

“Scripts not running” → Make sure the script’s trigger type is valid and that the Execution Mode is set to match your test environment.

“Nothing happens on click” → Check that TraitInteractable is present and the OnClick event is assigned.

---

💡 Reusable Prefab Workflow

1. Configure an asset with Traits and Scripts

2. Right-click in the Hierarchy

3. Choose Create Prefab Variant

4. Store in a versioned prefab folder for reuse across scenes

---

💬 Need Help?

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