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
• [Optional] CoreProtect — For block log queries
• [Optional] 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

# 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