配置文件
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 配置
| 配置项 | 说明 |
|---|---|
symbol | PAPI 变量前缀,默认 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 <玩家> 重置标记。
配置重载
修改任何配置文件后,执行 /kml reload 即可热重载,无需重启服务器。