Skip to content
AxDevv edited this page Dec 9, 2025 · 2 revisions

Boosts & Multipliers

UniverseJobs provides a comprehensive boost system to multiply XP and money earnings.

Boost Types

Type Description
XP Boost Multiplies XP earnings
Money Boost Multiplies money earnings

Giving Boosts

Via Commands

# Command structure
/jobs admin boost give <type> <player> <job> <action_type> <multiplier> <duration>

# Parameters:
# - type: xp or money
# - player: player name or * for all
# - job: job ID or * for all jobs
# - action_type: BREAK, KILL, etc. or * for all
# - multiplier: multiplier value (e.g., 2.0)
# - duration: duration in seconds

# Examples
/jobs admin boost give xp Steve * * 2.0 3600           # 2x XP for 1 hour
/jobs admin boost give money * miner * 1.5 7200       # 1.5x money for all players in miner
/jobs admin boost give xp Steve miner BREAK 3.0 1800  # 3x XP for BREAK actions only

Via Permissions

universejobs.multiplier.exp.<amount>
universejobs.multiplier.money.<amount>

Examples:

  • universejobs.multiplier.exp.1.5 - 1.5x XP permanently
  • universejobs.multiplier.money.2 - 2x money permanently

Calculation Modes

Configure in config.yml:

jobs:
  boost-calculation-mode: MULTIPLICATIVE
Mode Calculation Example (1.5x + 1.5x)
ADDITIVE Sum all bonuses 2.0x
MULTIPLICATIVE Multiply all 2.25x
HIGHEST Take highest 1.5x

Managing Boosts

# View active boosts (opens GUI for players)
/jobs admin boost info

# Remove a specific boost by ID
/jobs admin boost remove <boost_id>

Boost Targeting

Boosts can be targeted to specific:

Target Wildcard Example
Player * All online players
Job * All jobs
Action Type * All action types

Action Type Targeting

Target specific action types for precision boosts:

# 2x XP only for BREAK actions
/jobs admin boost give xp Steve miner BREAK 2.0 3600

# 3x money only for KILL actions
/jobs admin boost give money Steve hunter KILL 3.0 1800

Placeholders

Placeholder Description
%universejobs_boost_player_hasany% Has any active boost
%universejobs_boost_current_exp% Current XP multiplier
%universejobs_boost_current_money% Current money multiplier
%universejobs_boost_count_total% Total active boosts

See Placeholders for the complete list.

Boost Duration Limits

  • Maximum duration: 86400 seconds (24 hours)
  • Multiplier range: 0.1 to 10.0

Examples

# Server-wide 2x XP event for 2 days
/jobs admin boost give xp * * * 2.0 172800

# VIP player 1.5x money boost for 1 hour
/jobs admin boost give money VIPPlayer * * 1.5 3600

# Specific job boost
/jobs admin boost give xp Steve miner * 2.0 3600

# Remove a boost
/jobs admin boost remove abc123-def456

UniverseJobs Wiki

Getting Started

Core Features

Player Features

Reference

Advanced


GitHub

Clone this wiki locally