Kit save

19 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

Start by inspecting the concrete SaveGame class: save.inspect_class {class} lists default values and whether every reflected property actually has the SaveGame flag. save.write creates a slot from that class and only accepts values for writable SaveGame properties. save.read, save.get_property, and save.validate always load through the platform save system and return a clear missing/corrupt result instead of treating a file as valid.

Use save.set_property for a focused existing-slot change; save.reset_property restores the class default. save.reset_slot writes a complete class-default slot. save.copy_slot preserves the serialized object class, while save.migrate copies only same-name, same-type SaveGame fields into a chosen new class and returns skipped-field reasons. Compare before deleting or replacing a slot with save.compare and use save.validate_many for a bounded batch audit.

Raw save.read_bytes / save.write_bytes are recovery tools, not a format editor. The write is Risk 4 because invalid bytes can make a slot unloadable. Unreal exposes no cross-platform public slot listing or header reader, so this kit does not invent either.

Creating a schema: save.create_save_game_class {folder, name, variables:[{key:"Score",value:"int"}]} creates and compiles a SaveGame Blueprint whose variables all carry the SaveGame flag (types: bool, int, int64, float, string, name, text, vector, rotator, transform). Pass its path as class to save.write. Values use Unreal text syntax (42, Smoke, (X=1,Y=2,Z=3)).

In the editor, slots are files under <Project>/Saved/SaveGames/<slot>.sav. save.delete removes one; save.delete_many {slots:[...]} removes several and reports missing ones instead of failing.

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.

save.compare (riesgo 1, smoke)

Sin descripción.

Argumento	Tipo	Descripción
firstSlot	string	obligatorio. First plain slot name.
secondSlot	string	obligatorio. Second plain slot name.
userIndex	integer	Platform user index used for both slots. Valor predeterminado 0.

Devuelve: equal, different, firstOnly, secondOnly.

save.copy_slot (riesgo 3, modifica, smoke)

Sin descripción.

Argumento	Tipo	Descripción
destinationSlot	string	obligatorio. Destination plain slot name.
destinationUserIndex	integer	Destination platform user index; -1 keeps userIndex. Valor predeterminado -1.

Devuelve: slot, userIndex, exists, valid, class, byteCount, properties, problems.

save.create_save_game_class (riesgo 2, modifica, smoke)

Creates a SaveGame Blueprint asset with typed variables, all flagged SaveGame, and compiles it; returns its schema.

Argumento	Tipo	Descripción
folder	string	obligatorio. Content folder of the new SaveGame Blueprint, e.g. /Game/Save.
name	string	obligatorio. Asset name, e.g. BP_PlayerSave.
variables	array of UeaKeyValue	Variables to add: key = variable name, value = type (bool, int, int64, float, string, name, text, vector, rotator, transform). Every variable is flagged SaveGame.

Devuelve: class, properties, saveGamePropertyCount.

save.delete (riesgo 3, modifica, destructivo, smoke)

Sin descripción.

Argumento	Tipo	Descripción
slot	string	obligatorio. Plain slot name; separators are rejected.
userIndex	integer	Platform user index. Valor predeterminado 0.

Devuelve: slot, userIndex, exists, valid, class, byteCount, properties, problems.

save.delete_many (riesgo 3, modifica, destructivo, smoke)

Deletes several save slots (files under Saved/SaveGames in editor builds); missing slots are reported, not failed.

Argumento	Tipo	Descripción
slots	array of string	obligatorio. Plain slot names to validate.
userIndex	integer	Platform user index. Valor predeterminado 0.

Devuelve: results, validCount, invalidCount.

save.get_property (riesgo 1, smoke)

Sin descripción.

Argumento	Tipo	Descripción
property	string	obligatorio. Authored SaveGame property name.

Devuelve: slot, userIndex, exists, valid, class, byteCount, properties, problems.

save.inspect_class (riesgo 0, smoke)

Sin descripción.

Argumento	Tipo	Descripción
class	string	obligatorio. SaveGame class name or path.

Devuelve: class, properties, saveGamePropertyCount.

save.list_properties (riesgo 0, smoke)

Sin descripción.

Argumento	Tipo	Descripción
class	string	obligatorio. SaveGame class name or path.

Devuelve: class, properties, saveGamePropertyCount.

save.migrate (riesgo 3, modifica, smoke)

Sin descripción.

Argumento	Tipo	Descripción
destinationSlot	string	obligatorio. Destination slot.
destinationClass	string	obligatorio. Destination class. Matching SaveGame properties are copied by name and compatible type.
destinationUserIndex	integer	Destination platform user index; -1 keeps userIndex. Valor predeterminado -1.
failIfDestinationExists	boolean	Refuse to replace the destination slot. Valor predeterminado false.

Devuelve: slot, userIndex, exists, valid, class, byteCount, properties, problems.

save.read (riesgo 1, smoke)

Sin descripción.

Argumento	Tipo	Descripción
propertyContains	string	Return only properties whose names contain this text.

Devuelve: slot, userIndex, exists, valid, class, byteCount, properties, problems.

save.read_bytes (riesgo 2, smoke)

Sin descripción.

Argumento	Tipo	Descripción
slot	string	obligatorio. Plain slot name; separators are rejected.
userIndex	integer	Platform user index. Valor predeterminado 0.

Devuelve: slot, userIndex, byteCount, base64.

save.reset_property (riesgo 3, modifica, smoke)

Sin descripción.

Argumento	Tipo	Descripción
property	string	obligatorio. Authored SaveGame property name.

Devuelve: slot, userIndex, exists, valid, class, byteCount, properties, problems.

save.reset_slot (riesgo 3, modifica, smoke)

Sin descripción.

Argumento	Tipo	Descripción
class	string	obligatorio. Concrete SaveGame class whose defaults replace this slot.
failIfExists	boolean	Refuse to replace an existing slot. Valor predeterminado false.

Devuelve: slot, userIndex, exists, valid, class, byteCount, properties, problems.

save.set_property (riesgo 3, modifica, smoke)

Sin descripción.

Argumento	Tipo	Descripción
value	string	obligatorio. New value in the same Unreal text form used by the details panel.

Devuelve: slot, userIndex, exists, valid, class, byteCount, properties, problems.

save.slot_exists (riesgo 0, smoke)

Sin descripción.

Argumento	Tipo	Descripción
slot	string	obligatorio. Plain slot name; separators are rejected.
userIndex	integer	Platform user index. Valor predeterminado 0.

Devuelve: slot, userIndex, exists, valid, class, byteCount, properties, problems.

save.validate (riesgo 1, smoke)

Sin descripción.

Argumento	Tipo	Descripción
slot	string	obligatorio. Plain slot name; separators are rejected.
userIndex	integer	Platform user index. Valor predeterminado 0.

Devuelve: slot, userIndex, exists, valid, class, byteCount, properties, problems.

save.validate_many (riesgo 1, smoke)

Sin descripción.

Argumento	Tipo	Descripción
slots	array of string	obligatorio. Plain slot names to validate.
userIndex	integer	Platform user index. Valor predeterminado 0.

Devuelve: results, validCount, invalidCount.

save.write (riesgo 3, modifica, smoke)

Sin descripción.

Argumento	Tipo	Descripción
class	string	obligatorio. SaveGame class name or path.
values	array of UeaKeyValue	SaveGame property -> Unreal text value.
failIfExists	boolean	Reject a slot that already exists. Valor predeterminado false.

Devuelve: slot, userIndex, exists, valid, class, byteCount, properties, problems.

save.write_bytes (riesgo 4, modifica, smoke)

Sin descripción.

Argumento	Tipo	Descripción
base64	string	obligatorio. Base64 raw save-system bytes. This bypasses SaveGame deserialization.

Devuelve: slot, userIndex, byteCount, base64.