promotional bannermobile promotional banner

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.

File Details

SideGate 1.0.0 1.20.x

  • R
  • Dec 24, 2025
  • 10.25 KB
  • 5
  • 1.21.11+21

File Name

SideGate-1.0.0.jar

Supported Versions

  • 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

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.


[1.0.0] - 2025-12-25

Added

  • Hybrid Login System
    Supports simultaneous connections from both Premium (online UUID) and Offline (cracked) players while the server runs with online-mode=true.
  • Whitelist Bypass
    Allows cracked players to join only if their names are explicitly listed in config.yml (Whitelist-based access).
  • Allow All Guests Mode
    A config option (allow-all-guests) that permits all players to join without license verification
    (useful for temporary or testing environments).
  • Cancel-First Injection System
    Improved bypass logic stability by cancelling the original packet before injecting a new state,
    resolving timeout issues and race conditions.
  • Config Options
    • enable-guest-mode: Enable or disable the plugin functionality
    • guest-settings: Configure default GameMode and chat prefix for Guest players
    • messages: Customize join messages for Guests (supports & color codes)
  • Guest Restrictions
    Players who join through the Gate are assigned an Offline UUID (v3) and do not have skins,
    but can play normally (or according to the configured GameMode).

Fixed

  • Fixed server crashes and timeouts that occurred during license verification bypass in certain scenarios.
  • Fixed NetworkManager lookup failures (Reflection Errors) by scanning all lists within ServerConnection.
  • Improved memory management by adding an auto-cleanup system for pending connection IPs.

Notes

  • ProtocolLib 5.0+ is required
  • Premium players who are not in the Whitelist will go through Mojang’s normal authentication process
    and will have skins as usual (when allow-all-guests: false).
  • All players who join via the Gate (Bypass) will not have skins (Steve/Alex).