A premium Minecraft utility mod that introduces a Terraria-style research and progression system. Permanent item unlocks, dynamic crafting recipe-tree analysis, customizable JSON thresholds, and a robust global save profile system that ensures unlocks persist across multiple single-player worlds and multiplayer servers.
[
]()
Available for:
Embark on your item collection journey with a simple four-step process. No duplicate steps or cluttered visual assets:
[ Deposit Item ] ──> [ Track Progress ] ──> [ Unlock Permanently ] ──> [ Retrieve Infinitely ]Press J in-game to open your Catalog. Place items in the Deposit slot to count them toward your research progress.
The default deposit panel where your item progression starts.
The interface dynamically shows your progress and how many more items of this type are needed to fully unlock it.
Deposit items in the slot to see their exact requirement thresholds.
Switch to the Journey tab once items are fully unlocked. You can pull infinite stacks of unlocked items directly into your inventory!
Retrieve infinite copies of unlocked items (Left-Click for 1, Shift + Left-Click for 64).
Interact with Journey Mode via Brigadier commands:
| Command | Action | Description |
|---|---|---|
/journeymode on |
Enable | Enable Journey Mode for yourself (allows GUI access & deposits). |
/journeymode off |
Disable | Disable Journey Mode (prevents GUI access & deposits). |
/journeymode status |
Status | Check your current toggle state. |
/journeymode reset |
Reset | Permanently wipes your personal catalog and restarts your progress. |
J (rebindable under Options ──> Controls ──> Key Binds ──> Journey Mode).Thresholds are calculated automatically based on the complexity of the item's recipe:
| Item Type | Example Item | Default Threshold |
|---|---|---|
| Tools, Weapons, & Armor | Diamond Pickaxe | 1 item |
| Complex Crafted Mechanics | Redstone Comparator | 1 item |
| Non-Stackable Goods | Bucket, Shears | 1 item |
| Raw Materials | Iron Ore, Log, Cobblestone | 64 items (1 stack) |
| Simple Crafted (Depth 1) | Iron Ingot, Wooden Planks | 32 items (50% stack) |
| Secondary Crafted (Depth 2+) | Iron Block, Chest | 16 items (25% stack) |
[!TIP] You can easily override these dynamic calculations with specific static values inside
custom_thresholds.json.
Rather than locking progress to a single save world, Journey Mode saves unlocks to a centralized Terraria-Style profile. This means your progression is tied to your player profile, not the map!
.minecraft/ (or your server root folder)
├── config/
│ └── Journey Mode/ <-- Mod Configurations
│ ├── blacklist.json
│ └── custom_thresholds.json
├── journeymode_unlocks.json <-- CENTRAL SAVE PROFILE (Player Unlocks)
└── saves/
├── World_A/
└── World_B/journeymode_unlocks.json.journeymode_unlocks.json file to migrate progress to a new PC, back up your progression history, or share researched libraries with friends.journeymode_unlocks.json)The file is organized as a dynamic JSON dictionary mapped by unique player UUIDs (Universal Unique Identifiers), ensuring multiplayer safety and compatibility:
{
"4042cfd6-0c6a-4d2b-aa90-b1ffbc018c64": {
"collected_counts": {
"minecraft:diamond": 5,
"minecraft:dirt": 64,
"minecraft:oak_log": 12
},
"unlocked_items": [
"minecraft:dirt"
],
"unlock_timestamps": {
"minecraft:dirt": 1716154382000
},
"enabled": true
}
}Inside each player's UUID entry, the following parameters are tracked:
collected_counts: A dictionary mapping item namespaced IDs (e.g. "minecraft:diamond") to the exact number of items the player has deposited. This tracks active progress before an item is fully unlocked.unlocked_items: A list of fully researched item IDs. Items in this list are fully unlocked and can be retrieved infinitely from the Journey tab catalog.unlock_timestamps: A dictionary mapping each unlocked item to the exact Unix Epoch millisecond timestamp of when it was unlocked. Perfect for tracking progress over time.enabled: A boolean (true/false) tracking whether the player currently has Journey Mode active. Controlled dynamically in-game via the /journeymode on|off commands.Configurations are automatically generated under config/Journey Mode/. Edits apply dynamically in-real-time without restarting the client.
blacklist.jsonPrevent specific items from being deposited or researched:
{
"_comment": "Add item IDs to blacklist them from Journey Mode",
"blacklisted_items": [
"minecraft:bedrock",
"minecraft:barrier",
"minecraft:command_block",
"minecraft:structure_void"
]
}custom_thresholds.jsonOverride the recipe calculator with direct unlock targets:
{
"_comment": "Override unlock thresholds for specific items",
"thresholds": {
"minecraft:diamond": 10,
"minecraft:netherite_ingot": 5,
"minecraft:elytra": 1,
"minecraft:enchanted_golden_apple": 3
}
}Ensure you download the correct loader file based on your environment:
| Minecraft Version | Java Version | Target Mod Loaders | Key Requirements | File Name |
|---|---|---|---|---|
| 1.21.1 | Java 21 | NeoForge, Fabric | NeoForge 21.1.72+Fabric Loader 0.19.2+ & Fabric API |
journeymode-1.6.0N-1.21.1.jarjourneymode-fabric-1.6.0N-1.21.1.jar |
| 1.20.1 (LTS) | Java 17 | Forge, Fabric | Forge 47.4.10+Fabric Loader 0.19.2+ & Fabric API |
journeymode-1.6.0N-1.20.1.jarjourneymode-fabric-1.6.0N-1.20.1.jar |
| 1.19.2 | Java 17 | Forge, Fabric | Forge 41.1.0+Fabric Loader 0.14.9+ & Fabric API |
journeymode-1.6.0N-1.19.2.jarjourneymode-fabric-1.6.0N-1.19.2.jar |
| 1.16.5 | Java 8 | Forge, Fabric | Forge 36.2.39+Fabric Loader 0.11.7+ & Fabric API |
journeymode-1.6.0N-1.16.5.jarjourneymode-fabric-1.6.0N-1.16.5.jar |
| 1.12.2 | Java 8 | Forge only | Forge 14.23.5.2860+ |
journeymode-1.6.0N-1.12.2.jar |
main / 1.6.0N) - Minecraft 1.21.1 (Java 21)journey-mode/ # Root NeoForge 1.21.1 Project
├── src/ # NeoForge source files
├── build.gradle # NeoForge gradle configurations
└── Fabric/ # Standalone Fabric 1.21.1 Project1.20.1, 1.12.2)Each legacy version is maintained inside its respective git branch using dedicated build subdirectories to prevent environment collisions:
1.20.1: subdirectories Forge_1_20_1/ and Fabric_1_20_1/ (Java 17)1.19.2: subdirectories Forge_1_19_2/ and Fabric_1_19_2/ (Java 17)1.16.5: subdirectories Forge_1_16_5/ and Fabric_1_16_5/ (Java 8)1.12.2: subdirectory Forge_1_12_2/ (Java 8, Forge-only)1.4.0 codebase baseline.Recipe<?> types.getItemKey) to resolve stone, wool, and dye variant unlocks in 1.12.2.1.6.0N-1.12.2 (1.12.2 Forge Port & Subtypes Progression)Release Date: May 23, 2026
getItemKey) combining the registry name and metadata (e.g. minecraft:stone:4 for polished diorite) to separate progression and unlocks for stone types, wood types, colored wool, and dyes. Overloaded capabilities to accept both Item and ItemStack signatures.RenderHelper.enableGUIStandardItemLighting()) to resolve dark items in the Journey catalog grid. Overrode isEnabled() on container slots to cleanly hide/draw slots during tab switches.Forge_1_12_2/ directory with independent configs.1.6.0N-1.20.1 (1.20.1 Multi-Loader LTS Port)Release Date: May 20, 2026
RecipeDepthCalculator across both platforms to directly query raw pre-1.20.2 Recipe<?> types from RecipeManager, resolving modern RecipeHolder classloading conflicts.Map<UUID, JourneyDataAttachment> tracking capability to safeguard Fabric players from dimension-swap or respawn desyncs.Forge_1_20_1/ and Fabric_1_20_1/ with independent buildscripts.1.6.0N (Core Reconstruction)Release Date: May 19, 2026
1.4.0 codebase, completely resolving previous experimental multi-module startup crashes and desync issues.journeymode_unlocks.json save handler. In-game operations leverage modern attachments (NeoForge) and static tracking maps (Fabric) for lag-free in-memory lookups, while all progress dynamically saves to the central JSON file.Fabric/ directory with 100% feature-parity.mappings loom.officialMojangMappings()) natively alongside Fabric Loader 0.19.2, ensuring perfect compile-time type-safety.HandledScreenMixin.java) to inject cleanly on top of AbstractContainerScreen in the Mojmap environment.1.5.0N (Dedicated Server Stability)Release Date: May 19, 2026
ClientKeyHandler inside client-only classes, isolating server runs from graphics packages (preventing crashes on dedicated servers).1.4.1N (Dumping & Drag Grid Deletion)Release Date: May 19, 2026
1.4.0 (First Stable Baseline Release)Release Date: October 31, 2025
/journeymode on|off|status toggle handles client catalog restrictions dynamically.custom_thresholds.json and blacklist.json.Created by Aryangpt007 • Made with ❤️ for the Minecraft community.
