AIChat Plugin
AIChat is a sophisticated Minecraft plugin that integrates Ollama AI to provide context-aware chat responses and intelligent command execution within the game environment.

While optimized for Ollama, this plugin is compatible with any AI service that follows the Ollama API structure (standardized endpoints and JSON schema).

✨ Core Features
AI Integration

• Ollama Native: Connects seamlessly to local or remote Ollama servers.
• Broad Compatibility: Works with any Ollama-compatible API services.
• Dual Model Support: Configure a primary model and a secondary "Model2" (Basic AI) for fallback.
• Contextual Awareness: Utilizes recent chat history to provide human-like, relevant responses.

Multilingual Support

• Dual-Language System: The plugin's system messages and UI officially support English and Japanese.
• Universal AI Responses: The AI can detect and respond in virtually any language (e.g., Korean, Chinese, Arabic, Russian, Hindi), regardless of the system language.
• Seamless Interaction: The AI automatically adapts to the player's language for natural communication.

Version Compatibility

• Supported Versions: Minecraft 1.18 through 1.26.1 (Paper/Spigot).
• Adaptive Architecture: Features an internal adapter system to ensure stability across major Minecraft updates.

⚙️ Key Systems
User Management

• Usage Quotas: Configurable daily, weekly, and monthly AI interaction limits.
• Token Economy: Optional token-based tracking for usage control.
• VIP Privileges: Special access and higher limits for VIP users.
• Personal Toggle: Players can easily enable or disable their own AI interaction mode.

Technical Excellence

• Async Queue: Processes AI requests asynchronously to prevent server lag.
• Chat Logging: Robust management of conversation history.
• PlaceholderAPI: Integration for dynamic placeholders in other plugins.
• Real-time UI: Visual "Thinking" indicators during AI processing.

Commands
General Commands
Command Description
/ai [message] Send a direct message to the AI for processing
⚙️ Player Settings
Command Description
/ai settings command <true|yes|false|no> Toggle AI's ability to execute commands for you
/ai settings execution_mode auto Always allow AI command execution (No confirmation)
/ai settings execution_mode deny Always block AI command suggestions
/ai settings execution_mode confirm Require GUI confirmation before AI executes commands
‍ Admin Commands

• /ai admin token add <player> <amount> : Grant tokens to a player.
• /ai admin token remove <player> <amount> : Deduct tokens from a player.

Permissions

• ollamaplugin.use : Basic AI access (Default: Everyone)
• ollama.admin : Administrative control (Default: OP)

Quick Start

1. Install Ollama on your server or local machine.
2. Pull a Model: Download a compatible model (see recommendations below).
3. Start API: Ensure your Ollama API is accessible.
4. Configure: Update config.yml with your API endpoint and model names.
5. Restart: Reboot your Minecraft server and start chatting!

Recommended Models
Model Attributes Best For
gemma3:4b ⚖️ Balanced High-quality responses with moderate speed
llama3.2:3b ⚡ Lightweight Fast response times and minimal server impact
For Minecraft chat, we strongly recommend lightweight models. Heavy models may cause significant latency and increase AI queue wait times under high server load.

Technical Specifications

• Java Version: 21+
• Dependencies: Paper API, PlaceholderAPI (Optional), Gson
• Load Order: POSTWORLD
• Encoding: Full UTF-8 support for global language compatibility.

Support & Community
Need help with setup? Want to report a bug or suggest a feature? Join our community!



© 2026 AIChat Team. Bringing Intelligence to the Block.