YlesssのWiki

配置说明 ​

修改 config.yml、message.yml 和 lock.yml 后，可以使用 /ypl reload 重载。

配置文件 ​

文件 / 目录用途
config.yml基础设置
message.yml消息文本
lock.yml锁定设置

配置示例 ​

yaml
# 日志系统设置：控制插件的日志记录功能，启用后插件会记录日志
logger-enable: false

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

# 是否启用 bStats
# 说明：bStats 会收集一些匿名使用数据（如插件版本、服务器软件等），用于插件开发者改进功能与兼容性。
#       该统计不包含个人可识别信息；如需完全不发送任何数据可设为 false。
# 详细说明与查看： https://bstats.org/plugin/bukkit/YlesPlayerLock/
metrics: true
yaml
# 玩家距离最近非空气方块超过多少格时不可锁定
y-block-distance: 5

# 当玩家开启锁定时执行的内容
lock-on:
  - "[console]say %player_name% &a开启了锁定"

# 当玩家解锁时执行的内容
lock-off:
  - "[console]say %player_name% &c关闭了锁定"

# 变量 %ylesplayerlock_lock% 的返回文本
papi-set:
  lock-on: "&f已锁定"
  lock-off: "&7未锁定"
yaml
PREFIX: "[YlesPlayerLock]"
MESSAGE:
  RELOAD: 配置文件重载完成。
  LOCK:
    ENABLED: "&a已开启移动锁定。"
    DISABLED: "&c已关闭移动锁定。"
    TARGET:
      ENABLED: "&a已为 {0} 开启移动锁定。"
      DISABLED: "&c已为 {0} 关闭移动锁定。"
      ALREADY: "&e{0} 已经处于锁定状态。"
      NOT_LOCKED: "&e{0} 尚未被锁定。"
    HEIGHT_LIMIT: "&c当前位置距离地面超过 {0} 格，无法开启锁定。"
    USAGE: "&c用法: /ypl lock"
  ENABLE:
    USAGE: "&c用法: /ypl enable <player>"
  DISABLE:
    USAGE: "&c用法: /ypl disable <player>"
COMMAND:
  RELOAD: 重载插件的配置文件。
  LOCK: 开启或关闭移动锁定。
  ENABLE: 为指定玩家开启移动锁定。
  DISABLE: 为指定玩家关闭移动锁定。
ERROR:
  USAGE_COMMAND: 未知的命令。
  PLAYER_ONLY: 该命令只能由玩家执行。
  PLAYER_NOT_FOUND: 无法找到玩家 {0}。

高度限制 ​

y-block-distance 用于限制玩家离地过高时开启锁定。

插件会从玩家当前位置向下查找最近的非空气方块。如果玩家距离该方块表面超过配置值，就不会开启锁定。

设置为 -1 时表示不限制高度。

回调命令 ​

lock-on 会在玩家成功开启锁定后执行。

lock-off 会在玩家解除锁定后执行。

标识说明
[console]以控制台身份执行
[op]临时 OP 执行
[message]给玩家发送消息
[chat]让玩家发送聊天
[bc]全服广播
[sound]播放音效，格式为 [sound] 音效名:音量:音调
[actionbar]发送 ActionBar
[title]发送标题，格式为 [title] 主标题:副标题:淡入:停留:淡出
无标识以玩家身份执行命令

命令内容支持 %player% 和 PlaceholderAPI 变量。