PlaceholderAPI 占位符
EmakiStorage 在安装 PlaceholderAPI 时注册扩展,标识符为 emakistorage。占位符适用于计分板、菜单、聊天格式、BossBar、ActionBar 以及支持 PlaceholderAPI 的其他插件文本模板。
如果 PlaceholderAPI 未安装,EmakiStorage 本体仍然可以正常运行,只是不会注册 %emakistorage_*% 外部占位符。
占位符列表
| 占位符 | 说明 |
|---|---|
%emakistorage_used_slots% | 已占用槽位数。 |
%emakistorage_total_slots% | 有效槽位总数。 |
%emakistorage_free_slots% | 剩余空槽数。 |
%emakistorage_purchased_slots% | 已购买槽位数。 |
%emakistorage_granted_slots% | 授予槽位数。 |
%emakistorage_pages% | 总页数。 |
%emakistorage_stack_limit% | 当前生效的玩家级单槽上限。 |
%emakistorage_sort_mode% | 当前排序模式 id。 |
%emakistorage_total_amount% | 所有条目数量之和,溢出时饱和为 Long.MAX_VALUE。 |
%emakistorage_count_<token>% | 指定 ItemSource token 的存量,无此条目时为 0。 |
求值线程与未载入数据
所有占位符都读取在线玩家的内存数据,不做磁盘载入:占位符会在 PAPI 调用它的任意线程上求值,阻塞 IO 不可接受。玩家数据未载入时返回 0,无法识别的占位符返回空字符串。