Projects / PlayerLogger

PlayerLogger

Track and lookup player statistics across your Velocity network

Comprehensive player statistics tracking with MySQL or local storage support.

Stable Version 1.0.0
Status Stable
Compatibility 3.3.0, 3.4.0-SNAPSHOT, 3.4.0
Download Stable Modrinth

Overview

PlayerLogger is a powerful statistics tracking plugin for Velocity proxy servers. Track player information including names, UUIDs, IP addresses, login times, playtime, and current server locations. Features dual storage support (local JSON or MySQL), admin commands for player lookup, automatic playtime tracking, and clickable server names with connect functionality. All messages are fully customizable via YAML configuration.

Built With

Java Velocity API Adventure API Gson MySQL HikariCP SnakeYAML

Compatibility

Velocity

Quick Links

Modrinth Ko-Fi Discord

Technical Highlights

  • HikariCP connection pooling for optimal MySQL performance
  • Async CompletableFuture-based database operations
  • Automatic session tracking with playtime calculation
  • Formatted playtime display (days, hours, minutes, seconds)
  • Click-to-connect functionality with Adventure API
  • Dual storage provider architecture for flexibility

Features

Dual storage: Local JSON or MySQL database

Track player names, UUIDs, and IP addresses

Record first login and last seen timestamps

Automatic playtime tracking per session

Current server display with click-to-connect

Admin-only lookup commands with permission system

Fully customizable messages via YAML

Color code support with & formatting

HikariCP connection pooling for MySQL

Async database operations for performance

Commands & Permissions

Command Description Permission
/lookup <player> Display detailed statistics for a player including UUID, IP, login times, server, and playtime. playerlogger.admin
/playerlookup <player> Alias for /lookup command. playerlogger.admin

Installation Guide

  1. Download the plugin jar from GitHub releases.
  2. Place the jar in your Velocity plugins folder.
  3. Restart the proxy server.
  4. Configure storage type (local/mysql) in config.yml.
  5. Customize messages in messages.yml as needed.

Resources & Support

Modrinth

Download from Modrinth platform

Visit

Ko-Fi

Additional project resources

Visit

Discord

Join the community or access the bot where it is available

Visit

Other Projects

Explore more of my development work

View All Projects Minecraft Projects