占位符参考

CoreLib 本身不注册 PlaceholderAPI 扩展，但它提供了动作上下文变量系统，供所有模块在 Action 执行时使用。

动作上下文变量

当 Action 被触发时，CoreLib 会自动向上下文注入以下内置变量。所有模块的 Action 配置中均可使用 %variable% 格式引用。

内置变量

变量	说明	示例
%player_name%	玩家显示名。	Steve
%player_uuid%	玩家 UUID。	550e8400-e29b-...
%player_world%	玩家所在世界名。	world
%player_x%	玩家 X 坐标。	128
%player_y%	玩家 Y 坐标。	64
%player_z%	玩家 Z 坐标。	256
%phase%	当前动作阶段。	success

使用示例

actions:
  - type: message
    value: '<green>恭喜 %player_name%，操作成功！'
  - type: command
    value: 'say %player_name% 在 %player_world% 完成了操作'

内联 Token

CoreLib 还支持 <show_item> 内联 Token，当 Action 上下文中设置了 show_item 时，可在聊天消息中展示物品悬浮提示。

actions:
  - type: message
    value: '你获得了 <show_item>！'

说明

• 各子模块（Forge、Gem、Skills 等）会在自己的 Action 上下文中注入额外变量，详见各模块的占位符文档。
• 动作上下文变量与 PlaceholderAPI 占位符是独立的两套系统，格式相同但解析时机不同。
• PlaceholderAPI 占位符在 Action 中同样可用（需安装 PlaceholderAPI）。