Summary

Locus for Unity is an open-source AI agent designed to significantly enhance game development efficiency within the Unity Editor. It targets Unity developers by automating tedious tasks like C# coding, object manipulation, debugging, and documentation generation. The primary benefit is freeing creators from repetitive work, allowing them to focus on core creative aspects of game development.

How It Works

Locus operates as a standalone Rust + Tauri + Vue.js application, external to the Unity Editor process. It employs a proprietary intermediate representation for efficient scene and asset parsing, coupled with retrieval tools for rapid object location. C# code execution is handled via Roslyn's JIT compilation, enabling semantic asset edits directly within the editor. The system leverages Rust's parallel processing capabilities for high-performance asset database scans and semantic parsing. An automated knowledge system summarizes requirements into design documents and maintains project understanding in long-term memory, featuring configurable AI maintenance and retrieval modes. Runtime analysis is facilitated by C# state-machine tools that sample internal states via reflection.

Quick Start & Requirements

• Installation: Windows is the only currently supported platform. Installation is recommended via pre-built Releases installers. A post-installation setup guide is available in the Quick Start documentation.
• Prerequisites: Requires Unity 2021 or later. Building from source involves bun and Tauri 2, with Windows as the primary development platform.
• Development/Build Commands:
  • bun tauri dev: Starts the Vite development server and opens the Tauri app.
  • bun tauri build: Builds the application, including Roslyn DLL, managed runtimes, frontend, and packages the desktop app.
  • bun run release:installers: Builds Windows release installers.
• Documentation: Build toolchain documentation is located in docs/BUILD_TOOLCHAIN.md.
• Links: GitHub Releases

Highlighted Details

• In-Editor AI Agent: Automates C# coding, Unity object/asset modification, and full feature development workflows.
• Runtime Analysis & Debugging: Captures runtime state frame-by-frame for debugging and performance optimization.
• Visual Version Control: Provides a graphical interface for Unity YAML assets with semantic diff analysis and conflict resolution.
• Automated Knowledge System: Summarizes requirements, preserves project understanding, and supports configurable AI maintenance rules and multi-level context injection.
• Multi-Model Support: Allows subscription account sign-in and compatibility with various LLM APIs.

Maintenance & Community

Locus is currently in early testing (v0.2.8). Feedback is welcomed via GitHub Issues. No specific community channels (e.g., Discord, Slack) or details on notable contributors or sponsorships are provided in the README.

Licensing & Compatibility

The main repository source code is licensed under GPL-3.0-or-later. This is a strong copyleft license, meaning derivative works must also be licensed under GPL-3.0-or-later. Compatibility for commercial use or linking with closed-source projects requires careful consideration due to the copyleft nature of the license.

Limitations & Caveats

The project is in early alpha (v0.2.8) and currently only supports Windows. macOS support is planned but not yet available. Compatibility with Unity versions older than 2021 may require reporting issues, with fixes dependent on practical implementation effort. The GPL-3.0 license imposes significant obligations on derived works.