Writes meta.lsf. The previous file is backed up first; undo with dos2_restore. Fails with an error while the game process is running unless allow_running=true.
Players need the same .pak, as with any add-on. Fails if the file is missing or holds no single meta.lsx.
Returns the module name, author, UUID, the .pak path and the campaign's add-on list. To build a mod from a
source folder use dos2_mod_install.

Every write tool already backs up the files it touches, so use this for a complete snapshot before a risky
series of edits or before a play session. Returns the backup id and its path. List backups with dos2_backups
and bring one back with dos2_restore.

Read-only. Use it to find the id to pass to dos2_restore when an edit has to be undone. Returns an empty list
when the campaign has no backups yet.

The previous file is backed up first; undo with dos2_restore. Fails with an error while the game process is running unless allow_running=true.
Returns the backup id and the campaign's add-on list. Attach again with dos2_bridge_install.

The previous file is backed up first; undo with dos2_restore. Attaching: Fails with an error while the game process is running unless allow_running=true.
In multiplayer every player needs the same .pak and Script Extender, as with any add-on; after a rebuild, send
them the new file. Returns the .pak path, the packed files and the campaign's add-on list. Check the result
with dos2_live_status; remove with dos2_bridge_detach.

Read-only. Use it to orient yourself before reading details or editing. For full content follow up with
dos2_scene (who stands in a scene), dos2_template (one template), dos2_vignettes or dos2_notes. To pick a
campaign in the first place use dos2_status.

The campaign folder keeps its name, because the game identifies the campaign by it. The previous file is backed up first; undo with dos2_restore.
Fails with an error while the game process is running unless allow_running=true. Returns the backup id and the resulting metadata.

Writes Notes.lsf. The previous file is backed up first; undo with dos2_restore. Fails with an error while the game process is running unless allow_running=true.
Fails with an error when nothing matches. Returns the UUIDs removed and the backup id. To change a note's text
instead, use dos2_put_note.

Writes Eggs.lsf. The previous file is backed up first; undo with dos2_restore. Fails with an error while the game process is running unless allow_running=true.
Fails with an error when no template has that name. Returns the number of templates removed and the backup id.

Writes Vignettes.lsf. The previous file is backed up first; undo with dos2_restore. Fails with an error while the game process is running unless allow_running=true.
Fails with an error when nothing matches. Returns the UUIDs removed and the backup id.

Needs internet access. Writes only into the data folder; the game and the campaigns are not touched. When
Divine.exe is already there it returns at once without downloading. Returns {result, source}, or {error} on a
network failure or checksum mismatch (then nothing is unpacked).

Read-only. Use it to find a template to copy: pass a hit to dos2_put_npc_template as base="Campaign:Name". To
list one campaign's templates without searching use dos2_templates.

Read-only; needs the game running with the bridge mod (see dos2_live_status), otherwise it fails with a timeout
error. Use it to get GUIDs and positions for dos2_live_move, dos2_live_set, dos2_live_stage and
dos2_live_spawn. For what is saved in the campaign files rather than the running game, use dos2_scene.

It can change or break anything in the running session, so prefer the dedicated tools (dos2_live_characters,
dos2_live_spawn, dos2_live_move, dos2_live_set, dos2_live_stage) when they fit. The returned value must be
JSON-serializable. Lua errors come back as an error with the message; a call that outlives timeout fails. Needs
the bridge (see dos2_live_status). Do not call Osi functions while a level is still loading.

Changes only the running game, not the campaign files. During the Game Master pause the move is applied after
unpausing (the result has applies_on_unpause=true). Fails with an error when who matches no character or more
than one (then pass a GUID), or when neither a full x, y, z nor near is given. Needs the bridge (see
dos2_live_status). Get positions from dos2_live_characters.

Changes only the running game, not the campaign files or the template the character came from. Setting
alignment to "Evil NPC" makes the character hostile, which can start combat. Fails with an error when who
matches no character or more than one (then pass a GUID). Needs the bridge (see dos2_live_status). Returns the
character's new state. To move a character use dos2_live_move; to hide one use dos2_live_stage.

From a GM template only the model, level, alignment and name are used: its stat edits, skills and items are NOT
applied this way (placing it from the game's "Creatures and Items" panel applies them). During the Game Master
pause the character is created at once but moves into place only after unpausing: the result then has
applies_on_unpause=true and its position still reads 0, 0, 0. Needs the bridge (see dos2_live_status). Returns
the new character's GUID and state.

Changes only the running game. Fails with an error when who matches no character or more than one (then pass a
GUID). Needs the bridge (see dos2_live_status). Returns the character's new state.

Read-only, no parameters. Call it before the first live tool of a session and whenever a live tool times out.
If the bridge is not built or attached, run dos2_bridge_install with the game closed. For file-level setup
(campaign list, Divine.exe) use dos2_status.

Use it for mods you develop yourself; for a ready third-party .pak use dos2_addon, and for this server's bridge
use dos2_bridge_install. Fails if PublishVersion in meta.lsx is below a Definitive Edition editor version (use
909321303): the game would mark the mod as Classic and refuse it. The previous file is backed up first; undo with dos2_restore. Attaching: Fails with an error while the game process is running unless allow_running=true.
Returns the .pak path, packed files, module name and UUID, and the add-on list.

Read-only. When titles are enough, dos2_campaign is cheaper. Create or change a note with dos2_put_note and
remove one with dos2_delete_note.

Writes Eggs.lsf. The previous file is backed up first; undo with dos2_restore. Fails with an error while the game process is running unless allow_running=true.
Returns created (true for a new template), a summary of the template and the backup id. For NPC templates use
dos2_put_npc_template; to give an NPC template items, pass them in its items parameter instead.

Writes Journal.lsf. The previous file is backed up first; undo with dos2_restore. Fails with an error while the game process is running unless allow_running=true.
The shared flag was not verified against Larian's samples; the GM can also share entries in the game. Returns
the backup id and the journal as it now reads.

A note inside a scene hangs on an invisible marker item of the level, so new scene notes have to be placed in
the game; for one that already exists this tool changes title, text and folder and keeps its binding.

Writes Notes.lsf. The previous file is backed up first; undo with dos2_restore. Fails with an error while the game process is running unless allow_running=true.
Fails with an error if the map is not found or has to be specified. Returns created, the note's uuid, where it
sits and the backup id. Read notes with dos2_notes; remove one with dos2_delete_note.

Writes Eggs.lsf. The previous file is backed up first; undo with dos2_restore. Fails with an error while the game process is running unless allow_running=true.
The template only defines what the GM can place: it does not put a character into a scene (place it in the game,
or use dos2_live_spawn). Returns created (true for a new template), the resulting template in full and the
backup id. For item templates use dos2_put_item_template.

Writes Vignettes.lsf and, with image, copies the picture into the campaign's Vignettes/Illustrations. The previous file is backed up first; undo with dos2_restore.
Fails with an error while the game process is running unless allow_running=true. Fails with an error if the image file does not exist. Returns created, the vignette's uuid, the image
name and size, and the backup id. Read existing vignettes with dos2_vignettes.

Read-only. Prefer the structured tools (dos2_campaign, dos2_scene, dos2_template, dos2_vignettes, dos2_notes)
when they cover the need: raw files are large. With xpath the output starts with a match count; output longer
than max_chars is truncated with a note. Fails with an error if the file does not exist in the campaign.

The current state of the affected files is itself backed up first under the label "before-restore", so a
restore can be undone too. Fails with an error while the game process is running unless allow_running=true. Fails with an error when the backup id does not exist. Returns the id of
the before-restore backup and restored_from.

Read-only, and it shows the saved state, not a running game: for the live level use dos2_live_characters. Placed
characters cannot be edited through files; change them in the game or with the dos2_live_* tools. Fails with an
error if the scene has never been loaded in the game (it has no LevelCache file yet).

It does not change what is placed in the scene: characters and items are placed in the game or with the
dos2_live_* tools. The previous file is backed up first; undo with dos2_restore. Fails with an error while the game process is running unless allow_running=true.
Returns the backup id and the scene entry as it now reads.

Read-only, no parameters. Call it first in a session to choose a campaign and check setup: if divine_found is
false, run dos2_fetch_lslib before any other tool. For the readiness of the running game (Script Extender,
bridge mod) use dos2_live_status instead.

Read-only. Fails with an error when the campaign has no template with that name. Use it to inspect a template
before changing it with dos2_put_npc_template or dos2_put_item_template. To list the available names use
dos2_templates; to search across campaigns use dos2_find_templates.

Read-only. Use dos2_template to get one template in full, and dos2_find_templates to search by substring across
all campaigns, including Larian's sample ones.

Read-only. When titles are enough, dos2_campaign is cheaper. Create or change a vignette with dos2_put_vignette
and remove one with dos2_delete_vignette.