SideGate
面向在线模式服务器的混合访问控制
在保持在线模式安全性的同时,有选择地允许管理员批准的访客账户。
什么是 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)
- 可选安装 ProtocolLib (5.x+)。如果没有安装,SideGate 将使用其内置的登录引擎。
- 可选安装 Floodgate 和/或 Geyser-Spigot 以自动检测基岩版玩家。
- 将 SideGate
.jar文件放入/plugins文件夹。 - 在独立 Bukkit 模式下,在
server.properties中设置online-mode=true。 - 启动或重启服务器。
配置示例
# 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 可以将通用的无效会话响应替换为可配置的消息。
SideGate
Hybrid Access Control for Online-Mode Servers
Keep online-mode security while selectively allowing administrator-approved guest accounts.
What is SideGate?
SideGate is a Bukkit-compatible plugin (Spigot/Paper/Folia/Purpur) designed for servers that want to keep online-mode=true while selectively allowing administrator-approved guest accounts.
Authenticated players continue using the server's standard login flow, while approved guest accounts are handled through configurable SideGate access policies.
When Floodgate or Geyser-Spigot is installed, detected Bedrock players remain on the Bedrock authentication path and are not treated as SideGate guests.
SideGate 2.0.0 can also run on Bukkit backends behind SideGate for Velocity. Velocity handles the login decision while Bukkit applies Guest messages and gameplay settings.
Why use SideGate?
- Keep standard online-mode behavior for authenticated players.
- Avoid changing the entire server authentication mode.
- Control exactly which guest accounts may join.
- Apply restrictions and visual labels to guest accounts.
Core Features
- Selectable Login Engine:
login-enginecan use ProtocolLib, the built-in engine, or pick automatically (auto). - Hybrid Login Flow: Authenticated players use the standard server login process, while approved guest accounts follow SideGate access rules.
- Manual Account Override:
premium-usernamescan always follow the standard login path. - Account Session Failure Policy: Compare the login UUID with Mojang before encryption, then show a custom name-conflict message or continue as Guest.
- Guest Admission Policy: Use
allow-all-guestsorallowed-guests. - Optional Account Detection: Optional account status lookup with internal cache (
auto-detect-premium). - Floodgate/Geyser Support: Automatically bypass guest classification for detected Bedrock players when either Bukkit plugin is installed.
- Fail-Closed Authentication: If the account lookup fails, players stay on the standard online-mode login instead of being granted guest access.
- Guest Handling: Apply guest tags, GameModes, titles, subtitles, and messages.
- Guest Chat Prefix: Prefix applies to guest-tagged players only.
- Runtime Reload:
/sidegate reload. - Public API: Addon plugins can integrate through SideGate API services.
- Velocity Backend Mode: Use
proxy-mode.enabledto separate proxy authentication from Bukkit Guest actions.
Installation
Optional dependency: ProtocolLib (SpigotMC)
- Optionally install ProtocolLib (5.x+). Without it, SideGate uses its built-in login engine.
- Optionally install Floodgate and/or Geyser-Spigot for automatic Bedrock detection.
- Put the SideGate
.jarfile in your/pluginsfolder. - In standalone Bukkit mode, set
online-mode=trueinserver.properties. - Start or restart the server.
Configuration Example
# SideGate Configuration
enable-guest-mode: true
login-engine: auto # or protocollib / builtin
proxy-mode:
enabled: false
auto-detect-premium: true
allow-all-guests: true
premium-usernames:
- "TamKungZ"
premium-session-failure:
action: "KICK_WITH_MESSAGE" # or FALLBACK_TO_GUEST
message: "&cThis username belongs to a Premium account.\n&eChange your username and try again."
allowed-guests:
- "FriendName1"
- "FriendName2"
guest-settings:
default-gamemode: "SURVIVAL"
chat-prefix: "&7[Guest] &r"
messages:
join-title: "&cACCESS RESTRICTED"
join-subtitle: "&7Guest Mode"
join-message:
- "&c=================================="
- "&6 Welcome to SideGate Protocol"
- "&7 Account Status: &cGuest (Non-License)"
- "&7 You have restricted gameplay access."
- "&c=================================="
Requirements
- Java: 17+
- Server: Spigot / Paper / Folia / Purpur (Bukkit-compatible)
- Optional dependency: ProtocolLib 5.x+ (SpigotMC) (GitHub)
- Optional integrations: Floodgate, Geyser-Spigot
Bug Reports
Submit issues at:
Please include:
- Server software + exact version
- Java version
- ProtocolLib version
- SideGate version
- Relevant startup/login logs
Project Status & License
Closed Source
- Normal server usage is allowed.
- Separate addon plugins using the SideGate public API are allowed.
- Modification, redistribution, or repackaging is not allowed without permission.
- Commercial use or monetization requires prior permission via email: dev@tamkungz.me
Public reference snapshot:
(sidegate-1.0.0-rc.1)
Security Notice
Guest account access may introduce identity verification limitations. For production servers, use an authentication plugin and a strict permission setup.
If the account lookup is unavailable, SideGate does not assume the player is a guest. The server's standard online-mode login remains responsible for the connection.
FALLBACK_TO_GUEST is a high-risk server-wide policy. It allows unverified clients to join with a username that is registered to an official account, using a Guest UUID. Use an authentication plugin and UUID-based permissions.
The session failure policy requires auto-detect-premium: true.
A client that deliberately spoofs the exact official UUID remains on standard online-mode authentication and cannot bypass Mojang session verification.
When using Velocity, configure secure player forwarding and never expose backend ports publicly.
Keep Velocity online-mode=true and set Bukkit backends to online-mode=false.
SideGate Velocity requires player-info-forwarding-mode="modern" and preserves login results already set by Floodgate or another proxy authentication plugin.
The encrypted-session FALLBACK_TO_GUEST mode is available only in standalone Bukkit mode. Velocity-routed usernames registered to official accounts must pass normal Mojang session verification, but SideGate Velocity can replace the generic invalid-session response with a configurable message.
下载 SideGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SideGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SideGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SideGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SideGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SideGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SideGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
SideGate 2.0.1
发布日期:2026-11-08
新增
bedrock.verified-only(默认值false)。当设为true时,仅将经 Floodgate/Geyser API 确认的玩家视为基岩版玩家;不再识别形似 Floodgate 的 UUID 及用户名前缀。这使得在使用生成以零开头的离线 UUID 启动器(例如 PojavLauncher)的 Java 版玩家可被正确归类为访客(Guest),而不会被误认为基岩版玩家。
SideGate 1.2.3
发布日期:2026-08-25
已修复
- 修复了当 SideGate 直接推进登录状态时,访客登录绕过 Bukkit 的异步预登录事件的问题。LuckPerms 及类似插件现在能够在
PlayerLoginEvent之前接收离线 UUID 的预登录事件,从而正确预加载权限数据。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧