Client Configuration Reference

Journey Client provides extensive configuration options for all visual HUD elements. All client configs are stored in config/journey/ on the client side.

Configuration Files

Journey Client uses multiple configuration files:

party-client.json - Party HUD and 3D indicators
global-task-hud.json - Global task display settings
zone-visualization.json - Zone boundary rendering
path-visualization.json - Path rendering settings
objective-markers.json - Objective marker display
levelable-hud.json - XP and levelable display
buff-display.json - Buff/debuff HUD settings
notifications.json - Notification system config

Party Client Configuration

File: config/journey/party-client.json

Complete configuration for the Party HUD and 3D party member indicators.

{
  "enabled": true,
  "showHUD": true,
  "show3DIndicators": true,
  "anchorPosition": "TOP_RIGHT",
  "offsetX": 10,
  "offsetY": 10,
  "healthStyle": "HEARTS",
  "hudScale": 0.8,
  "showArmor": true,
  "showHunger": true,
  "showBuffs": true,
  "showPokemonTeam": true,
  "showDistance": true,
  "showDimension": true,
  "showLeadingPokemon": true,
  "showBattleIndicator": true,
  "showLevelable": true,
  "showMountIndicator": true,
  "showZoneName": true,
  "indicatorMaxDistance": 128.0,
  "showIndicatorHealth": true,
  "showIndicatorName": true,
  "showIndicatorDistance": true,
  "hudOpacity": 0.8,
  "indicatorScale": 1.0
}

Party HUD Fields

Core Settings

Field	Type	Default	Description
`enabled`	Boolean	`true`	Enable/disable entire party client system
`showHUD`	Boolean	`true`	Show the party member HUD
`show3DIndicators`	Boolean	`true`	Show 3D indicators above party members

HUD Position

Field	Type	Default	Description
`anchorPosition`	String	`"TOP_RIGHT"`	HUD anchor point: `TOP_LEFT`, `TOP_RIGHT`, `BOTTOM_LEFT`, `BOTTOM_RIGHT`
`offsetX`	Integer	`10`	Horizontal offset from anchor (pixels)
`offsetY`	Integer	`10`	Vertical offset from anchor (pixels)
`hudScale`	Float	`0.8`	HUD scale multiplier (0.1-3.0)
`hudOpacity`	Float	`0.8`	HUD background opacity (0.0-1.0)

Health Display

Field	Type	Default	Description
`healthStyle`	String	`"HEARTS"`	Display mode: `HEARTS`, `BAR`, `BOTH`
`showArmor`	Boolean	`true`	Display armor points
`showHunger`	Boolean	`true`	Display hunger/saturation
`showBuffs`	Boolean	`true`	Display active status effects

Party Member Info

Field	Type	Default	Description
`showPokemonTeam`	Boolean	`true`	Display party member’s Pokémon team
`showLeadingPokemon`	Boolean	`true`	Show the Pokémon currently out
`showDistance`	Boolean	`true`	Show distance to party members
`showDimension`	Boolean	`true`	Show which dimension members are in
`showBattleIndicator`	Boolean	`true`	Show if member is in Pokémon battle
`showMountIndicator`	Boolean	`true`	Show if member is riding a Pokémon
`showLevelable`	Boolean	`true`	Show active levelable and level
`showZoneName`	Boolean	`true`	Show zone member is currently in

3D Indicators

Field	Type	Default	Description
`indicatorMaxDistance`	Float	`128.0`	Max distance to render 3D indicators
`showIndicatorHealth`	Boolean	`true`	Show health bar above players
`showIndicatorName`	Boolean	`true`	Show player name above indicator
`showIndicatorDistance`	Boolean	`true`	Show distance in 3D indicator
`indicatorScale`	Float	`1.0`	3D indicator size multiplier

Health Style Options

HEARTS - Traditional Minecraft hearts display

❤❤❤❤❤ ❤❤❤❤❤

BAR - Horizontal health bar

[████████░░] 80%

BOTH - Hearts + bar for high health values

❤❤❤❤❤ ❤❤❤❤❤ +20❤
[██████████] 100%

Anchor Position Options

TOP_LEFT - Top-left corner of screen
TOP_RIGHT - Top-right corner of screen (default)
BOTTOM_LEFT - Bottom-left corner of screen
BOTTOM_RIGHT - Bottom-right corner of screen

Configuration via Commands

All settings can be changed in-game with /journeyclient party commands:

# Toggle features
/journeyclient party toggle          # Enable/disable HUD
/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 buffs           # Toggle buff display
/journeyclient party pokemon         # Toggle Pokémon team display
/journeyclient party indicators      # Toggle 3D indicators

# Appearance
/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 opacity <value>         # 0.0-1.0

# 3D Indicators
/journeyclient party indicatorscale <value>    # Indicator size
/journeyclient party indicatordist <blocks>    # Max render distance

# Info
/journeyclient party info            # Show current settings

Global Task HUD Configuration

File: config/journey/global-task-hud.json

Configuration for the global task display HUD.

{
  "enabled": true,
  "xPosition": 10,
  "yPosition": 60,
  "maxTasksShown": 2,
  "showProgress": true,
  "showParticipants": true,
  "showTopContributors": true,
  "maxContributorsShown": 3,
  "showPersonalRank": true,
  "compactMode": false,
  "scale": 0.7,
  "opacity": 0.85
}

Global Task HUD Fields

Field	Type	Default	Description
`enabled`	Boolean	`true`	Enable/disable global task HUD
`xPosition`	Integer	`10`	X position on screen (pixels from left)
`yPosition`	Integer	`60`	Y position on screen (pixels from top)
`maxTasksShown`	Integer	`2`	Maximum active tasks to display simultaneously
`showProgress`	Boolean	`true`	Display progress bars and percentages
`showParticipants`	Boolean	`true`	Show total participant count
`showTopContributors`	Boolean	`true`	Display leaderboard of top contributors
`maxContributorsShown`	Integer	`3`	Max contributors in leaderboard (1-10)
`showPersonalRank`	Boolean	`true`	Show your rank and contribution
`compactMode`	Boolean	`false`	Minimal display mode (hide extras)
`scale`	Float	`0.7`	HUD scale multiplier (0.1-3.0)
`opacity`	Float	`0.85`	Background opacity (0.0-1.0)

Display Modes

Normal Mode (compactMode: false):

╔══════════════════════════════════╗
║ Global Task: Catch 1000 Pokémon  ║
║ Progress: [████░░░░] 453/1000    ║
║ Contributors: 127 players         ║
║                                   ║
║ Top Contributors:                 ║
║ 1. Notch - 82 caught              ║
║ 2. jeb_ - 67 caught               ║
║ 3. Dinnerbone - 54 caught         ║
║                                   ║
║ Your Rank: #12 (23 caught)        ║
╚══════════════════════════════════╝

Compact Mode (compactMode: true):

╔═══════════════════════════╗
║ Catch Pokémon: 453/1000   ║
║ Your contribution: 23     ║
╚═══════════════════════════╝

Configuration via Commands

# Toggle display
/journeyclient globaltask toggle             # Enable/disable HUD
/journeyclient globaltask compact            # Toggle compact mode
/journeyclient globaltask progress           # Toggle progress display
/journeyclient globaltask participants       # Toggle participant count
/journeyclient globaltask contributors       # Toggle leaderboard
/journeyclient globaltask personalrank       # Toggle personal rank

# Positioning
/journeyclient globaltask position <x> <y>   # Set HUD position
/journeyclient globaltask scale <scale>      # Adjust HUD scale (0.1-3.0)
/journeyclient globaltask opacity <value>    # Set opacity (0.0-1.0)

# Leaderboard
/journeyclient globaltask maxcontributors <count>  # Set max shown (1-10)
/journeyclient globaltask maxtasks <count>         # Max tasks displayed

# Info
/journeyclient globaltask info               # Show current settings

Zone Visualization Configuration

File: config/journey/zone-visualization.json

Configure how zone boundaries are rendered in the world.

{
  "enabled": true,
  "opacity": 0.3,
  "fadeStartDistance": 64.0,
  "fadeEndDistance": 128.0,
  "renderDistance": 256.0,
  "lineWidth": 2.0,
  "showZoneNames": true,
  "nameScale": 1.0,
  "useDepthTest": true,
  "animateOpacity": true,
  "animationSpeed": 1.0
}

Zone Visualization Fields

Field	Type	Default	Description
`enabled`	Boolean	`true`	Enable/disable zone rendering
`opacity`	Float	`0.3`	Base zone boundary opacity (0.0-1.0)
`fadeStartDistance`	Float	`64.0`	Distance where fade begins (blocks)
`fadeEndDistance`	Float	`128.0`	Distance where fully faded (blocks)
`renderDistance`	Float	`256.0`	Maximum render distance (blocks)
`lineWidth`	Float	`2.0`	Zone boundary line thickness
`showZoneNames`	Boolean	`true`	Display zone names in world
`nameScale`	Float	`1.0`	Zone name text scale
`useDepthTest`	Boolean	`true`	Hide lines behind blocks
`animateOpacity`	Boolean	`true`	Pulse/fade animation
`animationSpeed`	Float	`1.0`	Animation speed multiplier

Distance Fading

Zones fade based on distance to improve performance and reduce visual clutter:

< fadeStartDistance:  Full opacity
fadeStart → fadeEnd:  Gradual fade (linear interpolation)
> fadeEndDistance:    Fully transparent (not rendered)
> renderDistance:     Culled completely (no processing)

Example:

{
  "fadeStartDistance": 64.0,
  "fadeEndDistance": 128.0
}

At 50 blocks: Full opacity (0.3 base)
At 96 blocks: Half opacity (0.15)
At 130 blocks: Not rendered

Configuration via Commands

# Toggle features
/journeyclient zone toggle                   # Enable/disable rendering
/journeyclient zone names                    # Toggle zone name display
/journeyclient zone animation                # Toggle opacity animation
/journeyclient zone depthtest                # Toggle depth testing

# Appearance
/journeyclient zone opacity <0.0-1.0>        # Base opacity
/journeyclient zone linewidth <pixels>       # Boundary line width
/journeyclient zone namescale <scale>        # Name text size

# Distance settings
/journeyclient zone fadestart <blocks>       # Fade start distance
/journeyclient zone fadeend <blocks>         # Fade end distance
/journeyclient zone renderdist <blocks>      # Max render distance

# Animation
/journeyclient zone animspeed <speed>        # Animation speed multiplier

# Info
/journeyclient zone info                     # Show current settings

Path Visualization Configuration

File: config/journey/path-visualization.json

Configure how quest paths are rendered in the world.

{
  "enabled": true,
  "lineColor": "#FFAA00",
  "lineWidth": 3.0,
  "opacity": 0.6,
  "renderDistance": 128.0,
  "showWaypoints": true,
  "waypointSize": 0.5,
  "animatePath": true,
  "animationSpeed": 2.0,
  "particleEffect": "minecraft:end_rod"
}

Path Visualization Fields

Field	Type	Default	Description
`enabled`	Boolean	`true`	Enable/disable path rendering
`lineColor`	String	`"#FFAA00"`	Path line color (hex)
`lineWidth`	Float	`3.0`	Path line thickness
`opacity`	Float	`0.6`	Path opacity (0.0-1.0)
`renderDistance`	Float	`128.0`	Max render distance (blocks)
`showWaypoints`	Boolean	`true`	Show waypoint markers
`waypointSize`	Float	`0.5`	Waypoint marker size
`animatePath`	Boolean	`true`	Animated flowing effect
`animationSpeed`	Float	`2.0`	Animation speed multiplier
`particleEffect`	ResourceLocation	`"minecraft:end_rod"`	Particle for waypoints

Configuration via Commands

# Toggle features
/journeyclient path toggle                   # Enable/disable rendering
/journeyclient path waypoints                # Toggle waypoint markers
/journeyclient path animation                # Toggle path animation

# Appearance
/journeyclient path color <hex>              # Set line color (#RRGGBB)
/journeyclient path width <pixels>           # Line thickness
/journeyclient path opacity <0.0-1.0>        # Path opacity
/journeyclient path waypointsize <size>      # Waypoint marker size

# Distance and animation
/journeyclient path renderdist <blocks>      # Max render distance
/journeyclient path animspeed <speed>        # Animation speed

# Particles
/journeyclient path particle <id>            # Waypoint particle effect

# Info
/journeyclient path info                     # Show current settings

Objective Markers Configuration

File: config/journey/objective-markers.json

Configure quest objective markers and indicators.

{
  "enabled": true,
  "showDistance": true,
  "showName": true,
  "maxDistance": 256.0,
  "scale": 1.0,
  "opacity": 0.9,
  "beaconHeight": 128.0,
  "beaconColor": "#00FFFF",
  "fadeNearPlayer": true,
  "fadeDistance": 5.0
}

Objective Marker Fields

Field	Type	Default	Description
`enabled`	Boolean	`true`	Enable/disable objective markers
`showDistance`	Boolean	`true`	Display distance to objective
`showName`	Boolean	`true`	Display objective name
`maxDistance`	Float	`256.0`	Max render distance (blocks)
`scale`	Float	`1.0`	Marker size multiplier
`opacity`	Float	`0.9`	Marker opacity (0.0-1.0)
`beaconHeight`	Float	`128.0`	Height of beacon beam
`beaconColor`	String	`"#00FFFF"`	Beacon color (hex)
`fadeNearPlayer`	Boolean	`true`	Fade when close to marker
`fadeDistance`	Float	`5.0`	Distance to start fading (blocks)

Configuration via Commands

# Toggle features
/journeyclient objective toggle              # Enable/disable markers
/journeyclient objective distance            # Toggle distance display
/journeyclient objective name                # Toggle name display
/journeyclient objective fade                # Toggle near-player fade

# Appearance
/journeyclient objective scale <size>        # Marker size
/journeyclient objective opacity <0.0-1.0>   # Marker opacity
/journeyclient objective beaconcolor <hex>   # Beacon color (#RRGGBB)
/journeyclient objective beaconheight <y>    # Beacon beam height

# Distance settings
/journeyclient objective renderdist <blocks> # Max render distance
/journeyclient objective fadedist <blocks>   # Near-player fade distance

# Info
/journeyclient objective info                # Show current settings

Best Practices

Performance Optimization

✅ Lower render distances for better FPS on weak hardware:

{
  "renderDistance": 128.0,  // Instead of 256.0
  "fadeEndDistance": 64.0   // Instead of 128.0
}

✅ Disable unused features to reduce overhead:

{
  "show3DIndicators": false,  // If you don't need party indicators
  "animatePath": false        // If animation causes lag
}

✅ Use compact modes for cleaner UI:

{
  "compactMode": true,        // Minimal global task display
  "showTopContributors": false
}

Visual Clarity

✅ Adjust opacity for better visibility:

{
  "hudOpacity": 0.9,    // More visible in bright areas
  "opacity": 0.3        // Subtle zone boundaries
}

✅ Scale elements for readability:

{
  "hudScale": 1.0,      // Larger for high-res displays
  "scale": 0.6          // Smaller for 1080p
}

✅ Position HUDs to avoid overlap:

{
  "anchorPosition": "TOP_RIGHT",
  "offsetX": 10,
  "offsetY": 10
}

Journey Client Overview - Feature overview and installation
Party System - Party mechanics and commands
Global Tasks - Global task system
Zones - Zone configuration
Markers - Quest markers and areas

Client Configuration Reference

Client Configuration Reference

Configuration Files

Party Client Configuration

Party HUD Fields

Core Settings

HUD Position

Health Display

Party Member Info

3D Indicators

Health Style Options

Anchor Position Options

Configuration via Commands

Global Task HUD Configuration

Global Task HUD Fields

Display Modes

Configuration via Commands

Zone Visualization Configuration

Zone Visualization Fields

Distance Fading

Configuration via Commands

Path Visualization Configuration

Path Visualization Fields

Configuration via Commands

Objective Markers Configuration

Objective Marker Fields

Configuration via Commands

Best Practices

Performance Optimization

Visual Clarity

Related Documentation