Kit data

8 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 data kit inspects Unreal Data Registries without changing project configuration, registry assets, or cache contents. Its prefix is data. and every tool requires the optional DataRegistry engine plugin. Use asset.* for DataTable, CurveTable, StringTable, and DataAsset authoring; use bp.* to wire a DataTable row node into a Blueprint.

Start here

1. Call data.registry_status {}. If initialized is false, wait for normal project startup or inspect the project's Data Registry settings; the kit never initializes or reconfigures registries itself.
2. Call data.list_registries {} to discover active registry type values, row itemStruct, and source diagnostics.
3. Choose the returned type (for example, Weapons) or use a loaded DataRegistry asset path in the following calls.
4. Call data.get_registry {"registry":"Weapons"} to inspect its public schema and sources.
5. Call data.list_registry_items {"registry":"Weapons","limit":100}. Add contains to narrow a large registry.
6. To inspect a value already in the engine cache, call data.get_cached_registry_item {"registry":"Weapons","item":"Sword"}.
7. To sample a curve registry entry already in cache, call data.evaluate_registry_curve {"registry":"Difficulty","item":"DamageScale","input":0.5,"defaultValue":1}.
8. To issue a bounded engine acquire, call data.acquire_registry_item {"registry":"Weapons","item":"Sword","timeoutSeconds":5}. It reports timeout, does_not_exist, or the callback status instead of treating a cache miss as success.

Tools

Tool	Use
data.registry_status	Initialization state and active registry count.
data.list_registries	All active registries with source availability and schema summaries.
data.get_registry	One registry's type, item struct, id count, initialization state, and sources.
data.list_registry_items	Resolvable item names with a case-insensitive filter and limit.
data.get_cached_registry_item	A cached struct as Unreal text; never queues an async load.
data.evaluate_registry_curve	A cached curve value, falling back to defaultValue when absent.
data.acquire_registry_item	Off-thread acquire lifecycle: scheduled/completed state, callback status, and the acquired struct when available.

Structured asset workflow

1. Create or find the backing DataTable with asset.create_data_table / asset.find.
2. Inspect its authored columns with asset.data_table_info.
3. Edit rows through asset.data_table_add_row, asset.data_table_set_cell, or bulk CSV/JSON operations in asset.data_table_import_csv and asset.data_table_import_json.
4. Edit CurveFloat, CurveVector, or CurveLinearColor keys with asset.curve_add_key and asset.curve_set_keys; inspect/evaluate them with asset.curve_get_keys and asset.curve_evaluate.
5. Inspect or update DataAsset properties with asset.data_asset_get and asset.data_asset_set.
6. Configure the project registry by your established editor/project workflow, then use data.* to verify the registry's visible state.

Gotchas

• Data Registry item acquisition is asynchronous. A cached:false response means no item is presently cached; it does not mean the id is invalid. Use data.acquire_registry_item when a bounded callback wait is appropriate, or run the game's normal loading path and query again.
• list_registry_items lists ids that the registry can resolve. It does not load those entries.
• evaluate_registry_curve returns defaultValue with found:false when the curve is unavailable. Check found before treating the returned value as data.
• value from data.get_cached_registry_item is Unreal property text for inspection. It is not a generic editing interface; use the owning DataTable or DataAsset tools for mutations.
• In a blank project there may be no configured registries. The discovery tools safely return an empty list. data.create_registry creates a DataRegistry asset with a DataTable source (it can create and seed <Name>_Table with rowNames) and initializes it, so the per-registry tools work on it right away; it is not added to the project scan list (DataRegistrySettings), so data.list_registries does not show it.
• Per-registry tools accept a registry asset path or a registered registry type. Cached reads, curve evaluation, and acquire_registry_item query the resolved registry directly.

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.

data.acquire_registry_item (risco 0, requer plugin DataRegistry)

Starts one acquire on the resolved registry and waits off-thread for its callback or the caller timeout.

Argumento	Tipo	Descrição
timeoutSeconds	number	Maximum wall-clock wait for the async registry callback, from 0.1 through 30 seconds. Padrão 5.0.

Retorna: itemId, scheduled, completed, acquired, status, itemStruct, value.

data.create_registry (risco 2, altera, requer plugin DataRegistry, smoke)

Creates a DataRegistry asset backed by a DataTable source (optionally creating the table and seeding rows). The asset is not added to the project-wide scan list.

Argumento	Tipo	Descrição
folder	string	obrigatório. Destination Content Browser folder under /Game.
name	string	obrigatório. DataRegistry asset name without spaces, slashes, or dots.
registryType	string	obrigatório. Registry type name used in FDataRegistryId (Type:Item); must be unique among the project's registries.
itemStruct	string	obrigatório. Item struct path; must derive from FTableRowBase, e.g. /Script/GameplayTags.GameplayTagTableRow.
sourceTable	string	Existing DataTable with the same row struct used as the DataTable source; empty creates _Table next to the registry.
rowNames	array of string	Row names seeded with default values when the DataTable is created by this call.
initialize	boolean	Initialize the registry and its sources right away so items can be listed and acquired without registering it project-wide. Padrão true.

Retorna: registry.

data.evaluate_registry_curve (risco 0, requer plugin DataRegistry, smoke)

Evaluates a curve registry item only from the registry cache; non-curve or unavailable items return defaultValue with found=false.

Argumento	Tipo	Descrição
registry	string	obrigatório. Registered registry type name, or a DataRegistry asset path starting with /.
item	string	obrigatório. Curve item name within the registry.
input	number	obrigatório. Curve input value.
defaultValue	number	Value returned when the item is not currently cached. Padrão 0.0f.

Retorna: itemId, found, value.

data.get_cached_registry_item (risco 0, requer plugin DataRegistry, smoke)

Exports an item only when it is already cached; it never starts an asynchronous Data Registry request.

Argumento	Tipo	Descrição
registry	string	obrigatório. Registered registry type name, or a DataRegistry asset path starting with /.
item	string	obrigatório. Item name within the registry.

Retorna: itemId, cached, itemStruct, value.

data.get_registry (risco 0, requer plugin DataRegistry, smoke)

Returns the schema, initialization state, availability and sources for one Data Registry.

Argumento	Tipo	Descrição
registry	string	obrigatório. Registered registry type name, or a DataRegistry asset path starting with /.

Retorna: registry.

data.list_registries (risco 0, requer plugin DataRegistry, smoke)

Lists all active Data Registries and their public source summaries.

Sem argumentos.

Retorna: registries, count.

data.list_registry_items (risco 0, requer plugin DataRegistry, smoke)

Lists the item ids currently resolved by one Data Registry.

Argumento	Tipo	Descrição
registry	string	obrigatório. Registered registry type name, or a DataRegistry asset path starting with /.
contains	string	Only item names containing this text are returned.
limit	integer	Maximum returned items; zero uses 100. Padrão 100.

Retorna: registryType, items, total.

data.registry_status (risco 0, requer plugin DataRegistry, smoke)

Reports whether the optional Data Registry subsystem is initialized and how many registries it exposes.

Sem argumentos.

Retorna: initialized, registryCount.