monban 是一个白名单、访问控制和权限插件,支持明确的 ONLINE(在线)、OFFLINE(离线)和 FLOODGATE 玩家身份标识。它支持独立的 Bukkit/Spigot 以及 Paper/Folia 服务器,并可以作为带有 Geyser/Floodgate 支持的 Velocity 网络的中央访问授权中心,具备玩家分组、受限后端访问和同步后端权限等功能。
支持的平台
| 平台 | 部署方式 | 全局白名单 | 玩家权限 | 受限后端访问 | 混合认证 | Floodgate 身份标识 |
|---|---|---|---|---|---|---|
| Bukkit / Spigot | 独立或后端 | ✓ | ✓ | — | — | — |
| Paper / Folia | 独立或后端 | ✓ | ✓ | — | — | — |
| Velocity | 网络权威 | ✓ | ✓ | ✓ | ✓ | ✓ |
Paper/Folia 的构建版本是 Paper 插件,与 Bukkit/Spigot 兼容构建版本是分开的。混合认证流程的选择由 Velocity 负责;Paper/Folia 插件不实现 deployment.mode: VELOCITY。
功能特性
- 使用明确的
ONLINE、OFFLINE和FLOODGATE身份标识,而不是通过 UUID 的存在来推断信任关系。 - 在 Velocity 上可选地集成 Geyser/Floodgate 以支持已认证的基岩版玩家。
- 玩家分组独立于 Velocity 的
SERVER_GROUP定义。 - 为代理和后端的插件提供分组和直接玩家权限。
- 访问规则和权限支持
NETWORK(网络)、SERVER_GROUP(服务器组)和SERVER(服务器)范围。 - 针对单个后端服务器和服务器的分组访问授予。
- 在所有支持平台上统一使用
/monban whitelist管理模型。 - 运行时支持
/monban whitelist enable和/monban whitelist disable。 - 自动根据玩家名称查找 ONLINE 配置文件,但仍提供显式 UUID 输入选项。
- 交互式白名单和受限访问列表,支持分页和保留过滤条件的导航。
- 在 Velocity 上强制执行全网络白名单。
- 每个后端支持
OPEN(开放)和GRANT_REQUIRED(需授予)访问策略。 - 在 Velocity 上使用
/monban lookup <player>查看身份和白名单状态详情。 - 在 Velocity 上使用
/monban status获取运行时访问摘要。 - 具有分组和直接授予来源的有效访问检查。
- 可选的 Velocity 混合
ONLINE/OFFLINE认证流程选择。 - 将 Velocity 的中心化状态同步到 Bukkit 和 Paper 后端。
- 本地后端权限无需依赖 LuckPerms。
- 感知权限的命令帮助,以及在权限更新后刷新后端命令树。
- 跨白名单、受限访问、分组和直接权限的 Floodgate 管理。
- 在 Paper 平台边界处原生支持 Folia 兼容的调度。
- 严格且带版本控制的 YAML 配置及持久化的访问状态。
- 启动时采用“失败关闭”模式,并在安全敏感初始化失败时进行访问验证。
要求
monban 插件字节码基于 Java 21。服务器运行时要求因平台和版本而异;特别是,Paper 26.1+ 需要 Java 25 才能运行。
安装
- 从 Modrinth 或 GitHub Releases 下载适合你平台的构建版本。
- 将 JAR 文件放入平台的
plugins/目录中。 - 对于独立的 Bukkit/Spigot 或 Paper/Folia,请将原生 Minecraft 白名单设置为
white-list=false。 - 启动服务器一次,配置
plugins/monban/config.yml,然后重启。 - 使用
/monban whitelist ...管理访问权限。Velocity 还提供/monban access ...、/monban lookup ...、/monban group ...、/monban user ...和/monban status。
请勿在同一服务器上安装多个 monban 平台构建版本。
独立服务器
对于独立服务器,monban 是白名单权威机构。请在 server.properties 中禁用原生白名单:
white-list=false
白名单可以在运行时更改:
/monban whitelist enable
/monban whitelist disable
要实现自动 ONLINE 配置文件解析,请使用:
/monban whitelist add online <name>
显式 UUID 输入仍然可用,使用 /monban whitelist add online <name> <uuid> 并绕过配置文件查找。
Floodgate 身份解析由 Velocity 构建版本处理。独立服务器和后端的构建版本继续使用 Java ONLINE 和 OFFLINE 身份标识。
Velocity 网络
Velocity 是网络白名单、后端访问、分组和权限的中心权威机构。在 Velocity 上安装 monban-velocity,并在所有应用同步权限的后端上安装匹配的 Bukkit/Spigot 或 Paper/Folia 构建版本。
在 Velocity 上启用后端权限:
backend-permissions:
enabled: true
Velocity 会自动创建 plugins/monban/sync.yml。将生成的文件及其相同内容复制到每个启用的后端。不要将 state-revision 复制到后端。
在后端的 config.yml 中启用后端权限,并将 server-name 设置为 Velocity 中注册的精确服务器名称:
backend-permissions:
enabled: true
server-name: lobby
后端会自动创建 server-groups.yml。仅在使用 SERVER_GROUP 权限或访问授予时才需要匹配服务器组映射。
在集中式模式下,白名单、分组和权限管理均在 Velocity 上执行。后端服务器不管理单独的本地 monban 状态,从而防止不同服务器出现不同的白名单或权限。
以下是使用 Chunky 的后端权限设置示例:
/monban group create moderator
/monban group moderator access grant server lobby
/monban group moderator permission add server lobby chunky.command.start
/monban group moderator permission add server lobby chunky.command.cancel
/monban user hanamuramiyu offline group add moderator
重新连接玩家并检查 /chunky 的 Tab 补全功能,然后根据情况运行 /chunky start 或 /chunky cancel。
Geyser 和 Floodgate
Velocity 支持 Geyser 和 Floodgate。Geyser 接受来自基岩版(Bedrock)的连接,Floodgate 提供经过身份验证的基岩版身份标识,而 monban 会将该连接评估为 FLOODGATE 身份标识。Bukkit 和 Paper 构建版本继续对 Java 版玩家使用 ONLINE 和 OFFLINE 身份标识;它们自身不会解析 Floodgate 身份标识。
在代理端安装 Geyser、Floodgate 和 monban。在生成的 Velocity 配置中启用 Floodgate:
identity:
mode: AUTO
floodgate:
enabled: true
require-provider: true
默认情况下禁用 Floodgate 集成。当基岩版访问控制是生产网络的一部分时,建议设置 require-provider: true:monban 将在启动时明显失败,而不是在没有预期的 Floodgate 提供者的情况下运行。
在向基岩版玩家添加白名单时,请使用报告给 monban 的标准 Floodgate Java 用户名,包括其配置的自定义前缀。对于未链接的基岩版账号,这通常是服务器可见的名称:
/monban whitelist add floodgate .BedrockName
标准名称是可用的持久访问密钥。可以通过 /monban whitelist add floodgate <name> <xuid> 提供可选的 XUID,但它仅作为元数据存储,不会改变身份匹配逻辑。因此,Floodgate 名称更改会导致访问密钥发生变化。
同步的后端权限附加到后端能够解析的 Java ONLINE 或 OFFLINE 身份标识上。Floodgate 组权限和直接权限由 Velocity 进行评估以决定准入和代理权限;它们不会在后端被重新匹配为 FLOODGATE 身份标识。
文档
完整的安装、配置、命令、存储、权限、Geyser/Floodgate、后端同步以及混合认证文档可在 monban.miyu.pw 获取。
构建
./gradlew clean build
许可证
monban 遵循 Mozilla Public License 2.0 许可协议。
monban
Minecraft access control for standalone servers and Velocity networks.
monban is a whitelist, access-control, and permissions plugin with explicit ONLINE, OFFLINE, and FLOODGATE player identities. It supports standalone Bukkit/Spigot and Paper/Folia servers, and can act as the central access authority for a Velocity network with Geyser/Floodgate support, player groups, scoped backend access, and synchronized backend permissions.
Supported platforms
| Platform | Deployment | Global whitelist | Player permissions | Scoped backend access | Hybrid auth | Floodgate identity |
|---|---|---|---|---|---|---|
| Bukkit / Spigot | Standalone or backend | ✓ | ✓ | — | — | — |
| Paper / Folia | Standalone or backend | ✓ | ✓ | — | — | — |
| Velocity | Network authority | ✓ | ✓ | ✓ | ✓ | ✓ |
The Paper/Folia artifact is a Paper plugin and is separate from the Bukkit/Spigot compatibility artifact. Hybrid authentication-flow selection belongs to Velocity; the Paper/Folia plugin does not implement deployment.mode: VELOCITY.
Features
- Explicit
ONLINE,OFFLINE, andFLOODGATEidentities instead of inferring trust from the presence of a UUID. - Optional Geyser/Floodgate integration on Velocity for authenticated Bedrock players.
- Player groups separate from Velocity
SERVER_GROUPdefinitions. - Group and direct player permissions for proxy and backend plugins.
NETWORK,SERVER_GROUP, andSERVERscopes for access rules and permissions.- Group access grants for individual backend servers and server groups.
- One
/monban whitelistadministration model across supported platforms. - Runtime
/monban whitelist enableand/monban whitelist disable. - Automatic ONLINE profile lookup by player name, with explicit UUID input still available.
- Interactive whitelist and scoped-access lists with pagination and filter-preserving navigation.
- Network-wide whitelist enforcement on Velocity.
- Per-backend
OPENandGRANT_REQUIREDaccess policies. /monban lookup <player>on Velocity for identity and whitelist status details./monban statuson Velocity for a runtime access summary.- Effective access inspection with group and direct-grant origins.
- Optional Velocity hybrid
ONLINE/OFFLINEauthentication-flow selection. - Centralized Velocity state synchronization to Bukkit and Paper backends.
- Local backend permissions without requiring LuckPerms.
- Permission-aware command help and backend command-tree refresh after permission updates.
- Floodgate administration across whitelist, scoped access, groups, and direct permissions.
- Native Folia-compatible scheduling at the Paper platform boundary.
- Strict, versioned YAML configuration and persistent access state.
- Fail-closed startup and access verification for security-sensitive initialization failures.
Requirements
monban plugin bytecode targets Java 21. Server runtime requirements are platform/version-specific; in particular, Paper 26.1+ requires Java 25 to run.
Install
- Download the build for your platform from Modrinth or GitHub Releases.
- Put the JAR in the platform's
plugins/directory. - For standalone Bukkit/Spigot or Paper/Folia, set the native Minecraft whitelist to
white-list=false. - Start the server once, configure
plugins/monban/config.yml, then restart. - Manage access with
/monban whitelist .... Velocity additionally provides/monban access ...,/monban lookup ...,/monban group ...,/monban user ..., and/monban status.
Do not install multiple monban platform builds on the same server.
Standalone servers
For standalone servers, monban is the whitelist authority. Disable the native whitelist in server.properties:
white-list=false
The whitelist can be changed at runtime:
/monban whitelist enable
/monban whitelist disable
For automatic ONLINE profile resolution, use:
/monban whitelist add online <name>
Explicit UUID input remains available with /monban whitelist add online <name> <uuid> and bypasses profile lookup.
Floodgate identity resolution belongs to the Velocity build. Standalone and backend builds continue to use Java ONLINE and OFFLINE identities.
Velocity networks
Velocity is the central authority for the network whitelist, backend access, groups, and permissions. Install monban-velocity on Velocity and the matching Bukkit/Spigot or Paper/Folia build on every backend that should apply synchronized permissions.
Enable backend permissions on Velocity:
backend-permissions:
enabled: true
Velocity creates plugins/monban/sync.yml automatically. Copy the generated file with the same contents to every enabled backend. Do not copy state-revision to backends.
Enable backend permissions in the backend's config.yml and set server-name to the exact registered server name from Velocity:
backend-permissions:
enabled: true
server-name: lobby
The backend creates server-groups.yml automatically. Matching server-group mappings are only needed when SERVER_GROUP permissions or access grants are used.
In centralized mode, whitelist, group, and permission administration is performed on Velocity. Backend servers do not manage a separate local monban state, preventing different whitelists or permissions on different servers.
Example backend permission setup using Chunky:
/monban group create moderator
/monban group moderator access grant server lobby
/monban group moderator permission add server lobby chunky.command.start
/monban group moderator permission add server lobby chunky.command.cancel
/monban user hanamuramiyu offline group add moderator
Reconnect the player and check /chunky tab completion, then run /chunky start or /chunky cancel as appropriate.
Geyser and Floodgate
Geyser and Floodgate support is available on Velocity. Geyser accepts Bedrock connections, Floodgate supplies the authenticated Bedrock identity, and monban evaluates that connection as a FLOODGATE identity. The Bukkit and Paper builds continue to use ONLINE and OFFLINE identities for Java players; they do not resolve Floodgate identities themselves.
Install Geyser, Floodgate, and monban on the proxy. Enable Floodgate in the generated Velocity configuration:
identity:
mode: AUTO
floodgate:
enabled: true
require-provider: true
Floodgate integration is disabled by default. require-provider: true is recommended when Bedrock access control is part of the production network: monban will fail visibly at startup instead of running without the expected Floodgate provider.
Use the normalized Floodgate Java username reported to monban, including its configured prefix, when adding a Bedrock player. For an unlinked Bedrock account this is normally the server-visible name:
/monban whitelist add floodgate .BedrockName
The normalized name is the durable access key. An optional XUID may be supplied with /monban whitelist add floodgate <name> <xuid>, but it remains metadata and does not change identity matching. A Floodgate name change therefore changes the access key.
Synchronized backend permissions are attached to the Java ONLINE or OFFLINE identity that the backend can resolve. Floodgate groups and direct permissions are evaluated by Velocity for admission and proxy permissions; they are not re-matched as FLOODGATE identities on a backend.
Documentation
Full setup, configuration, commands, storage, permissions, Geyser/Floodgate, backend synchronization, and hybrid authentication documentation is available at monban.miyu.pw.
Building
./gradlew clean build
License
monban is licensed under the Mozilla Public License 2.0.
下载 monban (Whitelist)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 monban (Whitelist)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 monban (Whitelist)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 monban (Whitelist)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 monban (Whitelist)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 monban (Whitelist)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 monban (Whitelist)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 monban (Whitelist)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 monban (Whitelist)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 monban (Whitelist)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
monban 3.3.0 — Geyser & Floodgate Release
monban 3.3.0 是一个针对 Geyser 和 Floodgate 的更新,它将经过身份验证的基岩版玩家纳入 Velocity 上的 monban 访问控制模型中。
基岩版连接现在可以解析为独立的 FLOODGATE 身份,而不是被当作 Java 版的 ONLINE 或 OFFLINE 玩家处理。Floodgate 仍是可选的:纯 Java 网络不需要它,现有的 Java 访问记录也保持其原有含义。
亮点
- Velocity 上支持可选的 Geyser 和 Floodgate 集成
- 新增
FLOODGATE身份类型,独立于 Java 版的ONLINE和OFFLINE - Floodgate 的 Java 用户名经过规范化处理,并用作持久的访问密钥
- 配置的前缀和空格替换功能适用于默认的
.Name格式 - XUID 作为可选元数据保留,不改变身份匹配逻辑
- Floodgate 选择器可用于白名单、作用域访问、组以及直接权限
- Velocity 配置文件中包含明确的
identity.floodgate设置 - Floodgate 集成默认处于禁用状态
- Floodgate 是 Velocity 的可选依赖项,并具有正确的插件加载顺序
- 一旦检测到提供程序,提供程序的故障将拒绝连接,而不是静默回退到 Java 身份
require-provider: true会在启动时因缺少 Floodgate API 而明显报错- 现有的 Java 身份处理和访问记录保持兼容
下载
选择适合您平台的 JAR 文件:
monban-bukkit-spigot-3.3.0.jar— Bukkit / Spigotmonban-paper-folia-3.3.0.jar— Paper / Foliamonban-velocity-3.3.0.jar— Velocity
请勿在同一服务器上安装多个平台版本的构建包。
Java
monban 面向 Java 21 字节码。
运行时要求仍然取决于 Minecraft 平台和版本。特别是,Paper 26.1+ 需要 Java 25。
独立服务器
对于独立的 Bukkit、Spigot、Paper 或 Folia 服务器,必须禁用 Minecraft 原生的白名单:
white-list=false
monban 仍作为本地白名单的管理者,并提供 /monban whitelist 命令用于管理。
Floodgate 身份解析属于 Velocity 构建部分。独立服务器和后端构建包继续使用 Java 版的 ONLINE 和 OFFLINE 身份。
Velocity 网络
Velocity 仍然是网络准入、后端作用域访问、玩家组和权限的中心权威机构。
现有的 Java 访问记录和后端同步继续像以前一样工作。
Geyser 和 Floodgate
在 Velocity 上安装 Geyser、Floodgate 和 monban。在 plugins/monban/config.yml 中启用集成:
identity:
mode: AUTO
floodgate:
enabled: true
require-provider: true
Floodgate 默认处于禁用状态。当基岩版访问控制是生产网络的一部分时,建议使用 require-provider: true:如果无法发现 Floodgate API,monban 将在启动时明显报错。
一旦检测到提供程序,登录期间的提供程序错误将拒绝连接,而不是静默回退到 Java 身份。
使用报告给 monban 的 Floodgate Java 用户名,包括为未链接账户配置的前缀。XUID 仅为可选元数据,不作为匹配键:
/monban whitelist add floodgate .BedrockName
/monban access grant server survival floodgate .BedrockName
/monban user .BedrockName floodgate group add bedrock
对于已链接的账户,Floodgate 报告的 Java 用户名可能与原始基岩版名称不同。请使用 monban 实际报告的值。
同步的后端权限继续应用于由后端解析的 Java 版 ONLINE 或 OFFLINE 身份。Floodgate 组和直接权限在 Velocity 上进行评估,在 3.3.0 版本中不会在后端重新匹配为 FLOODGATE。
升级
现有的 Java 访问记录保留其 ONLINE 和 OFFLINE 的含义。没有 Floodgate 块的 Velocity 配置会接收显式的默认值,因此升级后请检查重写后的配置文件。Floodgate 直到明确启用之前仍处于禁用状态。
请参阅 3.3 升级指南 以获取完整的检查清单。
文档
完整设置指南、配置参考、命令、权限、Velocity 设置、Geyser 和 Floodgate 设置、后端同步以及混合认证文档:
感谢所有使用 monban 并在过程中分享反馈的人 (˶ ¯ ꇴ ¯ ˶)
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧