AIServerHost

# AIServerHost An AI-powered server host plugin for Minecraft ## Overview AIServerHost integrates DeepSeek AI into your Minecraft server to act as an intelligent server host. It monitors player chat, detects conflicts, mediates disputes, enforces rules, and even initiates conversations when players are idle. ## Features - **AI Chat Monitoring** — Every player message is analyzed by the AI in real time. - **Conflict Detection & Mediation** — When players argue, the AI steps in to mediate. - **Evidence Gathering** — The AI can @ players for testimony and query CoreProtect logs (3-day limit) before taking action. - **Automated Punishment** — The AI can issue temporary bans (up to 10 minutes) via AdvancedBan. Punishments exceeding 10 minutes are logged for admin review instead of auto-executed. - **Idle Chat** — When the server is quiet and players seem bored, the AI can start friendly conversations. - **Token Saving** — The AI can pause chat monitoring when conversations are casual and don't require supervision. - **Full Action Logging** — Every AI analysis step is recorded in `whataido.yml` with configurable retention. - **Severe Punishment Logging** — Punishments over 10 minutes are recorded in `log.yml` with time, player, and details for admin review. - **Async Processing** — API calls and heavy operations run on separate threads to prevent server lag. ## Safety Restrictions The AI is **hardcoded** to never perform these actions: - Setting admin/op status - Banning players for more than 10 minutes directly - Shutting down the server - Deleting chunks - Filling blocks - Giving items to players - Executing arbitrary server commands ## Requirements - **Server**: Purpur or Paper 1.21.x - **Java**: 21+ - **DeepSeek API Key** — Required for AI functionality - ** CoreProtect** — For block log queries - ** AdvancedBan** — For punishment execution (falls back to kick if unavailable) ## Installation 1. Download `AIServerHost-1.0.0.jar` 2. Place it in your server's `plugins/` directory 3. Start the server — default config will be generated 4. Edit `plugins/AIServerHost/config.yml` and set your DeepSeek API key 5. Run `/aiserverhost reload` or restart the server ## Configuration ### config.yml ```yaml # DeepSeek API Configuration api: key: "YOUR_API_KEY_HERE" # Your DeepSeek API key (required) base-url: "https://api.deepseek.com" # API base URL model: "deepseek-chat" # Model name (deepseek-chat for V3) timeout: 30 # Request timeout in seconds # AI Behavior Settings ai: max-context: 100 # Maximum chat history messages to keep max-pause-duration: 30 # Maximum pause duration (minutes) idle-chat: enabled: true # Enable idle chat feature min-players: 2 # Minimum online players to trigger check-interval: 120 # Check interval in seconds max-idle-time: 300 # Max idle time before AI chats (seconds) # Punishment Settings punishment: max-direct-duration: 10 # Max direct punishment (minutes) log-threshold: 10 # Log threshold for severe punishment (minutes) # Logging Settings logging: whataido-retention-days: 30 # Days to keep whataido.yml records ``` ### Generated Files | File | Description | |------|-------------| | `config.yml` | Plugin configuration | | `whataido.yml` | AI action log (auto-cleaned based on retention days) | | `log.yml` | Severe punishment log (for admin review) | ## Commands | Command | Permission | Description | |---------|-----------|-------------| | `/aiserverhost reload` | `aiserverhost.admin` | Reload configuration | | `/aiserverhost` | `aiserverhost.admin` | Show plugin info | Aliases: `/ash`, `/aishost` ## AI Actions The AI responds in JSON format and can perform these actions: | Action | Description | |--------|-------------| | `chat` | Send a public chat message | | `ask_player` | Ask a specific player a question publicly | | `ask_witness` | Ask an online player for evidence/testimony | | `query_coreprotect` | Query CoreProtect block logs (3-day limit) | | `punish` | Issue a temporary ban (max 10 minutes) | | `request_ban` | Request a ban over 10 minutes (logged, not auto-executed) | | `mediate` | Mediate a conflict between players | | `pause` | Pause chat monitoring to save tokens | | `idle_chat` | Initiate a casual conversation | | `no_action` | No action needed | ## How It Works 1. When a player sends a chat message, it's added to the AI's context 2. The AI analyzes the message along with recent chat history 3. Based on its analysis, the AI decides on an action (or no action) 4. Actions are executed on the main server thread (game operations) or async threads (API calls) 5. Every step is logged in `whataido.yml`