占位符参考

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

动作上下文变量

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

内置变量

变量	说明	示例
%player%	玩家名。	Steve
%player_name%	玩家名（与 %player% 相同）。	Steve
%player_uuid%	玩家 UUID。	550e8400-e29b-...
%player_world%	玩家所在世界名。	world
%player_x%	玩家 X 坐标（浮点数）。	128.5
%player_y%	玩家 Y 坐标（浮点数）。	64.0
%player_z%	玩家 Z 坐标（浮点数）。	256.0
%phase%	当前动作阶段。	success

以上玩家变量只在动作上下文中存在玩家时注入。变量名匹配不区分大小写；如果调用方已经显式注入了同名变量，则以调用方的值为准。

使用示例

actions:
  - 'sendmessage text="<green>恭喜 %player_name%，操作成功！</green>"'
  - 'runcommandasconsole command="say %player_name% 在 %player_world% 完成了操作"'

内联 Token

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

actions:
  - 'sendmessage text="你获得了 <show_item>！"'

说明

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