CLICommands
item
snug item <COMMAND>Item Engine: inventory, crafting, durability, and collections.
Subcommands
| Command | What it does |
|---|---|
containers | Container management |
grant | Grant items from a definition into a container |
move | Move an item to another container/slot |
split | Split a stack into a new stack |
merge | Merge a source stack into a target stack |
transfer | Transfer an item to another user |
reservations | Reservation management |
craft | Craft items from a blueprint against a source container |
use | Apply wear to an item |
repair | Repair an item |
salvage | Salvage an item |
definitions | Definition catalog management |
blueprints | Blueprint catalog management |
collections | Collection catalog management |
Run snug item <command> --help for that command's own options.
The global options apply everywhere.
Examples
snug item definitions create --domain blacksmithing --file ./iron_sword.json
snug item definitions get --domain blacksmithing --id def_iron_sword
snug item definitions list --domain blacksmithing
snug item blueprints create --domain blacksmithing --file ./iron_sword_bp.json
snug item collections create --domain blacksmithing --file ./north_set.json
snug item containers create --domain game --kind slotted --slots 24 --max-weight 80
snug item containers get --domain game --container-id cont_abc --expand
snug item grant --domain game --definition def_iron_ingot --quantity 5 --container cont_abc
snug item move --domain game --item item_abc --to-container cont_chest --to-slot 3
snug item split --domain game --item item_abc --quantity 2 --to-slot 5
snug item merge --domain game --source item_a --target item_b
snug item transfer --domain game --item item_abc --to-user usr_b --to-container cont_b
snug item reservations create --domain game --container cont_abc --definition def_iron_ingot --quantity 2 --ttl-seconds 30
snug item reservations refresh --domain game --reservation resv_abc --fencing-token 2 --ttl-seconds 60
snug item reservations shrink --domain game --reservation resv_abc --fencing-token 3 --quantity 1
snug item reservations release --domain game --reservation resv_abc --fencing-token 3
snug item reservations commit --domain game --reservation resv_abc --fencing-token 3
snug item craft --domain game --container cont_abc --blueprint bp_iron_sword --target-container cont_out
snug item use --domain game --item item_abc --amount 5
snug item repair --domain game --item item_abc --materials-from cont_abc
snug item salvage --domain game --item item_abc
snug item collections progress --domain game --collection col_north --user usr_abcNext
- item guide - what the service does and when to reach for it.
- API reference - every endpoint these commands call.
- CLI reference - global options, output modes, and exit codes.