Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Leather Auth Bridge
Overview
Leather Auth Bridge is a lightweight authentication plugin for Bukkit/Paper servers that enables seamless login for Leather Client players while maintaining full compatibility with vanilla authentication systems.
What It Does
The plugin provides two authentication paths:
- Leather Client users — Authenticate automatically on join using their Leather session token
- Vanilla players — Use traditional
/registerand/logincommands
Both work independently without interfering with each other.
Why You Need It
If you want to support Leather Client on your server, this plugin unlocks the full experience. Without it, Leather Client players have to manually authenticate like everyone else. With it, they get a seamless join experience while vanilla players continue using normal auth commands.
Key Features
- Dual authentication system (Leather Client + vanilla)
- Configurable security settings
- Session management commands
- Offline mode support for LAN servers
- Lightweight with minimal performance impact
- Works with Paper, Spigot, and Bukkit
Installation & Setup
- Download
leather-auth-bridge.jar - Drop it in
/pluginsfolder - Restart server (config auto-generates)
- Edit
/plugins/LeatherAuth/config.ymland set a random secret - Run
/leather reload
Requirements
- Server: Paper, Spigot, or Bukkit (1.19+)
- Java: 17 or higher
- Leather Client: v1.0.0+ (on player side)
Configuration
# LeatherAuth config.yml
secret: CHANGE_THIS_TO_A_LONG_RANDOM_STRING
allow-vanilla: true
kick-message: "Authentication failed. Please use Leather Client or /login."
offline-mode: false
Change the secret to a long random string (32+ characters) — keep it secure.
Admin Commands
/leather reload— Reload config without restart/leather status— View active sessions/leather revoke <player>— Revoke a player's session
Requires leather.admin permission.
Troubleshooting
- Players kicked on join? Secret mismatch between server config and client settings
- Plugin won't load? Ensure you're running Paper or Spigot
- Auto-login failing? Verify player is using Leather Client v1.0.0+
Support
Join the Leather Client Discord: https://discord.gg/bktX9vMqF3


