SideGate

SideGate is a Minecraft server plugin that enables a hybrid login system, allowing Premium players to join normally while selectively permitting Offline (Cracked) players via a whitelist, maintaining online-mode security and configurability.
Download

File Details
Download

SideGate 1.2.0 (1.20/1.21/26.1)

ByTamKungZ_
  • R
  • May 19, 2026
  • 29.59 KB
  • 29
  • 26.1.2+24

File Name

SideGate-1.2.0.jar

Supported Versions

  • 26.1.2
  • 26.1.1
  • 26.1
  • 1.21.5-Snapshot
  • 1.21.11
  • 1.21.10
  • 1.21.9
  • 1.21.8
  • 1.21.7
  • 1.21.6
  • 1.21.5
  • 1.21.4
  • 1.21.3
  • 1.21.2
  • 1.21.1
  • 1.21
  • 1.20.3-Snapshot
  • 1.20.5-Snapshot
  • 1.20.6
  • 1.20.5
  • 1.20.4
  • 1.20.3
  • 1.20.2
  • 1.20.1
  • 1.20

CHANGE.md

SideGate 1.2.0

Release date: 2026-05-18

Added

  • Runtime API service (SideGateApi) exposed through Bukkit ServicesManager for addon/plugin integration.
  • Runtime reload support with /sidegate reload to re-read config and rebind listeners.
  • Guest handling improvements: guest scoreboard tag, configurable join title/subtitle/messages, and guest-only chat prefix.

Changed

  • ProtocolLib is now compileOnly to avoid shading/packaging ProtocolLib into SideGate and prevent classloader conflicts.
  • Login-state injection path was adjusted to prefer stable accept states (READY_TO_ACCEPT, fallback ACCEPTED) to reduce non-premium login timeouts.
  • Defensive ProtocolLib runtime checks were added to avoid NullPointerException when ProtocolManager is temporarily unavailable.
  • Guest login injection now cancels login at START and immediately injects approved guests, with delayed fallback retained for packet-order edge cases.
  • Post-auth login pipeline now supports modern GameProfile method signatures (verifyLoginAndFinishConnectionSetup, startClientVerification, finishLoginAndWaitForClient) for newer Paper builds.

Fixed

  • Fixed startup failure where ProtocolLibrary.getProtocolManager() could be null and crash plugin enable/disable.
  • Fixed guest login flow instability causing repeated guest injection and disconnect timeout behavior in hybrid mode.
  • Fixed Invalid session/timeout on Paper 1.21.11 when guest login state advanced incompletely.

Compatibility

  • Server: Paper/Spigot/Purpur (Bukkit-compatible)
  • Tested: Paper 1.20.1, Spigot 1.20.1, Paper 1.21.11, Paper 26.1.2
  • Practical compatibility range from implementation behavior: 1.20.1-1.21.11 (with ProtocolLib dev build recommended for 1.21.9+)
  • Java: 17+
  • Dependency: ProtocolLib 5.x+

Notes

  • For hybrid guest mode operation, set enforce-secure-profile=false in server.properties.
  • Keep online-mode=true; SideGate handles approved guest flow without globally switching offline mode.
  • Added startup warning for Minecraft 1.21.9-26.x to recommend ProtocolLib dev build: https://github.com/dmulloy2/ProtocolLib/releases/tag/dev-build.