4. 配置和自定义

插件提供了高度自定义的配置文件，以满足不同玩家的选择，默认的配置文件如下所示：

{
  "commands tips": {
    "enable": "If enable = false, then this directive will not be registered(如果enable = false,那么指令不会被注册)",
    "permission-level": "1 <==> operator only  |  0 <==> everyone (1表示仅管理员可用，0表示所有人可用)"
  },
  "commands": {
    "tick": {
      "enable": true,
      "permission-level": 1
    },
    "log": {
      "enable": true,
      "permission-level": 0
    },
 	...
  },
    "village": {
    "bound": "apricot",
    "spawn": "vatblue",
    "center": "teal",
    "poi-query": "white"
  },
  "basic-config": {
    "particle-performance-level": 3,
    "particle-view-distance": 128,
    "hud-refresh-freq": 20,
    "tool-damage-threshold": 10,
    "keep-sim-player-inv": true,
    "server-crash-token": "demo",
    "sim-player-prefix": "",
    "use-client-level": false
  },
  "default-functions-config": {
    "[FOR GLOBAL]": "If the following settings are enabled then these features are enabled globally",
    "force-place-level": 0,
    "dropper-no-cost": false,
    "hopper-counter": false,
    "safe-explosion": false,
    "max-pending-tick-size": 100,
    "[FOR SINGLE]": "The following features are enabled only when both the following settings and the player's own settings(/self command) are enabled",
    "hud": true,
    "creative-no-clip": false,
    "block-rotate": false,
    "auto-select-tool": false,
    "force-open-container": false
  },
  "shortcuts": {
   ...
  }
}

commands

ommands内配置了每个指令是否开启，以及命令的使用权限：

• enable为1时表示开启该命令，为0是插件不会注册该命令
• permission-level表示该命令的执行等级，和原版一致，0表示所有玩家都可执行，1表示仅OP或以上可执行

basic-config

basic-config内配置了插件的一些基本设置，如下表所示：

配置项	解释
particle-performance-level	粒子的显示效果,选填0,1,2,越大表示显示效果越好，但是对客户端的渲染压力越高
particle-view-distance	粒子的最大渲染距离，当粒子和距它最近的玩家距离超过该值时，粒子不会生成
hud-refresh-freq	HUD命令内数据的刷新率，默认是20gt刷新一次
tool-damage-threshold	开启自动切换工具后需要切换时工具剩余的最小耐久值
keep-sim-player-inv	假人死亡或者被despawn时是否保留背包数据
server-crash-token	手动崩服时需要输入的密钥
sim-player-prefix	生成假人时自动添加的前缀
use-client-level	是否读取%AppData%目录下的客户端存档而不是服务器根目录worlds下的存档(暂未开放)

default-enable-functions

在新版本中，TR将function和tweak合并，并重新分为两类：全局功能和个人功能，对于个人功能，需要使用func和self同时开启该功能才会对特定玩家生效；对于全局功能，只需要使用func指令开启，该功能则会全服务器生效。配置文件中的default-enable-functions中只会配置这些功能的全局开关（对于个人功能是否生效还是需要玩家自己用self指令来设置）。

下表展示了每个功能的解释和用途：

配置项	类别	解释
force-place-level	全局	默认开启强制放置
dropper-no-cost	全局	默认开启投掷器无消耗
hopper-counter	全局	默认开启漏斗计数器
safe-explosion	全局	默认开启爆炸不破坏地形
max-pending-tick-size	全局	默认的每区块的计划刻上限（100是游戏默认值）
hud	个人	默认开启HUD功能的全局开关
creative-no-clip	个人	默认开启创造模式无碰撞的全局开关
block-rotate	个人	默认开启仙人掌转方块的全局开关
force-open-container	个人	默认开启强制开容的全局开关

Village Colors

村庄边界的现实颜色支持下表中的16个值（请填写全小写的单词，不支持颜色代码和缩写）

颜色代码	颜色展示	缩写	名字
#000000		B	BLACK
#144a74		I	INDIGO
#8E65F3		L	LAVENDER
#07946e		T	TEAL
#AB5236		C	COCOA
#56575F		D	DARK
#A2A3A7		O	OATMEAL
#FFFFFF		W	WHITE
#FF3040		R	RED
#FF7300		A	APRICOT
#FFEC27		Y	YELLOW
#10E436		G	GREEN
#29ADFF		V	VAT
#83769C		S	SLATE
#FF77A8		P	PINK
#FFCCAA		E	FAWN