Journey Client

Journey Client is an optional companion mod installed on player clients. It adds HUDs, in-world rendering, and visual enhancements. Journey works perfectly without it — the client mod just makes the experience richer.

Installation

Download Journey Client (same source as Journey server mod)
Place the .jar in the client’s mods/ folder
Launch Minecraft with Fabric
Join your Journey server

Requirements:

Same Minecraft version as the server
Same mod loader (Fabric) as the server
Journey Client version must match Journey server version

Features

Party HUD

Displays real-time information about your party members.

Player faces rendered from skins
Health display (hearts, bars, or both) with status effects
Armor and hunger indicators
Distance and dimension display
Pokemon team visibility
Offline members shown in grey
Battle and mount indicators

Commands:

/journeyclient party toggle                   # Enable/disable
/journeyclient party healthstyle <mode>       # hearts/bar/both
/journeyclient party anchor <position>        # top-left/top-right/bottom-left/bottom-right
/journeyclient party scale <value>            # 0.1-3.0
/journeyclient party offset <x> <y>           # Position offset
/journeyclient party armor                    # Toggle armor display
/journeyclient party hunger                   # Toggle hunger display
/journeyclient party distance                 # Toggle distance display
/journeyclient party dimension                # Toggle dimension indicator
/journeyclient party info                     # Show current settings

Global Task HUD

Tracks server-wide task progress in real-time.

Progress bars with percentages
Active contributor count
Personal contribution tracking
Top contributors leaderboard
Compact mode for less screen space

Commands:

/journeyclient globaltask toggle              # Enable/disable
/journeyclient globaltask compact             # Toggle compact mode
/journeyclient globaltask position <x> <y>    # Set position
/journeyclient globaltask scale <scale>       # Adjust scale

Zone Rendering

Visualizes zone boundaries in the 3D world.

Color-coded boundaries based on zone type
Configurable opacity and fade distances
Distance-based fading for performance
Zone name display

Commands:

/journeyclient zone toggle                    # Enable/disable
/journeyclient zone opacity <value>           # Base opacity (0.0-1.0)
/journeyclient zone fadestart <distance>      # Fade start distance
/journeyclient zone fadeend <distance>        # Fade end distance

Path Rendering

Visualizes NPC patrol paths for editing and previewing.

See waypoints and wait points
Real-time path editor (press Z to toggle)
Preview paths before assigning to NPCs

Commands:

/journeyclient editmode path                  # Toggle path edit mode

Levelable XP HUD

Replaces boss bars with an XP progress ribbon.

Current level and progress to next level
XP gain popups with fade effects
Level-up celebration animations

Commands:

/journeyclient levelable toggle               # Enable/disable
/journeyclient levelable position <x> <y>     # Set position
/journeyclient levelable scale <scale>        # Adjust scale

Buff Display

Shows active buffs with icons and timers.

Duration countdown (MM:SS format, permanent shows infinity)
Tooltip with buff name, description, amplifier, and source
Color-coded by buff type

Notification System

Toast notifications and announcement banners.

Quest completion, task progress, and party invite notifications
Accept/Decline buttons for invites
Large center-screen banners for major events
Auto-dismiss after duration

Objective Rendering

Quest markers rendered as beacons and HUD indicators.

Vertical beams at quest locations
On-screen directional indicators
Distance display
Color-coded by objective type (yellow = active, blue = optional, green = turn-in)

Commands:

/journeyclient objective beacons              # Toggle beacons
/journeyclient objective markers              # Toggle HUD markers

Edit Modes

/journeyclient editmode path                  # Toggle path editing
/journeyclient editmode zone                  # Toggle zone editing

Configuration Files

Journey Client stores settings in .minecraft/config/journey-client/:

party-client.json — Party HUD settings
global-task-hud.json — Global task HUD settings
zone-visualization.json — Zone rendering settings
path-visualization.json — Path rendering settings
objective-markers.json — Objective marker settings

Use in-game commands to change these settings. See Client Configuration for the full reference.

Performance Tips

If experiencing FPS drops:

Reduce zone render distance
Disable zone rendering in crowded areas
Use compact mode for the Global Task HUD
Disable path rendering when not editing
Lower opacity values

Recommended settings:

Zone opacity: 0.3-0.5
Zone fade start: 32 blocks
Zone fade end: 64 blocks
HUD scale: 1.0
Objective render distance: 128 blocks

Troubleshooting

HUDs not showing:

Check the feature is enabled (/journeyclient <feature> toggle)
For Party HUD, you must be in a party
For Global Task HUD, a global task must be active
Verify HUD position isn’t off-screen and scale isn’t 0

Party HUD shows ”???”:

Party member is offline or on a different server
Network sync delay — wait a moment

Zone rendering not working:

Check zone rendering is enabled
Verify you’re near a zone and opacity isn’t 0.0
Confirm the server has Journey zones configured