Skip to content

[Devs] Quests Packs

Sensitive Pigeon edited this page Jul 12, 2026 · 13 revisions

This is the quests & datapack page for devs.

Quest File Reference

Here's the reference template for quests.

{
  "title": "Quivering",
  "lore": "A defender needs arrows.",
  "description": "My quiver runs dry. They're at the door again. I don't have much time. - Archer Daniel",
  "patron": "archer_daniel",
  "format": 1,
  "tier": 2,
  "required_item": "minecraft:arrow",
  "required_count": 8,
  "reward_item": "minecraft:spider_eye",
  "reward_count": 10
}
  • Title - it is required, and the mod won't load an empty title
  • Lore - this is the log line in the bargains display
  • Description - viewed by clicking the title, additional context is optional
  • Patron - this is a value called by a future feature. unused in 1.0
  • Format - does nothing in 1.0, default 1
  • Tier - adjusts tier requirement
  • required item: explains itself, use proper syntax, but if you typo it'll warn you properly
  • reward item: self explanatory also, same thing.

Bad files will warn and skip, it shouldn't break the load. It'll warn you for unknown items, bad syntax, empty items, missing titles, and bad counts (and malformed json will stack trace)

Please name your quest files the same way. BAD file paths or changes to it will change the quest identity, player progress will reset.

Datapack Creation

Making a data pack is simple to deliver. Please follow the right instructions for making a data pack for minecraft, here.

For minecraft 1.20.1, please use this as your pack.mcmeta:

  "pack": {
    "pack_format": 15,
    "description": "My QuestTome quest pack"
  }
}```


Everything *must* follow a **data/grimoire** directory, or else it will not be read. Yes, grimoire - that's the modid in the files, **not questtome.**

Following that, use:

data/grimoire/namehere/quests/tierX

Example finalized directory that will work correctly:
_data/grimoire/culinary/quests/tier3/beef_bounty.json_

**IMPORTANT! Renaming a quest file will change its identity, meaning player progress will be lost.**

Currently on 1.0.1, there is no custom tiers support. Please use the tiers that come in the base mod.

## Loading the Pack

Use Paxi for modpacks or something similar.

For servers, simply navigate to world/datapack and drop it in.

Players load the datapack as they would any other.

Use /datapack list to confirm it's loaded.




Clone this wiki locally