Verity Mod Ollama Setup Guide

Why You Need Ollama

Verity’s AI runs locally through Ollama — there’s no cloud API, no internet required, no API keys to manage. Everything stays on your machine. This is how it works:

• Your conversations never leave your computer
• Works offline after you’ve downloaded the model
• No rate limits or usage caps
• Completely free
• You can use any compatible LLM you want

---

System Requirements

Minimum specs

• RAM: 8GB (16GB if you want good performance)
• Storage: 5GB free for the model files
• CPU: Modern multi-core processor (Intel i5/AMD Ryzen 5 or better)
• OS: Windows 10+, macOS 12+, or Linux (Ubuntu 20.04+)

What you’ll actually want

• RAM: 16GB+
• GPU: NVIDIA with 4GB+ VRAM (makes a huge difference in speed)
• Storage: SSD for faster model loading
• CPU: Intel i7/AMD Ryzen 7 or better

---

Step 1: Install Ollama

Windows

1. Download Ollama from https://ollama.com/download
2. Run the installer (OllamaSetup.exe)
3. Follow the installation wizard
4. Ollama will start automatically

Verify it’s working:

ollama --version

macOS

1. Download from https://ollama.com/download
2. Open the .dmg file
3. Drag Ollama to Applications folder
4. Launch Ollama from Applications

Verify it’s working:

ollama --version

Linux

Ubuntu/Debian:

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

Verify it’s working:

ollama --version

---

Step 2: Download an AI Model

Recommended models for Verity

Model	Size	Speed	Quality	Best for
llama3.2:3b	2.0 GB	Fast	Good	Low-end systems
llama3.1:8b	4.7 GB	Medium	Better	Balanced performance
mistral:7b	4.1 GB	Medium	Good	General use
codellama:7b	3.8 GB	Medium	Good	Technical responses
llama3.1:70b	40 GB	Slow	Best	High-end systems

Download your first model

For most users (balanced):

ollama pull llama3.1:8b

For low-end systems:

ollama pull llama3.2:3b

For high-end systems:

ollama pull llama3.1:70b

Check what you’ve downloaded:

ollama list

You should see your model in the list.

---

Step 3: Configure Verity to Use Ollama

Find the mod configuration

1. Open Minecraft
2. Load a world with Verity installed
3. Press Esc to open menu
4. Go to Mods → Verity Mod → Config

Or manually edit: .minecraft/config/verity.toml

Configuration settings

# AI Provider Settings
ai_provider = "ollama"
ollama_url = "http://localhost:11434"
ollama_model = "llama3.1:8b"

# Performance Settings
ollama_timeout = 30000  # 30 seconds timeout
ollama_max_tokens = 150  # Max response length
ollama_temperature = 0.7  # Response creativity (0.0-1.0)

What each setting does

ai_provider

• Set to "ollama" — that’s it, no other options

ollama_model

• Must match exactly what you downloaded
• Check with ollama list
• Examples: llama3.1:8b, llama3.2:3b, mistral:7b

ollama_temperature

• 0.0 - Consistent, predictable responses
• 0.7 - Balanced creativity (recommended)
• 1.0 - Maximum creativity, less predictable

---

Step 4: Start Ollama

Windows

Ollama should start automatically. If it doesn’t:

ollama serve

Keep this terminal open while you’re playing.

macOS

Ollama runs as a background service. Check if it’s running:

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

Should return JSON with your models.

Linux

Start the Ollama service:

# Start the service
systemctl start ollama

# Enable auto-start on boot
systemctl enable ollama

# Check if it's running
systemctl status ollama

---

Step 5: Test the Connection

Verify Ollama is running

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

Expected response:

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

Test the model directly

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

Should return an AI response in JSON format.

Test in Minecraft

1. Launch Minecraft with Verity mod
2. Load a world
3. Walk up to the Verity entity
4. Use a chat command (e.g., /verity hello)
5. Should get a response from Ollama

---

Performance Optimization

GPU Acceleration (NVIDIA)

If you have an NVIDIA GPU, Ollama will use it automatically. Check if it’s working:

nvidia-smi

You should see the ollama process using GPU memory.

Force GPU usage

If Ollama isn’t using your GPU:

# Linux/macOS
export OLLAMA_GPU_LAYERS=99

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

Optimize for low-end systems

Use a smaller model:

ollama pull llama3.2:3b

Reduce context size: In .minecraft/config/verity.toml:

ollama_max_tokens = 100
ollama_temperature = 0.5

Close background apps:

• Web browsers (especially Chrome)
• Video players
• Other games

Optimize for high-end systems

Use a larger model:

ollama pull llama3.1:70b

Increase context size:

ollama_max_tokens = 300
ollama_temperature = 0.8

Enable streaming:

ollama_stream = true

---

Troubleshooting Ollama

Error: “Connection refused”

Problem: Ollama service isn’t running.

Fix:

# Start Ollama
ollama serve

# Or on Linux
systemctl start ollama

Error: “Model not found”

Problem: Model name doesn’t match what you downloaded.

Fix:

# List your models
ollama list

# Update config with the exact name
# Example: llama3.1:8b (not llama3.1 or llama3)

Error: “Timeout”

Problem: Model too large or system too slow.

Fix:

1. Use a smaller model: ollama pull llama3.2:3b
2. Increase timeout in config: ollama_timeout = 60000
3. Close background applications
4. Give Minecraft more RAM

Issue: Very slow responses

Problem: Running on CPU instead of GPU.

Fix:

1. Check GPU: nvidia-smi (should show ollama process)
2. Update GPU drivers
3. Set GPU layers: export OLLAMA_GPU_LAYERS=99
4. Use a smaller model

Issue: Out of memory

Problem: Model too large for your RAM.

Fix:

1. Use a smaller model
2. Close background applications
3. Increase system swap space (Linux)
4. Upgrade RAM

---

Advanced Configuration

Custom models

Create a custom model with specific personality:

# Create 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

# Build custom model
ollama create verity-custom -f VerityCustom

# Use in Minecraft
# Set ollama_model = "verity-custom" in config

Multiple models

Switch between models easily:

# Download multiple models
ollama pull llama3.1:8b
ollama pull mistral:7b
ollama pull codellama:7b

# List all models
ollama list

# Switch in Minecraft config
# Just change ollama_model setting

Network configuration

Change Ollama port:

export OLLAMA_HOST=0.0.0.0:8080
ollama serve

Then update Minecraft config:

ollama_url = "http://localhost:8080"

Allow remote connections:

export OLLAMA_HOST=0.0.0.0:11434
ollama serve

---

Best Practices

1. Start with smaller models — Test with llama3.2:3b before trying larger ones
2. Monitor system resources — Watch RAM and CPU usage
3. Keep models updated — Run ollama pull [model] regularly
4. Backup configs — Save your verity.toml settings
5. Test offline — Verify Ollama works without internet
6. Use GPU if available — Significantly faster responses
7. Adjust temperature — Lower for consistency, higher for creativity

---

Getting Help

Ollama Documentation

• Official docs: https://ollama.com/docs
• GitHub: https://github.com/ollama/ollama
• Discord: https://discord.gg/ollama

Verity Mod Support

• GitHub issues: https://github.com/varmint/Verity/issues
• Check troubleshooting guide

Community Resources

• Reddit: r/Ollama
• Minecraft forums
• YouTube tutorials

---

Still Need Help?

---

Last updated: 2026-07-26 | Tested with Ollama v0.3.0 and Verity Mod v1.0.0