Kit data

8 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 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.

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.

data.acquire_registry_item (riesgo 0, requiere el plugin DataRegistry)

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

Argumento	Tipo	Descripción
timeoutSeconds	number	Maximum wall-clock wait for the async registry callback, from 0.1 through 30 seconds. Valor predeterminado 5.0.

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

data.create_registry (riesgo 2, modifica, requiere el 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	Descripción
folder	string	obligatorio. Destination Content Browser folder under /Game.
name	string	obligatorio. DataRegistry asset name without spaces, slashes, or dots.
registryType	string	obligatorio. Registry type name used in FDataRegistryId (Type:Item); must be unique among the project's registries.
itemStruct	string	obligatorio. 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. Valor predeterminado true.

Devuelve: registry.

data.evaluate_registry_curve (riesgo 0, requiere el 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	Descripción
registry	string	obligatorio. Registered registry type name, or a DataRegistry asset path starting with /.
item	string	obligatorio. Curve item name within the registry.
input	number	obligatorio. Curve input value.
defaultValue	number	Value returned when the item is not currently cached. Valor predeterminado 0.0f.

Devuelve: itemId, found, value.

data.get_cached_registry_item (riesgo 0, requiere el plugin DataRegistry, smoke)

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

Argumento	Tipo	Descripción
registry	string	obligatorio. Registered registry type name, or a DataRegistry asset path starting with /.
item	string	obligatorio. Item name within the registry.

Devuelve: itemId, cached, itemStruct, value.

data.get_registry (riesgo 0, requiere el plugin DataRegistry, smoke)

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

Argumento	Tipo	Descripción
registry	string	obligatorio. Registered registry type name, or a DataRegistry asset path starting with /.

Devuelve: registry.

data.list_registries (riesgo 0, requiere el plugin DataRegistry, smoke)

Lists all active Data Registries and their public source summaries.

Sin argumentos.

Devuelve: registries, count.

data.list_registry_items (riesgo 0, requiere el plugin DataRegistry, smoke)

Lists the item ids currently resolved by one Data Registry.

Argumento	Tipo	Descripción
registry	string	obligatorio. 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. Valor predeterminado 100.

Devuelve: registryType, items, total.

data.registry_status (riesgo 0, requiere el plugin DataRegistry, smoke)

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

Sin argumentos.

Devuelve: initialized, registryCount.