Skip to content

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,无法识别的占位符返回空字符串。

相关页面

  • 容量与缩容total_slotspurchased_slots 等数值背后的四来源容量模型。
  • 事件 API:需要拦截而不只是读取时使用的 Bukkit 事件。
  • API 与集成:在代码中读取容量与存量的方式。