FTB Quests Mod (1.21.1, 1.20.1) – A Team-Based Questing Mod

Overview#

FTB Quests is the industry-standard questing mod for Minecraft, designed to provide a seamless and powerful interface for both players and modpack developers. Unlike older questing mods that relied on complex text files, FTB Quests features a robust in-game GUI editor that allows for real-time creation of quest lines, chapters, and rewards. It integrates deeply with the FTB Teams mod, allowing groups of players to progress together, share tasks, and claim rewards collectively or individually.

The mod is built around the concept of Chapters, which contain Quests. Each quest consists of one or more Tasks (requirements) and Rewards. Progression can be linear, using dependency lines to lock quests until previous ones are finished, or non-linear, allowing players to choose their own path.

Items#

FTB Quests adds several essential items used for progression and reward distribution.

Quest Book

The primary tool for players. While the quest interface can often be accessed via a button in the inventory or a keybind (default 'Z'), the Quest Book item provides a physical way to interact with the system.

Item	Crafting Recipe	Purpose
Quest Book	1x Book + 1x Dirt (Shapeless)	Opens the Quest GUI to view progress and claim rewards.

Loot Crates

Loot Crates are consumable items that, when right-clicked, grant the player a random reward from a pre-defined Reward Table. They are often used as quest rewards to add an element of chance to progression.

Common Loot Crate: Typically contains basic materials.
Uncommon Loot Crate: Contains mid-tier resources.
Rare Loot Crate: Contains valuable items or rare materials.
Epic Loot Crate: Contains high-end gear or rare artifacts.
Legendary Loot Crate: Contains the most powerful items in the modpack.

Custom Icons

Modpack creators can use various items or custom textures as icons for quests and chapters to make the quest book visually distinct.

Blocks#

The mod includes specialized blocks for world-based progression and automation.

Quest Barrier

A block that acts as an invisible or visible wall. It remains solid and unbreakable until a specific quest is completed by the player. Once the quest is finished, the barrier disappears or becomes passable.

Configuration: Must be linked to a Quest ID using an Anvil (renaming the barrier to the Quest ID) or via the GUI in editing mode.
Teleportation: Can be configured to teleport players to a specific coordinate once the quest is completed.

Stage Barrier

Similar to the Quest Barrier, but functions based on Game Stages (requires the Game Stages mod). It prevents players from entering an area until they have unlocked the required stage.

Task Screen

The Task Screen is a block used to automate the submission of items, fluids, or energy. It is essential for quests requiring massive amounts of resources (e.g., "Submit 1,000,000 Cobblestone").

Item Submission: Can be fed by hoppers or pipes.
Fluid Submission: Accepts liquids from tanks or pipes.
Energy Submission: Accepts FE (Forge Energy) or RF from power cables.
Configuration: Shift-right-click with a Quest Book or Configurator to link it to a specific task.

Quest Editor & Mechanics#

The Quest Editor is the core of the mod for developers. It is accessed by enabling Editing Mode.

Enabling Editing Mode

To start creating quests, use the command /ftbquests editing_mode true or click the pencil icon in the bottom-right corner of the Quest GUI (if you have operator permissions).

Key Mechanics

Chapters & Groups: Organize quests into logical sets (e.g., "Getting Started", "Magic", "Tech"). Groups allow you to collapse multiple chapters into a single category.
Visibility: Quests can be set to "Always Visible," "Hidden until Dependencies Met," or "Secret" (only visible once completed).
Shapes: Quests can be rendered as circles, squares, hexagons, hearts, or gears to denote different types of content (e.g., main story vs. side quests).
Repeatable Quests: Quests can be configured to be repeatable after a specific cooldown period, allowing players to farm rewards.

Task Types#

Tasks are the requirements players must meet to complete a quest. FTB Quests supports a wide variety of task types:

Task Type	Description
Item	Requires the player to have or consume specific items. Supports NBT and Tag filters.
Fluid	Requires submitting a specific amount of liquid (e.g., 10,000mB of Lava).
Energy	Requires submitting FE/RF energy via a Task Screen.
Kill Entity	Requires killing a specific number of a certain mob (e.g., 50 Zombies).
Visit Dimension	Completes when the player enters a specific dimension (Overworld, Nether, End, etc.).
Visit Biome	Completes when the player enters a specific biome.
Find Structure	Completes when the player is within the bounding box of a structure (e.g., Village, Fortress).
Advancement	Requires the player to earn a specific vanilla or modded advancement.
XP Levels	Consumes a set amount of player XP levels.
Checkmark	A simple task that completes when the player clicks the checkmark icon (used for info quests).
Observation	Requires the player to look directly at a specific block or entity.
Custom	Can be triggered by external scripts or other mods.

Reward Types#

Rewards are given to players upon quest completion. They can be configured for individual players or the entire team.

Reward Type	Description
Item	Grants a specific item or stack of items.
Choice	Allows the player to choose one reward from a provided list.
Random	Grants a random item based on weights from a Reward Table.
Loot Table	Gives the player a Loot Crate or rolls directly from a Minecraft loot table.
Command	Executes a server-side command (e.g., `/tp`, `/effect`, or custom mod commands).
XP / XP Levels	Grants raw experience points or full experience levels.
Advancement	Grants the player a specific advancement.
Toast	Displays a custom popup notification on the player's screen.
Stage	Unlocks a Game Stage for the player (requires Game Stages mod).

Reward Tables & Loot Crates#

Reward Tables are pools of items used for Random and Choice rewards. They are managed in the "Settings" menu of the Quest Book.

Creating a Table: In editing mode, go to Settings > Reward Tables > Add.
Adding Items: Drag and drop items into the table and assign them a "Weight." Higher weights mean a higher chance of being selected.
Converting to Loot Crate: Any reward table can be toggled into a "Loot Crate." This generates a physical item (Loot Crate) that uses that table's logic when opened.
Empty Tables: Use /ftbquests delete_empty_reward_tables to clean up unused data.

Commands#

FTB Quests provides several commands for administrators to manage player progress and quest data.

Command	Description
`/ftbquests editing_mode [true/false]`	Toggles the ability to edit quests in the GUI.
`/ftbquests change_progress <player> <reset/complete> <id>`	Resets or forces completion of a specific quest or chapter for a player.
`/ftbquests generate_chapter from_inventory`	Creates a new chapter with item tasks for every item in the player's inventory.
`/ftbquests generate_chapter from_entire_creative_list`	Creates a massive chapter containing every item in the game (Warning: Lag intensive).
`/ftbquests reload`	Reloads quest data from the server files.
`/ftbquests item_info`	Displays the ID, NBT, and Tags of the item held in hand (useful for task creation).
`/ftbquests export_reward_table_to_csv <id>`	Exports a reward table's data to a CSV file for external editing.

Configuration#

The mod's behavior can be fine-tuned through configuration files located in the config folder.

ftbquests-server.snbt: Controls server-side logic, such as whether rewards are shared by default, permission levels for commands, and quest file synchronization.
ftbquests-client.snbt: Controls client-side preferences, such as UI scale, quest notification positions, and the fallback locale for translations.
Quest Files: All quest data is stored in the world/ftbquests folder. This allows modpack creators to easily ship quest lines by including this folder in their modpack distribution.