FTB Quests Mod — Guide
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_tablesto clean up unused data.