變數Placeholders

安裝 PlaceholderAPI 後自動註冊，不需要另外下載 expansion。

識別碼

前綴	說明
`%vault_*%`	主要識別碼
`%vault3_*%`	與主要識別碼完全相同
`%vault2_*%`	舊版相容別名，回傳值同上

三組回傳完全相同的值。保留 vault2 是因為 PlaceholderAPI 在找不到識別碼時不會報錯，只會讓變數原樣顯示 —— 移除會造成難以追查的靜默失效。

目前玩家

%vault_balance%                原始數值
%vault_balance_formatted%      套用貨幣格式
%vault_eco_balance%            同 balance
%vault_eco_balance_formatted%  同 balance_formatted
%vault_eco_balance_fixed%      固定兩位小數
%vault_eco_balance_commas%     千分位，如 1,000
%vault_eco_balance_short%      縮寫，如 1.2k
%vault_ecobalance<0-8>dp%      自訂小數位數，例如 %vault_ecobalance3dp%
%vault_currency_symbol%        貨幣符號

指定玩家

%vault_balance_<player>%
%vault_balance_formatted_<player>%

查詢離線玩家的名稱需要解析 UUID。Vault3 有多層快取讓這件事很便宜，細節見效能設計。

富豪榜

%vault_top%                前 10 名，多行輸出
%vault_top_<n>%            第 n 名的完整資訊
%vault_top_name_<n>%       第 n 名的名稱
%vault_top_amount_<n>%     第 n 名格式化後的餘額

Registered automatically when PlaceholderAPI is installed. There is no separate expansion to download.

Identifiers

Prefix	Notes
`%vault_*%`	Primary identifier
`%vault3_*%`	Identical to the primary identifier
`%vault2_*%`	Legacy alias, same values

All three return exactly the same values. vault2 is kept because PlaceholderAPI does not error on an unknown identifier — it simply leaves the placeholder unresolved, which is hard to diagnose.

Current player

%vault_balance%                raw number
%vault_balance_formatted%      currency formatted
%vault_eco_balance%            same as balance
%vault_eco_balance_formatted%  same as balance_formatted
%vault_eco_balance_fixed%      fixed two decimals
%vault_eco_balance_commas%     thousands separators, e.g. 1,000
%vault_eco_balance_short%      abbreviated, e.g. 1.2k
%vault_ecobalance<0-8>dp%      custom decimals, e.g. %vault_ecobalance3dp%
%vault_currency_symbol%        currency symbol

Specific player

%vault_balance_<player>%
%vault_balance_formatted_<player>%

Looking up an offline player by name requires resolving a UUID. Vault3 caches this aggressively so it stays cheap — see Performance.

Leaderboard

%vault_top%                top 10, multi-line
%vault_top_<n>%            full entry for rank n
%vault_top_name_<n>%       name at rank n
%vault_top_amount_<n>%     formatted balance at rank n