NotQuests

NotQuests

A quest book for NeoForge 1.21.1. Quests sit on a map connected by lines – finishing one quest unlocks the next. Build them in-game with the editor, or write simple config files (works great with AI – see below).

Independent mod inspired by FTB Quests. Not affiliated with FTB, no FTB code or assets.

Features

• Quest map with chapters and chapter groups
• 11 task types: item, kill, location, dimension, biome, structure, advancement, checkmark, XP, statistic, observation
• 10 reward types: item, XP, XP levels, command, random / choice / all items from a reward table, loot table, advancement, toast
• Full in-game editor – right-click menus, drag & drop, copy / paste
• Dependencies – finishing a quest unlocks the next one
• Teams with shared progress
• Pinned quests on the HUD, completion toasts, Claim All button
• Quest Book item and a book button in the inventory
• Simple config files + /notquests reload

How to use

• Open the book with the ` key (left of 1), the book button in your inventory or the Quest Book item.
• Operators: click the pencil in the book to edit. Right-click the map to add quests. To connect quests, Ctrl+click a quest, right-click the next one → Require Selected.
• Quest files are in config/notquests/quests/. After editing them run /notquests reload.
• Install on the server and the client.

Config example

config/notquests/quests/
├── data.snbt               book settings + chapter groups
├── chapters/*.snbt         one file per chapter
└── reward_tables/*.snbt    one file per reward table

// config/notquests/quests/data.snbt
{
	title: "My Pack Quests",
	icon: "minecraft:writable_book",
	give_book_on_first_join: true,
	chapter_groups: [
		{ id: "group_main", title: "Main Story", icon: "minecraft:nether_star" }
	]
}

// config/notquests/quests/chapters/the_beginning.snbt
{
	id: "begin",                        // unique id, any text
	title: "&aThe Beginning",           // & = color codes
	icon: "minecraft:oak_sapling",
	group: "group_main",                // group id from data.snbt
	quests: [
		{
			id: "begin_welcome",
			title: "&eWelcome!",
			description: ["Welcome to the pack!", "Click the checkmark, then claim your reward."],
			x: 0, y: 0,                     // position on the map (x = right, y = down)
			size: 1.5,
			shape: "gear",
			tasks: [ { type: "checkmark" } ],
			rewards: [ { type: "item", item: "minecraft:bread", count: 8 } ]
		},
		{
			id: "begin_wood",
			title: "Timber!",
			x: 2.5, y: -1.25,
			dependencies: ["begin_welcome"], // unlocks after these quests
			tasks: [ { type: "item", item_tag: "minecraft:logs", count: 16 } ],
			rewards: [ { type: "xp", xp: 50 } ]
		},
		{
			id: "begin_stone",
			title: "Stone Age",
			x: 5, y: -1.25,
			dependencies: ["begin_wood"],
			tasks: [ { type: "item", item: "minecraft:cobblestone", count: 32, consume_items: true } ],
			rewards: [ { type: "random", table_id: "starter_loot" } ]
		},
		{
			id: "begin_hunter",
			title: "Monster Hunter",
			x: 2.5, y: 1.25,
			dependencies: ["begin_welcome"],
			tasks: [ { type: "kill", entity: "minecraft:zombie", value: 5 } ],
			rewards: [ { type: "xp_levels", xp_levels: 3 } ]
		},
		{
			id: "begin_iron",
			title: "Iron Age",
			x: 7.5, y: 0,
			dependencies: ["begin_stone", "begin_hunter"],
			tasks: [ { type: "item", item_tag: "c:ingots/iron", count: 8 } ],
			rewards: [ { type: "command", title: "Iron Pickaxe", icon: "minecraft:iron_pickaxe", command: "/give {p} minecraft:iron_pickaxe" } ]
		},
		{
			id: "begin_nether",
			title: "Into the Nether",
			x: 10, y: 0,
			size: 1.25,
			dependencies: ["begin_iron"],
			tasks: [ { type: "dimension", dimension: "minecraft:the_nether" } ],
			rewards: [ { type: "choice", table_id: "starter_loot" } ]
		}
	]
}

// config/notquests/quests/reward_tables/starter_loot.snbt
{
	id: "starter_loot",
	title: "Starter Loot",
	icon: "minecraft:chest",
	rewards: [
		{ item: "minecraft:bread", count: 6, weight: 10 },   // higher weight = more common
		{ item: "minecraft:iron_ingot", count: 3, weight: 5 },
		{ item: "minecraft:diamond", weight: 1 }
	]
}

// ALL TASK TYPES
{ type: "checkmark" }                                                         // player clicks it
{ type: "item", item: "minecraft:diamond", count: 3 }                         // just have it in the inventory
{ type: "item", item: "minecraft:cobblestone", count: 64, consume_items: true } // player hands it in
{ type: "item", item_tag: "c:gems/diamond", count: 3 }                        // any item from a tag
{ type: "item", item: "minecraft:crafting_table", only_from_crafting: true }
{ type: "kill", entity: "minecraft:zombie", value: 10 }                       // or a tag: "#minecraft:skeletons"
{ type: "location", dimension: "minecraft:overworld", location: [0, 60, 0, 16, 16, 16] } // x, y, z, width, height, depth
{ type: "dimension", dimension: "minecraft:the_end" }
{ type: "biome", biome: "minecraft:desert" }                                  // or "#minecraft:is_forest"
{ type: "structure", structure: "#minecraft:village" }                        // or "minecraft:stronghold"
{ type: "advancement", advancement: "minecraft:story/mine_diamond" }
{ type: "xp", value: 10 }                                                     // player pays 10 levels
{ type: "stat", stat: "minecraft:jump", value: 500 }
{ type: "observation", observe_type: "block", to_observe: "minecraft:diamond_ore", timer: 40 } // look at it for 2 s

// ALL REWARD TYPES
{ type: "item", item: "minecraft:diamond", count: 2 }
{ type: "xp", xp: 100 }
{ type: "xp_levels", xp_levels: 5 }
{ type: "command", command: "/give {p} minecraft:elytra", title: "Elytra", icon: "minecraft:elytra" }
{ type: "random", table_id: "starter_loot" }                                  // random item from a reward table
{ type: "choice", table_id: "starter_loot" }                                  // player picks one
{ type: "all_table", table_id: "starter_loot" }                               // everything from the table
{ type: "loot_table", loot_table: "minecraft:chests/simple_dungeon" }
{ type: "advancement", advancement: "minecraft:story/root" }
{ type: "toast", title: "Well done!", description: "You found the secret." }

// MORE QUEST OPTIONS
// optional: true, invisible: true, hide_until_deps_complete: true, can_repeat: true,
// dependency_requirement: "one_completed"  (all_completed, one_completed, all_started, one_started)
// shape: circle, square, rsquare, diamond, pentagon, hexagon, octagon, heart, gear

Make quests with AI

Copy the config example into ChatGPT / Claude / Gemini and write for example:

Make me a NotQuests chapter in exactly this format: 10 quests about the Nether, only vanilla 1.21.1 items, connected with dependencies.

Save the result into config/notquests/quests/chapters/ and run /notquests reload. If a file has a mistake, the log tells you the line.

Commands

Every command works as /notquests … and as the shorter /quest ….

• /quest open_book
• /quest editing_mode (op)
• /quest reload (op)
• /quest change_progress <players> complete|reset <quest|chapter|*> (op)
• /quest team create|invite|join|leave|kick|rename|info|list

Author: NotTerra · License: MIT