bpx-name

name	bpx-name
description	BPX `name` command skill. Inspect and edit NameMap entries with UE5-compatible hashes.

name

PREREQUISITE: Read bpx-shared.

Usage

bpx name list <file.uasset>
bpx name add <file.uasset> --value <name> [--non-case-hash <u16>] [--case-preserving-hash <u16>] [--dry-run] [--backup]
bpx name set <file.uasset> --index <n> --value <name> [--non-case-hash <u16>] [--case-preserving-hash <u16>] [--dry-run] [--backup]
bpx name remove <file.uasset> --index <n> [--dry-run] [--backup]

Behavior

• list: lists NameMap entries and hashes.
• add: appends a new NameMap entry.
• set: rewrites one NameMap entry by index.
• remove: removes tail NameMap entry only when safety checks pass.
• add/set auto-compute UE5 hashes when hash flags are omitted.

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

Command Matrix

Command	Use when	Notable defaults
list	lists NameMap entries and hashes.	Read-only path; safe for discovery.
add	appends a new NameMap entry.	Run --dry-run first and use --backup for real writes.
set	rewrites one NameMap entry by index.	Run --dry-run first and use --backup for real writes.
remove	removes tail NameMap entry only when safety checks pass.	Run --dry-run first and use --backup for real writes.

High-Signal Examples

bpx name list ./Sample.uasset
bpx name add ./Sample.uasset --value SampleName [--non-case-hash <u16>] [--case-preserving-hash <u16>] [--dry-run] [--backup]
bpx name set ./Sample.uasset --index 1 --value SampleName [--non-case-hash <u16>] [--case-preserving-hash <u16>] [--dry-run] [--backup]
bpx name remove ./Sample.uasset --index 1 [--dry-run] [--backup]