# PublicPlaytime
PublicPlaytime 是一个插件，可以轻松查看所有曾经在你的服务器上玩过的玩家的游戏时长。PublicPlaytime 使用 Bukkit* 的标准 Statistic 查询在线玩家的游戏时长，并使用数据库存储所有离线玩家的时间。游戏时长当然是指某个玩家在你的服务器上登录的时间。它应该与 Minecraft 原版中人们可以通过统计菜单访问的统计数据相同。**这也意味着，当你切换服务器的主世界时，游戏时长会被重置。** 为了防止这种情况发生，可以使用下面的备份功能。
*任何 Bukkit 的分支都可以使用（例如 Spigot、Paper 等）
## 指令
PublicPlaytime 具有几个功能。所有指令可以在游戏内通过 _/playtime help_ 查看，别名也在这里找到。
* **/playtime get \<玩家> \<输出模式>**
* 获取指定玩家的游戏时长，以特定格式显示
* \<输出模式> - _days, hours, minutes, seconds, ticks, standard_
* _standard_ 将以 DD:HH:MM:SS 格式输出游戏时长。
执行时输出: */playtime get LifelessNerd standard*
* **/playtime ranking \<输出模式> \<最大数量>**
* 以标准格式在你的聊天中输出游戏时长排行榜。
* \<最大数量> - _任何整数_
* 排行榜显示的位置数量。例如，_5_ 将显示前 5 名玩家。
* \<输出模式> - _days, hours, minutes, seconds, ticks, standard_
* _standard_ 将以 DD:HH:MM:SS 格式输出游戏时长。
执行时输出: */playtime ranking standard 10*
* **/playtime scoreboard \<显示/隐藏> \<输出模式> \<最大数量>**
* 显示或隐藏拥有最高游戏时长的玩家的排行榜。
* \<显示/隐藏> _'show' 或 'hide'_
* 是否显示或隐藏排行榜。
* \<最大数量> - _任何整数_
* 排行榜显示的位置数量。 例如，_5_ 将显示前 5 名玩家。
* \<输出模式> - _days, hours, minutes, seconds, ticks_
* _standard_ 不允许在此处使用，因为它不适合在排行榜中显示。
> 注意：此命令在配置文件中具有选项，用于是否允许排行榜刷新以及刷新间隔。请参阅 '文件'。
执行时输出: */playtime scoreboard show minutes 10*
* **/playtime help**
* 显示插件的所有指令列表。
* **/playtime about**
* 显示有关插件的信息，在哪里可以找到它等等。
* **/playtime backup**
* 将当前游戏时长保存到文件。 这将覆盖以前的备份。
* **/playtime load**
* 从备份文件加载游戏时长，并将所有游戏时长设置为备份文件中的值。 这将覆盖旧的游戏时长。 当转移主世界时，此功能很有用，因为它会重置游戏时长。 为了将游戏时长转移过来，请在旧世界中备份旧的游戏时长，更改世界，然后加载它们。
## 文件
插件首次启动时，将创建 2 个 YAML 文件，一个配置文件和一个数据库。 配置文件将包含插件选项供你编辑。 有 2 个设置可以更改：是否允许排行榜刷新，以及如果允许，它们应该以多快的间隔刷新。 任何低于 20 滴 (1 秒) 的设置都将无效，因为统计信息本身是使用秒来完成的。
数据库不应被编辑。它以每玩家的滴数为单位存储游戏时长。你可以添加玩家，尽管当人们首次加入时，插件已经完成了此操作，并且玩家退出服务器时，任何值都会被覆盖。
如果使用 /playtime backup 创建备份，则会创建一个备份文件。 你可以编辑此文件（尽管我建议你不要这样做），但请注意，要加载备份文件，首先需要重新加载/重启服务器，以便插件能够看到你所做的手动更改。
## 即将推出的功能(希望如此)
- PlaceholderAPI 支持
## 已知问题和支持/帮助
问题可以在 [这里](https://github.com/LifelessNerd/PublicPlaytime/issues/) 找到。
如果存在任何问题，请在 GitHub 上添加它们，[这里](https://github.com/LifelessNerd/PublicPlaytime/issues/new)，或者在 [Twitter](https://twitter.com/lukadevrij) 上私信我。 你也可以加入支持 Discord 服务器 [通过此链接](https://discord.gg/8n65jSEkVf)。