Minechat

插件

· 作者 HarshitKumar9030

支持权限等级、好友系统、群组管理的 Minecraft 聊天插件,集成 MongoDB 日志记录功能,并提供基于 REST API 与 WebSocket 的实时 Web 管理界面。

0 本站下载 0 关注 更新于 1 年前

最新 1.0 · 1.21.8 · Bukkit / Paper

一键开服(送7天)

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 良好配合使用(可选,用于获取等级数据)

快速开始

  1. 安装
  • 将插件 jar 文件放入服务器的 plugins 文件夹中。
  • 启动服务器一次以生成配置文件。
  1. 配置
  • 在 config.yml 中:
web:
  enable-api: true
  port: 8080          # HTTP REST API
  websocket-port: 8081 # WebSocket (实时通信)
  1. 启用 Web 访问
  • 在游戏中,每位玩家运行以下命令:
/friend webaccess enable <password>
  1. 从 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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源