Nook Quests

A small quest book written in data packs: chapters, a quest map, rewards. Quests build on advancements. Ships no quests - made for modpacks.

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 pos are 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).

Nook Quests Team

profile avatar
  • 5
    Projects
  • 1.1K
    Downloads

More from RiftwrightView all

  • Nookworks project image

    Nookworks

    Climb ropes, string café lights, print posters, cook udon and karaage, and open one door to every dimension - vanilla-style, for NeoForge 26.3 and 26.2.

    • 768
    • November 17, 2026
  • Nook Arms project image

    Nook Arms

    Two guns done with care: a Handgun and a Shotgun with sights, recoil and step-by-step loading. Every number is data - made for modpacks.

    • 12
    • November 17, 2026
  • Nook of the Dead project image

    Nook of the Dead

    Beyond the If Mirror, a world where it all went wrong. Go prepared, find suppressant before your time runs out, and be ready not to come back - a Nookworks add-on.

    • 146
    • November 15, 2026
  • Nook Technology project image

    Nook Technology

    A working steel mill for Nookworks - then conveyor belts with loading arms, power lines, billion-FE batteries, a chunk Quarry and ziplines.

    • 191
    • November 15, 2026
  • Nookworks project image

    Nookworks

    Climb ropes, string café lights, print posters, cook udon and karaage, and open one door to every dimension - vanilla-style, for NeoForge 26.3 and 26.2.

    • 768
    • November 17, 2026
  • Nook Arms project image

    Nook Arms

    Two guns done with care: a Handgun and a Shotgun with sights, recoil and step-by-step loading. Every number is data - made for modpacks.

    • 12
    • November 17, 2026
  • Nook of the Dead project image

    Nook of the Dead

    Beyond the If Mirror, a world where it all went wrong. Go prepared, find suppressant before your time runs out, and be ready not to come back - a Nookworks add-on.

    • 146
    • November 15, 2026
  • Nook Technology project image

    Nook Technology

    A working steel mill for Nookworks - then conveyor belts with loading arms, power lines, billion-FE batteries, a chunk Quarry and ziplines.

    • 191
    • November 15, 2026