Commands Reference
All commands provided by the QuestFable Bridge plugin. Commands are run in-game by an operator with the appropriate permission node.
LuckPerms permission nodes
| Node | Description |
|---|---|
questfable.use | View status and quest list |
questfable.quest.create | Create and preview quests |
questfable.quest.deploy | Deploy and remove quests |
questfable.quest.manage | Undo, history, adjust (includes deploy) |
questfable.admin | Link/unlink, setup (includes all above) |
All commands
/qf link› /qf linkGenerate a one-time pairing code and URL to link this server to your QuestFable account. Code expires in 15 minutes.
questfable.admin/qf unlink› /qf unlinkUnlink this server from your QuestFable account. You can re-link at any time.
questfable.admin/qf create› /qf create <description>Generate a new quest from a plain-language description. QuestFable shows a preview. Nothing is written to the server until you deploy.
questfable.quest.create/qf deploy› /qf deploy <quest-key>Deploy a quest that is in preview state to the server. Writes files to import/, triggers a hot-reload, and confirms the quest is live.
questfable.quest.deploy/qf preview› /qf preview <quest-key>Show the preview of a quest (title, objectives, rewards) without deploying it.
questfable.quest.create/qf regen› /qf regen <quest-key>Regenerate a quest that is in preview state. First 2 regenerations of an undeployed quest are free.
questfable.quest.create/qf remove› /qf remove <quest-key>Remove a deployed quest from the server. Deletes the quest files from import/ and triggers a hot-reload.
questfable.quest.manage/qf undo› /qf undo <quest-key>Roll back a quest to its previous version. Deploys the previous artefact without consuming quota.
questfable.quest.manage/qf history› /qf history <quest-key>List all versions of a quest with timestamps and deployment status.
questfable.quest.manage/qf list› /qf list [page]List all quests linked to this server (paginated, 10 per page).
questfable.use/qf status› /qf statusShow the current Bridge connection status, plugin version, quota remaining, and last heartbeat time.
questfable.use/qf setup-quests› /qf setup-questsGuided setup for servers without a quest plugin. Installs PikaMug (MIT licence) and configures it automatically.
questfable.admin/qf sync› /qf syncForce a heartbeat to sync pending deploy jobs (useful when the server was offline during generation).
questfable.admin/qf adjustV1.1: roadmap› /qf adjust <quest-key> <instruction>Adjust a deployed quest with a natural-language instruction without regenerating it from scratch.
questfable.quest.manageSupported quest plugins
| Plugin | Version | Status |
|---|---|---|
| Quests (PikaMug) | ≥ 5.0 | ✅ MVP |
| LMBishop's Quests | - | V1.1 |
| BetonQuest 3.0 | - | V2 |
| BeautyQuests | - | V3 (if demand) |
Quotas and credits
- Quota is deducted when the preview is confirmed (not on deploy).
- If QuestFable fails to produce a valid quest, no quota is charged.
- If a deploy fails (Bridge reload error), the quota unit is refunded automatically.
- First 2 regenerations of an undeployed quest are free. Each subsequent regeneration costs 1 unit.
- Credits are consumed after your monthly quota is exhausted (FIFO).