GPlayerID 🆔

Tired of typing long, complex usernames? GPlayerID is a lightweight, high-performance plugin that assigns a unique, short numeric ID (e.g., #15) to every player on your server.

Whether you're an admin trying to issue a quick ban or a player sending money, you can use these short IDs instead of full names. It also includes a powerful Alt-Tracker and interactive moderation GUIs!

✨ Key Features

• ⚡ Command Interceptor: Use IDs in any configured command! Typing /pay #15 100 or /tp #15 will instantly replace the ID with the player's actual name.

• 🌐 Offline Player Support: Issue punishments to offline players effortlessly. Commands like /ban #15 run asynchronous database lookups to find the player without lagging the server.

• 🕵️ Smart Alt-Tracker: The plugin silently tracks IP addresses. Use the built-in tool to instantly find all linked accounts (alts) for any specific ID to prevent ban evasion.

• 🗃️ Interactive GUIs:

• Online List: A beautiful, paginated GUI showing all online players and their IDs.

• Moderation Menu: Click on any player in the list (or use a command) to open their profile to issue quick punishments or check for alts.

• 🚀 Zero TPS Impact: Built with HikariCP for blazing-fast database connections (SQLite & MySQL supported). All database queries and offline lookups are handled asynchronously.

• 🔗 PlaceholderAPI Support: Display player IDs in chat, tab lists, or scoreboards using %playerid_id% (e.g., 15) or %playerid_formatted% (e.g., #15).

---

💻 Commands & Permissions

Player Commands:

• /id — Check your own unique ID.
• /id <player_name> — Get the ID of a specific online player.

Admin Commands (Requires gplayerid.admin):

• /playerid list — Open a paginated GUI with all online players.
• /playerid menu <#ID> — Open the moderation GUI for a specific player.
• /playerid alts <#ID> — View all known linked accounts (alts) for a specific player.

---

⚙️ Configuration

GPlayerID is highly customizable. You can:

• Change the ID prefix (e.g., #, @, !).
• Whitelist specific commands that allow ID replacement for online players (e.g., pay, msg, tp).
• Whitelist commands that are allowed to perform offline database lookups (e.g., ban, unban).
• Switch between local SQLite (plug-and-play) or external MySQL databases.