你是服务器管理员吗?是否厌倦了在每个由 100 个 Forge 服务器中添加单个玩家?等等,你只有 2 个 Forge 服务器?好吧,这个模组仍然可以帮到你!
介绍 Whitelist Sync!
一个允许你使用 MySQL 数据库、PostgreSQL 数据库、SQLite 数据库或全新的 Whitelist Sync Web 服务,将多个 Minecraft 服务器的白名单、OP 列表、被封禁的玩家(仅限 Web)和被封禁的 IP(仅限 Web)同步在一起的模组!
此模组会监听所有服务器上白名单、OP、封禁和封禁 IP 的更改(使用正常的 Minecraft 命令),并更新连接到同一数据库的所有其他 Forge 服务器。
Whitelist Sync Web
Whitelist Sync Web 是一项新服务,允许你在实时中将你的白名单、OP、被封禁的玩家和被封禁的 IP 跨所有服务器进行同步。这是一项付费服务,但它有一个免费层级供你试用。这项服务是同步服务器最简单的方法,除了安装模组和设置 API 密钥外,不需要你在端进行任何设置。有兴趣了解更多吗?点击这里。
支持该项目
如果你喜欢这个项目并希望支持它,请考虑使用此链接捐赠。任何金额都值得感激!
下载
所有发布版本都可以在 Modrinth 页面或 CurseForge 上找到。
支持/问题/反馈
关于模组的任何问题,请在 GitHub 上提交一个问题。对于其他支持请求、功能请求或其他一般讨论,请加入 Discord 服务器。
支持的 Forge 版本
- 1.21.3
- 1.21.1
- 1.21
- 1.20.6
- 1.20.2
- 1.20.1
- 1.19.2
- 1.19
- 1.18.2
- 1.16.5
1.12.2(不再支持,未来可能会回归)
支持的 Fabric 版本
- 26.3
- 26.2
- 26.1.2
- 1.21.11
- 1.21.10
- 1.21.8
- 1.21.7
- 1.21.6
- 1.21.5
- 1.21.4
- 1.21.3
- 1.21.2
- 1.21.1
- 1.21
- 1.20.1
支持的 NeoForge 版本
- 26.3
- 26.2
- 26.1.2
- 1.21.11
- 1.21.10
- 1.21.9
- 1.21.8
- 1.21.5
- 1.21.4
- 1.21.3
- 1.21.1
- 1.21
未列出在上述版本中 且早于 1.16.5 的版本可以作为问题提出请求。我会尽力满足需求。Whitelist Sync Web 订阅者优先处理。
安装
注意:此模组不支持以离线模式运行的服务器。
对于 Web 同步(推荐,最简单的设置):
- 请参阅 专用页面 上的 Whitelist Sync Web 设置
适用于 SQLite 数据库配置(需要自建 SQLite 数据库):
- 下载此模组并将其添加到你的 mods 文件夹中。
- 运行一次服务器并设置配置文件(位于 config 文件夹中的 whitelistsync.cfg/whitelistsync-common.toml),然后配置数据库设置和计时器。
- 注意:请确保所有要链接在一起的服务器使用相同的数据库路径!
- 当服务器运行时,如果没有现有数据库,它将创建一个新的数据库。如果你想将当前的白名单推送到新数据库中,请使用命令 "/wl copyServerToDatabase",之后你可以启动其他所有服务器,它们将会与数据库同步。
适用于 MySQL 数据库(需要自建 MySQL 数据库):
- 下载此模组并将其添加到你的 mods 文件夹中。
- 运行一次服务器并设置配置文件(位于 config 文件夹中的 whitelistsync.cfg/whitelistsync-common.toml),然后配置数据库设置和计时器。
- 配置你的 MySQL 数据库的 IP、端口以及身份验证信息,同时设置同步计时器。
- 运行服务器并确保数据库连接成功。注意: 模组会自动为你创建自己的数据库和表,或者连接到现有的数据库。
- 将现有的白名单推送到服务器(/wl copyServerToDatabase),或者从数据库中拉取更改(/wl sync)。
- 享受吧!
适用于 PostgreSQL 数据库(需要自建 PostgreSQL 数据库):
- 设置
databaseMode = "POSTGRESQL"并填写配置文件中的[postgresql]部分(IP、端口、数据库名称、模式、用户名、密码)。 - 注意: 数据库本身必须已经存在。模组会自动为您创建模式和表。
- 将您现有的白名单推送到数据库(/wl copyServerToDatabase)或拉取更改(/wl sync)。
命令
- /wl sync [whitelist|ops|banned-players|banned-ips] | 从数据库刷新本地同步数据。
- /wl push [whitelist|ops|banned-players|banned-ips] | 将本地服务器数据推送到数据库。如果您希望使用当前服务器数据更新数据库,请使用此命令。
- /wl restart | 重启同步线程。如果同步线程停止或出现问题,可以使用此命令。
旧版命令(仅适用于 v2.6.0 及更早版本!)
白名单控制
- /wl add <player> | 将指定玩家添加到白名单。(请替代使用此命令,而非 /whitelist add)
- /wl remove <player> | 从白名单中移除指定玩家。(请替代使用此命令,而非 /whitelist remove)
- /wl list | 列出所有服务器上的已授权用户。
- /wl sync | 从数据库拉取白名单并更新本地服务器的白名单。
- /wl push | 将本地服务器的白名单推送到数据库并进行合并。(v1.5.0 之前的版本请使用 /wl copyServerToDatabase)
Op 控制
- /wlop op <玩家> | 将指定玩家设为 OP。(请替代使用 /op)
- /wlop deop <玩家> | 将指定玩家移除 OP 权限。(请替代使用 /deop)
- /wlop list | 列出所有服务器中拥有 OP 权限的用户。
- /wlop sync | 从数据库拉取 OP 列表并更新本地服务器的 OP 权限。
- /wlop push | 将本地服务器的 OP 权限推送到数据库并进行合并。(v1.5.0 之前的版本使用 /wlop copyServerToDatabase)
该模组通过轮询机制检查自托管数据库中的更改,并相应地更新本地服务器的白名单和 OP 列表。轮询间隔可在配置文件中设置。
请将您的错误报告提交至 GitHub,或者更好的是,直接提交拉取请求!
Are you a server owner who is sick of adding individual players to each of your 100 forge servers? Wait you only have 2 forge servers? Well this mod can help you still!
Introducing Whitelist Sync!
A mod that allows you to sync the whitelists, ops list, banned players (Web only), and banned IPs (Web only) from multiple Minecraft servers together using one MySQL db, PostgreSQL db, SQLite db, or the NEW Whitelist Sync Web service!
This mod listens for whitelist, op, ban, and ban-ip changes (using the normal Minecraft commands) on all of your servers and will update all other forge servers connected to the same database.
Whitelist Sync Web
Whitelist Sync Web is a new service that allows you to sync your whitelist, ops, banned players, and banned IPs across all of your servers in real-time. This service is a paid service, but it does have a free tier for you to try out. This service is the easiest way to sync your servers and requires no setup on your end other than installing the mod and setting the API key. Interested in learning more? Click here.
Support the project
If you like this project and want to support it, consider donating using this link. Any amount is appreciated!
Download
All releases can be found on the Modrinth page or on CurseForge.
Support/Questions/Feedback
For issues with the mod please open an issue on GitHub. For other support requests, feature requests, or other general discussion. Please join the Discord Server.
Supported Forge Versions
- 1.21.3
- 1.21.1
- 1.21
- 1.20.6
- 1.20.2
- 1.20.1
- 1.19.2
- 1.19
- 1.18.2
- 1.16.5
1.12.2(no longer supported, may come back in the future)
Supported Fabric Versions
- 26.3
- 26.2
- 26.1.2
- 1.21.11
- 1.21.10
- 1.21.8
- 1.21.7
- 1.21.6
- 1.21.5
- 1.21.4
- 1.21.3
- 1.21.2
- 1.21.1
- 1.21
- 1.20.1
Supported NeoForge Versions
- 26.3
- 26.2
- 26.1.2
- 1.21.11
- 1.21.10
- 1.21.9
- 1.21.8
- 1.21.5
- 1.21.4
- 1.21.3
- 1.21.1
- 1.21
Versions not listed above and before 1.16.5 can be requested as an issue. I will try my best to accommodate. Whitelist Sync Web subscribers take priority.
Installation
Note: This mod does not support servers running in offline mode.
For Web Sync (Recommended, easiest setup):
- See the Whitelist Sync Web setup on the dedicated page
For SQLite database config (Requires self-hosted SQLite database):
- Download this mod and add it to your mods folder.
- Run your server once and set up the config (whitelistsync.cfg/whitelistsync-common.toml located in the config folder) and configure your database settings and timers.
- NOTE: Be sure to make the database path the same for all the servers you want to link together!
- When the server runs it is going to make a new database unless one already exists. If you want to push your current whitelist to the new database use "/wl copyServerToDatabase" then you can start all of your other servers and they will sync to the database.
For MySQL database (Requires self-hosted MySQL database):
- Download this mod and add it to your mods folder.
- Run your server once and set up the config (whitelistsync.cfg/whitelistsync-common.toml located in the config folder) and configure your database settings and timers.
- Set up your mySQL database IP, port, and authentication as well as the Sync Timer.
- Run server and make sure the database connects. Note: Mod will make its own database and table for you or connect to an existing one.
- Push your existing whitelist to the server (/wl copyServerToDatabase) or pull changes from your database (/wl sync).
- Enjoy!
For PostgreSQL database (Requires self-hosted PostgreSQL database):
- Set
databaseMode = "POSTGRESQL"and fill in the[postgresql]section of the config (IP, port, database name, schema, username, password). - Note: The database itself must already exist. The mod creates the schema and tables for you.
- Push your existing whitelist to the database (/wl copyServerToDatabase) or pull changes (/wl sync).
Commands
- /wl sync [whitelist|ops|banned-players|banned-ips] | Refreshes local synced data from database.
- /wl push [whitelist|ops|banned-players|banned-ips] | Pushes local server data to the database. Use this if you want to update the database with the current server data.
- /wl restart | Restarts the sync thread. Useful if the sync thread stops or has issues.
Legacy Commands (For v2.6.0 and below ONLY!)
Whitelist Control
- /wl add <player> | Adds a specified player to whitelist. (Use this instead of /whitelist add)
- /wl remove <player> | Removes a specified player from the whitelist. (Use this instead of /whitelist remove)
- /wl list | Lists users whitelisted across all servers.
- /wl sync | Pulls whitelist from the database and updates the local server whitelist.
- /wl push | Pushes local server whitelist to the database and merges them in. (Versions before v1.5.0 use /wl copyServerToDatabase)
Op Control
- /wlop op <player> | Ops a specified player. (Use this instead of /op)
- /wlop deop <player> | De-ops a specified player. (Use this instead of /deop)
- /wlop list | Lists users who are ops across all servers.
- /wlop sync | Pulls list of ops from the database and updates local server ops.
- /wlop push | Pushes local server ops to database and merges them in. (Versions before v1.5.0 use /wlop copyServerToDatabase)
The mod uses polling to check for changes in the self-hosted databases and will update the local server whitelist and ops list accordingly. The polling interval can be set in the config file.
Please post your bugs to GitHub or better yet make a pull request!
下载 Whitelist Sync 2
下载 Whitelist Sync 2
下载 Whitelist Sync 2
下载 Whitelist Sync 2
下载 Whitelist Sync 2
下载 Whitelist Sync 2
下载 Whitelist Sync 2
下载 Whitelist Sync 2
下载 Whitelist Sync 2
下载 Whitelist Sync 2
更新日志
2.10.0 (2026-10-22)
新功能
- 为 mysql 和 sqlite 添加封禁同步 (a045ada)
- 添加 Fabric 26.3 模块 (8a3784a)
- 添加用于生成新 MC 版本的 Gradle 任务 (7457db8)
- 添加 NeoForge 26.3 模块 (c80e22d)
- 新增 postgres 数据库支持 (5147ea1)
- 集中管理支持的版本并实现动态模块选择 (473a85f)
修复
- 并发问题 (bfb44d2)
- 修正 NeoForge ServerControl 中的版本号字符串转换 (8a772fc)
- 启用并修复现有 Fabric 模块的版本检查 (9e9ce98)
- 封禁逻辑按活动模式而非仅限 Web 进行限制 (bb1f403)
- 日志记录不正确 (a3d7dd9)
- 修复在 shaded gson 2.8.5 下 json 读取器崩溃的问题 (7a4310f)
- postgres: 二进制列需要使用
rs.getBoolean而不是rs.getInt(74870fb) - 移除 mysql 连接字符串中硬编码的 useSSL url 参数,改为可配置项。 (0da98ef)
- 优化性能低下的 O(n²) 同步逻辑。改用哈希集合代替每次循环扫描整个列表 (e2a0206)
[2.9.0] - 2026-07-06
- 为 NeoForge 和 Fabric 添加对新 Minecraft 版本的支持:
- fabric-26.1.2
- fabric-26.2
- neoforge-26.1.2
- neoforge-26.2
- 移除了 Forge 子项目 —— ForgeGradle 与 Gradle 9 不兼容。
- 将多版本源文件和构建脚本去重,整合到共享的 Fabric/NeoForge 构建逻辑中。
- 重构 CI 流程,采用基于 Java 21 + 25 的子项目矩阵构建,以解决 OOM(内存溢出)问题并支持 MC 26.x。
- 通过重新定位内置的 Gson,解决了 NeoForge 26.2 核心模组冲突问题。
[2.8.3] - 2025-12-14
- 为 NeoForge 和 Fabric 添加对新 Minecraft 版本的支持:
- fabric-1.21.11
- neoforge-1.21.11
- 将 SQLite 和 MySQL 数据库驱动重新打包进模组 jar 包。不再需要外部连接器模组 jar 包。
- 重构了包名,使其在所有版本和加载器中保持一致。
- 修复了命令 mixin 未正确转换为正确对象类型导致执行命令时出错的 bug。
- 修复了版本检查器无法工作的问题。
- 修复了在读取被封禁的玩家和 IP 的 json 文件时,若包含无原因记录的条目则出错的问题。
[2.8.2] - 2025-10-17
为 NeoForge 和 Fabric 添加对新 Minecraft 版本的支持:
- fabric-1.21.6
- fabric-1.21.7
- fabric-1.21.8
- fabric-1.21.10
- neoforge-1.21.8
- neoforge-1.21.9
- neoforge-1.21.10
错误修复:
- 修复 #33 [MySQL] 当数据库名称包含 '-' 字符时无法创建数据库
由于 ForgeGradle 与 Gradle v9 不兼容,Forge 将不再获得主动支持。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
模组
那是什么?一个 Waila/Hwyla 的分支。
评论 0
登录后参与评分
还没有评论,来抢沙发吧