[Devs] Quests Packs

This is the quests & datapack page for devs.

Pack Limits

QuestTome is built for pack integration to expand its quest pool, however it does have an upper and lower limit before things are diluted or stale.

On 1.0, the soft ceiling is around 15 quests per tiers 1-3 before the pool is diluted, offer repeats start to get rare.

This does not account for quests using 1.1's future one-and-done mechanics, so tread carefully.

The base mod 1.0.1 comes default built with: 10 quests for tiers 1-3 (Softcap 15-16) 6 quests on tier 4 4 quests on tier 6

In 1.2 it'll have an option to disable the default pack, sliming the availability to enable multiple datapacks to build in a more modular manner without colliding together too badly. There will also be an ability to upscale the amount of bargains offered per tier per day.

For now, on 1.0.1, it's only suggested for players to run one or two datapacks to avoid offers becoming too diluted, but size variability between packs is up in the air, so just be aware of the current soft total ceiling when you're building your own.

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.