bpx-level

name	bpx-level
description	BPX `level` command skill. Inspect level exports and read/write actor properties in .umap.

level

PREREQUISITE: Read bpx-shared.

Usage

bpx level info <file.umap> --export <n>
bpx level actor-search <file.umap> [--name <token>] [--actor-label <token>] [--actor-class <token>] [--limit <n>]
bpx level var-list <file.umap> --actor <name|PersistentLevel.Name|export-index>
bpx level var-set <file.umap> --actor <name|PersistentLevel.Name|export-index> --path <dot.path> --value '<json>' [--dry-run] [--backup]

Behavior

• info: inspects one level export.
• actor-search: filters PersistentLevel child exports by name/ActorLabel/ActorClass tokens.
• var-list: decodes actor properties selected by --actor.
• var-set: updates one actor property at --path.
• --actor accepts object name, PersistentLevel.<Name>, or export index.

[!CAUTION] This command includes write-capable operations. Confirm intent and run --dry-run first.

Command Matrix

Command	Use when	Notable defaults
info	inspects one level export.	Read-only path; safe for discovery.
actor-search	filters PersistentLevel child exports by name/ActorLabel/ActorClass tokens.	Check bpx help for exact required flags.
var-list	decodes actor properties selected by --actor.	Check bpx help for exact required flags.
var-set	updates one actor property at --path.	Run --dry-run first and use --backup for real writes.

Code-Aligned Caveats

• --actor resolution supports name, PersistentLevel.<Name>, or export index.
• var-set uses property path semantics; use var-list to validate target paths first.

High-Signal Examples

bpx level info ./Sample.umap --export 1
bpx level actor-search ./Sample.umap [--name SampleToken] [--actor-label SampleToken] [--actor-class SampleToken] [--limit 1]
bpx level var-list ./Sample.umap --actor <name|PersistentLevel.Name|export-index>
bpx level var-set ./Sample.umap --actor <name|PersistentLevel.Name|export-index> --path MyProperty --value '{"value":1}' [--dry-run] [--backup]