monban (Whitelist)

插件

· 作者 hanamuramiyu

适用于独立服务器和 Velocity 网络的现代 Minecraft 访问控制

0 本站下载 0 关注 更新于 3 周前

最新 3.3.0-velocity · 26.3 · Velocity

一键开服(送7天)
monban

monban

适用于独立服务器和 Velocity 网络的 Minecraft 访问控制插件。

Modrinth · Documentation · GitHub Releases

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 才能运行。

安装

  1. 从 Modrinth 或 GitHub Releases 下载适合你平台的构建版本。
  2. 将 JAR 文件放入平台的 plugins/ 目录中。
  3. 对于独立的 Bukkit/Spigot 或 Paper/Folia,请将原生 Minecraft 白名单设置为 white-list=false。
  4. 启动服务器一次,配置 plugins/monban/config.yml,然后重启。
  5. 使用 /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 许可协议。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源