ServerChan

# ServerChan (https://github.com/himekifee/ServerChan/actions/workflows/server-test.yml/badge.svg)](https://github.com/himekifee/ServerChan/actions/workflows/server-test.yml) (https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) (https://img.shields.io/modrinth/dt/frZpQL6O?logo=modrinth&label=Modrinth)](https://modrinth.com/mod/serverchan) (https://img.shields.io/curseforge/dt/1393571?logo=curseforge&label=CurseForge)](https://www.curseforge.com/minecraft/mc-mods/serverchan) (https://img.shields.io/badge/Minecraft-1.12--1.21-green.svg)](https://minecraft.net) (https://img.shields.io/discord/1450587683176054796?logo=discord&label=Discord)](https://discord.gg/NuzHC7BCDc) <p align="center"> <img src="https://raw.githubusercontent.com/himekifee/ServerChan/main/common/src/main/resources/assets/serverchan/icon.png" alt="ServerChan mod icon" width="400" /> </p> ServerChan is a friendly, AI-powered helper for Minecraft servers. It listens to chat, reacts to in-game events, and can even carry out commands when you give it permission. Whether you run a cozy SMP or a busy public server, ServerChan keeps conversations lively without spamming players. ## Features - **AI Chat Integration** - Uses OpenAI-compatible APIs (OpenAI, Azure, local LLMs, etc.) to power intelligent conversations - **Smart Response System** - Optional intention checker determines when the AI should respond, avoiding spam - **Game Event Awareness** - Reacts to player joins/leaves, deaths, and other server events - **Command Execution** - AI can execute Minecraft commands via function calling (with permission controls) - **Multi-Loader Support** - Works on Fabric, Forge, NeoForge, and Spigot/Paper - **Multi-Version Support** - Compatible with Minecraft 1.12 - 1.21 - **Fully Configurable** - Customize prompts, models, response behavior, and more - **Internationalization** - Built-in i18n support (English, Chinese, Japanese) ## Demo <p align="center"> <img src="https://raw.githubusercontent.com/himekifee/ServerChan/main/example/welcome.png" alt="ServerChan welcome message" width="800" /> </p> <p align="center"> <img src="https://raw.githubusercontent.com/himekifee/ServerChan/main/example/command.png" alt="ServerChan command execution" width="800" /> </p> ## Loader Compatibility Matrix | Version | Java | Fabric | Forge | NeoForge | Spigot/Paper | |---------|------|--------|-------|----------|--------------| | 1.12.x | 8 | — | ❌ | — | ✅ | | 1.13.x | 8 | — | ❌ | — | ✅ | | 1.14.x | 8 | ✅ | ❌ | — | ✅ | | 1.15.x | 8 | ✅ | ❌ | — | ✅ | | 1.16.x | 8 | ✅ | ✅ | — | ✅ | | 1.17.x | 16 | ✅ | ✅ | — | ✅ | | 1.18.x | 17 | ✅ | ✅ | — | ✅ | | 1.19.x | 17 | ✅ | ✅ | — | ✅ | | 1.20.x | 21 | ✅ | ✅ | ✅ | ✅ | | 1.21.x | 21 | ✅ | ✅ | ✅ | ✅ | `—` means the loader didn't exist for that version (Fabric starts at 1.14, NeoForge at 1.20). ## Installation You're just five steps away from a chatty server buddy: 1. Grab the jar that matches your loader from (https://modrinth.com/mod/serverchan) or (https://www.curseforge.com/minecraft/mc-mods/serverchan) 2. Drop it into the `mods/` folder (or `plugins/` for Spigot/Paper) 3. Launch the server once so the config file appears 4. Add your API key plus any tweaks you want (see (#configuration)) 5. Restart or `/reload` and start chatting ## Configuration The config file lives at: - **Fabric/Forge/NeoForge**: `config/serverchan.yaml` - **Spigot**: `plugins/ServerChan/config.yml` ### Required Settings | Option | Description | |--------|-------------| | `openaiApiKey` | Your OpenAI API key (or compatible provider) | | `openaiBaseUrl` | API base URL (default: `https://api.openai.com/v1`) **Important: Must include `/v1` path** | ### Optional Settings | Option | Default | Description | |--------|---------|-------------| | `model` | `gpt-5.1` | Model to use for responses | | `temperature` | `1.0` | Response randomness (0.0 - 2.0) | | `contextSize` | `20` | Number of messages to keep in context | | `botColor` | `b` | Minecraft color code for bot chat | | `timeZone` | `UTC` | Timezone for message timestamps | | `locale` | `en` | Language for bot messages | ### Intention Checker Settings The intention checker uses a smaller/faster model to decide if the AI should respond. | Option | Default | Description | |--------|---------|-------------| | `useIntentionChecker` | `true` | Enable smart response filtering | | `intentionCheckerModel` | `gpt-4o-mini` | Model for intention checking (personal rec: `qwen3-235b-a22b-2507` via Cerebras) | | `responseProbabilityThreshold` | `0.5` | Minimum probability