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 ` - Display detailed player statistics including status, server, playtime, and more - `/playerlookup ` - Alias for `/lookup` command - `/deletedata ` - Request deletion of all player data (requires confirmation) - `/deletedata 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 (https://discord.com/invite/vVrpvBEfeQ) if you have any questions, suggestions, or requests for new plugins.