Bedrock Player Managment for Floodgate (Geyser) - Bedrock Player Management for Floodgate (Geyser)

💡新版本更新（包含 Floodgate 2.0 支持）

如果您从低于 1.4 的版本升级，将会生成新的 config.yml 配置文件，旧文件将被重命名为 [日期]_[时间]_old.config.yml。您需要手动迁移您的配置选项。之后，您可以删除旧的配置文件并启动您的 Minecraft 服务器。

🎮代理版本

如果您在寻找代理版本（适用于 Bungee/Waterfall），请访问：

https://www.spigotmc.org/resources/...ent-for-floodgate-geyser-proxy-edition.94587/

（请注意：代理版本不支持下方常规服务器版本的所有功能！）

🎮ofunnys BedrockPlayerManager

本插件是优秀的 GeyserMC 项目的扩展。Geyser 允许基岩版玩家加入任何 Minecraft Java 版服务器。BedrockPlayerManager 依赖于 GeyserMC 的一部分——Floodgate API。

通过此插件，您可以根据玩家的客户端类型，在其加入服务器网络时执行自定义命令。您可以分别为 Java 版玩家、基岩版玩家或所有玩家执行命令。

本插件还支持权限插件 LuckPerms 和 Vault。当基岩版或 Java 版玩家加入服务器时，会根据其客户端类型自动添加或移除特定的基岩版权限组。

在线体验

您可以在我们的 Minecraft 服务器上体验此插件的实际效果。只需连接至 play.ofunny.world（支持 Java 版或基岩版客户端）。更多信息请访问 ofunny.world 或通过 Discord 获取。

✨主要功能

• 支持 Geyser/Floodgate 单服务器安装。
• 支持 Geyser/Floodgate Bungee/Waterfall 网络。
• 支持 Geyser 独立设置。
• 支持为 Java 版、基岩版或所有玩家执行自定义加入命令。
• 支持通过 LuckPerms 和 Vault 为基岩版玩家添加自定义权限组。

1.4 版本新增功能

• 支持 Floodgate 1.x 和 2.x（自动检测或手动设置）。
• 新增重载命令，可动态更改插件配置（无需重启）。
• 为所有命令添加了 PlaceholderAPI 支持（包含配置选项可开启/关闭）。
• 为玩家 UUID 添加了一个额外的标准占位符 {uuid}。
• 新增退出命令模块（在玩家离开时执行命令）。
• 现在可以为加入命令和权限分配设置独立的执行延迟。

1.3 版本新增功能

• 实现了对 Minecraft 服务器 1.8.8, 1.9.x, 1.10.x, 1.11.x, 1.12.x, 1.13.x, 1.14.x 和 1.15.x 的向后兼容。（Geyser 对于 1.16 之前的服务器依赖 ViaVersion，请务必同时安装它，否则基岩版客户端无法连接）。
• 权限模块添加了完整的 Vault 支持，因此所有 Vault API 支持的权限插件均可使用。例如：Permissions 3, bPermissions, PEX, GroupManager, PermissionsBukkit, zPermission, SimplyPerms, Privileges, DroxPerms, xPerms。更多信息请访问 Vault 资源页面。
• Vault 权限可以按世界或全局应用。
• 现在可以为所有玩家以“独立模式”执行加入命令。Floodgate 现在是软依赖。如果通过设置为 false 来停用 commands.java.enabled、commands.bedrock.enabled 和 permissions.enabled，则可以在没有 Floodgate 的情况下为所有玩家执行命令。

❓使用案例示例

• 为基岩版或 Java 版玩家添加自定义前缀或后缀（例如通过 LuckPerms 前缀）。
• 为基岩版玩家绕过反作弊检查（大多数反作弊插件允许通过权限绕过检查）。
• 根据客户端类型允许或禁止功能、命令、游戏模式或世界访问。
• 在游戏开始时给予物品或将基岩版玩家传送到另一个出生点。
• 通过使用自定义命令或根据玩家客户端类型分配权限，您几乎可以实现任何功能。

🔧如何配置

请访问 ofunny.world 获取更多信息：https://ofunny.world/bedrock-player-manager/#howto

重载命令

您可以使用 /bpm reload 命令来动态更新配置（无需重启）。玩家需要拥有 bedrockplayermanager.reload 权限才能执行此命令。

LuckPerms/Vault 权限

通过启用权限模块，您可以在基岩版玩家加入时自动为其分配一个组。该组会在 Java 版玩家加入时自动移除。不会影响其他已有的组分配。因此，现有的父组将保持不变，不会破坏任何权限或等级系统。

如果您想用分配的基岩版组覆盖 LuckPerms 中的权限，或者想显示前缀/后缀，只需将该组的权重设置为高于服务器上任何其他权限组的权重。请查看此链接了解关于 LuckPerms 组权重的更多信息。

服务器启动后的首次加入

每个模块只会在必要时初始化。这意味着命令和权限模块（如果启用）将在服务器启动后首次有玩家加入时初始化一次。特别是使用 LuckPerms 时，这可能会导致 Essentials 插件产生一次性的“延迟峰值”警告。

这无需担心，对后续运行没有影响。

⭐配置示例

### ofunnys BedrockPlayerManager for Floodgate ###

# 命令模块。
# 此模块在玩家加入服务器时，以服务器（控制台）或玩家身份执行命令（针对Java版、基岩版或所有客户端）。
# 请注意：您不应使用命令模块通过LuckPerms或任何Vault兼容插件分配组。请使用权限模块。
# 所有服务器和玩家命令都支持占位符。因此，您可以使用内置占位符 {player} 和 {uuid}，
# 或者任何由 PlaceholderAPI 支持的占位符（如果已安装并激活）。
# 占位符 {player} 将被替换为加入玩家的名称。
# 占位符 {uuid} 将被替换为加入玩家的 UUID。
# PlaceholderAPI 占位符，如 %luckperms_primary_group_name% 也将被替换（如果正确安装并激活）。
# 每行一个命令，如果为空则使用 {}。

join_commands:
  java:
    enabled: false
    server: {}
    player: {}
  bedrock:
    enabled: false
    server: {}
    player: {}
  all:
    enabled: false
    server: {}
    player: {}
  execution_delay: 1

# 此模块在玩家离开服务器时执行命令（与上述加入命令可能性相同，但"execution_delay"对"quit_commands"无效！）。
quit_commands:
  java:
    enabled: false
    server: {}
    player: {}
  bedrock:
    enabled: false
    server: {}
    player: {}
  all:
    enabled: false
    server: {}
    player: {}

# 权限模块。
# 此模块将在用户通过基岩版客户端加入时，为其添加一个定义的权限组。当用户通过Java版客户端加入时，也会再次移除该组。
# 仅适用于受支持的权限插件（见下方选项），这是添加/移除此类组的推荐方式！
# （对于不受支持的权限插件，您仍然可以使用上面的命令模块通过命令应用权限/组）。
permissions:
  enabled: false
  plugin: "luckperms"
  vault:
    per_world_permissions: false
    worlds: {}
  bedrock_group_name: "bedrock_user"
  execution_delay: 0

# 设置
settings:
  PlaceholderAPI: true
  debug: false

# 开发选项
# 请注意：对开发选项的更改始终需要服务器重启。（插件重载命令会更新值，但它们在下一次重启前不会生效）。
development:
  floodgate_version: "auto"
  Floodgate_v1_PluginName: "floodgate-bukkit"
  Floodgate_v2_PluginName: "floodgate"
  LuckPermsPluginName: "LuckPerms"
  VaultPluginName: "Vault"
  PlaceholderAPIPluginName: "PlaceholderAPI"

# 请勿修改以下行！
version: 1.4

💡支持与反馈

• Discord：https://discord.ofunny.world 频道 #bedrockplayermanager
• 问题反馈：如果您发现任何错误，请在 https://github.com/ofunny/BedrockPlayerManager/issues 报告，或访问上面的 Discord 链接。
• 请注意：请勿在评论部分发布任何错误报告或问题。

感谢您的使用！

—— ofunny