Deployment Failed
What happens when the Bridge can't load a quest, and what QuestFable does about it automatically.
What is a deployment failure?
After you deploy a quest, the Bridge plugin writes the quest file to plugins/Quests/import/ and triggers a PikaMug hot-reload. If PikaMug reports an error loading the quest (e.g., a malformed YAML value or incompatible feature), that's a deployment failure.
Automatic auto-repair
When QuestFable detects a reload failure, it attempts to repair the quest automatically:
- The Bridge plugin sends the error log (exception type + relevant excerpt) back to QuestFable.
- QuestFable runs up to 2 auto-repair passes, each generating a corrected version of the quest.
- If the repaired version loads successfully, it is deployed transparently: you may not even notice.
- If both repair passes fail, QuestFable rolls back to the previous state and refunds the quota unit.
Quota refund
If a quest cannot be deployed after auto-repair:
- The quest is returned to preview state (not deleted, you can try again).
- The quota unit consumed at preview confirmation is automatically refunded.
- No action is required from you: the refund happens within seconds of the failure confirmation.
In-game error message
[QuestFable] ❌ Deployment failed · auto-repair in progress...
[QuestFable] ✅ Auto-repaired. Quest qf_glowing_harvest re-deployed.or, if repair also fails:
[QuestFable] ❌ Deployment failed after repair attempts.
[QuestFable] Quest returned to preview state. Quota refunded.Common causes
| Cause | What to do |
|---|---|
| PikaMug version incompatibility | Check that PikaMug ≥ 5.0 is installed. Update via Modrinth. |
| Item or material name changed in a Minecraft update | Regenerate the quest: QuestFable will use the current item registry. |
| NPC UUID not linked | If the quest references an NPC, run /qf npc link <quest-key> <npc-name> to bind the NPC UUID. (V1.1 command) |
| import/ folder is read-only | Check the file permissions on plugins/Quests/import/. The server process needs write access. |
Manual rollback
If you want to roll back to the previous version of a deployed quest manually:
› /qf undo <quest-key>Or use the Restore previous version button in the web panel library. Rollback never consumes quota.
Still failing?
Paste the exact error from the Bridge plugin (visible in /qf status or the console) in the QuestFable Discord. Include your PikaMug version and Minecraft version.