Changelog

Journey v3.0.0 + Ceremony v4.1.4

New Features

Cutscene System Overhaul

Cutscenes now use Ceremony’s new timeline-based engine for smoother, more reliable playback
Multi-step cutscene sequences with precise frame-based timing
Improved player state save/restore when entering and exiting cutscenes

Region System (Ceremony)

Define 3D spatial regions with entry/exit messages
Per-region entity visibility control and Pokemon spawn rules
Entry/exit callbacks and tick-based MoLang script execution
Zone system now integrates with Ceremony’s region engine for better performance

HUD Manager (Ceremony)

Priority-based action bar messages — no more conflicting overlapping text
Multi-boss bar support with automatic priority management
Sidebar/scoreboard system with custom line builders
Tab list header/footer customization
Toast notification system with icons and progress

Display & Holograms (Ceremony)

Create persistent 3D text displays and holograms anywhere in the world
Per-player holograms visible only to specific players
Click-interactive displays

Sound Sequencer (Ceremony)

Create timed sequences of sound effects with pitch ramping
Per-player sound control and session management

Particle Composer (Ceremony)

High-level particle shape builder (circles, polygons, stars, etc.)
Matrix-based transformations for complex spell-like effects

Floating Popups (Ceremony)

Spawn floating text above entities (damage numbers, loot labels, etc.)
World-visible or player-specific popups with automatic despawn

Dynamic tooltips that auto-update on items
Custom tooltip definitions with placeholder support

MoLang Schema Dump

New /ceremony dump-molang command generates a complete MoLang schema
Documents all available functions, events, and struct types for tooling integration
Used for the config builder on the docs

Cross-Server Party Sync

Parties now sync across servers via NATS messaging
Remote party creation, disbanding, and member updates are reflected automatically

Improvements

Cooldown permissions now work correctly — cooldown bypass and tier permissions now properly check with the permissions API instead of only checking OP level
GUI lore no longer renders in italic — custom lore lines on GUI items now correctly display without Minecraft’s default italic formatting
GUI refresh is now overridable — allows custom GUIs to implement their own refresh logic
Bounty board no longer crashes on edge cases — fixed a rare crash when weighted random selection had floating-point rounding issues
Buff persistence improved — buffs now save their instance type for more reliable restoration after server restarts
Zone tracking now uses Ceremony’s region engine — more efficient player detection and removes redundant tick-based particle drawing
Task system cleanup — removed static task map that could cause stale references

Removed

Instance/Dungeon System — the experimental instance system (procedural dungeons, room templates, encounter scripting) has been removed. This was not production-ready and will be redesigned in a future update
Virtual Layer System — per-player block/entity layers have been removed in favor of Ceremony’s region-based visibility rules
Old Notification System — action bar, boss bar, and chat notifications replaced by Ceremony’s unified HUD manager
Old Widget GUI System — the widget-based GUI renderer (with 15+ widget types) has been replaced by the new config-driven GUI system
Renewable Resources — the renewable/harvestable resource system has been removed
Zone-based Spawning — zone spawn conditions removed; now handled by Ceremony’s region spawn rules
Legacy Camera Controller — replaced by the cinematic helper and orbit camera systems
Old Cutscene Controllers — block, entity, effect, and camera controllers replaced by timeline-based cutscene engine

Breaking Changes

Instance-related commands (/journey instance) have been removed
Virtual layer commands (/journey virtual) have been removed
Zone spawning configs will need to be migrated to Ceremony region configs
Old widget-based GUI JSON configs are no longer loaded — use the new config-driven GUI format
Notification configs using the old format will need to be updated

Ceremony 4.0.0

Journey 3.0.0 requires Ceremony 4.0.0. Key changes:

Config format changed to HOCON. The Ceremony config is now config/ceremony/config.conf (not JSON). See Ceremony Integration for the new format.

NATS or Redis for cross-server messaging. The message bus now supports both NATS and Redis. Configure via messageBus.type ("NATS", "REDIS", or "NONE").

Database storage backends. Choose from JSON, SQLITE, MARIA_DB, MONGO_DB, or SCYLLA_DB for persistent data storage.

Player data backends. Player data can be stored via Cardinal Components (per-world) or in a shared database for multi-server setups.

New features:

HUD Toast Channel — Toast notifications via CeremonyAPI.hud.toast
HUD Sound Integration — All HUD channels support showSound
Region Expansion — UUID, color, entry/exit messages, visibility rules, spawn filtering, MoLang scripts
Cutscene Action Expansion — Entity, block, effect, and script actions
Cutscene Extension SPI — Register custom cutscene actions from other mods
Duration Parser — Supports "30t" (ticks), "1500ms", "1.5s" in cutscene timing

Journey Client (Optional Mod)

Journey Client is an optional companion mod installed on player clients for HUDs and visual enhancements. See Journey Client for details.

Party HUD: Real-time party member display with health, armor, hunger, Pokemon teams, distance, dimension indicators, and offline tracking. Configurable health styles (hearts/bars/both), position, and scale.

Global Task HUD: Server-wide task progress tracking with contributor counts, personal rank, and compact mode.

Zone Rendering: Visual zone boundaries in-world with configurable opacity, fade distances, and color coding.

Path Rendering: Visualize NPC patrol paths with waypoints, wait points, and real-time editor (press Z).

Levelable XP HUD: XP progress ribbon replacing boss bars, with level-up animations and XP gain popups.

Buff Display: Buff icons with duration timers, tooltips, and color-coded types.

Notifications: Toast notifications and announcement banners for quest events, party invites, and global tasks.

Objective Rendering: Quest markers as beacons with HUD direction indicators and distance display.

Client Commands: Configure all features via /journeyclient (party, globaltask, zone, objective, editmode).

New Systems

Global Task System: Server-wide collaborative objectives where all players contribute to shared progress. Boss bar display, cross-server sync via Ceremony (NATS or Redis), contributor tracking, and automatic rewards. Configure in config/journey/global_tasks/.

Party System: Group task sharing with real-time health/position sync, cross-server invites, and Pokemon team visibility. Commands via /party.

Buff System: Four buff types (attribute, potion, script, shiny_chance) with tick-based durations, stacking, hidden buffs, and debuffs. Configure in config/journey/buffs/.

Task Items: Physical items with embedded quest tracking. Three completion behaviors: REMOVE_ITEM, KEEP_ITEM, TRANSFORM_ITEM. Give with /journey taskitem give.

Contract System: Player-to-player agreements with custom terms, rewards, penalties, escrow, and expiration. Build contracts in-game with /journey contract create.

Bounty Boards: Rotating task pools with schedule-based rotation, weighted selection, and MoLang unlock conditions. Configure in config/journey/bounty_boards/.

Marker System: 3D floating displays (text, item, block) for quest guidance with per-player visibility, animations, and task phase integration. Configure in config/journey/markers/.

NPC Visibility System: Per-player NPC visibility control via MoLang conditions for quest phasing. Commands via /journey npcvisibility.

GUI System: JSON-configurable GUIs for journal, party, bounty boards, and more. Widget types: button, display, task_list, party_member_list, party_settings, navigation, backpack_slots, bounty_task_list.

NPC Pathing: Custom patrol routes with visual path editor, stuck detection, progress persistence, and speed control. Configure in config/journey/paths/.

Interactables: Invisible interactive entities with MoLang scripting, per-player visibility, and custom hitboxes. Configure in config/journey/interactables/.

Improvements

Task System: Item-based requirements, better progress tracking, contribution tracking, new event types, improved repeat system (MINUTELY, HOURLY, DAILY, WEEKLY, MONTHLY, YEARLY, NONE), buff rewards.

Zone System: New zone events and functions (disable_pvp, disable_mob_spawning, regenerate_health), hot-reload support, zone rendering with Journey Client.

Levelable System: Journey Client XP ribbon HUD, level-up animations, XP gain popups.

Path System: Progress persistence across restarts, hot-reload support, path validation, visual preview.

Performance

Zone System (70% faster): Batched player checks per dimension, optimized shape calculations, early exit for distant players.

Memory Management: Automatic cache cleanup every 5 minutes, proper player data cleanup on disconnect, fixed unbounded memory growth.

Sidebar & UI: Only updates when changes occur, reduced CPU usage.

Task System: Event-driven instead of per-tick execution.

Bug Fixes

Fixed memory leak in zone listeners
Fixed duplicate zone events on config reload
Fixed zone tracking crashes on player logout
Fixed task UI crashes with missing icons (now shows barrier fallback)
Fixed sequential tasks skipping optional steps
Fixed tracked tasks not removing from sidebar
Fixed login rewards not granting correctly
Fixed MoLang error spam in console
Fixed XP calculation errors with multiple levelables
Fixed active levelable not persisting through logout
Fixed NPC path data not persisting through restarts
Fixed NPC positions drifting over time
Cleaner error messages for malformed configs

New Commands

# Party
/party create | invite | kick | leave | promote | disband

# Buffs
/journey buff give <player> <buff_id> [duration] [stacks]
/journey buff remove <player> <buff_id>
/journey buff clear <player>
/journey buff list [player]

# Backpack
/journey backpack [player]

# Path Management
/journey pathmanager
/journey path create | assign | preview

# Interactables
/journey interactable summon | remove | list | reload

# Levelables
/journey levelable give | progress | respec | switch | gui

# Global Tasks
/globaltask start | stop | list | active

# Contracts
/journey contract create | list | accept | complete | abandon

# NPC Visibility
/journey npcvisibility show | hide | check | setcondition | register | update | list

Configuration Locations

System	Location
Main config	`config/journey/config.json`
Tasks	`config/journey/tasks/`
Zones	`config/journey/zones/`
Levelables	`config/journey/levelables/`
Timelines	`config/journey/timelines/`
Buffs	`config/journey/buffs/`
Bounty Boards	`config/journey/bounty_boards/`
Global Tasks	`config/journey/global_tasks/`
Markers	`config/journey/markers/`
Interactables	`config/journey/interactables/`
Paths	`config/journey/paths/`
Messages	`config/journey/messages.json`
GUIs	`assets/journey/guis/`

Changelog

Changelog

Journey v3.0.0 + Ceremony v4.1.4

New Features

Cutscene System Overhaul

Region System (Ceremony)

HUD Manager (Ceremony)

Display & Holograms (Ceremony)

Sound Sequencer (Ceremony)

Particle Composer (Ceremony)

Floating Popups (Ceremony)

Tooltip System (Ceremony)

MoLang Schema Dump

Cross-Server Party Sync

Improvements

Removed

Breaking Changes

Ceremony 4.0.0

Journey Client (Optional Mod)

New Systems

Improvements

Performance

Bug Fixes

New Commands

Configuration Locations