Verity Mod 故障排除 - 解决常见问题

常见问题快速修复

问题：模组在 Minecraft 中不显示

解决方法：

1. 确认安装了正确版本（仅支持 Java 版）
2. 检查 Forge 版本是否满足模组要求
3. 确保 .jar 文件放在正确的 mods 文件夹中
4. 完全重启 Minecraft

问题：AI 功能无法使用

解决方法：

1. 检查网络连接（AI 功能需要联网）
2. 确认 Ollama API 运行正常（status.ollama.com）
3. 更新到最新模组版本
4. 检查模组配置文件

问题：性能问题 / 卡顿

解决方法：

1. 在配置中降低 AI 响应频率
2. 减少渲染距离
3. 关闭后台程序
4. 为 Minecraft 分配更多内存（至少 4GB）

---

按问题类型详细排查

安装问题

错误：“Mod not found”（未找到模组）

原因： 安装路径不正确或版本不匹配

修复：

1. 打开 Minecraft 文件夹：%appdata%\.minecraft（Windows）或 ~/Library/Application Support/minecraft（Mac）
2. 确认文件位于：.minecraft/mods/verity-1.0.0.jar
3. 检查 Forge 版本：必须与模组要求匹配
4. 重启 Minecraft（不要只是重新加载）

错误：“Missing dependency”（缺少依赖）或 “Forge version mismatch”（Forge 版本不匹配）

原因： 安装了错误的 Forge 版本

修复：

1. 查看模组页面获取所需 Forge 版本
2. 打开 Minecraft 启动器
3. 进入”安装”选项卡
4. 编辑你的 Forge 配置
5. 将 Forge 更新到所需版本
6. 保存并重启

错误：游戏启动时崩溃

原因： 模组冲突或 Java 版本不兼容

修复：

1. 暂时移除所有其他模组
2. 仅安装 Verity 进行测试
3. 如果正常运行，逐一添加回其他模组
4. 检查 Java 版本：必须是 Java 17 或更高版本
5. 更新显卡驱动

---

AI 连接问题

错误：“Failed to connect to AI service”（AI 服务连接失败）

原因： 网络连接或 API 问题

修复：

1. 测试网络连接（尝试打开网页）
2. 查看 Ollama API 状态：https://status.ollama.com
3. 确认防火墙未阻止 Minecraft
4. 如使用 VPN，尝试关闭
5. 重启路由器/调制解调器

错误：“AI responses too slow”（AI 响应过慢）

原因： 网络延迟或 API 过载

修复：

1. 关闭占用带宽的应用程序
2. 如使用 WiFi，改为有线连接
3. 稍后再试（API 可能过载）
4. 检查模组设置中的响应超时时间
5. 考虑使用离线模式（如可用）

错误：“AI not responding to commands”（AI 不响应命令）

原因： 命令语法错误或冷却时间未到

修复：

1. 确认命令格式（查看模组文档）
2. 检查 AI 是否在冷却中（等待 10-30 秒）
3. 确保你与实体距离足够近
4. 尝试不同的命令变体
5. 查看聊天日志中的错误信息

---

性能问题

问题：安装 Verity 后 FPS 降低

原因： 实体渲染开销

修复：

1. 打开模组配置：.minecraft/config/verity.toml
2. 将 “entity_render_distance” 降低到 32 或更低
3. 将 “ai_update_frequency” 降低到 20（ticks）
4. 关闭粒子效果
5. 分配更多内存：在启动器设置中使用 -Xmx4G

问题：内存占用过高

原因： AI 处理和世界数据加载

修复：

1. 增加 Minecraft 内存分配：
   • 打开启动器 → 安装 → 编辑
   • JVM 参数：-Xmx4G（8GB 以上系统可用 -Xmx6G）
2. 关闭后台应用程序
3. 在视频设置中降低渲染距离
4. 在模组配置中降低 AI 复杂度

问题：世界损坏或存档错误

原因： 模组冲突或不当关闭

修复：

1. 立即备份你的世界
2. 暂时移除 Verity 模组
3. 在原版 Minecraft 中加载世界
4. 如果正常加载，说明是模组导致的问题
5. 重新安装 Verity 并从备份恢复
6. 在 GitHub 上提交问题报告并附上崩溃日志

---

兼容性问题

问题：与 [特定模组] 不兼容

原因： 模组冲突

修复：

1. 查看 Verity 模组页面上的已知不兼容列表
2. 将两个模组都更新到最新版本
3. 尝试让 Verity 在其他模组之后加载
4. 在 GitHub 上报告冲突并提供详细信息
5. 如该模组必不可少，考虑使用替代模组

问题：在服务器上无法使用

原因： 服务器端限制

修复：

1. 确认服务器允许客户端模组
2. 查看服务器是否有模组黑名单
3. 联系服务器管理员获取权限
4. 部分服务器会屏蔽 AI 聊天功能
5. 在单人模式中测试以确认模组正常

问题：贴图 / 资源包冲突

原因： 资源包覆盖了模组贴图

修复：

1. 暂时禁用资源包
2. 使用默认贴图测试
3. 如果恢复正常，说明是资源包的问题
4. 联系资源包作者
5. 如有 Verity 专用资源包，请使用

---

平台特定问题

Windows

问题：杀毒软件阻止模组

修复：

1. 将 Minecraft 文件夹添加到杀毒软件白名单
2. 将 .minecraft/mods 目录加入白名单
3. 使用 Windows Defender 排除项：

   设置 → 更新和安全 → Windows 安全中心
   → 病毒和威胁防护 → 管理设置
   → 排除项 → 添加排除项 → 文件夹
   → 选择 .minecraft 文件夹

问题：文件路径过长

修复：

1. 将 Minecraft 安装目录移到更短的路径
2. 使用：C:\Games\Minecraft，避免过深的目录层级
3. 如有需要，在 Windows 中启用长路径支持

Mac

问题：权限被拒绝

修复：

1. 检查文件权限：

   chmod 755 ~/Library/Application\ Support/minecraft/mods/

2. 如有需要，以管理员身份运行 Minecraft
3. 临时关闭 Gatekeeper（不推荐）

问题：找不到 Java

修复：

1. 从 Adoptium 安装 Java 17
2. 设置 JAVA_HOME 环境变量
3. 在 Minecraft 启动器中更新 Java 路径

Linux

问题：模组未加载

修复：

1. 检查文件权限：

   ls -la ~/.minecraft/mods/
   chmod 644 ~/.minecraft/mods/verity-*.jar

2. 确认 Java 版本：

   java -version

3. 查看启动器日志中的错误信息

---

配置指南

位置：.minecraft/config/verity.toml

# AI Settings
ai_enabled = true
ai_response_delay = 100  # milliseconds
ai_max_response_length = 200

# Entity Settings
entity_render_distance = 64
entity_follow_distance = 3
entity_despawn_time = -1  # -1 = never despawn

# Performance
update_frequency = 10  # ticks (20 = 1 second)
particle_effects = true
sound_effects = true

# Advanced
debug_mode = false
log_ai_conversations = false

低配置电脑推荐设置

ai_response_delay = 500
entity_render_distance = 32
update_frequency = 20
particle_effects = false
sound_effects = false

---

获取帮助

求助前请先确认

1. 查阅本故障排除指南
2. 搜索 GitHub Issues
3. 更新到最新模组版本
4. 仅安装 Verity 进行测试
5. 收集崩溃日志

如何提交问题报告

1. 前往：https://github.com/varmint/Verity/issues
2. 点击 “New Issue”
3. 请包含以下信息：
   • Minecraft 版本
   • Forge 版本
   • 模组版本
   • 操作系统
   • 崩溃日志（如适用）
   • 复现步骤
   • 预期行为与实际行为

日志文件位置

• 崩溃日志： .minecraft/crash-reports/
• 最新日志： .minecraft/logs/latest.log
• 模组配置： .minecraft/config/verity.toml

---

常见错误信息

错误信息	原因	解决方法
”Missing dependency: forge”	Forge 版本错误	安装所需 Forge 版本
”Failed to initialize AI”	无网络 / API 问题	检查网络，等待后重试
”Entity rendering failed”	图形问题	更新驱动，降低设置
”Config file corrupted”	异常关闭	删除配置文件，重启 Minecraft
”Version mismatch”	模组版本错误	下载对应 MC 版本的正确文件

---

预防建议

1. 安装前备份世界

   将 .minecraft/saves/[世界名称] 复制到备份位置

2. 在独立实例中测试模组

   • 创建新的 Minecraft 安装
   • 先测试模组，再添加到主世界

3. 保持模组更新

   • 每周检查更新
   • 更新前阅读更新日志

4. 阅读模组文档

   • 查看系统要求
   • 了解已知问题
   • 严格按照安装说明操作

---

仍然需要帮助？

---

最后更新：2026-07-26 | 适用于 Minecraft 1.20.1+ 的 Verity Mod v1.0.0