CLICommands
quest
snug quest <COMMAND>Quest engine: definitions, progress, expeditions, and puzzles.
Subcommands
| Command | What it does |
|---|---|
definitions | Quest definition management (admin) |
events | Progress event ingestion |
offered | List quests currently offered to the caller |
accept | Accept an offered quest |
log | Show the caller's quest log |
turn-in | Turn in a completed quest and record rewards |
abandon | Abandon an active quest |
dispatch | Dispatch a party on an expedition |
check-in | Check in (resolve) an expedition |
answer | Submit an answer to a puzzle step |
hints | List hints for a puzzle step |
unlock-hint | Unlock a paid hint by charging its treasury price |
resume-rewards | Resume an interrupted reward fanout for a turned-in quest |
analytics | Quest funnel analytics (admin) |
Run snug quest <command> --help for that command's own options.
The global options apply everywhere.
Examples
snug quest definitions create --file ./forge_apprentice.json
snug quest definitions list --kind expedition
snug quest definitions list --query forge --page 1 --page-size 20
snug quest definitions get --quest-id quest_forge_apprentice
snug quest definitions update --quest-id quest_forge_apprentice --file ./forge_v2.json
snug quest definitions delete --quest-id quest_forge_apprentice
snug quest offered
snug quest accept --quest-id quest_forge_apprentice
snug quest events emit --type item.acquired --payload '{"item_id":"comp_iron_ore"}' --idempotency-key evt-1
snug quest events emit --type item.acquired --payload '{"item_id":"comp_iron_ore"}' --idempotency-key evt-2 --subject-user-id user_01HZX
snug quest log --status in_progress
snug quest turn-in --quest-id quest_forge_apprentice
snug quest abandon --quest-id quest_forge_apprentice
snug quest dispatch --quest-id quest_ruins_run --party user_01HZX,ent_hero_2
snug quest check-in --quest-id quest_ruins_run --early
snug quest answer --quest-id quest_cipher_hunt --step-id step_cipher --text "the raven"
snug quest hints --quest-id quest_cipher_hunt --step-id step_cipher
snug quest unlock-hint --quest-id quest_cipher_hunt --step-id step_cipher --order 1
snug quest resume-rewards --quest-id quest_forge_apprentice
snug quest analytics --quest-id quest_forge_apprentice --window 30dNext
- quest 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.