Kit build

12 ferramentas. Gerado a partir do código-fonte do plugin; não edite manualmente.

As descrições das ferramentas e dos argumentos são exibidas em inglês porque espelham o schema das ferramentas (o mesmo texto que o agente recebe em tools/list).

Guia

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.

Ferramentas

Legenda. risco 0 = somente leitura, 1 = operação inofensiva do editor, 2 = altera asset, 3 = apaga/substitui asset, 4 = projeto/config/build, 5 = potencialmente destrutivo (chamadas acima de MaxAutoRisk exigem "_confirm": true). altera = roda numa transação (edit.undo reverte). requer PIE / requer mundo = recusado sem sessão PIE / sem nível aberto. requer plugin = indisponível quando o plugin está desativado. dryRun = aceita o argumento dryRun. smoke = coberto por edit.self_test.

build.audit_source_layout (risco 0, smoke)

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

Sem argumentos.

Retorna: undeclaredModules, missingRuleFiles, targetsWithoutModuleDirectory, notes.

build.get_module_rule (risco 0)

Returns one discovered ModuleRules declaration and its literal dependency expressions.

Argumento	Tipo	Descrição
module	string	obrigatório. Module name, class name, or .Build.cs filename reported by build.list_module_rules.

Retorna: module.

build.get_target_rule (risco 0)

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

Argumento	Tipo	Descrição
target	string	obrigatório. Target name, TargetRules class, or .Target.cs filename reported by build.list_target_rules.

Retorna: target.

build.get_tool_paths (risco 0, smoke)

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

Sem argumentos.

Retorna: engineDirectory, unrealBuildTool, automationTool, warnings.

build.list_module_rules (risco 0, smoke)

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

Sem argumentos.

Retorna: modules, count.

build.list_target_rules (risco 0, smoke)

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

Sem argumentos.

Retorna: targets, count.

build.preflight_command (risco 0, smoke)

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

Argumento	Tipo	Descrição
target	string	Discovered target name for compile workflows.
platform	string	obrigatório. Target platform identifier such as Win64.
configuration	string	Development, DebugGame, Shipping, or another requested configuration. Padrão TEXT("Development").
maps	array of string	Explicit map package names for cook/package workflows.
archiveDirectory	string	Absolute archive/staging directory for package/stage workflows.

Retorna: ready, errors, warnings.

build.synthesize_compile_command (risco 0)

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

Argumento	Tipo	Descrição
target	string	Discovered target name for compile workflows.
platform	string	obrigatório. Target platform identifier such as Win64.
configuration	string	Development, DebugGame, Shipping, or another requested configuration. Padrão TEXT("Development").
maps	array of string	Explicit map package names for cook/package workflows.
archiveDirectory	string	Absolute archive/staging directory for package/stage workflows.

Retorna: tool, command, inputs, warnings.

build.synthesize_cook_command (risco 0, smoke)

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

Argumento	Tipo	Descrição
target	string	Discovered target name for compile workflows.
platform	string	obrigatório. Target platform identifier such as Win64.
configuration	string	Development, DebugGame, Shipping, or another requested configuration. Padrão TEXT("Development").
maps	array of string	Explicit map package names for cook/package workflows.
archiveDirectory	string	Absolute archive/staging directory for package/stage workflows.

Retorna: tool, command, inputs, warnings.

build.synthesize_package_command (risco 0, smoke)

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

Argumento	Tipo	Descrição
target	string	Discovered target name for compile workflows.
platform	string	obrigatório. Target platform identifier such as Win64.
configuration	string	Development, DebugGame, Shipping, or another requested configuration. Padrão TEXT("Development").
maps	array of string	Explicit map package names for cook/package workflows.
archiveDirectory	string	Absolute archive/staging directory for package/stage workflows.

Retorna: tool, command, inputs, warnings.

build.synthesize_stage_command (risco 0, smoke)

Synthesizes an explicit staging command without creating a staging directory.

Argumento	Tipo	Descrição
target	string	Discovered target name for compile workflows.
platform	string	obrigatório. Target platform identifier such as Win64.
configuration	string	Development, DebugGame, Shipping, or another requested configuration. Padrão TEXT("Development").
maps	array of string	Explicit map package names for cook/package workflows.
archiveDirectory	string	Absolute archive/staging directory for package/stage workflows.

Retorna: tool, command, inputs, warnings.

build.validation_status (risco 0, smoke)

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

Sem argumentos.

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