Verity Mod Troubleshooting - Fix Common Issues

Quick Fixes for Common Problems

Mod doesn’t appear in Minecraft

Installed it but can’t see it? Here’s what usually fixes it:

1. Make sure you got the right version — Java Edition only, not Bedrock
2. Check your Forge version matches what the mod needs
3. Verify the .jar file is actually in your mods folder (not the parent directory)
4. Restart Minecraft completely, not just reload the world

Verity shows up but won’t talk

The sphere’s there but staying silent? That’s an Ollama problem.

1. Is Ollama actually running? Open a terminal and check
2. Did you pull the right model? Run ollama list to see what you’ve got
3. Update to the latest mod version — older ones might have compatibility issues
4. Check your mod config file for typos

Performance issues or lag

Game running slow after installing Verity? Try these:

1. Lower the AI response frequency in your config
2. Reduce render distance a bit
3. Close background apps eating up RAM
4. Give Minecraft more RAM — 4GB minimum, 6GB better

---

Detailed Troubleshooting by Issue Type

Installation Problems

Error: “Mod not found” in Minecraft

What’s wrong: Mod file in the wrong place or version mismatch.

How to fix:

1. Open Minecraft folder: %appdata%\.minecraft (Windows) or ~/Library/Application Support/minecraft (Mac)
2. Verify file is in: .minecraft/mods/verity-1.0.0.jar (not the parent folder)
3. Check Forge version: Must match what the mod requires
4. Restart Minecraft — not just reload, actually close and reopen

Error: “Missing dependency” or “Forge version mismatch”

What’s wrong: Wrong Forge version installed.

How to fix:

1. Check the mod page for the required Forge version
2. Open Minecraft Launcher
3. Go to “Installations” tab
4. Edit your Forge profile
5. Update Forge to the required version
6. Save and restart

Error: Game crashes on startup

What’s wrong: Mod conflict or Java version problem.

How to fix:

1. Remove all other mods temporarily
2. Test with only Verity installed
3. If it works, add mods back one by one until you find the culprit
4. Check Java version: Must be Java 17 or higher
5. Update graphics drivers if needed

---

Ollama Connection Issues

Error: “Failed to connect to Ollama”

What’s wrong: Ollama service not running or blocked.

How to fix:

1. Open a terminal and run ollama list — if it errors, Ollama isn’t running
2. Start Ollama: ollama serve
3. Check firewall isn’t blocking port 11434
4. If using a VPN, try disabling it
5. Restart your computer if all else fails

Error: “AI responses too slow”

What’s wrong: Ollama running on CPU instead of GPU, or model too large.

How to fix:

1. Close bandwidth-heavy apps (browsers, downloads)
2. Switch to a smaller model: ollama pull llama3.2:3b
3. Check if you have a GPU: ollama list should show GPU info
4. Wait and try again — Ollama might be loading the model
5. Consider using offline mode if available

Error: “AI not responding to commands”

What’s wrong: Command syntax wrong or Ollama overloaded.

How to fix:

1. Check the command format — look at mod documentation
2. Give it a moment — Ollama might be processing
3. Make sure you’re close enough to the Verity entity
4. Try different command variations
5. Check chat logs for error messages

---

Performance Problems

Issue: Low FPS after installing Verity

What’s wrong: The Verity entity is adding rendering overhead.

How to fix:

1. Open mod config: .minecraft/config/verity.toml
2. Reduce entity_render_distance to 32 or lower
3. Lower ai_update_frequency to 20 (ticks)
4. Turn off particle effects if enabled
5. Allocate more RAM: -Xmx4G in launcher settings

Issue: High RAM usage

What’s wrong: AI processing and world data both eating memory.

How to fix:

1. Give Minecraft more RAM:
   • Open Launcher → Installations → Edit
   • JVM Arguments: -Xmx4G (or -Xmx6G if you have 8GB+)
2. Close background apps (Chrome is a RAM hog)
3. Reduce render distance in video settings
4. Lower AI complexity in mod config

Issue: World corruption or save errors

What’s wrong: Mod conflict or bad shutdown.

How to fix:

1. Stop and backup your world right now
2. Remove Verity mod temporarily
3. Load the world in vanilla Minecraft
4. If it loads fine, the mod is the problem
5. Reinstall Verity and restore from backup
6. Report the issue on GitHub with crash logs

---

Compatibility Issues

Issue: Doesn’t work with [specific mod]

What’s wrong: Mod conflict.

How to fix:

1. Check the Verity mod page for known incompatibilities
2. Update both mods to their latest versions
3. Try loading Verity after the other mod (load order matters)
4. Report the conflict on GitHub with details
5. Use an alternative mod if this one’s critical

Issue: Doesn’t work on servers

What’s wrong: Server doesn’t allow client-side mods.

How to fix:

1. Ask if the server allows client-side mods
2. Check if there’s a mod blacklist
3. Contact the server admin for permission
4. Some servers block AI chat features specifically
5. Try singleplayer to verify the mod itself works

Issue: Texture or resource pack conflicts

What’s wrong: Resource pack overriding mod textures.

How to fix:

1. Disable resource packs temporarily
2. Test with default textures
3. If it works, the resource pack is the issue
4. Contact the resource pack creator
5. Look for a Verity-specific resource pack

---

Platform-Specific Issues

Windows

Issue: Antivirus blocking the mod

How to fix:

1. Add your Minecraft folder to antivirus exceptions
2. Whitelist the .minecraft/mods directory
3. Use Windows Defender exclusions:

   Settings → Update & Security → Windows Security
   → Virus & threat protection → Manage settings
   → Exclusions → Add exclusion → Folder
   → Select your `.minecraft` folder

Issue: File path too long

How to fix:

1. Move your Minecraft installation to a shorter path
2. Use something like C:\Games\Minecraft instead of deep nested folders
3. Enable long paths in Windows if needed

Mac

Issue: Permission denied errors

How to fix:

1. Check file permissions:

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

2. Run Minecraft as administrator if needed
3. Disable Gatekeeper temporarily (not recommended, but works)

Issue: Java not found

How to fix:

1. Install Java 17 from Adoptium
2. Set JAVA_HOME environment variable
3. Update your Minecraft Launcher Java path

Linux

Issue: Mod not loading

How to fix:

1. Check file permissions:

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

2. Verify Java version:

   java -version

3. Check launcher logs for error messages

---

Configuration Guide

Config file location: .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

Recommended settings for low-end PCs

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

---

Getting Help

Before asking for help

1. Check this troubleshooting guide first
2. Search GitHub issues — your problem might already be solved
3. Update to the latest mod version
4. Test with only Verity installed (no other mods)
5. Collect crash logs if applicable

How to report issues

1. Go to: https://github.com/varmint/Verity/issues
2. Click “New Issue”
3. Include:
   • Minecraft version
   • Forge version
   • Mod version
   • Operating system
   • Crash log (if you have one)
   • Steps to reproduce the problem
   • What you expected vs what actually happened

Where to find logs

• Crash logs: .minecraft/crash-reports/
• Latest log: .minecraft/logs/latest.log
• Mod config: .minecraft/config/verity.toml

---

Common Error Messages

Error Message	What It Means	How to Fix
”Missing dependency: forge”	Wrong Forge version	Install the required Forge version
”Failed to initialize Ollama”	Ollama not running or connection issue	Start Ollama, check connection
”Entity rendering failed”	Graphics problem	Update drivers, lower settings
”Config file corrupted”	Bad shutdown or file error	Delete config file, restart Minecraft
”Version mismatch”	Wrong mod version for your MC	Download the correct version

---

Prevention Tips

1. Backup worlds before installing

   Copy `.minecraft/saves/[world-name]` to a backup location

2. Test mods in a separate instance

   • Create a new Minecraft installation
   • Test the mod before adding it to your main world

3. Keep mods updated

   • Check for updates weekly
   • Read the changelog before updating

4. Read mod documentation

   • Check requirements before installing
   • Note any known issues
   • Follow installation instructions exactly

---

Still Need Help?

---

Last updated: 2026-07-26 | Covers Verity Mod v1.0.0 for Minecraft 1.20.1+