Player Logger

This is a comprehensive player statistics tracking plugin for Velocity proxy servers that allows administrators to monitor and lookup player information across multiple backend servers.

What's New in Version 1.0.0:

Initial Release Features:

• Complete player data tracking system with UUID, names, IPs, and timestamps
• Dual storage support - Choose between local JSON files or MySQL database
• Real-time playtime tracking - Automatic session tracking with accurate playtime calculation
• Online/Offline status system - Visual status indicators for player availability
• Server tracking - Records current server for online players and last server for offline players
• Click-to-connect functionality - Join players directly from lookup results
• Live playtime updates - Current session time is included when viewing player stats

Administrative Tools:

• Lookup Commands - Two aliases for flexibility (/lookup and /playerlookup)
• Permission System - Separate permissions for lookups and data deletion
• Real-Time Data - Playtime updates automatically include current session

Commands:

• /lookup <player> - Display detailed player statistics including status, server, playtime, and more
• /playerlookup <player> - Alias for /lookup command
• /deletedata <player> - Request deletion of all player data (requires confirmation)
• /deletedata <player> confirm - Confirm data deletion within 30 seconds

Permissions:

• playerlogger.lookup - Permission to use lookup commands
• playerlogger.delete - Permission to delete player data (separate for security)

Tracked Data: The plugin tracks comprehensive player information:

• Player Name - Current and historical usernames
• UUID - Unique player identifier
• IP Address - Last known IP address
• First Login - Timestamp of first connection
• Last Seen - Most recent activity timestamp
• Online Status - Current online/offline state with visual indicators
• Current Server - Live server location with click-to-join (online players)
• Last Server - Most recent server location (offline players)
• Playtime - Total playtime with automatic session tracking

Storage Options: Choose between JSON files or MySQL database:

JSON Mode (Default):

• Simple file-based storage in playerdata.json
• No external dependencies required
• Perfect for smaller networks
• Automatic file creation and updates

MySQL Mode:

• Scalable database storage with HikariCP connection pooling
• Ideal for larger networks and multiple proxy instances
• Automatic table creation and schema updates
• Support for special characters in passwords
• Connection pooling for optimal performance

Technical Highlights:

• Async Operations - All database queries run asynchronously using CompletableFuture
• Session Tracking - Automatic playtime calculation with session management
• Live Updates - Playtime includes current session when viewing online players
• HikariCP Pooling - Optimized connection management for MySQL
• Schema Migration - Automatic database updates for new features
• Click Events - Adventure API integration for interactive server names
• Color Support - Full Minecraft color code support with & formatting

Supported Versions:

• Velocity 3.3.0 and higher (Java 17+)
• Minecraft 1.17, 1.18, 1.19, 1.20, 1.21

Important when setting up:

1. Choose your storage type in config.yml (local or mysql)
2. If using MySQL, configure database credentials with proper permissions
3. Restart the proxy server to initialize storage
4. Assign playerlogger.lookup permission to administrators
5. Assign playerlogger.delete permission only to trusted staff
6. Customize messages in messages.yml to match your server's style

Just send me a message on Discord if you have any questions, suggestions, or requests for new plugins.