Verity Mod Ollama 完整设置指南

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

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

Verity Mod 默认使用 Ollama 的云端 API 来提供 AI 响应。虽然方便，但改用 Ollama 有以下好处：

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

系统要求

最低配置

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

第一步：安装 Ollama

Windows 安装

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

验证安装：

ollama --version

macOS 安装

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

验证安装：

ollama --version

Linux 安装

Ubuntu / Debian：

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

验证安装：

ollama --version

第二步：下载 AI 模型

Verity 推荐模型

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

下载你的第一个模型

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

ollama pull llama3.1:8b

低配电脑：

ollama pull llama3.2:3b

高配电脑（最佳质量）：

ollama pull llama3.1:70b

查看已下载的模型：

ollama list

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

第三步：配置 Verity Mod 使用 Ollama

找到 Mod 配置

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

或者手动编辑配置文件：.minecraft/config/verity.toml

配置项说明

# AI 提供商设置
ai_provider = "ollama"  # 从 "ollama" 改为 "ollama"
ollama_url = "http://localhost:11434"  # Ollama 默认地址
ollama_model = "llama3.1:8b"  # 你下载的模型名称

# 性能设置
ollama_timeout = 30000  # 30 秒超时（毫秒）
ollama_max_tokens = 150  # 最大响应长度
ollama_temperature = 0.7  # 响应创造性（0.0-1.0）

# 回退设置
use_ollama_fallback = true  # Ollama 失败时使用 Ollama
ollama_api_key = ""  # 你的 Ollama API 密钥（如果使用回退）

关键配置详解

ai_provider

"ollama" — 使用本地 Ollama
"ollama" — 使用云端 Ollama API（默认）

ollama_model

必须与 ollama list 中显示的模型名称完全一致
示例：llama3.1:8b、llama3.2:3b、mistral:7b

ollama_temperature

0.0 — 确定性响应，稳定一致
0.7 — 平衡创造性（推荐）
1.0 — 最大创造性，结果更不可预测

use_ollama_fallback

true — Ollama 失败时回退到 Ollama（需要 API 密钥）
false — 仅使用 Ollama，不回退

第四步：启动 Ollama 服务

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 中测试

启动安装了 Verity mod 的 Minecraft
加载一个存档
靠近 Verity 实体
使用聊天命令（例如 /verity hello）
应该收到来自 Ollama 的响应

性能优化

GPU 加速（NVIDIA）

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

# 查看 GPU 使用情况
nvidia-smi

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

强制使用 GPU

如果 Ollama 没有使用 GPU：

# 设置环境变量（Linux / macOS）
export OLLAMA_GPU_LAYERS=99

# Windows PowerShell
$env:OLLAMA_GPU_LAYERS="99"
ollama serve

低配电脑优化

使用更小的模型：

ollama pull llama3.2:3b

限制上下文窗口： 在 .minecraft/config/verity.toml 中：

ollama_max_tokens = 100  # 更短的响应
ollama_temperature = 0.5  # 减少处理量

关闭后台应用：

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

高配电脑优化

使用更大的模型：

ollama pull llama3.1:70b

增加上下文长度：

ollama_max_tokens = 300  # 更长的响应
ollama_temperature = 0.8  # 更有创造性

启用流式输出：

ollama_stream = true  # 生成时实时显示响应

排查 Ollama 问题

错误：「Connection refused」

原因： Ollama 服务未运行

解决方法：

# 启动 Ollama
ollama serve

# 或在 Linux 上
systemctl start ollama

错误：「Model not found」

原因： 模型名称不匹配

解决方法：

# 列出可用模型
ollama list

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

错误：「Timeout」

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

解决方法：

使用更小的模型：ollama pull llama3.2:3b
在配置中增加超时时间：ollama_timeout = 60000
关闭后台应用
给 Minecraft 分配更多内存

问题：响应非常慢

原因： 在使用 CPU 而不是 GPU

解决方法：

验证 GPU：nvidia-smi（应该显示 ollama 进程）
更新 GPU 驱动
设置 GPU 层数：export OLLAMA_GPU_LAYERS=99
使用更小的模型

问题：内存不足错误

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

解决方法：

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

高级配置

自定义模型

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

# 创建 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 中使用
# 在配置中设置 ollama_model = "verity-custom"

多模型切换

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

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

# 列出所有模型
ollama list

# 在 Minecraft 配置中切换
# 只需修改 ollama_model 设置

网络配置

更改 Ollama 端口：

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

然后更新 Minecraft 配置：

ollama_url = "http://localhost:8080"

允许远程连接：

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

对比：Ollama vs Ollama

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

最佳实践

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

获取帮助

Ollama 文档

Verity Mod 支持

GitHub Issues：https://github.com/varmint/Verity/issues
查看故障排除指南

社区资源

Reddit：r/Ollama
Minecraft 论坛
YouTube 教程

还需要帮助？

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

Verity Mod Ollama 完整设置指南

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

系统要求

最低配置

推荐配置（流畅运行）

第一步：安装 Ollama

Windows 安装

macOS 安装

Linux 安装

第二步：下载 AI 模型

Verity 推荐模型

下载你的第一个模型

第三步：配置 Verity Mod 使用 Ollama

找到 Mod 配置

配置项说明

关键配置详解

第四步：启动 Ollama 服务

Windows

macOS

Linux

第五步：测试连接

验证 Ollama 是否运行

测试模型响应

在 Minecraft 中测试

性能优化

GPU 加速（NVIDIA）

强制使用 GPU

低配电脑优化

高配电脑优化

排查 Ollama 问题

错误：「Connection refused」

错误：「Model not found」

错误：「Timeout」

问题：响应非常慢

问题：内存不足错误

高级配置

自定义模型

多模型切换

网络配置

对比：Ollama vs Ollama

最佳实践

获取帮助

Ollama 文档

Verity Mod 支持

社区资源

还需要帮助？