Alts

🛡️ Alts

A lightweight, powerful, and highly effective security plugin for Bukkit/Spigot servers. Alts helps server administrators prevent bot attacks, alt-account abuse, and ban-evasion by enforcing strict configuration limits on how many unique accounts can connect from the exact same IP address.

🚀 Key Features

• 👥 Strict IP Account Limits: Enforce a maximum number of alternate accounts allowed per unique IP address (max-accounts-per-ip). Once the limit is reached, any new account attempting to join from that network will be gracefully rejected.
• 🔐 Smart Name-Sync Tracking: The plugin tracks player UUIDs alongside their last known account name. If a player changes their Minecraft username via Mojang, the plugin automatically detects the change upon login and updates their data record seamlessly.
• 🛡️ Admin Bypass Permission: Whitelist your trusted staff members, network team, or families playing under the same roof. Players with the bypass permission can connect with as many accounts as they want without triggering the limiter.
• 📢 Advanced Staff Logging: Keeps administrators fully informed. Whenever a player with a bypass permission logs in, a specialized alert message is sent directly to the server console.
• 🎨 Full Color Code Support: Customize your kick screen and console notifications with standard Bukkit color codes (& or §) to fit your network's design.
• ⚡ Instant Configuration Reloads: Modify your rules, change account thresholds, or alter messages on the fly with a simple command—no server restart required.

🛠️ Commands & Permissions

🔑 Permissions

• alts.admin — Required to execute the configuration reload command. (Note: Make sure to map this to your config's defined bypass settings!)
• Custom Bypass Permission — Defined directly inside your config.yml (e.g., alts.bypass) to allow certain players to ignore account thresholds.

📦 Configuration Overview

The plugin generates a structured configuration file allowing you to fully customize how restrictions behave and what players see:

# The maximum number of distinct accounts allowed per IP address
max-accounts-per-ip: 3

# The permission node required to bypass the IP account limit
bypass-permission: "alts.bypass"

# Message sent to the console when a whitelisted/bypass user logs in
console-message: "§a[Alts] Player %s logged in using an approved account limit bypass."

# The kick message displayed to users who exceed the allowed account limit
max-accounts-message: "§cYou have exceeded the maximum number of allowed accounts per IP on this server!"