MineBridge
将你的 Minecraft 服务器与 Discord 连接。桥接对话、分享游戏内事件,并保持社区紧密相连。
MineBridge 是一款 Minecraft × Discord 集成插件,旨在通过实时通信和自动事件通知,将你的游戏内社区与 Discord 服务器连接起来。
功能特性
Discord ↔ Minecraft 集成
- 双向 Minecraft 与 Discord 聊天中继。
- 可配置的 Discord 频道过滤。
- 机器人(Bot)和 Webhook 消息过滤。
- 消息清理与 Discord @提及抑制。
- 通过环境变量安全配置 Bot Token。
死亡信息
- 自动检测玩家死亡。
- 玩家对玩家(PvP)击杀通知。
- 生物相关死亡通知。
- 环境死亡检测,包括岩浆、火焰、溺水、坠落和虚空。
- 可自定义的 Minecraft 死亡消息。
- 丰富的 Discord 死亡通知嵌入卡片(Embeds)。
成就与进度公告
- 自动检测 Minecraft 进度达成。
- 故事线、下界、末地、冒险与畜牧类进度分类。
- 特殊挑战完成公告。
- 可自定义的 Minecraft 公告消息。
- 丰富的 Discord 成就嵌入卡片(Embeds)。
- 可配置的通知类别。
Discord 通知系统
- 支持的游戏内事件的丰富 Discord 嵌入卡片(Embeds)。
- 可配置的通知频道。
- 异步 Discord 消息发送。
- Markdown 转义与 @提及抑制。
- 可配置的事件通知设置。
管理与可靠性
- 管理员状态查看与配置重载命令。
- 有界消息队列与串行化 Discord 发送。
- 连接就绪检查。
- 改进的诊断信息与关闭处理。
- 重复事件通知抑制。
要求
- Minecraft Java Edition 服务器。
- Paper 或兼容的 Spigot 基服务器。
- Java 21 或用于插件构建的兼容运行时环境。
- 拥有适当权限的 Discord 机器人。
- 启用 Discord 消息内容意图(Message Content Intent)以进行聊天中继。
安装
- 从版本部分下载
MineBridge-1.2.x.jar。
- 停止你的 Minecraft 服务器。
- 将 JAR 文件放入服务器的
plugins 目录中。
- 启动服务器以生成配置文件。
- 配置你的 Discord Bot Token 和通知频道 ID。
- 使用
/minebridge status 验证连接。
为了获得更好的 Token 安全性,请配置 MINEBRIDGE_BOT_TOKEN 环境变量。切勿公开分享你的 Discord Bot Token。
命令与权限
MineBridge 提供管理员状态查看与配置重载命令。
管理访问权限使用 minebridge.admin 权限,默认赋予服务器操作员(OP)。
有关详细的命令用法和配置说明,请参阅项目 README。
兼容性与技术栈
- Java 21
- Spigot API 1.20.6
- JDA 5.6.1
- Gradle 构建系统
安全性
MineBridge 包含消息清理、Discord @提及抑制以及基于环境变量的安全 Token 配置。
自动化依赖项漏洞扫描尚未完成。未声明经过干净的漏洞审计结果。
发布信息
当前版本: 1.2.x
发布亮点:
- 死亡信息集成。
- 成就与进度公告。
- Discord 游戏内事件嵌入卡片(Embeds)。
- 改进了的事件处理与通知可靠性。
源代码:
MineBridge
Connect your Minecraft server with Discord. Bridge conversations, share gameplay events, and keep your community connected.
MineBridge is a Minecraft × Discord integration plugin designed to connect your in-game community with your Discord server through real-time communication and automated event notifications.
Features
Discord ↔ Minecraft Integration
- Two-way Minecraft and Discord chat relay.
- Configurable Discord channel filtering.
- Bot and webhook message filtering.
- Message sanitization and Discord mention suppression.
- Secure bot token configuration through environment variables.
Death Messages
- Automatic player death detection.
- Player-versus-player kill notifications.
- Mob-related death notifications.
- Environmental death detection, including lava, fire, drowning, falls and void.
- Customizable Minecraft death messages.
- Rich Discord death notification embeds.
Achievement & Advancement Announcements
- Automatic Minecraft advancement detection.
- Story, Nether, End, Adventure and Husbandry advancement classification.
- Special challenge completion announcements.
- Customizable Minecraft announcement messages.
- Rich Discord achievement embeds.
- Configurable notification categories.
Discord Notification System
- Rich Discord embeds for supported gameplay events.
- Configurable notification channels.
- Asynchronous Discord message delivery.
- Markdown escaping and mention suppression.
- Configurable event notification settings.
Administration & Reliability
- Administrative status and configuration reload commands.
- Bounded message queue and serialized Discord sends.
- Connection readiness checks.
- Improved diagnostics and shutdown handling.
- Duplicate event notification suppression.
Requirements
- Minecraft Java Edition server.
- Paper or compatible Spigot-based server.
- Java 21 or compatible runtime for the plugin build.
- Discord bot with appropriate permissions.
- Discord Message Content Intent enabled for chat relay.
Installation
- Download
MineBridge-1.2.x.jar from the Versions section.
- Stop your Minecraft server.
- Place the JAR inside your server's
plugins directory.
- Start the server to generate the configuration.
- Configure your Discord bot token and notification channel IDs.
- Use
/minebridge status to verify the connection.
For better token security, configure the MINEBRIDGE_BOT_TOKEN environment variable. Never share your Discord bot token publicly.
Commands & Permissions
MineBridge provides administrative status and configuration reload commands.
Administrative access uses the minebridge.admin permission, which defaults to server operators.
Refer to the project README for detailed command usage and configuration instructions.
Compatibility & Technology
- Java 21
- Spigot API 1.20.6
- JDA 5.6.1
- Gradle build system
Security
MineBridge includes message sanitization, Discord mention suppression, and secure environment-based token configuration.
Automated dependency vulnerability scanning has not yet completed. No clean vulnerability-audit result is claimed.
Release Information
Current version: 1.2.x
Release highlights:
- Death Messages integration.
- Achievement & Advancement announcements.
- Discord gameplay event embeds.
- Improved event handling and notification reliability.
Source Code:
评论 0
登录后参与评分
还没有评论,来抢沙发吧