Skip to content

Quest Packs

Quest Packs are self-contained bundles of quests, chapters, NPC profiles and translations that can be shared between servers. They are the primary way to distribute community-created quest content.

A quest pack is a single JSON file that contains everything needed for a set of quests to work:

  • Quest definitions (side, daily, weekly, or story)
  • Chapter structure (optional)
  • NPC profiles (optional)
  • Translations for EN and DE (optional)
  • Metadata (name, author, description, color)

In the Questbook, pack quests are listed in the normal tabs by their type, most of them under Side quests (see Quest Book Integration).

Every quest pack JSON file includes a _pack_info metadata block:

custom/halloween_event.json
{
"_pack_info": {
"id": "halloween_2026",
"name": "Halloween Event",
"description": "Spooky quests for the Halloween season",
"author": "ServerTeam",
"version": "1.0.0",
"createdAt": "2026-10-01",
"updatedAt": "2026-10-15",
"tags": ["event", "seasonal", "halloween"],
"color": "#FF6600"
},
"quests": [
{
"id": "hw_collect_pumpkins",
"type": "side",
"category": "halloween_2026",
"name": { "en-US": "Pumpkin Harvest", "de-DE": "Kuerbisernte" },
"objectives": [
{ "id": "gather", "type": "items_collected", "targets": ["Pumpkin"], "count": 20 }
],
"rewards": [
{ "type": "item", "itemId": "Candy_Bag", "amount": 1 }
]
}
],
"chapters": []
}
FieldRequiredDescription
idYesUnique identifier for the pack
nameYesDisplay name of the pack
colorNoHex color of the pack (e.g. #FF6600)
descriptionNoShort description of the pack
authorNoCreator name
versionNoSemantic version string
createdAtNoISO date when the pack was created
updatedAtNoISO date of the last update
tagsNoArray of tags for categorization
  1. Place the pack .json file into your server’s custom/ folder:
    mods/kyuubisoft_questbook/custom/halloween_event.json
  2. Run /ksquestadmin reload
  3. The pack’s quests appear in the Questbook (see below), and in the admin window’s quest list with the source “Pack”
  1. Place the file in the exports/ folder inside your quest data directory
  2. Use /ksquestadmin import <filename> to import the quests
  3. Imported quests are saved to the custom files and persist across restarts

Since the new Questbook (2.0.0) there are no separate pack tabs any more. Pack quests are sorted into the normal tabs by their type: daily, weekly and story quests go to their tabs, and every other quest (side quests and the usual pack quests) appears under Side quests. Story quests of a pack show in the Story tab when they belong to a chapter.

The admin window shows the pack as the quest’s source, and its quest list can filter by source.

The Mod Editor uses a dedicated .questpack interchange format for sharing packs between editors. This format includes additional metadata not needed by the server:

{
"_editor_format": "questpack",
"_editor_version": 1,
"pack": { "id": "...", "name": "...", ... },
"quests": [...],
"chapters": [...],
"npcProfiles": [...],
"localeEN": { "quest.hw_collect_pumpkins.name": "Pumpkin Harvest", ... },
"localeDE": { "quest.hw_collect_pumpkins.name": "Kuerbisernte", ... },
"customReferences": { "items": ["Pumpkin", "Candy_Bag"], "entities": [], "blocks": [] }
}

The .questpack format is for editor-to-editor sharing. To install on a server, export from the Mod Editor as a server JSON file, or use the zip export which generates the correct custom/ folder structure.

The Mod Editor provides a dedicated Packs workflow. Create a pack, add quests/chapters/NPC profiles, set translations, then export as server JSON (for custom/), .questpack (for sharing with other editors), or ZIP (full deployment structure).

  • Use a unique ID prefix for all quests in a pack (e.g. hw_ for Halloween) to avoid collisions
  • Set category to match the pack ID so quests group correctly in the Quest Book
  • Include EN translations at minimum; DE is recommended for multi-language servers