lang/ 文件夹 (语言文件)

plugins/CDKer/lang/ 文件夹是 CDKer 插件用于管理所有用户可见消息的专用目录。此文件夹内包含多个 YAML 格式的语言文件，每个文件对应一种支持的语言。插件会根据 config.yml 中 language 配置项的设定，自动加载并使用相应的语言文件来显示游戏内消息。

管理员可以通过编辑这些语言文件，完全自定义插件发送给玩家和控制台的每一条消息的内容、措辞以及颜色。这为服务器提供了极大的灵活性，以确保插件消息与服务器的整体风格和语言偏好保持一致。

• lang_cn.yml:

  • 描述: 包含所有插件消息的中文翻译。这是插件默认加载的语言文件（如果 config.yml 中的 language 设置为 "cn"）。
  • 用途: 为中文用户提供本地化的插件体验。

• lang_en.yml:

  • 描述: 包含所有插件消息的英文翻译。此文件在 config.yml 中的 language 设置为 "en" 时加载。
  • 用途: 为英文用户或国际服务器提供插件支持。

语言文件结构与自定义:

每个语言文件都采用 YAML 格式，并包含一个顶级的 messages 键，其下嵌套了所有具体的翻译键值对。

示例 (lang_cn.yml 片段):

# CDK 中文语言文件 (zh_CN)
prefix: "&7[&bCDK&7] &r"
no_permission: "&c你没有权限执行此命令！"
unknown_command: "&c未知命令！使用 /cdk help 查看命令列表。"
no_permission_use: "&c你没有权限使用此 CDK！"

help_header: "&6===== &e&lCDK 帮助 &6=====&r"
help_create: "&b/cdk create single <id> <数量> \"<命令1|命令2|...>\" [有效时间] &7- 创建一次性CDK"
# ... (其他消息键值对) ...

• 键 (Key): 例如 prefix, no_permission, help_header 等。这些键在插件的 Java 代码中被引用，用于检索对应的消息字符串。
• 值 (Value): 与键关联的实际消息内容。
  • 支持 Minecraft 颜色代码: 消息值中可以使用 & 符号后跟一个字符来插入 Minecraft 的颜色和格式代码（例如 &a 绿色, &c 红色, &b 青色, &7 灰色, &r 重置格式）。插件会自动将这些代码转换为游戏内可识别的颜色。
  • 支持占位符: 某些消息可能包含占位符（例如 %quantity%, %id%, %cdk%, %file%）。这些占位符在插件发送消息时会被动态替换为实际的数据。在自定义消息时，请确保保留这些占位符，以便消息能够正确显示动态信息。

自定义提示:

• 在编辑语言文件时，请确保使用支持 YAML 语法的文本编辑器（如 Notepad++, VS Code, Sublime Text），以避免格式错误。
• 修改语言文件后，您需要执行 /cdk reload 命令来重新加载插件配置，使更改立即生效。
• 您可以根据需要创建新的语言文件（例如 lang_fr.yml 用于法语），并在 config.yml 中将 language 设置为对应的语言代码。