兼容性
PlaceholderAPI
在受支持的 ItemsAdderAdditions 文本字段中可选解析 PlaceholderAPI。
PlaceholderAPI 支持是可选的。安装 PlaceholderAPI 后,ItemsAdderAdditions 会在受支持的文本字段中解析 placeholders。未安装时,原始文本会保持不变。
支持的功能
功能页面中记录的文本渲染路径会使用 PlaceholderAPI,包括:
- message、actionbar、title、toast 和 open inventory 动作
- 进度完成文本动作
- storage 物品栏标题
- text display behaviour 文本
示例
message:
text: "Hello %player_name%!"behaviours:
text_display:
text: "Coins: %vault_eco_balance%"
refresh_interval: 20对于 text displays,如果 placeholders 需要随时间更新,请将 refresh_interval 设置为正数。
可选依赖行为
如果缺少 PlaceholderAPI,placeholders 不会被解析,会原样保留在渲染文本中。
限制
- ItemsAdderAdditions 本身不提供 PlaceholderAPI expansions。
- Placeholder 支持只适用于使用共享文本渲染器或明确说明支持 PlaceholderAPI 的字段。
故障排查
- 安装提供你所用 placeholder 的 PlaceholderAPI expansion。
- 对会变化的 text display placeholders 使用正数刷新间隔。
- 如果文本按
%placeholder%原样显示,请确认 PlaceholderAPI 已安装并启用。