YlesssのWiki

配置说明 ​

修改 config.yml、setting.yml、message.yml 或 domain/*.yml 后，可以使用 /yd reload 重载。

配置文件 ​

文件 / 目录用途
config.yml基础设置
setting.yml区域魔杖和检测间隔
message.yml消息文本
domain/区域文件

配置示例 ​

yaml
# 是否开启调试模式
# 说明：调试模式会打印较多内部信息，仅在开发或排查 bug 时建议开启。
debug: false

# 是否启用 bStats
# 说明：bStats 会收集一些匿名使用数据（如插件版本、服务器软件等），用于插件开发者改进功能与兼容性。
#       该统计不包含个人可识别信息；如需完全不发送任何数据可设为 false。
# 详细说明与查看： https://bstats.org/plugin/bukkit/YlesDomain/
metrics: true
yaml
wand:
  material: GOLD_HOE
  name: '&6区域魔杖'
  lore:
    - '&7左键选择坐标一'
    - '&7右键选择坐标二'
    - '&7使用 /yd create <key> 创建区域'
domain:
  # 区域进入/离开检测的轮询间隔（单位：tick）。
  # 20 tick = 1 秒；值越小检测越频繁，但性能开销更高。
  # 建议范围 5~40，默认 10（约 0.5 秒）。
  check-interval-ticks: 10
yaml
type: cuboid
world: world
loc1: 0,64,0
loc2: 20,80,20
actions:
  join:
    - "[message]&a你进入了主城"
  leave:
    - "[message]&c你离开了主城"

区域类型 ​

类型说明
cuboid立方体区域，使用 loc1 和 loc2 两个坐标
cylinder圆柱区域，使用 center、radius、yMin、yMax
world整个世界区域，只需要 world

区域文件 ​

每个区域对应 domain/ 目录下的一个 .yml 文件。

区域文件名就是区域名，例如 domain/spawn.yml 对应区域 spawn。

进入和离开动作 ​

配置项说明
actions.join玩家进入区域时执行
actions.leave玩家离开区域时执行

动作列表由 YlesLib 的 CommandApi 执行，可以直接使用 YlesLib 支持的动作格式。

检测间隔 ​

domain.check-interval-ticks 控制异步区域检测间隔。

默认 10 tick，约 0.5 秒。数值越小检测越频繁，性能开销也越高。