| name | bpx-material |
| description | BPX `material` command skill. Inspect materials, scan child instances, and extract custom HLSL. |
material
PREREQUISITE: Read bpx-shared.
Usage
bpx material read <file.uasset> [--export <n>] [--include-hlsl] [--children-root <directory>] [--parent <token>] [--pattern "*.uasset"] [--recursive] [--limit <n>]
Behavior
read: unified read entry for material inputs/references/parent and optional child scan/HLSL summary.
inspect: summarizes material inputs, asset references, and direct parent material.
children: scans a directory for material instances matching --parent token.
hlsl: shows custom-node HLSL snippets (UMaterialExpressionCustom::Code) and explains full-translation limits.
Code-Aligned Caveats
material read is the canonical entry; use flags to opt into HLSL and child scans.
- Directory scans should always narrow with
--parent, --pattern, and --limit.
High-Signal Examples
bpx material read ./Sample.uasset [--export 1] [--include-hlsl] [--children-root ./Content] [--parent SampleToken] [--pattern "*.uasset"] [--recursive] [--limit 1]