✍️Scripting System

Use MiniScript to add runtime behavior to URT3D assets — from animations and interactions to custom event logic. Learn how to write, trigger, and debug scripts in Unity.

📘 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

MiniScript is a lightweight scripting language built into the URT3D runtime. It lets you define dynamic logic that runs when an asset loads, updates, or responds to custom events — no C# required.

---

🔹 What Can MiniScript Do?

Use it to:

• Animate assets • React to clicks or hovers • Move or rotate objects • Communicate between assets • Delay or sequence actions • Run scripts per frame with Update()

Scripts are embedded inside .urta files and authored through the URT3D component in Unity or via external tools.

---

🔹 Trigger Types

OnLoad Runs once when the asset is loaded.

OnUpdate Runs every frame.

OnCustomEvent Runs only when manually triggered.

Example (C#):

wrapper.TriggerCustomEvent("jump");

---

🔹 Syntax Overview

Get a trait:

position = GetTrait("Position3d")

Set a value:

position.SetValue(Vector3(0, 1, 0))

Check for a trait:

if HasTrait("Animatable") then
    ...
end if

Trigger an event:

TriggerEvent("wave")
TriggerEventOn("wave", "npc_asset_guid")

Use a delay:

Delay(2.5)

---

🔹 Execution Modes

Each script can be configured to run in one of the following:

• EditorOnly – Only in Unity Editor • RuntimeOnly – Only during Play Mode or builds • Both – Runs in all modes

Set this via the URT3D component in the Inspector.

---

🧾 Looking for example scripts?

We’ve collected real-world MiniScript patterns in one place. → MiniScript Recipes

Includes:

🔹 Animate on load 🔹 Hover/click reactions 🔹 Delayed events 🔹 Cross-asset messaging 🔹 Scripted state logic

---

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