? NexusBridge
Discord ↔ Minecraft 桥接 — NeoForge 1.21.1
专为 NeoForge 1.21.1 打造的全面 Discord ↔ Minecraft 集成方案
✨ 功能特性
? 双向聊天同步
游戏内发送的消息会即时显示在 Discord 上,反之亦然——完整保留用户名和前置格式。
?️ 完整的制裁管理
封禁、临时封禁和静音操作会在两个平台间实时同步。解封和解除静音操作会自动传播。
✅ 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 Bot Token |
— |
⚠️ 仅限服务端。 玩家无需在客户端安装任何内容。
? 安装指南
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 <player> [reason] |
封禁一名玩家 |
nexusbridge.ban |
/nexus_mute <player> [duration] [reason] |
静音一名玩家 |
nexusbridge.mute |
/nexus_unban <player> |
解封一名玩家 |
nexusbridge.unban |
/nexus_unmute <player> |
解除静音一名玩家 |
nexusbridge.unmute |
/nexus_verify |
获取你的验证链接 |
— |
Discord
| 命令 |
描述 |
所需角色 |
/verify |
获取验证码 |
所有人 |
/verify <code> |
绑定你的 Minecraft 账号 |
所有人 |
/status |
显示服务器状态 |
所有人 |
/ban <user> [reason] |
封禁一名 Discord 用户 |
Admin |
/mute <user> [reason] |
静音一名 Discord 用户 |
Moderator |
?️ 数据库结构
NexusBridge 在首次启动时会自动创建以下表:
| 表名 |
用途 |
players |
UUID ↔ Discord ID 映射,验证状态 |
bans |
封禁历史(Minecraft 与 Discord) |
mutes |
带时长支持的静音历史 |
chat_logs |
来自两个平台的完整聊天记录 |
verification_codes |
带有过期时间的有效验证码 |
⚡ 性能优化
- 异步操作 —— 所有数据库查询均在主服务器线程之外运行
- HikariCP 连接池 —— 默认最多 10 个连接(可配置至 20 以支持 100+ 玩家)
- 内存翻译缓存 —— 启动后零 I/O 开销
- 内置 Discord 速率限制处理 —— 基于 JDA 5.2.3
? 许可协议
NexusBridge 是专有软件,根据 NexusBridge Business License v1.0 分发。
|
个人使用 |
商业使用 |
| 在你的服务器上运行 |
✅ |
✅ |
| 修改配置文件 |
✅ |
✅ |
| 商业化运营服务器 |
✅ |
✅ |
| 重新分发源代码 |
❌ |
❌ |
| 转售本模组 |
❌ |
❌ |
| 无许可证使用 |
❌ |
❌ |
? 技术支持
- ? 发现了 Bug?在 GitHub 上提交 Issue
- ? 完整文档可在仓库 Wiki 查阅
支持提供 法语 和 英语。
?️ 路线图
- 用于服务器管理的 Web 仪表盘
- 用于详细日志记录的 Discord Webhook
NexusBridge 商业许可证 v1.0 — © 2026 Not_Found
? NexusBridge
Discord ↔ Minecraft Bridge — NeoForge 1.21.1
The most complete Discord ↔ Minecraft integration for NeoForge 1.21.1
✨ Features
? Bidirectional Chat Sync
Messages sent in-game appear on Discord, and Discord messages appear in Minecraft — instantly, with full username and prefix formatting.
?️ Full Sanctions Management
Bans, temporary bans, and mutes are synchronized across both platforms in real time. Unban and unmute operations are automatically propagated.
✅ Discord Verification System
Link your players' Minecraft accounts to their Discord identities with a secure 6-digit code system. Codes expire after 5 minutes. Unverified players can optionally be kicked.
? LuckPerms Integration
Full support for LuckPerms permission groups — control who can ban, mute, and manage players directly from Discord or in-game.
? Database Persistence (MariaDB / MySQL)
All data (players, bans, mutes, chat logs, verification codes) is stored in a MariaDB/MySQL database via a HikariCP connection pool for maximum reliability and performance.
? Full i18n Support
NexusBridge ships with French and English translations out of the box. Adding new languages is as simple as dropping a new file.
? Requirements
| Requirement |
Version |
| Minecraft Java Edition |
1.21.1 |
| NeoForge |
21.1.77+ |
| Java |
21 (LTS) |
| MariaDB or MySQL |
8.0+ |
| Discord Bot Token |
— |
⚠️ Server-side only. Players do not need to install anything on their client.
? Installation
1. Download & install
Download the latest JAR and drop it into your server's mods/ folder.
2. Set up the database
mysql -u root -p < setup.sql
3. Start the server once
NexusBridge will generate its configuration file at:
config/nexusbridge/config.json
4. Configure
Fill in the required fields:
{
"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. Restart & enjoy ?
? Commands
Minecraft
| Command |
Description |
Permission |
/nexus_ban <player> [reason] |
Ban a player |
nexusbridge.ban |
/nexus_mute <player> [duration] [reason] |
Mute a player |
nexusbridge.mute |
/nexus_unban <player> |
Unban a player |
nexusbridge.unban |
/nexus_unmute <player> |
Unmute a player |
nexusbridge.unmute |
/nexus_verify |
Get your verification link |
— |
Discord
| Command |
Description |
Role required |
/verify |
Get a verification code |
Everyone |
/verify <code> |
Link your Minecraft account |
Everyone |
/status |
Show server status |
Everyone |
/ban <user> [reason] |
Ban a Discord user |
Admin |
/mute <user> [reason] |
Mute a Discord user |
Moderator |
?️ Database Schema
NexusBridge automatically creates the following tables on first start:
| Table |
Purpose |
players |
UUID ↔ Discord ID mapping, verification status |
bans |
Ban history (Minecraft & Discord) |
mutes |
Mute history with duration support |
chat_logs |
Full chat history from both platforms |
verification_codes |
Active codes with expiration |
⚡ Performance
- Async operations — all database queries run off the main server thread
- HikariCP pool — up to 10 connections by default (configurable up to 20 for 100+ players)
- In-memory translation cache — zero I/O overhead after startup
- Built-in Discord rate limit handling via JDA 5.2.3
? Licensing
NexusBridge is proprietary software distributed under the NexusBridge Business License v1.0.
|
Personal use |
Commercial use |
| Use on your server |
✅ |
✅ |
| Modify config files |
✅ |
✅ |
| Monetize your server |
✅ |
✅ |
| Redistribute the code |
❌ |
❌ |
| Resell the mod |
❌ |
❌ |
| Use without a license |
❌ |
❌ |
? Support
- ? Found a bug? Open an issue on GitHub
- ? Full documentation available on the repository wiki
Support is provided in French and English.
?️ Roadmap
- Web dashboard for server management
- Discord webhooks for detailed logging
NexusBridge Business License v1.0 — © 2026 Not_Found
评论 0
登录后参与评分
还没有评论,来抢沙发吧