Enzonic Emi (Formerly Enzonic AI)

Enzonic EMI

---

About

Enzonic EMI (Enzonic Minecraft Intelligence) is a powerful Minecraft plugin that integrates OpenAI-compatible AI APIs directly into your server. Players can chat with an intelligent assistant that understands Minecraft, provides helpful information, and even responds contextually to their in-game situation.

Features

- Formatted Messages - Context-aware AI that knows Minecraft gameplay - Formatted Messages - Command-only, private chat, or public chat responses - Formatted Messages - AI intelligently decides when to respond - Formatted Messages - Knows player username, location, game mode, and health - Formatted Messages - Remembers up to 15 messages for context - Formatted Messages - Pre-configured, encrypted API keys - Formatted Messages - OP commands to enable/disable plugin - Formatted Messages - Customize prefix, system prompt, and settings - Formatted Messages - Built-in protection against API abuse - Formatted Messages - Non-blocking requests for smooth gameplay - Formatted Messages - Beautiful colored messages

---

Installation

Requirements

- Java: 1.20.4 or higher - Java: Paper (recommended) or Spigot - Java: 17 or higher

Quick Install

1. Download the latest `enzonic-emi-x.x.x.jar` 2. Place it in your server's `plugins` folder 3. Restart your server 4. Done! The plugin works out of the box with built-in credentials

Configuration

Edit `plugins/EnzonicEMI/config.yml`:

```yaml

AI Response Mode: "command", "chat", or "player"

response-mode: "chat"

Chat prefix (command mode only)

chat-prefix: "&6[&eEMI&6] &f"

Customize AI behavior

system-prompt: "You are a helpful and friendly Minecraft assistant..."

API Configuration

API is pre-configured and cannot be modified

Conversation context

context: max-messages: 15 include-system: true

Rate limiting

rate-limit: cooldown: 2 max-per-minute: 30

Enable/disable plugin

enabled: true ```

---

Usage

Response Modes

Command Mode

Use `/ai <message>` to chat with the AI: ``` /ai How do I craft a diamond sword? [EMI] To craft a diamond sword, you need 2 diamonds and 1 stick... ```

Chat Mode (Default)

Chat normally and AI responds privately: ``` [Player] What's the best way to find diamonds? EMI: Mine at Y-level -58 or lower in the deepslate layer... ```

Player Mode

Chat normally and AI responds in public chat: ``` [Player] How do I enchant items? [EMI] To enchant items, you need an enchanting table with bookshelves... ```

Commands

| Command | Description | Permission | |---------|-------------|------------| | `/ai <message>` | Chat with AI | `enzonic.emi.use` | | `/aiclear` | Clear conversation history | `enzonic.emi.clear` | | `/emi <subcommand>` | Manage plugin (see below) | `enzonic.emi.admin` |

Admin Commands

| Command | Description | |---------|-------------| | `/emi enable` | Enable the AI plugin | | `/emi disable` | Disable the AI plugin | | `/emi status` | Check plugin status and configuration | | `/emi reload` | Reload plugin configuration |

Permissions

| Permission | Default | Description | |------------|---------|-------------| | `enzonic.emi.use` | `true` | Use AI chat and auto-response | | `enzonic.emi.clear` | `true` | Clear conversation history | | `enzonic.emi.admin` | `op` | Use admin commands |

---

AI Features

Context Awareness

The AI automatically knows: - Player username and display name - World and location - Game mode (Survival, Creative, etc.) - Health status - Last 15 messages in conversation

Smart Response Control

The AI uses `<no response>` to skip unnecessary messages: - Responds to: Questions, help requests, command inquiries - Skips: Greetings, simple statements, casual chat

This creates natural, helpful interactions without spam.

---

Configuration Options

Response Mode

- `player` - AI only responds to `/ai` commands - `player` - AI responds privately to regular chat (default) - `player` - AI responds publicly in chat

System Prompt

Customize how the AI behaves: ```yaml system-prompt: "You are a helpful Minecraft assistant..." ```

Conversation Context

```yaml context: max-messages: 15 # Messages to remember include-system: true # Include system prompt ```

Rate Limiting

```yaml rate-limit: cooldown: 2 # Seconds between requests max-per-minute: 30 # Max requests per player ```

---

Security

- Status Command - API keys are Base64 encoded - Status Command - Keys never visible in distribution - Status Command - Sensitive commands require OP - Status Command - Verify configuration safely

---

Troubleshooting

AI Not Responding?

1. Check `/emi status` to verify plugin is enabled 2. Check `response-mode` in config 3. Verify player has `enzonic.emi.use` permission

Wrong Response Type?

Change `response-mode` in config: - `command` - Only `/ai` commands - `chat` - Private responses - `player` - Public responses

Then run `/emi reload`

API Errors?

- Built-in credentials are pre-configured - Check console for specific error messages - Verify your server can reach the API endpoint

Plugin Won't Load?

- Ensure Minecraft 1.20.4+ (Paper recommended) - Verify Java 17+ is installed - Check console for error messages

Admin Commands Not Working?

- Ensure you are OP (operator) - Check you have `enzonic.emi.admin` permission - Use `/emi status` to test if the command works

---

Compatibility

| Platform | Version | |----------|----------| | Minecraft | 1.20.4+ | | Server | Paper (recommended), Spigot | | Java | 17+ | | API | OpenAI Chat Completions compatible |

---

Changelog

Version 1.0.0

- Initial release - OpenAI-compatible API integration - 15-message conversation context - Configurable system prompt and chat prefix - Rate limiting and cooldown system - Commands: /ai, /aiclear, /emi - Async API requests for performance - Built-in encrypted credentials - Three response modes (command, chat, player) - Context-aware AI (username, location, health) - Smart response control with `<no response>` - Admin commands (enable/disable/status/reload) - Plugin status checking - Enhanced system prompts with player context

---

License

This plugin is developed by Enzonic. All rights reserved.

---

Support

- Email: Email - Email: %%MD1%% - Email: [email protected]

For issues, questions, or feature requests, please visit enzonic.com.

---