跳到主要内容

配置文件

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 <玩家> 重置标记。

配置重载

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