VerityAI allows players to chat directly with an AI assistant inside Minecraft with support for multiple AI models, conversation memory, commands, and server integrations.

✨ Features

• 💬 Chat with AI directly in-game
• 🧠 Conversation memory system
• 🔄 Automatic API key fallback
• 🎭 Multiple personality presets
• 📊 Usage statistics
• 🗺️ In-game mini-map support
• 📝 Personal reminders and tasks
• 🎯 AI-generated quests
• 📚 In-game tutorials and help
• 💡 Player feedback and correction system
• 🔌 Integration with popular server plugins

📥 Installation

1. Download the latest VerityAI.jar
2. Place the jar file into your server's:

plugins/

folder.

1. Start or restart your Paper server.
2. VerityAI will generate its default configuration:

plugins/VerityAI/config.yml

1. Add your OpenRouter API key to the configuration file.
2. Restart your server or use:

/verity reload

🔑 Getting an OpenRouter API Key

1. Go to OpenRouter and create an account or sign in.
2. Open the Keys section.
3. Click Create Key.
4. Copy your generated API key.
5. Add it to config.yml:

ai:
  api-keys:
    - "sk-or-v1-your-key-here"

You can add multiple API keys.

VerityAI automatically switches to another key if the current key fails or reaches its rate limit.

Some OpenRouter models are free, while stronger models may require credits.

📜 Commands

Command	Description
/verity reload	Reload configuration
/verity clear [player]	Clear conversation memory
/verity info	Show plugin information
/verity toggle	Enable or disable Verity
/verity personality [name]	Change AI personality preset
/verity owner [player]	View or set server owner
/verity map	Show in-chat mini-map
/verity stats	Show usage statistics
/verity model [name]	View or switch AI model
/verity task <add|remove|list>	Manage personal reminders
/verity quest	Generate a random quest
/verity tutorial <topic>	Get in-game help
/verity feedback <good|bad> [correction]	Submit AI feedback

⚙️ Requirements

• Paper (or compatible forks) 1.21+
• Java 21+
• OpenRouter API key

🔌 Soft Dependencies

VerityAI can integrate with these plugins if installed:

• PlaceholderAPI
• Vault
• LuckPerms
• Essentials

All dependencies are optional. VerityAI works without them.

⚙️ Configuration

Main configuration file:

plugins/VerityAI/config.yml

You can customize:

• AI models
• API keys
• Personality presets
• Plugin behavior
• Server settings

📊 Metrics

VerityAI uses bStats for anonymous usage statistics (server count, versions, feature usage — never anything personal). Opt out anytime via plugins/bStats/config.yml.

🛠️ Building from source

mvn clean package

The finished jar is written to target/VerityAI.jar.

📜 License

VerityAI is free and open-source software licensed under the GNU General Public License v3.0 (GPL-3.0).

You are free to:

• ✅ Use VerityAI for personal or commercial purposes
• ✅ Study and modify the source code
• ✅ Fork and redistribute modified versions
• ✅ Distribute copies of the plugin

When redistributing VerityAI or a modified version, you must comply with the terms of the GPL-3.0 license.

The full license text is available in the LICENSE file.

Copyright © 2026 TheROMZ52

🚀 Support

If you find a bug or have a suggestion, please create an issue or contact the developer.

Enjoy using VerityAI! 🤖