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

---

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.

---

MMO

Module required (nexusprism-mmo).

Placeholder	Returns	Notes
%nexusprism_mmo_level%	MMO character level	integer
%nexusprism_mmo_mana%	Current mana	integer
%nexusprism_mmo_mana_max%	Maximum mana	integer
%nexusprism_mmo_stat_points%	Unspent stat points	integer
%nexusprism_mmo_stat_strength%	STRENGTH value	integer
%nexusprism_mmo_stat_dexterity%	DEXTERITY value	integer
%nexusprism_mmo_stat_intelligence%	INTELLIGENCE value	integer
%nexusprism_mmo_stat_vitality%	VITALITY value	integer
%nexusprism_mmo_stat_endurance%	ENDURANCE value	integer
%nexusprism_mmo_stat_luck%	LUCK value	integer
%nexusprism_mmo_skill_<treeid>%	Skill tree level	e.g. mmo_skill_warrior
%nexusprism_mmo_profession_<profid>%	Profession level	e.g. mmo_profession_mining

---

Events

bloodmoon_* resolve even without the Events module (returning false / 1.00).

Placeholder	Returns	Notes
%nexusprism_bloodmoon_active%	true / false	server-wide
%nexusprism_bloodmoon_multiplier%	Kill-pay multiplier	1.00 when inactive
%nexusprism_sacrifice_streak%	Survival streak	Module required
%nexusprism_in_sacrifice%	true / false	Module required
%nexusprism_isekai_active%	true / false	Module required

---

Traits & RNG

Module required (nexusprism-traits).

Placeholder	Returns	Notes
%nexusprism_traits_research%	Research/gacha level	integer
%nexusprism_traits_count%	Number of assigned trait cards	integer
%nexusprism_traits_cards%	Comma-separated card names	none if empty

---

Jobs

Module required (nexusprism-economy).

Placeholder	Returns	Notes
%nexusprism_job%	Active job ID	none if no job
%nexusprism_job_level%	Level in active job	0 if no job
%nexusprism_job_xp%	XP in active job	0 if no job

---

Discord

Module required (nexusprism-discord).

Placeholder	Returns	Notes
%nexusprism_discord_linked%	true / false	—
%nexusprism_discord_id%	Discord snowflake ID	empty string if not linked

---

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%"
    - "&7Votes: &e%nexusprism_votes_total% &7(streak: %nexusprism_vote_streak%)"
    - "&7Clan: &f%nexusprism_clan_name%"
    - "&7Playtime: &f%nexusprism_playtime%"