QuestWeaver

QuestWeaver is a browser-based editor for making FTB Quests books without writing SNBT by hand. It is designed for both people and general-purpose AI models such as Gemini and GPT.

Open the editor: kiradiamond.github.io/QuestWeaver

Everything runs in the browser. Quest projects are not uploaded or stored on a server.

Make a quest book

1. Rename the starter chapter or add more chapters.
2. Add quests and edit their title, description, icon, size, and shape.
3. Add item or checkmark tasks and item or XP rewards.
4. Connect quests with dependencies and drag their nodes into position.
5. Select Export FTB ZIP.
6. Extract the ZIP into the modpack root. It contains config/ftbquests/quests and the files FTB Quests expects beneath it.

Keep a reusable copy with Save JSON. That file can be imported into QuestWeaver later.

Build with Gemini, GPT, or another AI

Models are not expected to click or control QuestWeaver. Give a text-only model the AI authoring guide, or select Ask AI to include the book currently open in the editor.

1. Select Ask AI, or open the text-only AI guide directly in your model.
2. Give the model the generated prompt or your requested quest book changes.
3. Save the model's response as a .json file. The response must contain only the JSON object, without a Markdown code fence.
4. Select Import JSON in QuestWeaver.
5. Review the result visually, then save the project or export the FTB ZIP.

The homepage, llms.txt, AI guide, public JSON Schema, and example project are all readable without running the client-side application.

Current support

• QuestWeaver project schema version 1
• FTB Quests file format 13
• English (en_us) text files
• Item and checkmark tasks
• Item and XP rewards
• Chapter layout, quest dependencies, JSON round-tripping, and ZIP export

The first release intentionally does not import existing FTB .snbt books or target older FTB Quests formats. Test an exported book in a copy of your modpack before replacing a working quest book.

Run locally

Requires a current Node.js LTS release and npm.

npm ci --ignore-scripts
npm run dev

Quality checks:

npm run lint
npm run typecheck
npm test -- --run
npm run build

The production build is written to dist. GitHub Pages publishes it automatically from main using the workflow in .github/workflows/deploy.yml.

Format notes

QuestWeaver's exporter is based on FTB Quests' current format-13 source behavior: chapter data and localized text are split into their expected directories, and built-in task/reward types use their short type names. The .snbt files use strict JSON syntax, which is accepted by the mod's JSON5 reader.

Useful references:

• FTB Quests source
• FTB Quests documentation
• Vite static deployment guide