Kit build

12 herramientas. Generado a partir del código fuente del plugin; no lo edites a mano.

Las descripciones de las herramientas y de los argumentos se muestran en inglés porque reflejan el schema de las herramientas (el mismo texto que el agente recibe en tools/list).

Guía

The build kit reads C++ target-rule metadata and reports whether Data Validation is already available. It does not run UBT/UAT, package a project, compile code, build lighting/navigation, run asset validators, load modules, save files, or open a window.

Start here

1. Call build.list_target_rules {} to discover project-owned .Target.cs files.
2. Call build.list_module_rules {} and build.get_module_rule {module} to inspect literal ModuleRules declarations without evaluating C#.
3. Use build.audit_source_layout {} to compare descriptor modules, local rules, and targets before handing a concrete build to edit.*.
4. Select a returned name, targetClass, or filename.
5. Call build.get_target_rule {"target":"MyGameEditor"} for the selected declaration.
6. Treat type, defaultBuildSettings, and includeOrderVersion as source metadata. Conditional C# and inherited values are deliberately not evaluated.
7. Call build.validation_status {} before planning an asset-validation step.
8. If its plugin/status fields permit it, run validation with asset.validate; this build kit never starts validators.
9. Poll an already-running world build with edit.is_building and inspect lighting state with edit.get_lighting_build_info.
10. Inspect Live Coding without compiling through edit.live_coding_status. Its risk-gated, off-thread compile action remains edit.live_coding_compile.

Tools

Tool	Use
build.list_target_rules	Lists bounded, read-only metadata from Source/**/*.Target.cs.
build.list_module_rules / build.get_module_rule	Lists or inspects bounded .Build.cs text and literal dependency expressions; neither runs UBT.
build.audit_source_layout	Reports descriptor/rule/target layout mismatches without evaluating C# or compiling.
build.get_target_rule	Inspects one target found by the list tool.
build.validation_status	Reports Data Validation availability and points to the existing execution/status owners.

Ownership map

Need	Tool
Engine build configuration, platform, compiler, and project build metadata	project.get_build_info, project.get_descriptor, project.list_platforms
Start or poll a lighting/geometry/navigation/HLOD build	edit.build, edit.is_building, edit.get_lighting_build_info
Validate assets	asset.validate
Discover or run automation tests	edit.list_tests, edit.run_test, edit.run_tests, edit.get_test_results
Live Coding state or compile	edit.live_coding_status, edit.live_coding_compile

Gotchas

• A Blueprint-only project normally has no Source/**/*.Target.cs files. build.list_target_rules returns an empty list in that case.
• The parser reads no file larger than one MiB and only returns selected direct assignments. It does not execute C# expressions, resolve variables, or invoke UnrealBuildTool.
• dataValidationModulePresent and dataValidationPluginEnabled differ: an installed engine plugin can be disabled for the project. dataValidationModuleLoaded only reports the current editor state.
• A successful status check does not validate content. Run the owner tool deliberately, because validators may load assets and execute project-defined rules.

Herramientas

Leyenda. riesgo 0 = solo lectura, 1 = operación inofensiva del editor, 2 = modifica un asset, 3 = elimina/reemplaza un asset, 4 = proyecto/configuración/build, 5 = potencialmente destructivo (las llamadas por encima de MaxAutoRisk requieren "_confirm": true). modifica = se ejecuta en una transacción (edit.undo la revierte). requiere PIE / requiere mundo = se rechaza sin una sesión PIE / sin un nivel abierto. requiere el plugin = no disponible cuando el plugin está desactivado. dryRun = acepta el argumento dryRun. smoke = cubierto por edit.self_test.

build.audit_source_layout (riesgo 0, smoke)

Audits Source layout against project descriptor module declarations without compiling or evaluating rules.

Sin argumentos.

Devuelve: undeclaredModules, missingRuleFiles, targetsWithoutModuleDirectory, notes.

build.get_module_rule (riesgo 0)

Returns one discovered ModuleRules declaration and its literal dependency expressions.

Argumento	Tipo	Descripción
module	string	obligatorio. Module name, class name, or .Build.cs filename reported by build.list_module_rules.

Devuelve: module.

build.get_target_rule (riesgo 0)

Reads one discovered .Target.cs file and returns selected TargetRules assignments.

Argumento	Tipo	Descripción
target	string	obligatorio. Target name, TargetRules class, or .Target.cs filename reported by build.list_target_rules.

Devuelve: target.

build.get_tool_paths (riesgo 0, smoke)

Audits locally installed AutomationTool and UnrealBuildTool script locations without launching them.

Sin argumentos.

Devuelve: engineDirectory, unrealBuildTool, automationTool, warnings.

build.list_module_rules (riesgo 0, smoke)

Lists bounded C++ ModuleRules files beneath the active project without evaluating C#.

Sin argumentos.

Devuelve: modules, count.

build.list_target_rules (riesgo 0, smoke)

Lists .Target.cs files and their selected build-rule metadata without invoking UBT.

Sin argumentos.

Devuelve: targets, count.

build.preflight_command (riesgo 0, smoke)

Validates target, platform, maps, and archive arguments needed by a requested build workflow.

Argumento	Tipo	Descripción
target	string	Discovered target name for compile workflows.
platform	string	obligatorio. Target platform identifier such as Win64.
configuration	string	Development, DebugGame, Shipping, or another requested configuration. Valor predeterminado TEXT("Development").
maps	array of string	Explicit map package names for cook/package workflows.
archiveDirectory	string	Absolute archive/staging directory for package/stage workflows.

Devuelve: ready, errors, warnings.

build.synthesize_compile_command (riesgo 0)

Synthesizes a reviewable UBT invocation for a discovered target without launching it.

Argumento	Tipo	Descripción
target	string	Discovered target name for compile workflows.
platform	string	obligatorio. Target platform identifier such as Win64.
configuration	string	Development, DebugGame, Shipping, or another requested configuration. Valor predeterminado TEXT("Development").
maps	array of string	Explicit map package names for cook/package workflows.
archiveDirectory	string	Absolute archive/staging directory for package/stage workflows.

Devuelve: tool, command, inputs, warnings.

build.synthesize_cook_command (riesgo 0, smoke)

Synthesizes a reviewable cook command for maps and platform without launching UAT.

Argumento	Tipo	Descripción
target	string	Discovered target name for compile workflows.
platform	string	obligatorio. Target platform identifier such as Win64.
configuration	string	Development, DebugGame, Shipping, or another requested configuration. Valor predeterminado TEXT("Development").
maps	array of string	Explicit map package names for cook/package workflows.
archiveDirectory	string	Absolute archive/staging directory for package/stage workflows.

Devuelve: tool, command, inputs, warnings.

build.synthesize_package_command (riesgo 0, smoke)

Synthesizes a reviewable package command and exposes packaging inputs without launching UAT.

Argumento	Tipo	Descripción
target	string	Discovered target name for compile workflows.
platform	string	obligatorio. Target platform identifier such as Win64.
configuration	string	Development, DebugGame, Shipping, or another requested configuration. Valor predeterminado TEXT("Development").
maps	array of string	Explicit map package names for cook/package workflows.
archiveDirectory	string	Absolute archive/staging directory for package/stage workflows.

Devuelve: tool, command, inputs, warnings.

build.synthesize_stage_command (riesgo 0, smoke)

Synthesizes an explicit staging command without creating a staging directory.

Argumento	Tipo	Descripción
target	string	Discovered target name for compile workflows.
platform	string	obligatorio. Target platform identifier such as Win64.
configuration	string	Development, DebugGame, Shipping, or another requested configuration. Valor predeterminado TEXT("Development").
maps	array of string	Explicit map package names for cook/package workflows.
archiveDirectory	string	Absolute archive/staging directory for package/stage workflows.

Devuelve: tool, command, inputs, warnings.

build.validation_status (riesgo 0, smoke)

Reports Data Validation availability without loading modules, running validators, compiling, or opening UI.

Sin argumentos.

Devuelve: dataValidationCompiled, dataValidationModulePresent, dataValidationModuleLoaded, dataValidationPluginEnabled, assetValidationTool, buildStatusTool, liveCodingStatusTool, executionPolicy.