Skip to content

PlaceholderAPI Reference

NexusPrism registers its own PlaceholderAPI expansion under the nexusprism identifier. All placeholders follow the pattern %nexusprism_<name>%.

Requires: PlaceholderAPI (soft dependency — install separately)


Economy

Placeholder Description Example
%nexusprism_money% Player's current money balance 12500.00
%nexusprism_credits% Player's credit balance 350

Essentials

Placeholder Description Example
%nexusprism_playtime% Total playtime (formatted) 3d 12h 45m
%nexusprism_playtime_minutes% Total playtime in minutes 5085
%nexusprism_homes% Number of homes set 3
%nexusprism_afk% true if player is AFK false
%nexusprism_afk_status% Human-readable AFK status AFK / Online

Clans

Placeholder Description Example
%nexusprism_clan_name% Player's clan name Shadowborn
%nexusprism_clan_tag% Clan tag SHD
%nexusprism_clan_role% Player's role in clan Owner / Officer / Member
%nexusprism_clan_level% Clan's current level 5
%nexusprism_clan_members% Online member count 8
%nexusprism_clan_bank% Clan bank balance 75000.00

Returns empty string if the player is not in a clan.


Crystal Defense

Placeholder Description Example
%nexusprism_crystal_wave% Current wave number 7
%nexusprism_crystal_health% Crystal HP remaining 680.0
%nexusprism_crystal_points% Player's kill points in current game 145
%nexusprism_crystal_arena% Arena name the player is in arena1

Returns empty string if the player is not in a Crystal Defense game.


Security

Placeholder Description Example
%nexusprism_authenticated% true if the player is logged in true
%nexusprism_auth_status% Human-readable auth status Authenticated / Pending

Votifier

Placeholder Description Example
%nexusprism_votes_total% Total lifetime votes 127
%nexusprism_vote_streak% Current vote streak length 12

Player Stats

Placeholder Description Example
%nexusprism_player_blocks_broken% Total blocks broken 48320
%nexusprism_player_machines_placed% Total machines placed 214
%nexusprism_player_items_crafted% Total items crafted 5630
%nexusprism_player_energy_generated% Total energy generated (RF) 1200000
%nexusprism_player_items_smelted% Total items smelted 890
%nexusprism_player_research_unlocked% Research entries unlocked 34
%nexusprism_player_level% Player NexusPrism level 15
%nexusprism_researched_<id>% true if a specific research is unlocked true

Backpacks

Placeholder Description Example
%nexusprism_backpacks_owned% Number of backpacks the player owns 2

Machines

Placeholder Description Example
%nexusprism_machines_count% Total machines placed by player 42

LuckPerms

Placeholder Description Example
%nexusprism_lp_prefix% Player's LuckPerms prefix &6[VIP]
%nexusprism_lp_suffix% Player's LuckPerms suffix &7✦

These require LuckPerms to be installed.


Guide

Placeholder Description
%nexusprism_guide_<id>% Dynamic guide entry for item/machine ID

These are dynamic — replace <id> with any registered item or machine ID.


Core / Misc

Placeholder Description Example
%nexusprism_version% Plugin version string 2.0.0-BETA
%nexusprism_player% Player username Steve
%nexusprism_uuid% Player UUID 069a79f4-...

Usage in Scoreboards / TAB

# Example with TAB plugin
header: "&bNexusPrism &7%nexusprism_version%"
tablist-name: "%nexusprism_lp_prefix%%player_name%"
scoreboard:
  title: "&b&lYour Stats"
  lines:
    - "&7Money: &a$%nexusprism_money%"
    - "&7Credits: &b%nexusprism_credits%"
    - "&7Votes: &e%nexusprism_votes_total% &7(streak: %nexusprism_vote_streak%)"
    - "&7Clan: &f%nexusprism_clan_name%"
    - "&7Playtime: &f%nexusprism_playtime%"