Skip to content
Task guideDevelopmentEngine ccf7d03f

Compile an existing project’s scripts without launching the Editor or preparing Native shader tools. The same command can generate IDE projects that use the engine’s actual projected script APIs.

Use an engine checkout and its pinned .NET SDK. Supply an existing InnoEngine project directory with its assets, configuration and required plugins. Choose a caller-owned output directory for compiled scripts. This operation compiles project source; it is not a documentation query or a way to run arbitrary documentation snippets.

From the engine root, replace the paths with your project and output locations:

Terminal window
dotnet run --project entry/InnoEngine.Build/InnoEngine.Build.csproj -- scripts --project /absolute/project --output /absolute/project/ExportedScripts --ide

On Windows, use absolute Windows paths and quote paths containing spaces. Pass --dotnet when an explicit SDK executable is required. Omit --ide to export scripts without also generating IDE projects.

The application opens the managed authoring workspace, compiles project and installed-plugin scripts, publishes the script output, and then generates IDE projects through the same compiler. Successful output identifies the published script directory. Opening the workspace does not create an SDL window or an ImGui session.

Open the generated IDE project. Its reference paths identify the actual Runtime and Editor script projections selected by the authoring closure. Use those references for script example validation; do not substitute host implementation DLLs or pick the newest-looking cache directory.

Generated projects and Library/ are derived state. Change source, plugins or configuration through their actual owners and run the operation again. Host and script namespaces are different surfaces: a public CLR lifecycle method may intentionally be absent from scripts.

Compiler diagnostics identify invalid source, unavailable projected members or missing dependencies. Fix the first reported cause and keep the original result when retrying. A failed compilation does not become a successful empty export.

--tools-target and --support-packs are rejected for this command because managed script preparation does not consume them. Game and plugin builds have different preparation requirements. A script compilation success does not certify a game package, Native window or platform device.

Cancellation stops owned work before a partial publication can become current. Do not delete active output or cache directories to interrupt the operation; use the caller’s cancellation path.