Verity Mod Ollama 完整设置指南

Ollama 设置分步指南 — 安装 Ollama、配置本地 AI 模型、优化性能、排查连接问题，让 Verity Mod AI 在你的电脑上跑起来。

为什么用 Ollama 而不是默认 AI？

Verity 支持两种 AI 模式：云端（Groq/OpenRouter，需要 API Key）和本地（Ollama）。本指南讲的是本地模式，好处如下：

  • yes 完全隐私 — AI 在本地运行，数据不会离开你的电脑
  • yes 无需联网 — 初次设置完成后即可离线使用
  • yes 无 API 限制 — 无限次响应，没有频率限制
  • yes 自定义模型 — 可使用任何兼容的大语言模型
  • yes 更低延迟 — 在高性能硬件上响应更快
  • yes 完全免费 — 无需支付 API 费用

系统要求

最低配置

  • 内存： 8GB（推荐 16GB）
  • 存储： 5GB 可用空间（用于存放模型文件）
  • CPU： 现代多核处理器（Intel i5 / AMD Ryzen 5 或更好）
  • 操作系统： Windows 10+、macOS 12+ 或 Linux（Ubuntu 20.04+）

推荐配置（流畅运行）

  • 内存： 16GB 以上
  • GPU： NVIDIA 显卡，4GB+ 显存（可选，但会显著加速）
  • 存储： SSD（模型加载更快）
  • CPU： Intel i7 / AMD Ryzen 7 或更好

第一步：安装 Ollama

Windows 安装

  1. 从 https://ollama.com/download 下载 Ollama
  2. 运行安装程序（OllamaSetup.exe）
  3. 按照安装向导完成安装
  4. Ollama 会自动启动

验证安装：

ollama --version

macOS 安装

  1. 从 https://ollama.com/download 下载
  2. 打开 .dmg 文件
  3. 将 Ollama 拖到「应用程序」文件夹
  4. 从「应用程序」启动 Ollama

验证安装：

ollama --version

Linux 安装

Ubuntu / Debian：

curl -fsSL https://ollama.com/install.sh | sh

验证安装：

ollama --version

第二步：下载 AI 模型

Verity 推荐模型

模型大小速度质量适合场景
llama3.2:3b2.0 GB⚡⚡⚡良好低配电脑
llama3.1:8b4.7 GB⚡⚡较好均衡之选
mistral:7b4.1 GB⚡⚡良好日常使用
codellama:7b3.8 GB⚡⚡良好技术类回答
llama3.1:70b40 GB⚡最佳高配电脑

下载你的第一个模型

大多数用户推荐（性能与质量平衡）：

ollama pull llama3.1:8b

低配电脑：

ollama pull llama3.2:3b

高配电脑（最佳质量）：

ollama pull llama3.1:70b

查看已下载的模型：

ollama list

你应该能在列表中看到已下载的模型。

第三步：配置 Verity Mod 使用 Ollama

找到 Mod 配置

  1. 打开 Minecraft
  2. 加载一个安装了 Verity 的存档
  3. 按 Esc 打开菜单
  4. 进入 Mods → Verity Mod → Config

配置项说明

在模组的 AI 设置里选择 Ollama 作为提供方，模型名填你拉取的完整名称（用 ollama list 查，例如 llama3.1:8b；只写 llama3.1 匹配不上）。Ollama 地址保持默认（http://localhost:11434）。

其余配置项（Day Count、True Darkness 等）控制的是 Verity 的行为，与 AI 连接无关：见故障排除指南。

Windows

Ollama 应该会自动启动。如果没有：

# 启动 Ollama 服务
ollama serve

玩 Minecraft 时保持此终端窗口打开。

macOS

Ollama 作为后台服务运行。验证是否在运行：

curl http://localhost:11434/api/tags

应该返回包含你模型的 JSON 数据。

Linux

启动 Ollama 服务：

# 启动服务
systemctl start ollama

# 设置开机自启
systemctl enable ollama

# 检查状态
systemctl status ollama

第五步：测试连接

验证 Ollama 是否运行

curl http://localhost:11434/api/tags

预期响应：

{
  "models": [
    {
      "name": "llama3.1:8b",
      "size": 4700000000,
      "digest": "..."
    }
  ]
}

测试模型响应

curl http://localhost:11434/api/generate -d '{
  "model": "llama3.1:8b",
  "prompt": "Hello, how are you?",
  "stream": false
}'

应该返回 AI 响应的 JSON 数据。

在 Minecraft 中测试

  1. 启动安装了 Verity mod 的 Minecraft
  2. 加载一个存档
  3. 靠近 Verity 实体
  4. 跟 Verity 打个招呼（按对话键或用语音输入）
  5. 应该收到来自 Ollama 的响应

性能优化

GPU 加速（NVIDIA）

如果你有 NVIDIA GPU，Ollama 会自动使用它。验证方式：

# 查看 GPU 使用情况
nvidia-smi

你应该能看到 ollama 进程正在使用显存。

强制使用 GPU

如果 Ollama 没有使用 GPU：

# 设置环境变量（Linux / macOS）

# Windows PowerShell
ollama serve

低配电脑优化

使用更小的模型：

ollama pull llama3.2:3b

限制上下文窗口：

关闭后台应用：

  • 网页浏览器（尤其是 Chrome）
  • 视频播放器
  • 其他游戏

高配电脑优化

使用更大的模型：

ollama pull llama3.1:70b

增加上下文长度：

启用流式输出：

排查 Ollama 问题

错误：「Connection refused」

原因： Ollama 服务未运行

解决方法：

# 启动 Ollama
ollama serve

# 或在 Linux 上
systemctl start ollama

错误：「Model not found」

原因： 模型名称不匹配

解决方法：

# 列出可用模型
ollama list

# 使用准确的模型名称更新配置
# 例如：llama3.1:8b（不是 llama3.1 或 llama3）

错误：「Timeout」

原因： 模型太大或系统太慢

解决方法：

  1. 使用更小的模型：ollama pull llama3.2:3b
  2. 关闭后台应用
  3. 给 Minecraft 分配更多内存

问题：响应非常慢

原因： 在使用 CPU 而不是 GPU

解决方法：

  1. 验证 GPU：nvidia-smi（应该显示 ollama 进程）
  2. 更新 GPU 驱动
  3. 使用更小的模型

问题：内存不足错误

原因： 模型太大，超出可用内存

解决方法：

  1. 使用更小的模型
  2. 关闭后台应用
  3. 增加系统交换空间（Linux）
  4. 升级内存

高级配置

自定义模型

创建具有特定个性的自定义模型：

# 创建 Modelfile
cat > VerityCustom <<EOF
FROM llama3.1:8b
SYSTEM "You are Verity, a helpful AI companion in Minecraft. Keep responses brief and friendly."
PARAMETER temperature 0.7
PARAMETER num_ctx 2048
EOF

# 构建自定义模型
ollama create verity-custom -f VerityCustom

# 在 Minecraft 中使用
# 在模组 AI 设置里把模型名设为 "verity-custom"

多模型切换

轻松在不同模型之间切换：

# 下载多个模型
ollama pull llama3.1:8b
ollama pull mistral:7b
ollama pull codellama:7b

# 列出所有模型
ollama list

# 在 Minecraft 配置中切换
# 只需在 AI 设置里改模型名

网络配置

更改 Ollama 端口：

# 设置自定义端口
export OLLAMA_HOST=0.0.0.0:8080
ollama serve

然后更新 Minecraft 配置：

允许远程连接：

# 允许其他设备连接
export OLLAMA_HOST=0.0.0.0:11434
ollama serve

对比：Ollama vs Ollama

特性Ollama（本地）Ollama（云端）
隐私yes 完全隐私no 数据发送到云端
联网yes 无需联网no 需要联网
费用yes 免费yes 免费额度，之后收费
速度⚡ 取决于硬件⚡⚡⚡ 非常快
质量starstarstarstar 良好starstarstarstarstar 优秀
设置no 较复杂yes 简单
可靠性yes 始终可用no 可能出现 API 故障
自定义yes 完全可控no 受限

最佳实践

  1. 从小模型开始 — 先用 llama3.2:3b 测试，再尝试更大的模型
  2. 监控系统资源 — 注意内存和 CPU 使用情况
  3. 保持模型更新 — 定期运行 ollama pull [模型名]
  4. 测试离线功能 — 验证 Ollama 在无网络时也能工作
  5. 尽量使用 GPU — 响应速度会显著提升
  6. 调整 temperature — 追求稳定就调低，追求创意就调高

获取帮助

Ollama 文档

Verity Mod 支持

社区资源

  • Reddit：r/Ollama
  • Minecraft 论坛
  • YouTube 教程

还需要帮助？

最后更新：2026-07-26 | 基于 Ollama v0.3.0 和 Verity Mod v1.0.0 测试

By Verity Mod Hub Team · Last updated: July 2026