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

Download AIServerHost-1.0.0.jar
Place it in your server's plugins/ directory
Start the server — default config will be generated
Edit plugins/AIServerHost/config.yml and set your DeepSeek API key
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

When a player sends a chat message, it's added to the AI's context
The AI analyzes the message along with recent chat history
Based on its analysis, the AI decides on an action (or no action)
Actions are executed on the main server thread (game operations) or async threads (API calls)
Every step is logged in whataido.yml