Nook Quests is a small quest book for NeoForge 26.3, written in data packs. Chapters, a map of quests, rewards to claim - opened with J or a button on your inventory. It carries no quests of its own: a modpack, a data pack or another mod brings them.
NeoForge 26.3 · server and client · no other mods needed · no mixins · English, 日本語, 简体中文, 繁體中文, 한국어, Español, Русский, Português (Brasil) · free to use in modpacks · MIT
What it is
- A book of chapters. Each chapter is a map: a plate a quest, a line from each quest to the ones it opens. Drag the map, zoom it with the wheel, click a quest to read it.
- Quests that follow what you do. A quest is done when its tasks are: an advancement earned, items held, a statistic reached (mobs killed, things crafted, chests opened...), a box ticked. What you did before a quest opened still counts.
- Rewards you claim. Items, experience, or a roll of a loot table. One button claims everything that waits; a mark on the inventory button says when something does.
- One notice, not two. A quest done is announced where advancements are - but not when an advancement has just announced the same deed.
- Each player their own. On a server everyone has their own progress and their own rewards. A player without the mod can still join (and has no book).
What it is not
- No in-game editor. Quests are files.
- No teams, no handing items in, no choice of rewards, no repeatable quests - not in this version.
- Not a second advancement screen. It builds on advancements: a quest can simply point at one.
For pack makers
A chapter and a quest are one small JSON file each, in a data pack; their texts are language files in a resource pack.
{
"chapter": "mypack:start",
"requires": ["mypack:start/welcome"],
"tasks": [
{ "type": "advancement", "advancement": "minecraft:story/smelt_iron" },
{ "type": "item", "item": "#minecraft:logs", "count": 16 }
],
"rewards": [
{ "type": "item", "id": "minecraft:torch", "count": 16 },
{ "type": "xp", "points": 20 }
]
}
- Point a task at any advancement - vanilla's, a mod's, or one you add with no
display(it then shows nowhere but in the book). Every trigger advancements know becomes a task; a quest that points at a shown advancement takes its icon. - Four kinds of task:
advancement,item(an item or a tag, counted over the whole inventory),stat(any statistic: kills, crafts, uses, custom ones),check(a box the player ticks). - Three kinds of reward:
item(with components; more than a stack is given as stacks),xp,loot(a loot table). - Conditions work (
neoforge:conditions), and a quest whose advancement is not loaded leaves the book by itself - the quests behind it go on past the gap. - No positions needed: quests without a
posare laid out as a tree. Give them one when you want your own map. - Mistakes are named: a misspelt field, a ring of requirements, a quest left out - each is a line in the log.
- Texts in any language: titles and descriptions are translation keys, with the eight languages above for the mod's own words.
The whole format is one page, WRITING_QUESTS.md, inside the mod's jar (a jar opens as a zip).
/nookquests complete and /nookquests reset help while you try a chapter out.
Good to know
- The mod alone shows an empty book: that is as it should be.
- Progress is kept in two places the game already saves: advancements, and a small record with each player.
- Quest ids are kept for good once players have them; everything else about a quest can change between pack versions.
Made for the author's own modpack of Nookworks, nookTechnology and Nook of the Dead; it needs none of them. Made with AI under the author's direction: the code and textures by Claude (Anthropic).