免费 开源 娱乐 PlayerTime — 游玩时长统计！ 2024-12-31

[MD]# PlayerTime

## 这是什么？

这是我自行编写的，用于统计服务器上玩家存留时间的插件。我知道这听起来可能会有点像“其他同类插件”一样，但我还没有看见能对离线玩家生效的同类竞品。这就是我决定自己做一个的原因。

## 核心特色

* 支持离线玩家
* 支持 MySQL
* 支持 BungeeCord（通过配置将所有子服连接到同一 MySQL 数据库）
* 支持 PlaceholderAPI
* 自带前十排行榜

## 插件原理

插件的原理非常简单。在玩家登录后，插件就会检查玩家登录时间，在玩家离开游戏后，插件就会根据玩家的时间戳计算出时间差，从而将得到的游戏时长存入文件，这样就能做到即便**离线**也能获取在线时间。

## 插件命令

* /ptcheck
* /pttop
* /ptreload

## 插件权限

* playertime.check（允许使用命令检查自己的游玩时间）
* playertime.others（允许使用命令检查其他玩家的游玩时间）
* playertime.top（允许打开界面）
* playertime.reload（允许重载配置）

## 插件配置

``` YAML
# PlayerTime ${project.version}

# 请勿修改
config-version: 2

plugin-prefix: "[&dPlayer&eTime&f]"

# 支持填入 YML 或 MySQL
database:
type: YML
# 若要使用 MySQL 则请取消下方配置注释
# host: "localhost"
# port: 3306
# username: "root"
# password: "password"
# database: "playertime"
# pool-size: 10

format: "&a{name} 已游玩了 {days} 天, {hours} 时, {minutes} 分, {seconds} 秒"

# 可以填入 gui 或 text，填入其他值无效
leaderboard-type: "gui"

# "time-format" 也会基于排行榜的版本发生变化
gui:
title: "游玩时间排行榜前十"
time-format: "{days} 天, {hours} 时, {minutes} 分, {seconds} 秒"
item:
name: "{player} 的游玩时长"
material: "PAPER"
lore:
- "排名 #{slot}"
- "游玩时长: {format}"

text-top:
title: "&7------------------------"
footer: "&7------------------------"
content: "&7{place}, &a{name} &f{time}"


messages:
incorrect-usage: "参数过多, 请使用命令 /ptcheck 或 /ptcheck <名称>"
never-played-before: "未找到该玩家数据. 他是否游玩过本服?"
no-playtime-data: "尚无该玩家的游玩时长数据"
config-reload: "插件配置已被重载!"
```

## PlaceholderAPI 变量

* %playertime_time%
* %playertime_time_seconds%
* %playertime_time_minutes%
* %playertime_time_hours%
[/MD]