Skip to content
Matcha! Mods

Introduction to Journey

Introduction to Journey

Section titled “Introduction to Journey”

Journey is a Minecraft mod for Fabric servers running Cobblemon that transforms your server into a rich, story-driven experience. It adds quests, skill progression, zone management, cutscenes, parties, and much more — all driven by JSON configuration files you can edit without touching code.

Why Journey?

Section titled “Why Journey?”

Most quest mods give you a rigid set of tools. Journey is different. Its systems are deeply composable — you can combine tasks, zones, flags, levelables, timelines, buffs, and Molang scripting to create experiences far beyond simple “go here, do that” quests.

Want an NPC that only appears after a player earns 3 gym badges? Done. A daily bounty board that rotates random challenges? Easy. A cutscene that plays when a player catches their first shiny? Absolutely.

What You Can Build

Section titled “What You Can Build”

Here are just a few things servers have built with Journey:

  • Full gym challenge systems with badge tracking, leader NPCs, and progressive unlocks
  • Daily and weekly bounty boards with rotating task pools and currency rewards
  • Skill/profession systems like Mining, Combat, and Exploration that level up from gameplay
  • Guided tutorials that walk new players through your server step by step
  • Story quests with cutscenes, NPC dialogue, and branching paths
  • Community events where all players contribute to a shared global goal

Core Systems at a Glance

Section titled “Core Systems at a Glance”

Journey is built around several interconnected systems. You don’t need to use all of them — start simple and add complexity as you go.

Tasks : The heart of Journey. Create quests with objectives, event triggers, Molang filters, and rewards. Supports linear, sequential, and randomized progression.

Zones : Define 3D areas in your world (spheres, cylinders, boxes) that trigger scripts, display messages, and control gameplay when players enter, exit, or stay inside.

Levelables : RPG-style skills that gain experience from gameplay events. Players level up Mining by mining, Combat by battling, Exploration by walking — you define the rules.

Timelines : Orchestrate timed sequences of commands and scripts. Perfect for cutscenes, reward ceremonies, and story beats.

Flags : Simple true/false values attached to players. Track “has this player completed the tutorial?” or “did they earn the Thunder Badge?” and use these checks everywhere.

Buffs : Apply temporary or permanent attribute modifiers and potion effects to players as rewards or zone effects.

Parties : Let players group up and share quest progress. Supports real-time member status sync and cross-server play.

Bounty Boards : Rotating pools of tasks that refresh on a schedule. Hook them up to NPCs, signs, or commands.

Global Tasks : Server-wide collaborative objectives where every player’s progress counts toward a shared goal.

Markers : 3D floating displays (text, items, particles, beacons) that guide players to quest locations. Requires Journey Client mod.

Cutscenes : Scripted cinematic sequences with camera movement, NPC dialogue, sound effects, and more. Powered by Ceremony under the hood.

NPCs & Paths : Control NPC visibility per-player and define walking paths that NPCs follow automatically.

Backpacks : A separate quest-item inventory that persists across sessions.

How Configuration Works

Section titled “How Configuration Works”

Everything in Journey is configured through JSON files in your server’s config/journey/ directory:

config/journey/
├── config.json              # Main settings
├── messages.json            # Customizable messages
├── tasks/                   # Quest definitions
├── zones/                   # Zone definitions
├── levelables/              # Skill progression configs
├── timelines/               # Timed action sequences
├── buffs/                   # Buff/debuff definitions
├── bounty_boards/           # Bounty board configs
├── global_tasks/            # Server-wide task configs
├── markers/                 # Standalone marker configs
├── paths/                   # NPC movement paths
├── cutscenes/               # Cutscene definitions
├── npc_visibility/          # Entity visibility rules
├── interactables/           # Interactive hitbox configs
├── items/                   # Custom item definitions
├── guis/                    # GUI configurations
└── examples/                # Working example configs

All changes can be hot-reloaded with /journey reload — no server restart required.

What You’ll Need

Section titled “What You’ll Need”

Required:

  • Minecraft 1.21.1 (Fabric)
  • Fabric Loader (latest)
  • Cobblemon (compatible version)
  • Ceremony 4.1.4+ (powers regions, cutscenes, HUD, displays, and cross-server features)
  • Fabric API
  • Polymer
  • Impactor (powers currency and economy rewards)
  • LuckPerms (permission management for commands and features)

Recommended:

  • Journey Client mod (for markers, enhanced UI on player clients)

Next Steps

Section titled “Next Steps”

Ready to get started? Here’s the recommended path:

  1. Installation Guide — Get Journey running on your server
  2. Configuration Overview — Understand the config structure
  3. Your First Task — Create a simple quest
  4. Event System — Learn what triggers are available
  5. Molang Scripting — Unlock advanced conditional logic