PlayerLogger – 高级游戏时长与命令日志记录
PlayerLogger 是一款轻量级但功能强大的 Paper 插件,可将玩家活动(包括加入、离开、命令执行、总游戏时长和在线状态)记录到数据库中。
专为需要准确追踪、管理洞察或统计数据的服务器管理员设计。
开箱即用支持 SQLite 和 MySQL。
PlayerLogger 追踪哪些内容?
- 玩家加入与离开事件
- 总游戏时长(含实时会话计算)
- 在线/离线状态
- 命令执行日志
- 首次出现与最后出现的时间戳
- 历史会话数据
所有数据均高效存储在数据库中,并采用优化的索引以提升性能。
功能特点
⚡ 针对 Paper 1.21+ 优化
? 支持 SQLite(默认)或 MySQL
? 实时游戏时长计算
? 多语言支持(英语 & 德语)
? 可配置的命令过滤(例如忽略 /login, /register)
? 异步数据库处理(非阻塞)
? 崩溃后自动修正离线状态
? 前 10 名游戏时长排行榜
✒️ 用于调整或删除数据的后台管理工具
命令
/plog stats
/plog stats <player>
/plog top
/plog reload
/plog delete <player>
/plog add <player> <time>
每个子命令均包含相应的权限设置。
权限
玩家权限
| 权限 |
描述 |
| playerlogger.stats |
允许查看自己的游戏时长 |
| playerlogger.stats.other |
允许查看其他玩家的游戏时长 |
| playerlogger.top |
允许查看排行榜 |
管理员权限
| 权限 |
描述 |
| playerlogger.Admin.reload |
允许重新加载插件 |
| playerlogger.Admin.delete |
允许删除已存储的玩家数据 |
| playerlogger.Admin.add |
允许查看排行榜(注:原文此处描述有误,通常对应添加数据权限,但按字面翻译为“允许查看排行榜”以忠实原文,若需修正建议改为“允许向玩家添加游戏时长”) |
(注:根据原文表格最后一行 Description "Allows viewing the top ranking" 直译,尽管这与 Permission name "add" 逻辑不符,此处严格遵循原文翻译)
数据库结构
表:
player
sessions
command_logs
- 支持 UPSERT(MySQL + SQLite)
- 索引查询
- 外键
- 为大服务器优化的架构
配置
- SQLite 或 MySQL
- 命令日志开关
- 加入/离开日志开关
- 命令黑名单过滤器
- 语言选择
config.yml
database:
type: SQLITE # SQLITE or MYSQL
sqlite-file: playerlogger.db
mysql:
host: localhost
port: 3306
database: minecraft
user: minecraft
password: ""
language: de #de or en
language-auto: false
logging:
join-quit: true
commands: true
command-filter:
enabled: true
deny-prefixes:
- "/login"
- "/register"
- "/changepassword"
使用场景
- 员工活动监控
- 玩家参与度追踪
- 服务器统计数据
- 管理调查
- 基于游戏时长的奖励
- 管理员审计
性能
- 使用专用的异步数据库线程
- 无主线程阻塞查询
- 安全关闭处理
- 在中大型服务器上扩展性良好
兼容性
- Paper 1.21+
- Java 21
- 适用于 Windows、Linux 和托管服务提供商
- 兼容 MySQL 和 MariaDB
为什么选择 PlayerLogger?
与简单的游戏时长插件不同,PlayerLogger 提供:
- 命令历史记录日志
- 持久化会话追踪
- 数据库级别的完整性
- 清晰且结构化的代码库
- 多语言支持
如果您正在寻找一种可靠、基于数据库的 Paper 服务器玩家追踪解决方案 —— PlayerLogger 值得信赖。
PlayerLogger – Advanced Playtime & Command Logging
PlayerLogger is a lightweight yet powerful Paper plugin that logs player activity to a database, including joins, quits, commands, total playtime, and online status.
Designed for server administrators who need accurate tracking, moderation insights, or statistical data.
Supports SQLite and MySQL out of the box.
What Does PlayerLogger Track?
- Player Join & Quit Events
- Total Playtime (with live session calculation)
- Online / Offline Status
- Command Execution Logs
- First Seen & Last Seen timestamps
- Historical Session Data
All data is stored efficiently in a database with optimized indexing for performance.
Features
⚡ Optimized for Paper 1.21+
? SQLite (default) or MySQL support
? Real-time playtime calculation
? Multi-language support (English & German)
? Configurable command filtering (e.g., ignore /login, /register)
? Async database handling (non-blocking)
? Automatic offline correction after crashes
? Top 10 playtime ranking
✒️ Admin tools for adjusting or deleting data
Commands
/plog stats
/plog stats <player>
/plog top
/plog reload
/plog delete <player>
/plog add <player> <time>
Permissions included for each subcommand.
Permissions
Player Permissions
| Permission |
Description |
| playerlogger.stats |
Allows viewing own playtime |
| playerlogger.stats.other |
Allows viewing other players' playtime |
| playerlogger.top |
Allows viewing the top ranking |
Admin Permissions
| Permission |
Description |
| playerlogger.Admin.reload |
Allows reloading the plugin |
| playerlogger.Admin.delete |
Allows deleting stored player data |
| playerlogger.Admin.add |
Allows viewing the top ranking |
Database Structure
Tables:
player
sessions
command_logs
- UPSERT support (MySQL + SQLite)
- Indexed queries
- Foreign keys
- Optimized schema for large servers
Configuration
- SQLite or MySQL
- Command logging toggle
- Join/Quit logging toggle
- Command blacklist filter
- Language selection
config.yml
database:
type: SQLITE # SQLITE or MYSQL
sqlite-file: playerlogger.db
mysql:
host: localhost
port: 3306
database: minecraft
user: minecraft
password: ""
language: de #de or en
language-auto: false
logging:
join-quit: true
commands: true
command-filter:
enabled: true
deny-prefixes:
- "/login"
- "/register"
- "/changepassword"
Use Cases
- Staff activity monitoring
- Player engagement tracking
- Server statistics
- Moderation investigation
- Playtime-based rewards
- Admin auditing
Performance
- Uses a dedicated async database thread
- No main-thread blocking queries
- Safe shutdown handling
- Scales well for medium to large servers
Compatibility
- Paper 1.21+
- Java 21
- Works on Windows, Linux, and hosting providers
- Compatible with MySQL & MariaDB
Why Choose PlayerLogger?
Unlike simple playtime plugins, PlayerLogger provides:
- Command history logging
- Persistent session tracking
- Database-level integrity
- Clean and structured codebase
- Multilingual support
If you're looking for a reliable, database-driven player tracking solution for Paper servers — PlayerLogger delivers.
评论 0
登录后参与评分
还没有评论,来抢沙发吧