配置文件详解
约 630 字大约 2 分钟
2025-07-03
配置文件详解
CDKer 插件在首次运行时会在 plugins/CDKer/
目录下生成以下配置文件。理解这些文件的结构和作用对于有效管理插件至关重要。
config.yml
config.yml
是 CDKer 插件的核心全局配置文件。它定义了插件运行时的基本行为参数,例如用户界面的语言设置以及在聊天中显示的消息前缀。此文件是插件正常运行的必要组成部分,不建议随意删除。
# CDKer 插件主配置文件
# 此文件用于配置插件的全局行为,例如语言和消息前缀。
# 它是插件正常运行所必需的,请勿随意删除。
# 使用的语言。插件将加载 'lang/lang_<language>.yml' 文件。
# 目前支持 'cn' (中文) 和 'en' (英文)。
language: "cn"
# 插件发送到聊天框的消息前缀。
# 支持 Minecraft 颜色代码,例如 &b (青色), &7 (灰色), &f (白色)。
prefix: "&bCDKer &7> &f"
配置项说明:
language
:- 类型: 字符串 (String)
- 描述: 此配置项指定了插件在游戏内向玩家和管理员显示消息时所使用的语言。插件将根据此处设置的值,自动加载
plugins/CDKer/lang/
目录下对应的语言文件(格式为lang_<language>.yml
)。 - 可选值:
"cn"
: 表示加载中文语言文件 (lang_cn.yml
)。"en"
: 表示加载英文语言文件 (lang_en.yml
)。
- 默认值:
"cn"
。 - 重要提示: 如果您更改了此设置,请务必确认
plugins/CDKer/lang/
文件夹中存在与新设置值对应的语言文件。更改后,您需要执行/cdk reload
命令以使新的语言设置生效,而无需重启服务器。
prefix
:- 类型: 字符串 (String)
- 描述: 此配置项定义了 CDKer 插件在聊天框中发送所有消息时所使用的前缀。一个清晰且具有辨识度的前缀有助于玩家快速识别插件发出的信息。
- 支持: 该字符串完全支持 Minecraft 的颜色代码。您可以使用
&
符号后跟一个十六进制数字或字母来应用颜色和格式。例如:&b
: 青色&7
: 灰色&f
: 白色&r
: 重置颜色和格式
- 默认值:
&bCDKer &7> &f
。 - 建议: 您可以根据服务器的主题或偏好,自定义此前缀以提升用户体验和品牌一致性。更改后,同样需要使用
/cdk reload
命令进行重载。