# McBorder 插件文档
# 区域
> 命令 /mb region-edit-mode 可以切换到区域编辑模式
## 用法
> 在编辑模式下,直接输入以下格式即可,无需添加 /
> 区域由三个或更多点组成,可以在编辑模式下直接配置
> 区域文件位于插件配置文件的 region 文件夹中
- add
- 将当前位置加载到最近编辑的区域节点
- save
- 将当前编辑的区域保存为配置文件。文件名:region_id.yml
- exit
- 退出编辑模式
- tp
- 传送到指定的节点,可以使用 look 查看所有节点编号,tp 编号传送到该节点
- 注意:是上下偏移,基于自身高度传送,飞高后再传送,否则可能卡墙
- look
- 查看当前编辑的区域
- region
- 切换到现有的区域进行编辑,如果指定的 id 不存在,则创建一个新的。修改后记得保存。
- id
- 设置当前编辑区域的 id,影响文件名
- display
- 设置当前编辑区域的显示名称
- weight
- 设置当前编辑区域的权重。当区域重叠时,权重较高的区域被认为是玩家的位置
- world
- 设置当前编辑区域的世界
- insert
- 将当前位置作为节点插入到指定位置
- flag
- 向区域添加一个标志
- set
- 将当前位置设置为区域节点
- remove
- 移除区域的节点
- clear
- 清空当前区域的节点
## 标志
- check-perm-move
- 检查玩家在该节点值中是否具有指定的权限。如果没有,则会阻止玩家在该区域内移动
- check-perm-join
- 检查玩家在该节点值中是否具有指定的权限。如果没有,则会阻止玩家进入该区域
- check-perm-tp-move
- 类似于上述,但会阻止玩家在当前区域内传送到另一个位置
- check-perm-tp-join
- 类似于上述,阻止传送到该区域
- deny-to
- 禁止从该区域移动到其他指定的区域
- 格式:* 表示禁止移动到任何其他区域,或可以指定特定名称
- 示例:deny-to: "A,B,C,D" 禁止从该区域移动到 ID 为 A、B、C、D 的区域
- deny-tp-to
- 禁止从该区域传送至其他区域,格式与 deny-to 相同
- deny-move-message
- 当在区域内移动被阻止时显示的提示信息
- deny-join-message
- 当进入该区域被阻止时显示的提示信息
- deny-to-message
- 当从该区域移动到其他区域被阻止时显示的提示信息
- deny-tp-join-message
- 当传送进入该区域被阻止时显示的提示信息
- deny-tp-to-message
- 当从该区域传送其他区域被阻止时显示的提示信息
# 变量
- %BorderInfo_BorderSize% | 当前世界边框大小
- %BorderInfo_BorderCenterX% | 当前世界边框中心的 X 坐标
- %BorderInfo_BorderCenterZ% | 当前世界边框中心的 Z 坐标
- %BorderInfo_BorderOutDamage% | 当前世界边框之外的伤害值
- %McBorder_Biome% | 玩家当前位置的生物群系
- %BorderInfo_Region_In_RegionID% | 返回玩家是否在指定的区域名称中(返回:true/false)
- %BorderInfo_Region_Name% | 返回玩家当前所在区域的显示名称
# 权限
> McBorder.commandName
> {.is-success}
# 命令
- `/McBorder(mb) help`
- 查看插件帮助
- `/McBorder(mb) setborder [time]`
- 设置世界边框的大小
- `/McBorder(mb) setcenter `
- 设置世界边框的中心点
- `/McBorder(mb) setplayer [time]`
- 设置玩家所在世界的边框大小并将其居中
- `/McBorder(mb) setplayerworld [size] [world] [time]`
- 设置玩家所在世界边框,具有更多可选参数
- `/McBorder(mb) reborder `
- 重置指定世界的边框
- `/McBorder(mb) replayer `
- 重置玩家所在世界的边框
- `/McBorder(mb) setwarning `
- 设置世界中的边框警告距离、警告时间、缓冲距离和超出边框的伤害值
- `/McBorder(mb) increase `
- 增加世界边框的大小
- `/McBorder(mb) reduce `
- 减少世界边框的大小
- `/McBorder(mb) getcenter `
- 获取指定世界中心的坐标
- `/McBorder(mb) getsize `
- 获取指定世界边框的大小
- `/McBorder(mb) rtp `
- 将指定的玩家随机传送到指定世界边界内
- `/McBorder(mb) reload`
- 重新加载插件
- `/McBorder(mb) upsetting`
- 通过配置文件更新边框
- `/McBorder(mb) region-edit-mode`
- 进入区域编辑模式,区域编辑关键字可以直接在此模式下发送