跳到主要内容

语言文件

Monoceros 默认提供 lang/zh_CN.yml 和 lang/en_US.yml 两个语言文件。当前最适合中文服主直接改的是 zh_CN.yml。

默认语言文件覆盖了什么​

从当前默认 zh_CN.yml 来看，语言键主要分成以下几类：

前缀用途
script-*脚本加载、预热、编译失败、执行失败
dispatcher-*分发器加载与注册
schedule-*调度加载、启动、自动启动
command-*/mono 命令提示、重载结果、脚本统计
wireshark-*Packet 会话与 Tap 注册
volatility-*挥发能力相关提示
workflow-*动作工作流、属性访问器注册
startup-info-*插件启动时输出到控制台的信息
ops-*运维与重载结果

当前默认消息示例​

script-load-success: "脚本加载完成: {0} 成功, {1} 失败"
command-version: "Monoceros v{0}"
command-debug-on: "调试模式已开启"
command-debug-off: "调试模式已关闭"
startup-info-github: "&7开源仓库: &bhttps://github.com/YsGqHY/Monoceros"
ops-reload-failed: "重载失败: {0}"

占位符规则​

默认语言文件大量使用 {0}、{1} 这种参数占位符。它们会在运行时被真实值替换。

例如：

  • Monoceros v{0} → {0} 通常会被替换成插件版本号
  • 脚本加载完成: {0} 成功, {1} 失败 → {0} 和 {1} 会被替换成加载统计结果

修改这类消息时，不要随便删掉占位符，否则输出内容可能会变得不完整。

颜色代码​

默认语言文件使用 & 颜色代码，例如：

startup-info-version: "&7插件版本: &f{0}"

如果你想调整控制台或聊天消息样式，可以继续沿用这种写法。

修改语言文件时的建议​

  • 先保留原键名，不要改 key，只改 value
  • 先确认占位符和颜色代码是否还完整
  • 改完后执行对应命令，或直接观察控制台输出确认是否生效

适合放到语言文件里的内容​

  • 命令成功/失败提示
  • 加载统计信息
  • 启动信息
  • 调试输出的文案

不适合放到语言文件里的内容​

  • 脚本业务逻辑
  • 调度触发逻辑
  • 分发器规则
  • 工作流节点配置

这些应该继续放在 script/、schedule/、dispatcher/、workflow/action/ 下维护。