JourneyBeyond

JourneyBeyond brings Terraria-style Journey Mode to Minecraft, with research-based duplication, persistent unlocks, and datapack-configurable requirements.   It’s perfect for builders, testers, or survival progression servers that want controlled creative access.

---

🌟 Features

Commands

• /journey on - turns on journey mode
• /journey off - turns off journey mode
• /journey ui - access the ui through the command line of MC

📚 Research & Unlocking

• Sacrifice items in the Journey Table to unlock them for infinite duplication.
• Each item has a research requirement — sacrifice enough copies to unlock it forever.
• Rare or unique items (e.g., Dragon Egg) only require 1 copy.
• Requirements are fully configurable via datapacks (see below).

♾ Duplication

• Once unlocked, click an item in the Duplication Panel to instantly get a full stack.
• Items go directly into your inventory or drop nearby if full.
• Works in both singleplayer and multiplayer.

🖥 Journey Table UI

• Clean, Minecraft-inspired interface.
• Sacrifice slot on the left, Duplication Grid on the right.
• Search bar to filter unlocked items.
• Colored slot backgrounds to make sacrifice, duplication, and inventory areas easy to distinguish.

💾 Persistence

• All unlocks are saved in the world save (<world>/data/journey_data.dat).
• Data is automatically saved when:   - You unlock a new item.   - You log out.   - The server/world saves.
• Works seamlessly in multiplayer — all players share the same unlocks (per-world progression).

---

📂 Datapack Configuration

JourneyBeyond supports datapack-defined research requirements so you can control how many copies of each item are needed to unlock them.

File Location

data/<namespace>/journey_research/<item>.json

Example for minecraft:diamond:

{
  "item": "minecraft:diamond",
  "required": 64
}

Special Notes

• required: 0 disables unlocking for that item entirely.
• required: 1 is recommended for unique/rare items (like Elytra, Dragon Egg).
• If an item has no datapack entry, the mod uses its default requirement.
• You can override vanilla and other mod items with datapacks.

Installing a Datapack

1. Create a datapack in your world or server’s datapacks/ folder.
2. Follow standard Minecraft datapack structure:

datapacks/
  my_journey_settings/
   pack.mcmeta  
     data/
      mypack/
        journey_research/
          minecraft_diamond.json

1. Reload with /reload or restart the world.

---

📸 Screenshots

(Add screenshots of sacrifice slot, duplication grid, search, and custom-colored slots.)

---

⚙ Technical Info

• Platform: NeoForge 1.21.1+
• Persistence: SavedData in <world>/data/
• Capabilities: EntityCapability<IJourneyData, Void>
• Networking: Syncs on join, unlock, and world save
• Datapacks: JSON files for custom research requirements

---

📦 Modpack / Server Usage

• Great for creative or sandbox servers.
• Prevents full creative mode abuse while allowing controlled infinite items.
• Fully compatible with modded items (datapacks can tweak their requirements too).

---

📋 Planned

• Per-player progression mode.
• Advancement integration.
• Configurable UI size and layout.
• In-game research editor.

---

📜 License

MIT License — use freely in modpacks with credit.