这是一个用于 Velocity 代理服务器的全面玩家统计追踪插件,允许管理员跨多个后端服务器监控和查询玩家信息。
版本 1.0.0 更新内容:
初始发布功能:
- 完整的玩家数据追踪系统,包含 UUID、名称、IP 地址和时间戳
- 双重存储支持——可在本地 JSON 文件或 MySQL 数据库之间选择
- 实时游戏时长追踪——自动会话追踪与准确的游戏时长计算
- 在线/离线状态系统——可视化的玩家可用性状态指示器
- 服务器追踪——记录在线玩家的当前服务器以及离线玩家的最后服务器
- 点击连接功能——可直接从查询结果中跳转加入玩家所在的服务器
- 实时游戏时长更新——查看玩家统计时包含当前会话时长
管理工具:
- 查询命令——提供两个别名以增加灵活性(
/lookup 和 /playerlookup)
- 权限系统——查询和数据删除拥有独立的权限
- 实时数据——游戏时长更新会自动包含当前会话时间
命令:
/lookup <player> - 显示详细的玩家统计信息,包括状态、服务器、游戏时长等
/playerlookup <player> - /lookup 命令的别名
/deletedata <player> - 请求删除所有玩家数据(需要确认)
/deletedata <player> confirm - 在 30 秒内确认删除数据
权限:
playerlogger.lookup - 使用查询命令的权限
playerlogger.delete - 删除玩家数据的权限(出于安全考虑独立设置)
追踪数据:
该插件追踪全面的玩家信息:
- 玩家名称 - 当前和历史用户名
- UUID - 唯一的玩家标识符
- IP 地址 - 最近已知的 IP 地址
- 首次登录 - 首次连接的时间戳
- 最后可见 - 最近的活动时间戳
- 在线状态 - 当前的在线/离线状态及可视化指示器
- 当前服务器 - 实时服务器位置(支持点击加入,仅限在线玩家)
- 最后服务器 - 最近的服务器位置(仅限离线玩家)
- 游戏时长 - 总游戏时长,支持自动会话追踪
存储选项:
可选择 JSON 文件或 MySQL 数据库:
JSON 模式(默认):
- 基于文件的简单存储,位于
playerdata.json
- 无需外部依赖
- 适合小型网络
- 自动创建文件和更新
MySQL 模式:
- 可扩展的数据库存储,使用 HikariCP 连接池
- 适合大型网络和多个代理实例
- 自动创建表和架构更新
- 支持密码中的特殊字符
- 连接池优化性能
技术亮点:
- 异步操作 - 所有数据库查询均使用 CompletableFuture 异步运行
- 会话追踪 - 带会话管理的自动游戏时长计算
- 实时更新 - 查看在线玩家时,游戏时长包含当前会话
- HikariCP 连接池 - 针对 MySQL 优化的连接管理
- 架构迁移 - 新功能自动数据库更新
- 点击事件 - Adventure API 集成以实现可交互的服务器名称
- 颜色支持 - 完整支持 Minecraft 颜色代码及
& 格式
支持版本:
- Velocity 3.3.0 及以上版本(Java 17+)
- Minecraft 1.17, 1.18, 1.19, 1.20, 1.21
设置注意事项:
- 在
config.yml 中选择存储类型(local 或 mysql)
- 如果使用 MySQL,请配置具有适当权限的数据库凭据
- 重启代理服务器以初始化存储
- 将
playerlogger.lookup 权限分配给管理员
- 仅将
playerlogger.delete 权限分配给受信任的工作人员
- 在
messages.yml 中自定义消息以匹配服务器风格
如果您有任何问题、建议或对新插件的请求,请在 Discord 上联系我。
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:
- Choose your storage type in
config.yml (local or mysql)
- If using MySQL, configure database credentials with proper permissions
- Restart the proxy server to initialize storage
- Assign
playerlogger.lookup permission to administrators
- Assign
playerlogger.delete permission only to trusted staff
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧