# RelishAuth
\n**Advanced Authentication System for Velocity Proxy Servers \ud83d\udd10**<\/p>\n
<\/p>\n
*Secure your Velocity network with advanced authentication, Discord integration, and premium account support*<\/p>\n<\/div>\n
## \ud83c\udf1f Features<\/p>\n
### \ud83d\udd10 **Multi-Method Authentication**
\n– **Password Authentication**: Traditional secure password system with Argon2 hashing
\n– **Discord Integration**: Link Discord accounts for seamless authentication
\n– **Premium Auto-Login**: Automatic authentication for premium Minecraft accounts
\n– **Hybrid Mode**: Combine password + Discord for maximum security<\/p>\n
### \ud83d\udee1\ufe0f **Advanced Security**
\n– **Session Management**: Configurable session durations (0-1 hour)
\n– **IP Validation**: Optional IP-based session validation
\n– **Rate Limiting**: Protection against brute force attacks
\n– **Premium Verification**: Real-time Mojang API validation
\n– **Bedrock Support**: Compatible with Floodgate for cross-platform play<\/p>\n
### \ud83e\udd16 **Discord Bot Integration**
\n– **Real-time Verification**: Instant Discord DM verification
\n– **Join Notifications**: Security alerts when someone joins with your account
\n– **Account Management**: Change passwords, manage sessions via Discord
\n– **Admin Commands**: Full server management through Discord slash commands
\n– **Rich Embeds**: Beautiful, informative Discord messages<\/p>\n
### \ud83c\udf10 **Multi-Language Support**
\n– **English** and **Arabic** language packs included
\n– **Customizable Messages**: Full message customization support<\/p>\n
### \ud83d\udcbe **Flexible Database Support**
\n– **SQLite**: Zero-configuration local database (default)
\n– **MySQL\/MariaDB**: Network database support for multi-server setups
\n– **PostgreSQL**: Enterprise-grade database with advanced features
\n– **Connection Pooling**: High-performance HikariCP integration<\/p>\n
—<\/p>\n
## \ud83d\udcf8 Screenshots
\n### Discord Integration
\n<\/p>\n
*Seamless Discord verification with interactive buttons*<\/p>\n
### Admin Dashboard
\n<\/p>\n
*Powerful admin tools accessible through Discord slash commands*<\/p>\n
### Security Notifications
\n<\/p>\n
*Real-time security notifications keep your account safe*<\/p>\n
### Optimized Limbo world
\n<\/p>\n
—<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
### Prerequisites
\n– **Velocity Proxy** 3.4.0 or higher
\n– **Java** 21 or higher
\n– **LimboAPI** plugin (required dependency)
\n– **Discord Bot** (optional, for Discord features)<\/p>\n
### Step 1: Download and Install
\n1. Download plugin JAR file
\n2. Place the JAR file in your Velocity `plugins\/` folder
\n3. Install LimboAPI Place it in the same folder
\n4. Restart your Velocity proxy<\/p>\n
### Step 2: Initial Configuration
\n1. Navigate to `plugins\/relishauth\/`
\n2. Edit `config.yml` to configure your authentication method
\n3. Set up your database connection
\n4. Configure Discord bot (optional but recommended)<\/p>\n
### Step 3: Discord Bot Setup (Optional)
\n1. Create a Discord application at Discord Developer Portal
\n2. Create a bot and copy the token
\n3. Add the token to your `config.yml`
\n4. Invite the bot to your Discord server with appropriate permissions<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### Basic Configuration<\/p>\n
“`yaml
\n# Choose your authentication method
\nauthentication:
\n method: “password” # Options: password, discord
\n premium-auto-login: true
\n allow-bedrock-players: true<\/p>\n
# Session management
\nsession:
\n duration: “5m” # Options: 0, 1m, 5m, 15m, 30m, 1h
\n allow-different-locations: true<\/p>\n
# Database setup
\ndatabase:
\n type: “sqlite” # Options: sqlite, mysql, mariadb, postgresql
\n sqlite:
\n path: “data.db”
\n“`<\/p>\n
### Authentication Methods<\/p>\n
#### \ud83d\udd11 Password Authentication
\nPerfect for traditional servers wanting secure password-based auth:<\/p>\n
“`yaml
\nauthentication:
\n method: “password”
\n password:
\n min-length: 6
\n max-length: 32
\n hashing: “argon2” # Secure password hashing
\n“`<\/p>\n
**How it works:**
\n1. New players create a password when first joining
\n2. Returning players enter their password to authenticate
\n3. Sessions are saved based on configured duration
\n4. Optional Discord linking for additional features<\/p>\n
<\/p>\n
#### \ud83d\udcac Discord Authentication
\nIdeal for Discord-centric communities:<\/p>\n
“`yaml
\nauthentication:
\n method: “discord”
\ndiscord:
\n bot-token: “YOUR_BOT_TOKEN”
\n server-id: “YOUR_DISCORD_SERVER_ID”
\n“`<\/p>\n
**How it works:**
\n1. Players enter their Discord username in-game
\n2. Bot sends verification DM with interactive buttons
\n3. Players click “Verify” to authenticate
\n4. Account is permanently linked to Discord<\/p>\n
\n<\/p>\n
#### \ud83c\udfc6 Premium Auto-Login
\nStreamlined experience for premium players:<\/p>\n
“`yaml
\nauthentication:
\n premium-auto-login: true
\n allow-premium-username-impersonation: false # Security: prevent impersonation
\n“`<\/p>\n
**How it works:**
\n1. Premium accounts are automatically verified via Mojang API
\n2. No password or Discord verification required
\n3. Instant server access for legitimate premium players
\n4. Cracked clients cannot impersonate premium accounts<\/p>\n
<\/p>\n
### Security Configuration<\/p>\n
“`yaml
\nsecurity:
\n authentication-timeout: 300 # 5 minutes to authenticate
\n password-attempts:
\n max-attempts: 3
\n lock-duration: 15 # Minutes
\n premium:
\n verification-timeout: 5
\n api-url: “https:\/\/api.mojang.com\/users\/profiles\/minecraft\/”
\n“`<\/p>\n
### Limbo World Customization<\/p>\n
“`yaml
\ncustomization:
\n limbo:
\n dimension: “THE_END” # OVERWORLD, NETHER, THE_END
\n gamemode: “SPECTATOR”
\n spawn:
\n x: 0
\n y: 64
\n z: 0
\n block-movement: true
\n“`<\/p>\n
## \ud83c\udfae Commands<\/p>\n
### Player Commands<\/p>\n
| Command | Description | Usage | ### Admin Commands<\/p>\n | Command | Description | Usage | ## \ud83e\udd16 Discord Bot Integration<\/p>\n ### Setup Process<\/p>\n 1. **Create Discord Application** 2. **Configure Bot Permissions** 3. **Invite Bot to Server** 4. **Configure in RelishAuth** ### Discord Slash Commands<\/p>\n | Command | Description | Permission | —  —<\/p>\n **Made with \u2764\ufe0f by M5LB**<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":" [Update: Player Skin Support + Full Premium UUID Support] \ud83d\udd10 Advanced Authentication System for Velocity Proxy Servers<\/p>\n","protected":false},"featured_media":131714,"template":"","meta":{"_minecraft_slug":"relishauth","_minecraft_project_id":"8BqplnPe","_minecraft_author":"iM5LB1","_minecraft_license":"MIT","_minecraft_downloads":159,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"relishauth.zip","_minecraft_size_bytes":129764870,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T13:18:21.465722Z","_minecraft_date_created":"2026-01-31T20:52:26.654457Z","_minecraft_date_modified":"2026-05-13T17:57:30.494524Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/relishauth","_minecraft_icon_attachment_id":131714,"_minecraft_imported_at":"2026-06-07T18:25:31+00:00","_minecraft_import_hash":"09dc0e69bdb841d46f2d427d25b78095","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,867,123,92,985],"mod_loader":[986],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,852,853,854,855,856,857,858,859,166,10,11,12,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-131713","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-social","mod_category-technology","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-3-1","minecraft_version-1-3-2","minecraft_version-1-4-2","minecraft_version-1-4-4","minecraft_version-1-4-5","minecraft_version-1-4-6","minecraft_version-1-4-7","minecraft_version-1-5-1","minecraft_version-1-5-2","minecraft_version-1-6-1","minecraft_version-1-6-2","minecraft_version-1-6-4","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|———|————-|——-|
\n| `\/ra password
\n| `\/ra discord
\n| `\/ra logout` | Clear all sessions | `\/ra logout` |
\n| `\/ra session [duration]` | Set session duration | `\/ra session 30m` |
\n| `\/ra notify
\n| `\/ra unlink` | Unlink Discord account | `\/ra unlink` |
\n| `\/ra info` | View account information | `\/ra info` |<\/p>\n
\n|———|————-|——-|
\n| `\/ra reload` | Reload configuration | `\/ra reload` |
\n| `\/ra info
\n| `\/ra unlink
\n| `\/ra block
\n| `\/ra unblock
\n| `\/ra clearblocks
\n| `\/ra setpassword
\n| `\/ra resetpassword
\n—<\/p>\n
\n – Go to Discord Developer Portal
\n – Click “New Application” and give it a name
\n – Navigate to “Bot” section and create a bot<\/p>\n
\n Required permissions:
\n – Send Messages
\n – Use Slash Commands
\n – Manage Roles (for linked role)
\n – Read Message History<\/p>\n
\n “`
\n https:\/\/discord.com\/api\/oauth2\/authorize?client_id=YOUR_BOT_ID&permissions=268435456&scope=bot%20applications.commands
\n “`<\/p>\n
\n “`yaml
\n discord:
\n bot-token: “YOUR_BOT_TOKEN”
\n server-id: “YOUR_DISCORD_SERVER_ID”
\n linked-role-id: “ROLE_ID_FOR_LINKED_USERS”
\n “`<\/p>\n
\n|———|————-|————|
\n| `\/link` | Instructions for linking account | Everyone |
\n| `\/session [duration]` | Set session duration | Linked users |
\n| `\/notifications [toggle]` | Toggle join notifications | Linked users |
\n| `\/info [player]` | View account information | Admin |
\n| `\/kick
\n| `\/unlink
\n| `\/block
\n| `\/unblock
\n| `\/clearblocks
\n| `\/setpassword
\n| `\/resetpassword
\n| `\/reload` | Reload plugin configuration | Admin |<\/p>\n
\n## \ud83d\udcde **Support & Links**<\/p>\n
\n
\n\n<\/p><\/div>\n