Skip to content

neuregex/SimpleGuard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛡️ SimpleGuard (Legacy Fix)

A lightweight security plugin designed for Spigot/Paper 1.8.8 that fixes compatibility issues with Velocity (Modern Forwarding).

⚠️ The Problem

When using Velocity with older 1.8.8 servers, the "IP Forwarding" security system sometimes fails or kicks players before displaying a clear error message. Additionally, the official BungeeGuard plugin can sometimes cause conflicts on such old versions.

🛠️ The Solution

SimpleGuard acts as a hybrid firewall:

  1. Packet Injection (ProtocolLib): Intercepts the initial handshake and simulates a valid BungeeCord connection to prevent Spigot from disconnecting the player prematurely.
  2. Token Verification: Verifies that the connection truly originates from the Proxy using your secret from forwarding.secret.
  3. Custom Kick: If the connection is illegal, it allows the Login event to proceed solely to display a clear, formatted error message to the player (instead of a generic "Disconnected" or "End of Stream").

📋 Requirements

  • Java 8+
  • Spigot/Paper 1.8.8
  • ProtocolLib 4.4.0

⚙️ Configuration

The config.yml file is generated automatically:

secret-token: "YOUR_VELOCITY_TOKEN_HERE"
kick-message: "&cAccess Denied: Connections are only allowed from the Proxy."

Contact

Have a complex server setup or need custom solutions like this one? I'm open to collaborating on Minecraft development projects, optimization, and network configuration.

  • Discord: 1txt

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages