Overview#
The Advancement Book Mod provides a tangible way for players to track their progress within Minecraft. By adding a craftable Advancement Book and an Advancement Bookstand, the mod integrates the advancement system into the physical world of the game. This is particularly useful for immersive roleplay, modpacks with complex keybindings, or players who prefer using in-game tools over menu shortcuts.
The mod is designed to be lightweight and compatible with both vanilla and modded advancements, ensuring that any custom milestones added by other mods are visible through the book's interface. It is available for multiple versions of Minecraft, including 1.18.2 and 1.16.5, supporting both Forge and Fabric loaders.
Items#
The mod adds a primary utility item that serves as the portable interface for the advancement system.
Advancement Book
- Type: Tool / Utility
- Stack Size: 1
- Function: When held in the main hand or off-hand, right-clicking with the Advancement Book will immediately open the standard Minecraft Advancement GUI. This allows the player to browse through different advancement tabs, check completed challenges, and see requirements for pending tasks.
Blocks#
For players who wish to display their progress or provide a public access point for advancements in a base or server hub, the mod includes a functional block.
Advancement Bookstand
- Type: Decorative / Functional Block
- Tool Required: Axe (any)
- Drops: Itself (Advancement Bookstand)
- Function: The Advancement Bookstand acts as a stationary version of the Advancement Book. Once placed in the world, any player can right-click the stand to open their own advancement menu. It features a unique model that resembles a lectern with the Advancement Book resting on top. It is an ideal addition to libraries, town halls, or spawn points in multiplayer servers.
Recipes#
Both the book and the stand are easily obtainable in survival mode using early-game materials. The recipes are designed to be low-cost to encourage early-game progression tracking.
Crafting the Advancement Book
The recipe is shapeless, meaning the ingredients can be placed anywhere in the crafting grid.
| Result | Ingredients | Recipe Type |
|---|---|---|
| Advancement Book | 1x Book + 1x Gold Nugget | Shapeless |
Crafting the Advancement Bookstand
The bookstand requires a shaped recipe involving wood and the Advancement Book itself.
| Result | Ingredients | Pattern |
|---|---|---|
| Advancement Bookstand | 1x Advancement Book + 3x Wooden Slab + 2x Wooden Planks | SSS / PBP / P P |
(Note: 'S' represents any Wooden Slab, 'P' represents any Wooden Planks, and 'B' represents the Advancement Book. The bottom-middle slot is typically left empty.)
Mechanics#
The mod functions by triggering the internal GUI call for advancements when the item or block is interacted with. It does not replace the default 'L' keybind but supplements it.
- GUI Access: The interface opened is the native Minecraft advancement screen. It supports all tabs (Minecraft, Nether, End, Husbandry, etc.) and any custom tabs added by other installed mods (e.g., Twilight Forest, Thermal Expansion).
- Multiplayer Compatibility: In a multiplayer environment, the book and stand are player-specific. When a player clicks the bookstand, they see their own progress, not the progress of the player who placed the stand.
- Off-hand Usage: The Advancement Book can be used from the off-hand, allowing players to keep a weapon or tool in their main hand while checking their goals.
- Commands: The mod does not introduce any new player-facing commands, relying entirely on item interaction.
Configuration#
The mod includes configuration options to help modpack creators and server admins tailor the experience. These settings are found in the advancementbook-client.toml or advancementbook-common.toml files depending on the version.
| Option | Default | Description |
|---|---|---|
giveBookOnFirstJoin |
false |
If set to true, every player who joins the world for the first time will automatically receive an Advancement Book in their inventory. |
disablePauseMenuButton |
false |
If set to true, the 'Advancements' button in the escape/pause menu will be removed, forcing players to use the book or keybind. |
These settings allow for a more 'hardcore' immersion where the player must physically possess the book to check their status.
Entities and World Generation#
To maintain its lightweight nature and ensure maximum compatibility with other mods, the Advancement Book Mod does not add any of the following:
- Mobs/Creatures: No new entities, animals, or monsters are added.
- Biomes: No new biomes or environmental changes are introduced.
- Dimensions: The mod does not add new worlds or dimensions.
- Structures: No naturally generating structures are added to the world. All items must be crafted by the player.
