fix #197: add yaw and pitch retrieval for dominion teleport locations and fix substring indices for member checks

Author: ColdeZhang

src/notes/doc/owner/3.其他/4.placeholder.md

@@ -17,203 +17,126 @@ permalink: /notes/doc/owner/other/placeholder/
 - 领地离开提示消息；
 - CUI 标题、按钮（名称、lore）；
 
-## Dominion 目前提供的占位符
-
-### 玩家相关
-
-#### `%dominion_group_title%`
-
-- **功能**: 获取玩家当前使用的称号组名称
-- **返回值**: 称号组的彩色名称，如果玩家没有使用称号组则返回空
-- **使用示例**:
-  ```yaml
-  # 在其他插件配置中使用
-  message: "欢迎 %dominion_group_title% %player_name%！"
-  ```
-
-#### `%dominion_current_dominion%`
-
-- **功能**: 获取玩家当前所在领地的名称
-- **返回值**: 领地名称，如果玩家不在任何领地内则返回空
-- **使用示例**:
-  ```yaml
-  # 显示当前所在领地
-  format: "你现在在 %dominion_current_dominion% 领地内"
-  ```
-
-### 领地信息
-
-#### `%dominion_tp_loc_[x, y, z]_<领地名称>%`
-
-- **功能**: 获取指定领地传送点的x、y、z坐标
-- **返回值**: 对应坐标的数值，如果领地不存在则返回空
-- **使用示例**:
-  ```yaml
-  # 显示领地传送点坐标
-  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"，如果不在领地内则返回空
-- **使用示例**:
-  ```yaml
-  # 根据成员身份显示不同消息
-  message: "%dominion_is_member% == 'true' ? '你是这里的成员' : '你不是这里的成员'"
-  ```
-
-#### `%dominion_is_member_<领地名称>%`
-
-- **功能**: 检查玩家是否为指定领地的成员
-- **返回值**: "true" 或 "false"，如果领地不存在则返回空
-- **使用示例**:
-  ```yaml
-  # 检查特定领地的成员身份
-  condition: "%dominion_is_member_MyDominion% == 'true'"
-  ```
-
-#### `%dominion_members%`
-
-- **功能**: 获取玩家当前所在领地的所有成员名单
-- **返回值**: 以逗号分隔的成员名称列表，如果不在领地内则返回空
-- **使用示例**:
-  ```yaml
-  # 显示当前领地成员
-  message: "当前领地成员: %dominion_members%"
-  ```
-
-#### `%dominion_members_<领地名称>%`
-
-- **功能**: 获取指定领地的所有成员名单
-- **返回值**: 以逗号分隔的成员名称列表，如果领地不存在则返回空
-- **使用示例**:
-  ```yaml
-  # 显示指定领地成员
-  message: "领地 MyDominion 的成员: %dominion_members_MyDominion%"
-  ```
-
-#### `%dominion_member_count%`
-
-- **功能**: 获取玩家当前所在领地的成员数量
-- **返回值**: 成员数量数值，如果不在领地内则返回空
-- **使用示例**:
-  ```yaml
-  # 显示成员数量
-  message: "当前领地有 %dominion_member_count% 名成员"
-  ```
-
-#### `%dominion_member_count_<领地名称>%`
-
-- **功能**: 获取指定领地的成员数量
-- **返回值**: 成员数量数值，如果领地不存在则返回空
-- **使用示例**:
-  ```yaml
-  # 显示指定领地成员数量
-  message: "领地 MyDominion 共有 %dominion_member_count_MyDominion% 名成员"
-  ```
-
-### 权限组相关
-
-#### `%dominion_group%`
-
-- **功能**: 获取玩家在当前所在领地中的组名称
-- **返回值**: 组的彩色名称，如果不在领地内或不在任何组中则返回空
-- **使用示例**:
-  ```yaml
-  # 显示玩家在当前领地的组
-  message: "你在当前领地的组: %dominion_group%"
-  ```
-
-#### `%dominion_group_<领地名称>%`
-
-- **功能**: 获取玩家在指定领地中的组名称
-- **返回值**: 组的彩色名称，如果领地不存在或不在任何组中则返回空
-- **使用示例**:
-  ```yaml
-  # 显示玩家在指定领地的组
-  message: "你在 MyDominion 领地的组: %dominion_group_MyDominion%"
-  ```
-
-#### `%dominion_groups%`
-
-- **功能**: 获取玩家当前所在领地的所有组列表
-- **返回值**: 以逗号分隔的组名称列表（带颜色），如果不在领地内则返回空
-- **使用示例**:
-  ```yaml
-  # 显示当前领地的所有组
-  message: "当前领地的组: %dominion_groups%"
-  ```
-
-#### `%dominion_groups_<领地名称>%`
-
-- **功能**: 获取指定领地的所有组列表
-- **返回值**: 以逗号分隔的组名称列表（带颜色），如果领地不存在则返回空
-- **使用示例**:
-  ```yaml
-  # 显示指定领地的所有组
-  message: "领地 MyDominion 的组: %dominion_groups_MyDominion%"
-  ```
-
-#### `%dominion_group_count%`
-
-- **功能**: 获取玩家当前所在领地的组数量
-- **返回值**: 组数量数值，如果不在领地内则返回空
-- **使用示例**:
-  ```yaml
-  # 显示当前领地组数量
-  message: "当前领地有 %dominion_group_count% 个组"
-  ```
-
-### 权限相关
-
-#### `%dominion_pri_flag_<权限名称>%`
-
-- **功能**: 获取玩家在当前所在领地中指定特权权限的值
-- **返回值**: "true" 或 "false"，如果权限不存在则返回空
-- **使用示例**:
-  ```yaml
-  # 检查玩家是否有破坏权限
-  condition: "%dominion_pri_flag_destroy% == 'true'"
-  # 检查玩家是否有建造权限
-  message: "%dominion_pri_flag_place% == 'true' ? '你可以建造' : '你不能建造'"
-  ```
-
-#### `%dominion_env_flag_<权限名称>%`
-
-- **功能**: 获取玩家当前所在领地中指定环境权限的值
-- **返回值**: "true" 或 "false"，如果权限不存在则返回空
-- **使用示例**:
-  ```yaml
-  # 检查是否允许爆炸
-  condition: "%dominion_env_flag_explode% == 'true'"
-  # 检查是否允许刷怪
-  message: "当前领地天气控制: %dominion_env_flag_monster_spawn%"
-  ```
-
-## 综合使用示例
-
-### 领地信息显示板
-
-```yaml
-# 使用多个占位符创建领地信息显示
-title: "&6当前领地信息"
-content:
-  - "&7领地名称: &a%dominion_current_dominion%"
-  - "&7成员身份: %dominion_is_member% == 'true' ? '&a成员' : '&c访客'"
-  - "&7成员数量: &e%dominion_member_count%"
-  - "&7成员列表: &f%dominion_members%"
+# 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`，标志不存在则为空。
+
+**示例：**
+
+```text
+%dominion_pri_flag_build%
+%dominion_pri_flag_open_chest%
 ```
 
-### 传送点信息
+---
+
+## 🌍 环境标志（Environment Flag）
+
+* **`%dominion_env_flag_<flag>%`**
+  判断当前领地是否启用了指定环境规则。
+  返回：`true` / `false`，标志不存在则为空。
+
+**示例：**
 
-```yaml
-# 显示领地传送点完整坐标
-message: "领地 AAA 的传送点位于: (%dominion_tp_loc_x_AAA%, %dominion_tp_loc_y_AAA%, %dominion_tp_loc_z_AAA%)"
+```text
+%dominion_env_flag_pvp%
+%dominion_env_flag_fire_spread%
 ```
+
+---
+
+## ℹ️ 返回值说明
+
+* 若领地不存在、玩家不在领地、未分组或标志不存在，通常返回空字符串。
+* 布尔类占位符统一返回 `"true"` 或 `"false"`。
+* 列表类占位符返回以英文逗号分隔的字符串。
+