Minechat
Minechat 为 Minecraft 服务器带来现代化的实时聊天功能,提供具有 Minecraft 主题风格的 Web 界面、REST API 和 WebSocket 网关。玩家可以在浏览器或游戏内聊天,发送离线私信,管理好友和群组,并查看等级与在线状态——所有数据保持同步。
注意
- 你可以从 minechat 仓库中的
/web文件夹获取 Web 界面
特性
- 实时聊天
- Web 端与游戏端之间的 WebSocket 实时更新
- 支持公告和基本管理的群聊
- 离线友好的私信(Web↔Web 和 Web↔MC;消息持久化保存)
- 好友与群组
- 好友列表、请求及移除
- 创建/加入/离开群组,带成员资格检查的邀请流程
- 群组角色(所有者/管理员/成员)及成员数量统计
- 等级与在线状态
- 在 Web 端渲染 Minecraft “§” 颜色/样式代码
- 在线/离线指示器及成员列表
- Web API + WebSocket
- REST 用于认证、列表和历史记录查询
- WebSocket 用于实时事件接收和消息发送
- 开发环境下启用 CORS
- 生产环境就绪
- 错误处理、会话令牌、基础速率限制
- Nginx 反向代理示例及 HTTPS 配置指南
- 可与 Vault/LuckPerms/PowerRanks 良好配合使用(可选,用于获取等级数据)
快速开始
- 安装
- 将插件 jar 文件放入服务器的
plugins文件夹中。 - 启动服务器一次以生成配置文件。
- 配置
- 在
config.yml中:
web:
enable-api: true
port: 8080 # HTTP REST API
websocket-port: 8081 # WebSocket (实时通信)
- 启用 Web 访问
- 在游戏中,每位玩家运行以下命令:
/friend webaccess enable <password>
- 从 Web 端连接
- REST API:
- WebSocket: ws://localhost:8081/ws
Web API(亮点)
- POST
/api/auth— 使用用户名 + Web 密码进行认证 - GET
/api/friends?playerUUID={uuid} - GET
/api/groups?playerUUID={uuid} - GET
/api/messages?groupId={uuid}&limit=50 - GET
/api/users, GET/api/ranks - 群组邀请:GET
/api/group-invites, POST 接受/拒绝
登录请求示例:
POST /api/auth
{ "username": "Player", "password": "web_password" }
WebSocket(亮点)
- 连接:
ws://localhost:8081/ws - 认证:
{ "type": "auth", "data": { "username": "Player", "password": "web_password" } }
- 发送消息:
- 好友消息:
type: "friend_message" - 群组消息:
type: "group_message"
- 好友消息:
- 接收消息:
friend_message,group_message,message_sent,error等
命令(精选)
- Web 访问
/friend webaccess enable <password>/friend webaccess disable
- 群组(示例)
/group create <name> [description]/group join <name>/group leave <name>/group invite <name> <player>/group accept <name>|/group deny <name>/group chat <name> <message>
注意:管理员/所有者操作和设置由服务端强制执行。
兼容性
- 服务器:Paper/Spigot/Purpur(推荐使用 Paper)
- Java:17+
- MC 版本:1.20.x–1.21.x(根据你的环境自行调整)
- 可选:Vault/LuckPerms/PowerRanks 用于更丰富的等级显示
安全说明
- 玩家通过游戏内密码控制 Web 访问权限。
- 包含会话令牌和基本速率限制。
- 支持反向代理 + HTTPS(参见 Nginx 示例)。
- Web UI 已对输入进行清理;集成时仍需在服务端进行验证。
链接
- 源码:
- 问题反馈:
- 许可证:MIT
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧