Placeholder API
754 字约 3 分钟
2025-02-24
介绍
Placeholder API 是一款 Minecraft 服务端插件,用于为其他插件提供占位符支持。
通过 Placeholder API 你可以在其他任意支持 Placeholder API 的插件中使用 Dominion 提供的占位符从而获得 Dominion 对应的信息, 或者也可以在 Dominion 中支持的地方使用其他插件提供的一些信息。
Dominion 目前支持使用占位符的地方
- 领地进入提示消息;
- 领地离开提示消息;
- CUI 标题、按钮(名称、lore);
Dominion 目前提供的占位符列表
📌 基础信息类
%dominion_group_title%获取玩家当前使用的组称号。 返回:组名称(含颜色),未使用称号则为空。%dominion_current_dominion%获取玩家当前所在的领地名称。 返回:领地名,不在领地中则为空。
📍 传送点坐标类
用于获取指定领地的传送点信息:
%dominion_tp_loc_x_<领地名>%获取传送点 X 坐标。%dominion_tp_loc_y_<领地名>%获取传送点 Y 坐标。%dominion_tp_loc_z_<领地名>%获取传送点 Z 坐标。%dominion_tp_loc_Y_<领地名>%获取传送点 Yaw(水平朝向)。%dominion_tp_loc_P_<领地名>%获取传送点 Pitch(垂直朝向)。
👥 成员相关
%dominion_is_member%判断玩家是否为当前所在领地的成员。 返回:true/false,不在领地中则为空。%dominion_is_member_<领地名>%判断玩家是否为指定领地的成员。 返回:true/false,领地不存在则为空。%dominion_members%获取当前所在领地的成员列表。 返回:成员名逗号分隔字符串。%dominion_members_<领地名>%获取指定领地的成员列表。 返回:成员名逗号分隔字符串。%dominion_member_count%获取当前所在领地的成员数量。 返回:整数。%dominion_member_count_<领地名>%获取指定领地的成员数量。 返回:整数。
🏷️ 权限组相关
%dominion_group%获取玩家在当前领地中的所属组名称。 返回:组名称(含颜色),未分组则为空。%dominion_group_<领地名>%获取玩家在指定领地中的所属组名称。 返回:组名称(含颜色),未分组或领地不存在则为空。%dominion_groups%获取当前领地的所有组名称。 返回:组名(含颜色)逗号分隔字符串。%dominion_groups_<领地名>%获取指定领地的所有组名称。 返回:组名(含颜色)逗号分隔字符串。%dominion_group_count%获取当前领地的组数量。 返回:整数。
🔐 权限标志(Privilege Flag)
%dominion_pri_flag_<flag>%判断玩家在当前领地是否拥有指定权限标志。 返回:true/false,标志不存在则为空。
示例:
%dominion_pri_flag_build%
%dominion_pri_flag_open_chest%🌍 环境标志(Environment Flag)
%dominion_env_flag_<flag>%判断当前领地是否启用了指定环境规则。 返回:true/false,标志不存在则为空。
示例:
%dominion_env_flag_pvp%
%dominion_env_flag_fire_spread%ℹ️ 返回值说明
- 若领地不存在、玩家不在领地、未分组或标志不存在,通常返回空字符串。
- 布尔类占位符统一返回
"true"或"false"。 - 列表类占位符返回以英文逗号分隔的字符串。
