跳到主要内容

配置文件

config.yml​

config.yml 是插件的主配置文件，默认内容如下：

target_block:
  distance: 64
  ignore_block:
    - air
    - stone
onDropItemOwner: false
showOwnerName:
  enable: true
  format: "{name} &7({owner})"
  merge: false
borderDamagePeriod: 1000
prevent_period:
  left_click_block: 5
  right_click_block: 5
  jump_on_block: 5
  sneak_on_block: 5
  walk_on_block: 5
papi_parse:
  symbol: "kmlparse"

配置项说明​

target_block — 目标方块检测​

用于 /kml getloc 命令和 kml setblock 动作的方块检测参数。

配置项说明
distance最大检测距离（方块数），默认 64
ignore_block忽略的方块类型列表，检测时会跳过这些方块

onDropItemOwner — 掉落物归属​

设为 true 时，通过 evel drop 掉落的物品会带有归属标记，只有归属玩家能拾取。

showOwnerName — 归属名称显示​

配置项说明
enable是否在掉落物名称上显示归属信息
format显示格式。{name} 为物品名，{owner} 为归属玩家名
merge是否允许同归属的掉落物合并

borderDamagePeriod — 边界伤害间隔​

世界边界伤害的触发间隔，单位毫秒，默认 1000（1 秒）。

prevent_period — 方块事件冷却​

防止方块事件被频繁触发的冷却时间（tick）。每种事件类型独立配置：

配置项对应事件
left_click_block左键方块
right_click_block右键方块
jump_on_block跳跃在方块上
sneak_on_block蹲下在方块上
walk_on_block行走在方块上

默认值均为 5 tick。

papi_parse — PlaceholderAPI 配置​

配置项说明
symbolPAPI 变量前缀，默认 kmlparse。使用方式：%kmlparse_<kether脚本>%

nodes.yml​

公共节点数据文件，供 Kether 的 node 动作读取。你可以在这里存放需要在多处复用的数据。

def1:
  def2:
    - '123'
    - '456'
  def3: "789"
def4: "000"

在 Kether 中读取：

node "def1.def2"    # 返回 ['123', '456']
node "def4"         # 返回 "000"

player.yml​

玩家事件配置，目前支持全服首次加入事件：

first_player_join: |-
  kml setblock at "world,0,80,0" stone
  tell "你是第一个进入服务器的玩家"

服务器启动后，第一位加入的玩家会执行这里配置的 Kether 脚本。可通过 /kml resetFirstJoin 重置运行时标记，让下一位加入的玩家再次触发。

wand.yml​

选区工具配置，用于给玩家一把可选取两个方块顶点的工具，并输出可直接填入 position 的区域字符串。

wand:
  item: "minecraft:golden_axe[name=&6&l选区工具]"
  give: "minecraft:golden_axe"
  give-name: "&6&l选区工具"
  give-lore:
    - "&7左键方块: 设置 &bpos1"
    - "&7右键方块: 设置 &bpos2"
    - "&7潜行+左键空气: 清空选区"
  cancel-interact: true
actions:
  pos1: "LEFT_CLICK_BLOCK"
  pos2: "RIGHT_CLICK_BLOCK"
  clear: "shift-LEFT_CLICK_AIR"
output:
  format: "{w},{x1},{y1},{z1}~{x2},{y2},{z2}"
  mode: "block"
  feedback-area: "&7[&fKML&7] &f区域: [&b&n点击复制](hover={area};suggest={area})"
visualize:
  enable: true
  period: 10
  step: 0.5
  render-distance: 48

通过 /kml wand give 获取工具，左键和右键分别设置 pos1、pos2，再用 /kml wand get 输出选区字符串。

配置重载​

修改任何配置文件后，执行 /kml reload 即可热重载，无需重启服务器。