bpx-prop

name	bpx-prop
description	BPX `prop` command skill. Read decoded properties or mutate properties in one export.

prop

PREREQUISITE: Read bpx-shared.

Usage

bpx prop list <file.uasset> --export <n>
bpx prop set <file.uasset> --export <n> --path <dot.path> --value '<json>' [--dry-run] [--backup]
bpx prop add <file.uasset> --export <n> --spec '<json>' [--dry-run] [--backup]
bpx prop remove <file.uasset> --export <n> --path <dot.path> [--dry-run] [--backup]

Behavior

• list: decodes properties for one export and includes warnings.
• set: updates an existing property value at --path.
• add: appends a new top-level property from --spec JSON.
• remove: removes a property at --path.
• Write subcommands report old/new values, size deltas, and changed-byte status.

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

Command Matrix

Command	Use when	Notable defaults
list	decodes properties for one export and includes warnings.	Read-only path; safe for discovery.
set	updates an existing property value at --path.	Run --dry-run first and use --backup for real writes.
add	appends a new top-level property from --spec JSON.	Run --dry-run first and use --backup for real writes.
remove	removes a property at --path.	Run --dry-run first and use --backup for real writes.

Code-Aligned Caveats

• Write paths mutate one export only; invalid dot paths fail explicitly.
• Prefer prop list immediately before prop set/add/remove to avoid stale assumptions.

High-Signal Examples

bpx prop list ./Sample.uasset --export 1
bpx prop set ./Sample.uasset --export 1 --path MyProperty --value '{"value":1}' [--dry-run] [--backup]
bpx prop add ./Sample.uasset --export 1 --spec '{"value":1}' [--dry-run] [--backup]
bpx prop remove ./Sample.uasset --export 1 --path MyProperty [--dry-run] [--backup]