🚀 New Update: Scripting System Now Supported in the Untold Engine

[untoldengine]

I’m excited to share that the Untold Engine now includes full scripting support through a new Swift-based workflow powered by the USC DSL (Untold Script).
This update brings integrated gameplay scripting directly into the UntoldEditor — letting you create, edit, build, and hot-reload logic as part of your normal workflow.

You can find a general introduction to the Scripting System here.

For a detailed walkthrough of the scripting workflow, including UI flow and project layout, see the scripting workflow documentation on the docs site. :contentReference[oaicite:0]{index=0}

---

🎯 What’s New

✅ Integrated Script Creation Workflow

You can now create scripts directly from the UntoldEditor toolbar:

• A new Scripts section in the toolbar lets you:
  • Create new script files
  • Open the script workspace in Xcode
• Scripts are created under your asset base path in:
  • YourAssetFolder/Scripts/
• Each new script:
  • Is generated as a Swift file with USC DSL scaffolding
  • Is wired into a Swift Package managed by SwiftPM

---

✅ Xcode-Powered Script Development

With one click, you can open the script package in Xcode and get:

• Full IDE support (autocomplete, errors, type checking)
• A dedicated GenerateScripts.swift entry point you control
• A simple Cmd+R build step that:
  • Compiles your Swift script definitions
  • Generates .uscript files into Scripts/Generated/
  • Prints output to the Xcode console

Build artifacts and generated files are ignored by default via .gitignore, so only your Swift source lives in version control.

---

✅ Entity-Level Script Components

Scripts are now part of the entity workflow via a ScriptComponent:

• In the Inspector, when an entity has a ScriptComponent, you get:
  • Load Script — attach a .uscript file from the Asset Browser
  • Reload — hot-reload the currently attached script from disk
• This enables a tight loop:
  1. Edit script in Xcode
  2. Run to regenerate .uscript
  3. Switch back to UntoldEditor
  4. Hit Reload to see the new behavior

---

✅ USC DSL for Gameplay Logic

The USC DSL gives you a structured way to define behavior, such as:

• Events
  • onStart() — runs once when Play mode starts
  • onUpdate() — runs every frame
• Properties
  • Get and set transforms (position, rotation, scale)
  • Read and write physics-related values (e.g., velocity)
• Math and Logic
  • Vector math helpers (add, scale, length)
  • Float operations
  • Simple conditional patterns
• Input (Keyboard)
  • Check keys (e.g., "W" for movement)

With these building blocks, you can implement:

• Player controllers
• Enemy / NPC movement
• Camera behavior
• Simple AI and triggers
• Physics-driven motion
• Procedural adjustments to entities

---

📁 Project Structure (Generated for You)

Once initialized, your project scripts folder is structured as:

YourAssetFolder/
└── Scripts/
    ├── Package.swift
    ├── .gitignore
    ├── Sources/
    │   └── GenerateScripts/
    │       ├── GenerateScripts.swift     // Entry point – you control which scripts are generated
    │       ├── PlayerController.swift    // Example script
    │       └── EnemyAI.swift             // Example script
    └── Generated/
        ├── PlayerController.uscript
        └── EnemyAI.uscript

🙏 Feedback

This scripting system is a big step toward making the Untold Engine a complete, end-to-end game and scene creation environment.

If you try it out:

• Share bugs you hit
• Suggest improvements to the workflow
• Propose new DSL features you’d find useful

Your feedback will directly shape where the scripting system goes next.