NexusBridge

🌉 NexusBridge

Discord ↔ Minecraft 桥接 — NeoForge 1.21.1

专为 NeoForge 1.21.1 打造的最完备的 Discord ↔ Minecraft 集成方案

---

✨ 特性

🔗 双向聊天同步

游戏内消息会即时显示在 Discord 上，Discord 消息也会出现在 Minecraft 中——包含完整的用户名和前缀格式。

🛡️ 全面的处罚管理

封禁、临时封禁和禁言会在两个平台实时同步。解封和解禁操作会自动同步。

✅ Discord 验证系统

通过安全的 6 位数字代码将玩家的 Minecraft 账号与其 Discord 身份绑定。代码在 5 分钟后过期。可选择踢出未验证玩家。

🔐 LuckPerms 集成

完全支持 LuckPerms 权限组——可直接从 Discord 或游戏内控制谁可以进行封禁、禁言和管理玩家。

💾 数据库持久化（MariaDB / MySQL）

所有数据（玩家、封禁、禁言、聊天记录、验证码）均通过 HikariCP 连接池存储在 MariaDB/MySQL 数据库中，以实现最高可靠性和性能。

🌐 完整国际化（i18n）支持

NexusBridge 自带法语和英语翻译。添加新语言只需放入一个新文件即可。

---

📋 需求

需求	版本
Minecraft Java 版	1.21.1
NeoForge	21.1.77+
Java	21（LTS）
MariaDB 或 MySQL	8.0+
Discord 机器人令牌	—

⚠️ 仅服务端安装。 玩家无需在客户端安装任何内容。

---

🚀 安装

1. 下载并安装

下载最新的 JAR 文件，放入服务器 mods/ 文件夹。

2. 设置数据库

mysql -u root -p < setup.sql

3. 首次启动服务器

NexusBridge 将会在以下位置生成其配置文件：

config/nexusbridge/config.json

4. 配置

填写必填字段：

{
  "serverId": "your_server_id_here",
  "discord": {
    "token": "YOUR_BOT_TOKEN",
    "guildId": 123456789,
    "chatChannelId": 987654321,
    "verificationChannelId": 987654321,
    "logsChannelId": 987654321
  },
  "database": {
    "host": "localhost",
    "port": 3306,
    "database": "nexusbridge",
    "username": "root",
    "password": "password"
  },
  "verification": {
    "enabled": true,
    "kickUnverifiedPlayers": false
  },
  "language": "en"
}

5. 重启并尽情享受 🎉

---

🎮 命令

Minecraft

命令	描述	权限
/nexus_ban <玩家> [原因]	封禁一名玩家	nexusbridge.ban
/nexus_mute <玩家> [时长] [原因]	禁言一名玩家	nexusbridge.mute
/nexus_unban <玩家>	解封一名玩家	nexusbridge.unban
/nexus_unmute <玩家>	解禁一名玩家	nexusbridge.unmute
/nexus_verify	获取验证链接	—

Discord

命令	描述	所需角色
/verify	获取验证码	所有人
/verify <代码>	绑定你的 Minecraft 账号	所有人
/status	显示服务器状态	所有人
/ban <用户> [原因]	封禁一个 Discord 用户	管理员
/mute <用户> [原因]	禁言一个 Discord 用户	版主

---

🗄️ 数据库架构

NexusBridge 在首次启动时会自动创建以下表：

表	用途
players	UUID ↔ Discord ID 映射，验证状态
bans	封禁记录（Minecraft 及 Discord）
mutes	禁言记录，支持时长
chat_logs	来自两个平台的完整聊天记录
verification_codes	带有效期的活动验证码

---

⚡ 性能

• 异步操作 — 所有数据库查询均不在主服务器线程上运行
• HikariCP 连接池 — 默认最多 10 个连接（对于 100+ 玩家可配置至 20 个）
• 内存翻译缓存 — 启动后零 I/O 开销
• 内置 Discord 速率限制处理 — 基于 JDA 5.2.3

---

💶 许可协议

NexusBridge 是根据 NexusBridge 商业许可证 v1.0 分发的专有软件。

	个人使用	商业使用
在你的服务器上使用	✅	✅
修改配置文件	✅	✅
从你的服务器获利	✅	✅
重新分发代码	❌	❌
转售此模组	❌	❌
无许可证使用	❌	❌

📌 每个服务器实例需要单独的许可证——每服务器 25€。 如需多服务器许可，请直接联系作者。

请在 BuiltByBit 或 Polymart 购买许可证。

---

🆘 支持

• 🐛 发现 Bug？请在 GitHub 提交 Issue
• 💬 有问题？通过 rochehugo.fr 联系 Not_Found
• 📖 完整文档请参阅仓库 Wiki

提供法语和英语支持。

---

NexusBridge 商业许可证 v1.0 — © 2026 Not_Found