介绍

Placeholder API 是一款 Minecraft 服务端插件，用于为其他插件提供占位符支持。

通过 Placeholder API 你可以在其他任意支持 Placeholder API 的插件中使用 Dominion 提供的占位符从而获得 Dominion 对应的信息， 或者也可以在 Dominion 中支持的地方使用其他插件提供的一些信息。

Dominion 目前支持使用占位符的地方

• 领地进入提示消息；
• 领地离开提示消息；
• CUI 标题、按钮（名称、lore）；

Dominion 目前提供的占位符

玩家相关

%dominion_group_title%

• 功能: 获取玩家当前使用的称号组名称
• 返回值: 称号组的彩色名称，如果玩家没有使用称号组则返回空
• 使用示例:

  # 在其他插件配置中使用
  message: "欢迎 %dominion_group_title% %player_name%！"

%dominion_current_dominion%

• 功能: 获取玩家当前所在领地的名称
• 返回值: 领地名称，如果玩家不在任何领地内则返回空
• 使用示例:

  # 显示当前所在领地
  format: "你现在在 %dominion_current_dominion% 领地内"

领地信息

%dominion_tp_loc_[x, y, z]_<领地名称>%

• 功能: 获取指定领地传送点的x、y、z坐标
• 返回值: 对应坐标的数值，如果领地不存在则返回空
• 使用示例:

  # 显示领地传送点坐标
  message:
   - "领地 AAA 的传送点坐标："
   - "X: %dominion_tp_loc_x_AAA%"
   - "Y: %dominion_tp_loc_y_AAA%"
   - "Z: %dominion_tp_loc_z_AAA%"

成员相关

%dominion_is_member%

• 功能: 检查玩家是否为当前所在领地的成员
• 返回值: "true" 或 "false"，如果不在领地内则返回空
• 使用示例:

  # 根据成员身份显示不同消息
  message: "%dominion_is_member% == 'true' ? '你是这里的成员' : '你不是这里的成员'"

%dominion_is_member_<领地名称>%

• 功能: 检查玩家是否为指定领地的成员
• 返回值: "true" 或 "false"，如果领地不存在则返回空
• 使用示例:

  # 检查特定领地的成员身份
  condition: "%dominion_is_member_MyDominion% == 'true'"

%dominion_members%

• 功能: 获取玩家当前所在领地的所有成员名单
• 返回值: 以逗号分隔的成员名称列表，如果不在领地内则返回空
• 使用示例:

  # 显示当前领地成员
  message: "当前领地成员: %dominion_members%"

%dominion_members_<领地名称>%

• 功能: 获取指定领地的所有成员名单
• 返回值: 以逗号分隔的成员名称列表，如果领地不存在则返回空
• 使用示例:

  # 显示指定领地成员
  message: "领地 MyDominion 的成员: %dominion_members_MyDominion%"

%dominion_member_count%

• 功能: 获取玩家当前所在领地的成员数量
• 返回值: 成员数量数值，如果不在领地内则返回空
• 使用示例:

  # 显示成员数量
  message: "当前领地有 %dominion_member_count% 名成员"

%dominion_member_count_<领地名称>%

• 功能: 获取指定领地的成员数量
• 返回值: 成员数量数值，如果领地不存在则返回空
• 使用示例:

  # 显示指定领地成员数量
  message: "领地 MyDominion 共有 %dominion_member_count_MyDominion% 名成员"

权限组相关

%dominion_group%

• 功能: 获取玩家在当前所在领地中的组名称
• 返回值: 组的彩色名称，如果不在领地内或不在任何组中则返回空
• 使用示例:

  # 显示玩家在当前领地的组
  message: "你在当前领地的组: %dominion_group%"

%dominion_group_<领地名称>%

• 功能: 获取玩家在指定领地中的组名称
• 返回值: 组的彩色名称，如果领地不存在或不在任何组中则返回空
• 使用示例:

  # 显示玩家在指定领地的组
  message: "你在 MyDominion 领地的组: %dominion_group_MyDominion%"

%dominion_groups%

• 功能: 获取玩家当前所在领地的所有组列表
• 返回值: 以逗号分隔的组名称列表（带颜色），如果不在领地内则返回空
• 使用示例:

  # 显示当前领地的所有组
  message: "当前领地的组: %dominion_groups%"

%dominion_groups_<领地名称>%

• 功能: 获取指定领地的所有组列表
• 返回值: 以逗号分隔的组名称列表（带颜色），如果领地不存在则返回空
• 使用示例:

  # 显示指定领地的所有组
  message: "领地 MyDominion 的组: %dominion_groups_MyDominion%"

%dominion_group_count%

• 功能: 获取玩家当前所在领地的组数量
• 返回值: 组数量数值，如果不在领地内则返回空
• 使用示例:

  # 显示当前领地组数量
  message: "当前领地有 %dominion_group_count% 个组"

权限相关

%dominion_pri_flag_<权限名称>%

• 功能: 获取玩家在当前所在领地中指定特权权限的值
• 返回值: "true" 或 "false"，如果权限不存在则返回空
• 使用示例:

  # 检查玩家是否有破坏权限
  condition: "%dominion_pri_flag_destroy% == 'true'"
  # 检查玩家是否有建造权限
  message: "%dominion_pri_flag_place% == 'true' ? '你可以建造' : '你不能建造'"

%dominion_env_flag_<权限名称>%

• 功能: 获取玩家当前所在领地中指定环境权限的值
• 返回值: "true" 或 "false"，如果权限不存在则返回空
• 使用示例:

  # 检查是否允许爆炸
  condition: "%dominion_env_flag_explode% == 'true'"
  # 检查是否允许刷怪
  message: "当前领地天气控制: %dominion_env_flag_monster_spawn%"

综合使用示例

领地信息显示板

# 使用多个占位符创建领地信息显示
title: "&6当前领地信息"
content:
  - "&7领地名称: &a%dominion_current_dominion%"
  - "&7成员身份: %dominion_is_member% == 'true' ? '&a成员' : '&c访客'"
  - "&7成员数量: &e%dominion_member_count%"
  - "&7成员列表: &f%dominion_members%"

传送点信息

# 显示领地传送点完整坐标
message: "领地 AAA 的传送点位于: (%dominion_tp_loc_x_AAA%, %dominion_tp_loc_y_AAA%, %dominion_tp_loc_z_AAA%)"