modid:
verityconfig
Minecraft Java 版 1.20.1 / Forge 47.4.21 的客户端辅助模组,用于更便捷地配置
Verity JE(varmite.verity)的 AI 参数,并把它的界面与聊天消息中文化。
本文件写给「想改代码 / 想自己打包」的人。只想玩的玩家看 安装 一节即可。
Verity JE 本体把 AI、语音、本地模型等设置放在一个由 Yet Another Config Lib(YACL)
渲染的英文界面里,而且大量提示走聊天栏。Verity Plus 做三件事:
用同一套 YACL API 重建了一个中文配置界面,覆盖提供商、API Key、Base URL、模型、
语音朗读、深度思考等全部选项。
拦截 Verity 发到聊天栏的固定文案,命中词表就换成中文;同时处理断线界面、
本地 AI(Ollama)安装页、进度 HUD 等处的英文。
首次启动引导、旧存档导入、高级设置(dayCount / canCrash 等)、
记忆文件修复、赞助码等。
注意:AI 生成的回复正文(
<Verity>后面那句)不在翻译范围内,
那是模型输出,不属于模组的固定文案。
必需
| 依赖 | 版本 |
|---|---|
| Minecraft | 1.20.1 |
| Forge | 47.x(开发与测试使用 47.4.21) |
| Verity JE | 6.0.0 及以上 |
| Yet Another Config Lib | 3.6.6 及以上 |
可选
- Modpack Helper(modid:
modpackhelper)—— 提供帮助文档、常见问题、 旧存档导入与 DeepSeek 峰谷提示。不装也能正常游戏,只是缺这几项功能与对应指令。
把 jar 放进 mods 目录即可,客户端专用;专用服务器上不会加载。
| 指令 | 作用 |
|---|---|
/vc |
提示常用指令 |
/vc cs |
打开 Verity AI 配置界面 |
/vc configscreen |
同上 |
/vc exitgame |
直接退出游戏(部分启动器下按钮不生效时的备用) |
/vc verity mfix |
修复 Verity 的聊天记忆(移除空 AI 消息) |
/vc verity mdel |
删除记忆文件,让 Verity 重新生成 |
以下指令需要安装 Modpack Helper 才会注册:
| 指令 | 作用 |
|---|---|
/vc help |
显示指令列表 |
/vc help <主题> |
打开指定帮助文档(支持中文主题名) |
/vc qanda |
打开常见问题 |
/vc dshint [on|off] |
开关 DeepSeek 峰谷时段提示 |
/vc dshint date |
按当前时间查询一次峰谷提示 |
/vc dshint date <日期> <时间> |
查询指定时刻,格式 YYYY-MM-DD mm.ss |
按键:反斜杠 \ 打开配置界面(可在「按键设置」里改)。
游戏目录下:
| 路径 | 说明 |
|---|---|
config/verity-common.toml |
Verity 本体的配置(本模组也读写它) |
config/verity-common-m.toml |
手机端模板 |
config/verityconfig-common.toml |
本模组自己的开关(赞助码、峰谷提示等) |
config/simple_translate/*.json |
简单翻译模组的联动配置 |
首次启动时若缺少 verity-common.toml,会用 assets/verityconfig/config/
下的模板补齐;已存在的文件不会被覆盖。
src/main/java/com/cb2495/verityconfig/
├── VerityPlus.java 模组入口,版本扫描,标题界面事件
├── client/ 客户端行为(19 个类)
│ ├── ChatFilter.java 聊天消息入口,只做翻译链路
│ ├── ChatTranslator.java 中英词表与匹配逻辑(纯字典,不改游戏类)
│ ├── ErrorChatHandler.java 解析 "ERROR: {json}" 并给出中文说明
│ ├── ClientCommands.java /vc 指令注册
│ ├── VerityConfigScreenFactory.java 用 YACL 重建中文配置界面
│ ├── VerityConfigScreenHook.java 接管打开原版配置界面的入口
│ ├── OllamaSetupScreenZh.java 本地 AI(Ollama)安装页中文版
│ ├── OllamaHudTranslator.java 下载进度 HUD 中文
│ ├── DisconnectScreenTranslator.java 被踢出游戏时的 Farewell 文本
│ ├── ModpackHelperBridge.java 反射调用 Modpack Helper(可选依赖)
│ └── KeyBindings.java \ 键打开配置
├── config/ 配置读写(7 个类)
│ ├── VerityConfigManager.java 读写 verity-common.toml
│ ├── ModConfig.java 本模组自己的开关
│ ├── Providers.java AI 提供商与模型清单
│ └── GeneralSettings.java 高级设置的字段
├── screen/ 本模组自己的界面(7 个类)
│ ├── VerityPlusScreen.java 主配置界面
│ ├── AdvancedSettingsScreen.java 高级设置
│ ├── WelcomeScreen.java 首次启动欢迎页
│ ├── SponsorScreen.java 赞助页
│ ├── RestartPrompt.java 重启确认
│ ├── OpenUrlScreen.java 缺少 Modpack Helper 时的提示页
│ └── ModsListScreen.java 只保留按平台自动启停,不再画界面
├── util/ 日志、后台线程、图片头解析等工具
└── widget/ 下拉框、滑块、勾选框、滚动区域
src/main/resources/
├── assets/verity/lang/zh_cn.json 覆盖 Verity 的内置语言文件
├── assets/verityconfig/config/ 配置模板
├── data/verity/advancements/ 进度(成就)的中文覆盖
└── META-INF/mods.toml 模组元数据
| 项目 | 版本 / 说明 |
|---|---|
| IDE | IntelliJ IDEA |
| Gradle | 8.8 · 用自带的 gradlew,不要用系统 Gradle |
| Forge | 47.4.21 |
| Mappings | official / 1.20.1 |
| Java | 17 |
# 克隆后进入仓库根目录
cd VerityConfig
# Windows
gradlew.bat build
# Linux / macOS
./gradlew build产物在 build/libs/,文件名形如:
[Verity拓展增强]verityplus'2.9.9'-2.9.9.jar
gradlew.bat runClient # Windows
./gradlew runClient # Linux / macOS打包注意:
build/reobfJar会写build/libs下的 jar。 如果那个文件正被游戏或编辑器占用,会报「另一个程序正在使用此文件」, 先关掉占用它的程序再打包。
ModPack Helper 是另一个仓库,通过 settings.gradle 以子工程形式接入:
include 'modpackhelper'
project(':modpackhelper').projectDir = file('../ModPackHelper')
所以两个仓库必须放在同一级目录:
任意路径/
├── VerityConfig/ 本仓库
└── ModPackHelper/ 子工程
依赖方向是单向的:
ModPackHelper ──编译期依赖──▶ VerityPlus
VerityPlus ──反射调用────▶ ModPackHelper
VerityPlus 从不 import ModPack Helper 的类,所有调用都走
ModpackHelperBridge(反射),因此:
| 安装情况 | 结果 |
|---|---|
| 只装 VerityPlus | 正常,缺 Modpack Helper 的那几项功能 |
| 只装 Modpack Helper | 游戏拒绝加载(它声明了强制依赖) |
| 两个都装 | 全部功能 |
不要试图把 Modpack Helper 改成 VerityPlus 的编译期依赖,那会形成循环,
并且 reobf 后的 SRG 名 jar 混进
runClient的 userdev 环境会直接
NoSuchMethodError崩溃。
单独构建子工程:
gradlew.bat :modpackhelper:build
gradlew.bat :modpackhelper:runClient
-
建议两个模组一起分发
-
只装 VerityPlus 时
/vc help、/vc qanda、/vc dshint不存在, 这不是 bug -
Android 端不支持输入法冲突修复,首次启动会按平台自动禁用
本节是本项目最重要的一节,请在使用或分发前完整阅读。
Verity Plus 是第三方社区项目,由 CreeperBoy-CB 独立开发,
与 Verity JE 的作者 Varmite、BlockMaster29、JJack、ErrorCezar
(以及 Verity 形象原作者 ThatMob)没有任何隶属、合作或背书关系。
本项目未获得他们的官方授权或认可。
Verity JE 的 mods.toml 中明确声明:
license="All Rights Reserved"
All Rights Reserved 意味着版权方保留全部权利:除法律明确允许的
合理使用等情形外,未经作者书面许可,不得复制、修改、再分发其代码或资源。
本项目的 MIT 许可证只覆盖 CreeperBoy-CB 自己编写的代码,
不能、也不会改变 Verity JE 的授权状态。
为了说明边界,下面逐项列出本项目对 Verity JE 的交互方式:
| 行为 | 说明 | 是否分发 Verity 的代码/资源 |
|---|---|---|
| 聊天/界面文本翻译 | 运行时匹配 Verity 发出的字符串并替换为中文,译文在本项目自己的字典里 | ❌ 否 |
| 配置界面 | 用 YACL 重新搭建,只读写 verity-common.toml 这个配置数据 |
❌ 否 |
| 界面与 HUD 钩子 | 通过反射按类名访问 varmite.verity.*,不 import、不打包 |
❌ 否 |
assets/verity/lang/zh_cn.json |
本项目自行翻译的语言文件(原版只有 en_us.json) |
|
data/verity/advancements/*.json |
本项目自行翻译的进度名称与描述 | |
| Modpack Helper 的帮助文档 | 文字与截图均为本项目自制 | ❌ 否 |
标
它们在运行时覆盖原版同名资源,前提是玩家自己已经安装了 Verity JE。
聊天栏里那些被替换的英文原句,是开发时通过反编译 Verity JE 的 class 文件 读取字符串常量得到的 —— 因为模组不提供源码,这是唯一可行的途径。
需要说明的是:
- 这些英文原句只作为匹配用的键,以中英对照的形式写在本项目的
ChatTranslator.java字典里 - 译文由本项目自行撰写
- 本项目不分发 Verity JE 的 class 文件、反编译源码或原始资源文件
如果你打算在自己的项目里做类似的事,请注意:多数司法管辖区允许 为互操作性进行的逆向工程,但不允许分发逆向得到的代码。 只把字符串常量当作对照表的键、自己撰写译文,是这类项目最稳妥的做法。
-
❌ Verity JE 的任何
.class文件或反编译源码 -
❌ Verity JE 的贴图、模型、音效、动画
-
❌ Verity JE 的原始
.json资源 -
❌ 任何用于绕过 Verity JE 授权检查的代码
本项目的 jar 无法在未安装 Verity JE 的环境下提供任何 Verity 功能,
它完全依赖玩家自己合法取得的 Verity JE。
-
本项目按「现状」提供,不附带任何明示或暗示的担保
-
作者不对使用本项目造成的任何直接或间接损失负责 (包括但不限于存档损坏、AI API 费用、游戏崩溃)
-
本项目会调用第三方 AI 接口,产生的费用由使用者自行承担
-
若 Verity JE 作者提出异议,本项目会配合调整或停止分发
如果你认为本项目侵犯了你的权利,请通过仓库的 Issue 联系。
作者承诺会在核实后及时移除相关内容或停止分发,无需法律程序。
-
✅ 自己游玩使用
-
✅ 在整合包中附带(注意同时提示玩家 Verity JE 需自行取得授权)
-
✅ 学习、参考本项目的实现思路
-
✅ Fork 并修改本项目自己的代码(MIT 允许)
-
⚠️ 商业整合包分发:请先确认 Verity JE 作者对整合包分发的态度 -
❌ 将本项目改造成绕过 Verity JE 授权或收费的模式
本项目采用 MIT 许可证,全文见仓库根目录的 LICENSE.txt。
Copyright (c) 2026 CreeperBoy-CB
你可以自由使用、修改、再发布本项目的代码,只需在副本中保留上述版权声明与
许可声明。
注意本项目的依赖各有各的许可证,不在 MIT 覆盖范围内:
| 依赖 | 许可证 |
|---|---|
| Forge | LGPL 2.1 |
| Yet Another Config Lib | LGPL 3.0-or-later |
| Modpack Helper | MIT(本项目) |
| Verity JE | All Rights Reserved |
Verity JE 采用 All Rights Reserved,本项目没有获得其作者的授权。 本项目与它的交互方式(运行时翻译、反射钩子、读写配置)以及相关风险说明见上一节。