Community listing page, reviews here may not be monitored by the author.
Community voices
Reviews
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
About
Description
Sever Agent โ AI Assistant for Minecraft Servers
An AI chatbot assistant for your Minecraft server. Just install it on the server (compatible with single-player / LAN / dedicated servers) โ no client mod required.
Supported versions: Minecraft 1.21.1 ยท NeoForge
โจ Features
- ๐จ๏ธ Chat with AI โ players ask questions with
/ai <message>or/ai ask <message>, and the answer is delivered back as a private message (/telleffect). - ๐ Web Search โ built-in presets that automatically declare web search to the connected model. Supports ChatGPT/OpenAI, DeepSeek, Zhipu GLM, Qwen (Tongyi), ERNIE (Wenxin), Doubao (Volcengine Ark) and more.
- โ๏ธ Hot-reload config โ change everything at runtime via
/ai config set <key> <value>or/ai reload, no server restart needed. - ๐ซ Admin controls โ ban/unban players from using the AI with
/ai ban <player>//ai unban <player>. - ๐ง Deep thinking support โ optionally show the model's reasoning process (
showThinking), if the model supports it. - ๐ Smart queue & rate limiting โ a shared server-wide FIFO queue with sliding-window rate limits and global cooldown; never floods your API key.
- ๐ฆ Full, non-streamed replies โ waits for the complete response before sending; long answers are split automatically.
- ๐ Multi-language โ Simplified/Traditional Chinese (HK & TW), Classical Chinese, English, Spanish, French, Arabic, Russian and Japanese.
๐ Commands
| Command | Description | Permission |
|---|---|---|
/ai <message> |
Ask the AI (same as /ai ask) |
Player |
/ai ask <message> |
Ask the AI, reply via private message | Player |
/ai status |
Show API config, rate-limit & queue status | Player |
/ai reload |
Reload config from disk | Admin (OP 2) |
/ai config set <key> <value> |
Change config at runtime, applied immediately | Admin (OP 2) |
/ai ban <player> |
Ban a player from using the AI | Admin (OP 2) |
/ai unban <player> |
Unban a player | Admin (OP 2) |
โ๏ธ Configuration
Generated at config/severagent-server.toml on first run (NeoForge native TOML).
Key options (also changeable via /ai config set):
| Key | Description |
|---|---|
apiKey |
Your API key (leave empty to disable AI) |
baseUrl |
OpenAI-compatible endpoint URL |
model |
Model name |
webSearchEnabled |
Enable web search (default off) |
webSearchMode |
Preset: chatgpt / deepseek / zhipu / qwen / ernie / doubao / search_field / search_enabled_field |
windowMinutes |
Rate-limit window (only 1 / 5 / 10) |
maxRequestsPerWindow |
Max requests per window |
cooldownSeconds |
Global cooldown between requests |
showThinking |
Show the model's thinking process |
systemPrompt |
System prompt template ({player_name} placeholder) |
๐ Quick Start
/ai config set apiKey sk-xxxx
/ai config set webSearchEnabled true
/ai config set webSearchMode chatgpt
/ai ไปๅคฉๅคฉๆฐๆไนๆ ท๏ผ
Note: Web search only works if the model/API you connect to actually supports it. DeepSeek's official API does not offer native web search โ use it through a compatible gateway, or use the aggregator platform's preset (e.g.
qwen) instead.
Sever Agent โโ ๆ็ไธ็ๆๅกๅจ AI ๅฉๆๆจก็ป
ไธบไฝ ็ Minecraft ๆๅกๅจๆฅๅ ฅ AI ่ๅคฉๅฉๆใ ไป ้ๅจๆๅก็ซฏๅฎ่ฃ ๏ผๅ ผๅฎนๅไบบๆธธๆ / ๅฑๅ็ฝๅผๆพ / ไธ็จๆๅกๅจ๏ผ๏ผๅฎขๆท็ซฏๆ ้ๅฎ่ฃ ใ
ๆฏๆ็ๆฌ๏ผMinecraft 1.21.1 ยท NeoForge
โจ ๅ่ฝ็นๆง
- ๐จ๏ธ ไธ AI ๅฏน่ฏ โโ ็ฉๅฎถ็จ
/ai <ๅ ๅฎน>ๆ/ai ask <ๅ ๅฎน>ๆ้ฎ๏ผๅ็ญไปฅ็งไฟก๏ผ/tellๆๆ๏ผๅไผ ใ - ๐ ่็ฝๆ็ดข โโ ๅ ็ฝฎไธปๆตๅคงๆจกๅ่็ฝๅฃฐๆ้ข่ฎพ๏ผ่ชๅจ็ๆๅฏนๅบๅนณๅฐ็่ฏทๆฑๅญๆฎต๏ผๆฏๆ ChatGPT/OpenAIใDeepSeekใๆบ่ฐฑ GLMใ้ไนๅ้ฎใๆๅฟไธ่จใ่ฑๅ ๏ผ็ซๅฑฑๆน่๏ผ ็ญใ
- โ๏ธ ้
็ฝฎ็ญๆดๆฐ โโ ้่ฟ
/ai config set <้ฎ> <ๅผ>ๆ/ai reload่ฟ่กๆถไฟฎๆน้ ็ฝฎ๏ผๆ ้้ๅฏๆๅกๅจใ - ๐ซ ็ฎก็ๅๅฐ็ฆ โโ
/ai ban <็ฉๅฎถ>//ai unban <็ฉๅฎถ>ๅป็ป/ๆขๅค็ฉๅฎถๅฏน AI ็่ฎฟ้ฎๆ้ใ - ๐ง ๆทฑๅบฆๆ่ๆฏๆ โโ ๅฏ้
็ฝฎๆฏๅฆๅฑ็คบๆจกๅ็ๆ่่ฟ็จ๏ผ
showThinking๏ผ๏ผ้็จไบๆฏๆๆทฑๅบฆๆ่็ๆจกๅใ - ๐ ๆบ่ฝ้ๅไธ้ๆต โโ ๅ จๆๅ ฑไบซ FIFO ่ฏทๆฑ้ๅ๏ผ้ ๅๆปๅจๆถ้ด็ชๅฃ้ๆตไธๅ จๅฑๅทๅด๏ผ้ฟๅ API ่ขซๅนถๅๆ็ใ
- ๐ฆ ๅฎๆดๅๅบใ้ๆตๅผๅไผ โโ ็ญๅพ ๅฎๆดๅๅคๅๅๅ้๏ผ็ปไธๆตๅผ้ๆกๆชๆญ๏ผ่ถ ้ฟๅๅค่ชๅจๅ็ใ
- ๐ ๅค่ฏญ่จๆฏๆ โโ ็ฎไฝ/็นไฝไธญๆ๏ผ้ฆๆธฏใๅฐๆนพ๏ผใๆ่จๆใ่ฑ่ฏญใ่ฅฟ็ญ็่ฏญใๆณ่ฏญใ้ฟๆไผฏ่ฏญใไฟ่ฏญใๆฅ่ฏญใ
๐ ๆไปคไธ่ง
| ๆไปค | ่ฏดๆ | ๆ้ |
|---|---|---|
/ai <ๅ
ๅฎน> |
็ดๆฅๆ้ฎ๏ผ็ญไปทไบ /ai ask๏ผ |
็ฉๅฎถ |
/ai ask <ๅ
ๅฎน> |
ๅ AI ๆ้ฎ๏ผ็ปๆ็งไฟกๅไผ | ็ฉๅฎถ |
/ai status |
ๆฅ็ API ้ ็ฝฎใ้ๆตไธ้ๅ็ถๆ | ็ฉๅฎถ |
/ai reload |
ไป็ฃ็็ญ้่ฝฝ้ ็ฝฎ | ็ฎก็ๅ๏ผOP 2๏ผ |
/ai config set <้ฎ> <ๅผ> |
่ฟ่กๆถไฟฎๆน้ ็ฝฎๅนถ็ซๅณ็ๆ | ็ฎก็ๅ๏ผOP 2๏ผ |
/ai ban <็ฉๅฎถ> |
ๅฐ็ฆ็ฉๅฎถไฝฟ็จ AI | ็ฎก็ๅ๏ผOP 2๏ผ |
/ai unban <็ฉๅฎถ> |
่งฃ้คๅฐ็ฆ | ็ฎก็ๅ๏ผOP 2๏ผ |
โ๏ธ ้ ็ฝฎ่ฏดๆ
้ฆๆฌก่ฟ่ก่ชๅจ็ๆ config/severagent-server.toml๏ผNeoForge ๅ็ TOML ้
็ฝฎ๏ผ๏ผไนๅฏ้่ฟ /ai config set ไฟฎๆน๏ผ
| ้ฎ | ่ฏดๆ |
|---|---|
apiKey |
API ๅฏ้ฅ๏ผ็็ฉบ็ฆ็จ AI๏ผ |
baseUrl |
ๅ ผๅฎน OpenAI ๅ่ฎฎ็ๆฅๅฃๅฐๅ |
model |
ๆจกๅๅ็งฐ |
webSearchEnabled |
ๆฏๅฆๅฏ็จ่็ฝๆ็ดข๏ผ้ป่ฎคๅ ณ้ญ๏ผ |
webSearchMode |
้ข่ฎพ๏ผchatgpt / deepseek / zhipu / qwen / ernie / doubao / search_field / search_enabled_field |
windowMinutes |
้ๆตๆถ้ด็ชๅฃ๏ผไป 1 / 5 / 10๏ผ |
maxRequestsPerWindow |
็ชๅฃๅ ๆๅคงๅฏน่ฏๆฌกๆฐ |
cooldownSeconds |
็ธ้ป่ฏทๆฑๅ จๅฑๅทๅด |
showThinking |
ๆฏๅฆๅฑ็คบๆ่่ฟ็จ |
systemPrompt |
็ณป็ปๆ็คบ่ฏๆจกๆฟ๏ผ{player_name} ๅ ไฝ็ฌฆ๏ผ |
๐ ๅฟซ้ไธๆ
/ai config set apiKey sk-xxxx
/ai config set webSearchEnabled true
/ai config set webSearchMode chatgpt
/ai ไปๅคฉๅคฉๆฐๆไนๆ ท๏ผ
ๆ็คบ๏ผ่็ฝๅ่ฝๆฏๅฆ็ๆๅๅณไบๆ่ฟๆฅๆจกๅ/API ๆฌ่บซๆฏๅฆๆฏๆใDeepSeek ๅฎๆนๆฅๅฃๆ ๅ็่็ฝ๏ผ้้่ฟๅ ผๅฎน็ฝๅ ณๆฅๅ ฅ๏ผๆๆน็จ่ๅๅนณๅฐ้ข่ฎพ๏ผๅฆ
qwen๏ผใ
Building / ๆๅปบ
Requires JDK 21.
./gradlew build
The built mod jar is at build/libs/severagent-<version>.jar.
License / ่ฎธๅฏ่ฏ
Licensed under the GNU General Public License v3.0 (GPL-3.0). See LICENSE.
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources