Enzonic EMI
一款智能 Minecraft 插件,为你的服务器带来 AI 驱动辅助功能
简介
Enzonic EMI (Enzonic Minecraft Intelligence) 是一款强大的 Minecraft 插件,将兼容 OpenAI 的 AI API 直接集成到你的服务器中。玩家可与一位了解 Minecraft 的智能助手聊天,获取有用信息,甚至根据其游戏内状况进行上下文相关的回复。
特性
- 智能 AI 助手 - 具备上下文感知能力且熟知 Minecraft 玩法的 AI
- 多种回复模式 - 仅命令、私聊或公聊回复
- 智能回复控制 - AI 能智能判断何时进行回复
- 上下文感知 - 知晓玩家用户名、位置、游戏模式和生命值
- 对话记忆 - 可记住最多 15 条消息以维持上下文
- 内置凭证 - 预配置并加密的 API 密钥
- 管理员控制 - OP 指令用于启用/禁用插件
- 完全可配置 - 自定义前缀、系统提示词和设置
- 速率限制 - 内置防 API 滥用保护
- 异步处理 - 非阻塞请求以确保流畅的游戏体验
- 格式化消息 - 美观的彩色消息
安装
要求
- Minecraft: 1.20.4 或更高版本
- 服务端: Paper(推荐)或 Spigot
- Java: 17 或更高版本
快速安装
- 下载最新的
enzonic-emi-x.x.x.jar
- 将其放入服务器的
plugins 文件夹中
- 重启服务器
- 完成!插件使用内置凭证开箱即用
配置
编辑 plugins/EnzonicEMI/config.yml:
# AI 回复模式:"command"、"chat" 或 "player"
response-mode: "chat"
# 聊天前缀(仅命令模式)
chat-prefix: "&6[&eEMI&6] &f"
# 自定义 AI 行为
system-prompt: "You are a helpful and friendly Minecraft assistant..."
# API 配置
# API 已预配置,不可修改
# 对话上下文
context:
max-messages: 15
include-system: true
# 速率限制
rate-limit:
cooldown: 2
max-per-minute: 30
# 启用/禁用插件
enabled: true
使用方法
回复模式
命令模式
使用 /ai <message> 与 AI 聊天:
/ai How do I craft a diamond sword?
[EMI] To craft a diamond sword, you need 2 diamonds and 1 stick...
聊天模式(默认)
正常聊天,AI 会私聊回复:
[Player] What's the best way to find diamonds?
EMI: Mine at Y-level -58 or lower in the deepslate layer...
玩家模式
正常聊天,AI 会在公聊中回复:
[Player] How do I enchant items?
[EMI] To enchant items, you need an enchanting table with bookshelves...
命令
| 命令 |
描述 |
权限 |
/ai <message> |
与 AI 聊天 |
enzonic.emi.use |
/aiclear |
清除对话历史 |
enzonic.emi.clear |
/emi <subcommand> |
管理插件(见下文) |
enzonic.emi.admin |
管理员命令
| 命令 |
描述 |
/emi enable |
启用 AI 插件 |
/emi disable |
禁用 AI 插件 |
/emi status |
检查插件状态和配置 |
/emi reload |
重新加载插件配置 |
权限
| 权限 |
默认值 |
描述 |
enzonic.emi.use |
true |
使用 AI 聊天和自动回复 |
enzonic.emi.clear |
true |
清除对话历史 |
enzonic.emi.admin |
op |
使用管理员命令 |
AI 特性
上下文感知
AI 自动知晓以下信息:
- 玩家用户名和显示名称
- 世界和位置
- 游戏模式(生存、创造等)
- 生命值状态
- 对话中的最近 15 条消息
智能回复控制
AI 使用 <no response> 来跳过不必要的消息:
- 回复:问题、求助请求、命令查询
- 跳过:问候语、简单陈述、闲聊
这能创建自然、有帮助的交互,而不会产生垃圾信息。
配置选项
回复模式
command - AI 仅响应 /ai 命令
chat - AI 对普通聊天进行私聊回复(默认)
player - AI 在公聊中进行公开回复
系统提示词
自定义 AI 的行为方式:
system-prompt: "You are a helpful Minecraft assistant..."
对话上下文
context:
max-messages: 15 # 要记住的消息数量
include-system: true # 包含系统提示词
速率限制
rate-limit:
cooldown: 2 # 请求之间的间隔秒数
max-per-minute: 30 # 每位玩家的每分钟最大请求数
安全性
- 加密凭证 - API 密钥采用 Base64 编码
- 无公开密钥 - 分发过程中密钥绝不可见
- 仅限管理员 - 敏感命令需要 OP 权限
- 状态命令 - 安全地验证配置
故障排除
AI 没有回复?
- 检查
/emi status 以确认插件已启用
- 检查配置中的
response-mode
- 验证玩家是否具有
enzonic.emi.use 权限
回复类型错误?
更改配置中的 response-mode:
command - 仅限 /ai 命令
chat - 私聊回复
player - 公聊回复
然后运行 /emi reload
API 错误?
- 内置凭证已预配置
- 检查控制台以获取具体错误消息
- 验证你的服务器能否访问 API 端点
插件无法加载?
- 确保 Minecraft 1.20.4+(推荐 Paper)
- 验证已安装 Java 17+
- 检查控制台中的错误消息
管理员命令无效?
- 确保你是 OP(操作员)
- 检查你是否拥有
enzonic.emi.admin 权限
- 使用
/emi status 测试命令是否有效
兼容性
| 平台 |
版本 |
| Minecraft |
1.20.4+ |
| 服务器 |
Paper(推荐), Spigot |
| Java |
17+ |
| API |
兼容 OpenAI Chat Completions |
更新日志
Version 1.0.0
- 首次发布
- 集成 OpenAI 兼容 API
- 支持 15 条消息的对话上下文
- 可配置的系统提示词和聊天前缀
- 速率限制与冷却系统
- 命令:/ai, /aiclear, /emi
- 异步 API 请求以提升性能
- 内置加密凭据存储
- 三种响应模式(命令、聊天、玩家)
- 上下文感知 AI(用户名、位置、生命值)
- 智能响应控制,支持
<no response>
- 管理员命令(enable/disable/status/reload)
- 插件状态检查
- 增强型系统提示词,包含玩家上下文信息
许可协议
本插件由 Enzonic 开发。保留所有权利。
支持
如遇问题、疑问或有功能建议,请访问 enzonic.com。
Enzonic EMI
An intelligent Minecraft plugin that brings AI-powered assistance to your server
About
Enzonic EMI (Enzonic Minecraft Intelligence) is a powerful Minecraft plugin that integrates OpenAI-compatible AI APIs directly into your server. Players can chat with an intelligent assistant that understands Minecraft, provides helpful information, and even responds contextually to their in-game situation.
Features
- Intelligent AI Assistant - Context-aware AI that knows Minecraft gameplay
- Multiple Response Modes - Command-only, private chat, or public chat responses
- Smart Response Control - AI intelligently decides when to respond
- Context Awareness - Knows player username, location, game mode, and health
- Conversation Memory - Remembers up to 15 messages for context
- Built-in Credentials - Pre-configured, encrypted API keys
- Admin Controls - OP commands to enable/disable plugin
- Fully Configurable - Customize prefix, system prompt, and settings
- Rate Limiting - Built-in protection against API abuse
- Async Processing - Non-blocking requests for smooth gameplay
- Formatted Messages - Beautiful colored messages
Installation
Requirements
- Minecraft: 1.20.4 or higher
- Server: Paper (recommended) or Spigot
- Java: 17 or higher
Quick Install
- Download the latest
enzonic-emi-x.x.x.jar
- Place it in your server's
plugins folder
- Restart your server
- Done! The plugin works out of the box with built-in credentials
Configuration
Edit plugins/EnzonicEMI/config.yml:
# AI Response Mode: "command", "chat", or "player"
response-mode: "chat"
# Chat prefix (command mode only)
chat-prefix: "&6[&eEMI&6] &f"
# Customize AI behavior
system-prompt: "You are a helpful and friendly Minecraft assistant..."
# API Configuration
# API is pre-configured and cannot be modified
# Conversation context
context:
max-messages: 15
include-system: true
# Rate limiting
rate-limit:
cooldown: 2
max-per-minute: 30
# Enable/disable plugin
enabled: true
Usage
Response Modes
Command Mode
Use /ai <message> to chat with the AI:
/ai How do I craft a diamond sword?
[EMI] To craft a diamond sword, you need 2 diamonds and 1 stick...
Chat Mode (Default)
Chat normally and AI responds privately:
[Player] What's the best way to find diamonds?
EMI: Mine at Y-level -58 or lower in the deepslate layer...
Player Mode
Chat normally and AI responds in public chat:
[Player] How do I enchant items?
[EMI] To enchant items, you need an enchanting table with bookshelves...
Commands
| Command |
Description |
Permission |
/ai <message> |
Chat with AI |
enzonic.emi.use |
/aiclear |
Clear conversation history |
enzonic.emi.clear |
/emi <subcommand> |
Manage plugin (see below) |
enzonic.emi.admin |
Admin Commands
| Command |
Description |
/emi enable |
Enable the AI plugin |
/emi disable |
Disable the AI plugin |
/emi status |
Check plugin status and configuration |
/emi reload |
Reload plugin configuration |
Permissions
| Permission |
Default |
Description |
enzonic.emi.use |
true |
Use AI chat and auto-response |
enzonic.emi.clear |
true |
Clear conversation history |
enzonic.emi.admin |
op |
Use admin commands |
AI Features
Context Awareness
The AI automatically knows:
- Player username and display name
- World and location
- Game mode (Survival, Creative, etc.)
- Health status
- Last 15 messages in conversation
Smart Response Control
The AI uses <no response> to skip unnecessary messages:
- Responds to: Questions, help requests, command inquiries
- Skips: Greetings, simple statements, casual chat
This creates natural, helpful interactions without spam.
Configuration Options
Response Mode
command - AI only responds to /ai commands
chat - AI responds privately to regular chat (default)
player - AI responds publicly in chat
System Prompt
Customize how the AI behaves:
system-prompt: "You are a helpful Minecraft assistant..."
Conversation Context
context:
max-messages: 15 # Messages to remember
include-system: true # Include system prompt
Rate Limiting
rate-limit:
cooldown: 2 # Seconds between requests
max-per-minute: 30 # Max requests per player
Security
- Encrypted Credentials - API keys are Base64 encoded
- No Public Keys - Keys never visible in distribution
- Admin Only - Sensitive commands require OP
- Status Command - Verify configuration safely
Troubleshooting
AI Not Responding?
- Check
/emi status to verify plugin is enabled
- Check
response-mode in config
- Verify player has
enzonic.emi.use permission
Wrong Response Type?
Change response-mode in config:
command - Only /ai commands
chat - Private responses
player - Public responses
Then run /emi reload
API Errors?
- Built-in credentials are pre-configured
- Check console for specific error messages
- Verify your server can reach the API endpoint
Plugin Won't Load?
- Ensure Minecraft 1.20.4+ (Paper recommended)
- Verify Java 17+ is installed
- Check console for error messages
Admin Commands Not Working?
- Ensure you are OP (operator)
- Check you have
enzonic.emi.admin permission
- Use
/emi status to test if the command works
Compatibility
| Platform |
Version |
| Minecraft |
1.20.4+ |
| Server |
Paper (recommended), Spigot |
| Java |
17+ |
| API |
OpenAI Chat Completions compatible |
Changelog
Version 1.0.0
- Initial release
- OpenAI-compatible API integration
- 15-message conversation context
- Configurable system prompt and chat prefix
- Rate limiting and cooldown system
- Commands: /ai, /aiclear, /emi
- Async API requests for performance
- Built-in encrypted credentials
- Three response modes (command, chat, player)
- Context-aware AI (username, location, health)
- Smart response control with
<no response>
- Admin commands (enable/disable/status/reload)
- Plugin status checking
- Enhanced system prompts with player context
License
This plugin is developed by Enzonic. All rights reserved.
Support
For issues, questions, or feature requests, please visit enzonic.com.
评论 0
登录后参与评分
还没有评论,来抢沙发吧