SideGate

插件

· 作者 TamKungZ_

SideGate 允许 Bukkit 服务器在保持 online-mode=true 的同时,让正版玩家(Mojang 验证账户)和已批准的访客(无 Mojang 验证账户的玩家)加入。

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

最新 2.0.1 · 26.3 · Bukkit / Paper

一键开服(送7天)

SideGate

SideGate Logo

面向在线模式服务器的混合访问控制
在保持在线模式安全性的同时,有选择地允许管理员批准的访客账户。

In-Game Screenshot

什么是 SideGate?

SideGate 是一个兼容 Bukkit 的插件(支持 Spigot/Paper/Folia/Purpur),专为希望保持 online-mode=true 同时有选择地允许管理员批准的访客账户加入的服务器设计。

经过身份验证的玩家继续使用服务器的标准登录流程,而获批准的访客账户则通过可配置的 SideGate 访问策略进行处理。

当安装了 Floodgate 或 Geyser-Spigot 时,检测到的基岩版玩家将继续走基岩版认证路径,不会被视作 SideGate 访客。

SideGate 2.0.0 还可以在 Velocity 后端的 Bukkit 后端上运行。此时由 Velocity 处理登录决策,而 Bukkit 负责应用访客消息和游戏设置。

为什么使用 SideGate?

  • 为已验证玩家保持标准的在线模式行为。
  • 避免更改整个服务器的认证模式。
  • 精确控制哪些访客账户可以加入。
  • 对访客账户应用限制和视觉标签。

核心功能

  • 可选登录引擎: login-engine 可使用 ProtocolLib、内置引擎或自动选择(auto)。
  • 混合登录流程: 已验证玩家使用标准服务器登录过程,而获批准的访客账户遵循 SideGate 访问规则。
  • 手动账户覆盖: premium-usernames 始终走标准登录路径。
  • 账户会话失败策略: 在加密前将登录 UUID 与 Mojang 进行比较,然后显示自定义的名称冲突消息或作为访客继续。
  • 访客准入策略: 使用 allow-all-guests 或 allowed-guests。
  • 可选账户检测: 使用内部缓存进行可选的账户状态查询(auto-detect-premium)。
  • Floodgate/Geyser 支持: 当安装任一 Bukkit 插件时,自动绕过对检测到的基岩版玩家的访客分类。
  • 故障关闭认证: 如果账户查询失败,玩家保持在标准在线模式登录中,而不是被授予访客访问权限。
  • 访客处理: 应用访客标签、游戏模式、标题、副标题和消息。
  • 访客聊天前缀: 前缀仅应用于带有访客标签的玩家。
  • 运行时重载: /sidegate reload。
  • 公共 API: 附加插件可以通过 SideGate API 服务进行集成。
  • Velocity 后端模式: 使用 proxy-mode.enabled 将代理认证与 Bukkit 访客操作分离。

安装

可选依赖项: ProtocolLib (SpigotMC)

  1. 可选安装 ProtocolLib (5.x+)。如果没有安装,SideGate 将使用其内置的登录引擎。
  2. 可选安装 Floodgate 和/或 Geyser-Spigot 以自动检测基岩版玩家。
  3. 将 SideGate .jar 文件放入 /plugins 文件夹。
  4. 在独立 Bukkit 模式下,在 server.properties 中设置 online-mode=true。
  5. 启动或重启服务器。

配置示例

# SideGate Configuration

enable-guest-mode: true

login-engine: auto # 或 protocollib / builtin

proxy-mode:
  enabled: false

auto-detect-premium: true

allow-all-guests: true

premium-usernames:
  - "TamKungZ"

premium-session-failure:
  action: "KICK_WITH_MESSAGE" # 或 FALLBACK_TO_GUEST
  message: "&c此用户名属于高级账户。\n&e请更改您的用户名并重试。"

allowed-guests:
  - "FriendName1"
  - "FriendName2"

guest-settings:
  default-gamemode: "SURVIVAL"
  chat-prefix: "&7[Guest] &r"

messages:
  join-title: "&c访问受限"
  join-subtitle: "&7访客模式"
  join-message:
    - "&c=================================="
    - "&6 欢迎使用 SideGate 协议"
    - "&7 账户状态:&c访客(非许可证)"
    - "&7 您受到游戏玩法访问限制。"
    - "&c=================================="

要求

  • Java: 17+
  • 服务器: Spigot / Paper / Folia / Purpur (兼容 Bukkit)
  • 可选依赖项: ProtocolLib 5.x+ (SpigotMC) (GitHub)
  • 可选集成: Floodgate, Geyser-Spigot

错误报告

请在以下地址提交问题:

请包含以下内容:

  • 服务器软件及确切版本
  • Java 版本
  • ProtocolLib 版本
  • SideGate 版本
  • 相关的启动/登录日志

项目状态与许可

闭源

  • 允许正常服务器使用。
  • 允许使用 SideGate 公共 API 的独立附加插件。
  • 未经许禁止修改、重新分发或重新打包。
  • 商业使用或变现需事先通过电子邮件获得许可:dev@tamkungz.me

公共参考快照:

(sidegate-1.0.0-rc.1)


安全须知

访客账户访问可能会引入身份验证限制。对于生产服务器,请使用身份验证插件并配置严格的权限设置。

如果账户查询不可用,SideGate 不会假定该玩家为访客。服务器的标准在线模式登录仍负责处理连接。

FALLBACK_TO_GUEST 是一项高风险的全服策略。它允许未经验证的客户端使用已注册到官方账户的用户名加入游戏,并使用访客 UUID。请配合使用身份验证插件和基于 UUID 的权限系统。

会话失败策略需要 auto-detect-premium: true。

故意伪造确切官方 UUID 的客户端将保持在标准在线模式认证下,无法绕过 Mojang 会话验证。

使用 Velocity 时,请配置安全的玩家转发功能,切勿公开暴露后端端口。 保持 Velocity online-mode=true,并将 Bukkit 后端设置为 online-mode=false。 SideGate Velocity 需要 player-info-forwarding-mode="modern",并保留由 Floodgate 或其他代理身份验证插件已设置的登录结果。

加密会话的 FALLBACK_TO_GUEST 模式仅在独立 Bukkit 模式下可用。通过 Velocity 路由且已注册到官方账户的用户名必须通过正常的 Mojang 会话验证,但 SideGate Velocity 可以将通用的无效会话响应替换为可配置的消息。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源