Guia completa de configuração do Ollama para Verity Mod

Por que usar o Ollama em vez da IA padrão?

O Verity Mod usa por padrão a API na nuvem do Ollama para as respostas de IA. Embora seja prático, usar o Ollama te dá:

• Privacidade total — A IA roda localmente, nenhum dado sai do seu computador
• Sem internet necessária — Funciona offline após a instalação inicial
• Sem limites de API — Respostas ilimitadas, sem restrição de frequência
• Modelos personalizados — Use qualquer LLM compatível
• Menor latência — Respostas mais rápidas em hardware potente
• Grátis — Sem custos de API

---

Requisitos do sistema

Requisitos mínimos

• RAM: 8 GB (16 GB recomendados)
• Armazenamento: 5 GB de espaço livre (para os arquivos dos modelos)
• CPU: Processador multicore moderno (Intel i5 / AMD Ryzen 5 ou superior)
• SO: Windows 10+, macOS 12+ ou Linux (Ubuntu 20.04+)

Recomendado para bom desempenho

• RAM: 16 GB ou mais
• GPU: NVIDIA com 4 GB+ de VRAM (opcional, mas notavelmente mais rápido)
• Armazenamento: SSD (carregamento de modelos mais rápido)
• CPU: Intel i7 / AMD Ryzen 7 ou superior

---

Passo 1: Instalar o Ollama

Instalação no Windows

1. Baixe o Ollama em https://ollama.com/download
2. Execute o instalador (OllamaSetup.exe)
3. Siga o assistente de instalação
4. O Ollama iniciará automaticamente

Verificar a instalação:

ollama --version

Instalação no macOS

1. Baixe em https://ollama.com/download
2. Abra o arquivo .dmg
3. Arraste o Ollama para a pasta Aplicativos
4. Inicie o Ollama a partir de Aplicativos

Verificar a instalação:

ollama --version

Instalação no Linux

Ubuntu / Debian:

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

Verificar a instalação:

ollama --version

---

Passo 2: Baixar um modelo de IA

Modelos recomendados para o Verity

Modelo	Tamanho	Velocidade	Qualidade	Ideal para
llama3.2:3b	2,0 GB	⚡⚡⚡	Boa	PCs mais modestos
llama3.1:8b	4,7 GB	⚡⚡	Melhor	Equilibrado
mistral:7b	4,1 GB	⚡⚡	Boa	Uso geral
codellama:7b	3,8 GB	⚡⚡	Boa	Respostas técnicas
llama3.1:70b	40 GB	⚡	A melhor	PCs potentes

Baixe seu primeiro modelo

Para a maioria dos usuários (equilíbrio desempenho/qualidade):

ollama pull llama3.1:8b

Para PCs mais modestos:

ollama pull llama3.2:3b

Para PCs potentes (qualidade máxima):

ollama pull llama3.1:70b

Ver modelos baixados:

ollama list

Você deve ver o modelo baixado na lista.

---

Passo 3: Configurar o Verity Mod para usar o Ollama

Encontrar a configuração do mod

1. Abra o Minecraft
2. Carregue um mundo com o Verity instalado
3. Pressione Esc para abrir o menu
4. Vá em Mods → Verity Mod → Config

Ou edite manualmente: .minecraft/config/verity.toml

Ajustes de configuração

# Ajustes do provedor de IA
ai_provider = "ollama"  # Mudar de "ollama" para "ollama"
ollama_url = "http://localhost:11434"  # Endereço padrão do Ollama
ollama_model = "llama3.1:8b"  # Nome do modelo baixado

# Ajustes de desempenho
ollama_timeout = 30000  # Timeout de 30 segundos (em milissegundos)
ollama_max_tokens = 150  # Comprimento máximo da resposta
ollama_temperature = 0.7  # Criatividade da resposta (0.0-1.0)

# Ajustes de fallback
use_ollama_fallback = true  # Usar Ollama se o Ollama falhar
ollama_api_key = ""  # Sua chave API do Ollama (se usar fallback)

Ajustes principais explicados

ai_provider

• "ollama" — Usar Ollama local
• "ollama" — Usar a API na nuvem do Ollama (padrão)

ollama_model

• Deve corresponder exatamente ao nome do modelo em ollama list
• Exemplos: llama3.1:8b, llama3.2:3b, mistral:7b

ollama_temperature

• 0.0 — Respostas determinísticas e consistentes
• 0.7 — Criatividade equilibrada (recomendado)
• 1.0 — Criatividade máxima, menos previsível

use_ollama_fallback

• true — Se o Ollama falhar, tentar com Ollama (requer chave API)
• false — Usar apenas Ollama, sem fallback

---

Passo 4: Iniciar o serviço Ollama

Windows

O Ollama deve iniciar automaticamente. Se não:

# Iniciar o serviço Ollama
ollama serve

Mantenha este terminal aberto enquanto joga Minecraft.

macOS

O Ollama roda como serviço em segundo plano. Verifique se está funcionando:

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

Deve retornar um JSON com seus modelos.

Linux

Iniciar o serviço Ollama:

# Iniciar serviço
systemctl start ollama

# Ativar início automático na inicialização
systemctl enable ollama

# Verificar status
systemctl status ollama

---

Passo 5: Testar a conexão

Verificar se o Ollama está funcionando

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

Resposta esperada:

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

Testar resposta do modelo

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

Deve retornar um JSON com a resposta da IA.

Testar no Minecraft

1. Inicie o Minecraft com o mod Verity
2. Carregue um mundo
3. Aproxime-se da entidade Verity
4. Use o comando de chat (ex: /verity hello)
5. Deve receber uma resposta do Ollama

---

Otimização de desempenho

Aceleração por GPU (NVIDIA)

Se você tem uma GPU NVIDIA, o Ollama vai usá-la automaticamente. Verificação:

# Verificar uso da GPU
nvidia-smi

Você deve ver o processo ollama usando memória da GPU.

Forçar uso da GPU

Se o Ollama não está usando a GPU:

# Definir variável de ambiente (Linux/macOS)
export OLLAMA_GPU_LAYERS=99

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

Otimizar para PCs mais modestos

Reduzir tamanho do modelo:

ollama pull llama3.2:3b

Limitar janela de contexto: No .minecraft/config/verity.toml:

ollama_max_tokens = 100  # Respostas mais curtas
ollama_temperature = 0.5  # Menos processamento

Fechar aplicativos em segundo plano:

• Navegadores web (especialmente Chrome)
• Reprodutores de vídeo
• Outros jogos

Otimizar para PCs potentes

Usar um modelo maior:

ollama pull llama3.1:70b

Aumentar contexto:

ollama_max_tokens = 300  # Respostas mais longas
ollama_temperature = 0.8  # Mais criativo

Ativar streaming:

ollama_stream = true  # Mostrar a resposta conforme é gerada

---

Solução de problemas do Ollama

Erro: «Connection refused»

Causa: O serviço Ollama não está funcionando

Solução:

# Iniciar Ollama
ollama serve

# Ou no Linux
systemctl start ollama

Erro: «Model not found»

Causa: O nome do modelo não corresponde

Solução:

# Listar modelos disponíveis
ollama list

# Atualizar a configuração com o nome exato do modelo
# Exemplo: llama3.1:8b (não llama3.1 nem llama3)

Erro: «Timeout»

Causa: Modelo grande demais ou sistema lento demais

Solução:

1. Use um modelo menor: ollama pull llama3.2:3b
2. Aumente o timeout na configuração: ollama_timeout = 60000
3. Feche aplicativos em segundo plano
4. Aloque mais RAM para o Minecraft

Problema: Respostas muito lentas

Causa: Usando CPU em vez de GPU

Solução:

1. Verifique a GPU: nvidia-smi (deve mostrar o processo ollama)
2. Atualize os drivers da GPU
3. Defina as camadas GPU: export OLLAMA_GPU_LAYERS=99
4. Use um modelo menor

Problema: Erros de memória insuficiente

Causa: Modelo grande demais para a RAM disponível

Solução:

1. Use um modelo menor
2. Feche aplicativos em segundo plano
3. Aumente o espaço de swap do sistema (Linux)
4. Faça upgrade da RAM

---

Configuração avançada

Modelos personalizados

Crie um modelo personalizado com personalidade específica:

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

# Construir modelo personalizado
ollama create verity-custom -f VerityCustom

# Usar no Minecraft
# Definir ollama_model = "verity-custom" na configuração

Múltiplos modelos

Alterne entre modelos facilmente:

# Baixar vários modelos
ollama pull llama3.1:8b
ollama pull mistral:7b
ollama pull codellama:7b

# Listar todos os modelos
ollama list

# Alternar na configuração do Minecraft
# Basta mudar o ajuste ollama_model

Configuração de rede

Mudar a porta do Ollama:

# Definir porta personalizada
export OLLAMA_HOST=0.0.0.0:8080
ollama serve

Depois atualize a configuração do Minecraft:

ollama_url = "http://localhost:8080"

Permitir conexões remotas:

# Permitir conexões de outros dispositivos
export OLLAMA_HOST=0.0.0.0:11434
ollama serve

---

Comparação: Ollama vs Ollama

Recurso	Ollama (local)	Ollama (nuvem)
Privacidade	Total	Dados enviados à nuvem
Internet	Não necessária	Necessária
Custo	Grátis	Nível grátis, depois pago
Velocidade	⚡ Depende do hardware	⚡⚡⚡ Muito rápido
Qualidade	Boa	Excelente
Configuração	Complexa	Simples
Confiabilidade	Sempre disponível	⚠️ Possíveis quedas da API
Personalização	Controle total	Limitada

---

Boas práticas

1. Comece com modelos menores — Teste com llama3.2:3b antes de tentar os maiores
2. Monitore os recursos do sistema — Fique de olho no uso de RAM e CPU
3. Mantenha os modelos atualizados — Rode ollama pull [modelo] regularmente
4. Faça backup das configurações — Salve seus ajustes do verity.toml
5. Teste offline — Verifique que o Ollama funciona sem internet
6. Use GPU se disponível — Respostas notavelmente mais rápidas
7. Ajuste a temperatura — Mais baixa para consistência, mais alta para criatividade

---

Obter ajuda

Documentação do Ollama

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

Suporte Verity Mod

• Issues no GitHub: https://github.com/varmint/Verity/issues
• Consulte o guia de solução de problemas

Recursos da comunidade

• Reddit: r/Ollama
• Fóruns de Minecraft
• Tutoriais no YouTube

---

Ainda precisa de ajuda?

---

Última atualização: 2026-07-26 | Testado com Ollama v0.3.0 e Verity Mod v1.0.0