Player Logger

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

25

Quick challenge

How far can you run before the mobs catch you?

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

Real-Time Data - Real-Time Data - Two aliases for flexibility (`/lookup` and `/playerlookup`) - Real-Time Data - 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)

Playtime The plugin tracks comprehensive player information: - Playtime - Current and historical usernames - Playtime - Unique player identifier - Playtime - Last known IP address - Playtime - Timestamp of first connection - Playtime - Most recent activity timestamp - Playtime - Current online/offline state with visual indicators - Playtime - Live server location with click-to-join (online players) - Playtime - 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

Color Support - Color Support - All database queries run asynchronously using CompletableFuture - Color Support - Automatic playtime calculation with session management - Color Support - Playtime includes current session when viewing online players - Color Support - Optimized connection management for MySQL - Color Support - Automatic database updates for new features - Color Support - 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.

ADS