Placeholders

Placeholders

UniverseJobs provides PlaceholderAPI integration for use in scoreboards, holograms, chat formats, and more.

Requirements

• PlaceholderAPI installed

General Placeholders

Placeholder	Description	Example
%universejobs_totaljobs%	Total number of available jobs	7
%universejobs_equippedjobs%	Number of jobs player has	2
%universejobs_currentjobs%	Names of current jobs	Miner, Farmer
%universejobs_multiplier_<job>%	Usage multiplier for job	1.0

Equipped Jobs Placeholders

Access jobs by index (1-based):

Placeholder	Description
%universejobs_equipped_<index>%	Job name at index
%universejobs_equipped_<index>_level%	Level of job at index
%universejobs_equipped_<index>_xp%	XP of job at index
%universejobs_equipped_<index>_id%	Job ID at index

Examples:

%universejobs_equipped_1%           → Miner
%universejobs_equipped_1_level%     → 25
%universejobs_equipped_2_xp%        → 1500

Job-Specific Placeholders

Replace <job> with the job ID (e.g., miner, farmer).

Player Job Data

Placeholder	Description	Example
%universejobs_<job>_player_level%	Current level	25
%universejobs_<job>_player_xp%	Current XP	1500.0
%universejobs_<job>_player_rank%	Player's rank in job	3
%universejobs_<job>_player_progress%	XP progress (current/required)	500.0/1000.0
%universejobs_<job>_player_progresspercent%	Progress percentage	50.0%
%universejobs_<job>_player_hasjob%	Is player in this job	true

Job Info

Placeholder	Description	Example
%universejobs_<job>_job_name%	Job display name	Miner
%universejobs_<job>_job_description%	Job description	Mine ores...
%universejobs_<job>_job_maxlevel%	Maximum level	100
%universejobs_<job>_job_enabled%	Is job enabled	true
%universejobs_<job>_job_playercount%	Players with this job	42

Examples

%universejobs_miner_player_level%       → 25
%universejobs_miner_player_xp%          → 1500.0
%universejobs_miner_player_rank%        → 3
%universejobs_miner_player_hasjob%      → true
%universejobs_miner_job_name%           → Miner
%universejobs_miner_job_maxlevel%       → 100

Job Leaderboard Placeholders

Format: %universejobs_<job>_leaderboard_<position>_<info>%

Info	Description
player or name	Player name at position
level	Level at position
xp	XP at position
rank or position	Position number
formatted	Full formatted entry

Examples:

%universejobs_miner_leaderboard_1_player%    → Steve
%universejobs_miner_leaderboard_1_level%     → 100
%universejobs_miner_leaderboard_1_xp%        → 50000.0
%universejobs_miner_leaderboard_2_name%      → Alex
%universejobs_miner_leaderboard_3_formatted% → #3 Bob - Level 85 (42000.0 XP)

Global Leaderboard Placeholders

Placeholder	Description
%universejobs_global_rank%	Player's global rank
%universejobs_global_<pos>_player%	Player name at position
%universejobs_global_<pos>_level%	Total level at position

Boost Placeholders

Boost Counts

Placeholder	Description
%universejobs_boost_count_xp%	Active XP boost count
%universejobs_boost_count_money%	Active money boost count
%universejobs_boost_count_total%	Total active boosts

Player Boosts

Placeholder	Description
%universejobs_boost_player_hasxp%	Player has XP boost
%universejobs_boost_player_hasmoney%	Player has money boost
%universejobs_boost_player_hasany%	Player has any boost
%universejobs_boost_player_xpcount%	Player's XP boost count
%universejobs_boost_player_moneycount%	Player's money boost count
%universejobs_boost_player_totalcount%	Player's total boost count

Global Boosts

Placeholder	Description
%universejobs_boost_global_hasxp%	Global XP boost active
%universejobs_boost_global_hasmoney%	Global money boost active
%universejobs_boost_global_hasany%	Any global boost active
%universejobs_boost_global_xpcount%	Global XP boost count
%universejobs_boost_global_moneycount%	Global money boost count

Current Multipliers

Placeholder	Description
%universejobs_boost_current_exp%	Player's total XP multiplier
%universejobs_boost_current_exp_<job>%	XP multiplier for job
%universejobs_boost_current_money%	Player's total money multiplier
%universejobs_boost_current_money_<job>%	Money multiplier for job

Boost List Details

Format: %universejobs_boost_list_<type>_<position>_<info>%

Where type is xp or money, and info is:

Info	Description
id	Boost ID
multiplier	Multiplier value
remainingtime	Time remaining
playername	Target player name
job	Target job
action	Target action
isglobal	Is global boost
isactive	Is active

Usage Examples

Scoreboard (Featherboard)

lines:
  - "&6Jobs"
  - "&7Miner: &f%universejobs_miner_player_level%"
  - "&7  %universejobs_miner_player_progress%"
  - "&7Farmer: &f%universejobs_farmer_player_level%"
  - ""
  - "&6Boost: &a%universejobs_boost_current_exp%x XP"

Hologram (DecentHolograms)

lines:
  - "&6&lMiner Leaderboard"
  - "&e1. &f%universejobs_miner_leaderboard_1_player% &7- Lvl &f%universejobs_miner_leaderboard_1_level%"
  - "&e2. &f%universejobs_miner_leaderboard_2_player% &7- Lvl &f%universejobs_miner_leaderboard_2_level%"
  - "&e3. &f%universejobs_miner_leaderboard_3_player% &7- Lvl &f%universejobs_miner_leaderboard_3_level%"

Testing Placeholders

Use PlaceholderAPI's parse command:

/papi parse me %universejobs_miner_player_level%
/papi parse me %universejobs_boost_current_exp%
/papi parse me %universejobs_miner_leaderboard_1_player%

Refresh Rate

Placeholders are cached for performance:

• Player stats: Real-time
• Leaderboards: Updated every 30 seconds
• Boosts: Real-time