AdvancedBungeeKick

⚠ IMPORTANT ⚠
This plugin works ONLY on a BungeeCord proxy!

Overview
AdvancedBungeeKick is a lightweight BungeeCord plugin that prevents player disconnects caused by backend kicks.
Instead of being kicked off the network, players are automatically redirected to your fallback or default server.

The original kick reason is still visible to the player (if enabled), so they know why the redirect happened.

⚙ Key Features

• Zero Setup – Works out of the box using your BungeeCord fallback/default settings.
• Kick Interception – Supports all kick types (timeout, flying, errors, etc.).
• Kick Reason Mapping – Replace ugly default messages with clean custom ones.
• Reason-Based Filtering – Configure whitelist or blacklist reasons to control when redirects happen.
• Reason-Based Redirects – Send players to specific fallback servers depending on the kick reason.
• Silent Redirects – Suppress all messages for seamless background transfers.
• Per-Player Redirect Limit – Disconnect players if they are redirected too frequently.
• Fallback Modes – Choose between PRIORITY, RANDOM, or ROUND_ROBIN fallback server selection.
• File Logging – Log all redirects and real kicks to a text file with custom formatting.
• Discord Webhook Support – Send fully customizable embeds to a Discord channel.
• Staff Notifications – Notify online staff members when players are redirected.
• Ultra-Lightweight – Minimal resource usage, no metrics, no database.
• Version-Friendly – Compatible with BungeeCord 1.8.8 → 1.21.x

Installation

1. Download AdvancedBungeeKick.jar.
2. Place it into your proxy's /plugins folder.
3. Restart the proxy or use /greload.
4. Edit the generated config.yml to customize behavior.

Configuration Highlights
All settings can be controlled via the `config.yml`:

• disabled-servers – Skip redirect if kicked from these servers (e.g. auth).
• whitelist-reasons / blacklist-reasons – Filter based on kick reason content.
• replace-reasons – Customize the displayed kick message.
• reason-redirects – Choose redirect target based on the kick reason.
• fallback-selection – Server selection strategy (PRIORITY, RANDOM, ROUND_ROBIN).
• send-original-reason – Show or hide the original kick message to the player.
• silent-redirect – Fully silent redirection without message.
• redirect-limit – Prevent spammy redirections by limiting per hour.
• file-logging – Log events in a local .txt file (custom format).
• discord-webhook – Send event embeds to a Discord channel.

Commands & Permissions
This plugin registers no commands.
Only one permission exists:

• advancedkick.notify – Required to receive staff alerts about player redirects.

How It Works
When a player is kicked from a backend server:

• They are redirected to the configured fallback server (unless blocked).
• You can choose whether to show the kick reason or not.
• Redirects and kicks are logged to console, file, and/or Discord.
• Advanced filters and limits are applied based on your configuration.

✅ Compatibility

• Proxy: BungeeCord, Waterfall, FlameCord and forks
• Backend: Spigot, Paper, Purpur, etc.
• Java: 8 or higher

Metrics & Updates
This plugin collects no data, uses no updater, and runs completely standalone.

Support
Need help or want to suggest a feature?
Post in the discussion thread or open a ticket via GitHub or Discord.
Community feedback is always welcome!

Keep your players online and informed—never lose them to a kick again.