查看“OnTime”的源代码

== 介绍 ==
通过OnTime这款功能众多的插件，现在服务器可以跟踪玩家的游戏时间（包括本日、本周、本月以及总和），并且可以在游戏中显示在线时间前十的玩家。
同时，所有玩家的在线情况也可以在离线模式下查看。<br />
管理员可以通过这款插件为玩家配置在线时间奖励。包括：金钱、物品、经验、权限添加、权限组升降、执行指令、发送个性化的信息以及''忠诚点数''(loyalty points,待Dalao提供准确译法)<br />
你同时也可以为玩家配置每日/每周/每月奖励，当他们在线时间达到一定时长的时候。<br />
总之，这是一款强大的在线时间插件。
== 插件指令 ==
以下所使用的术语：<br />
在线时间：指玩家在服务器的游戏时间（从玩家第一次在限定时间内进入正确运行有Ontime插件的服务器的时刻开始计算）<br />
本次在线时间：指玩家最近一次登录以来在服务器的游戏时间<br />
日在线时间：指玩家本日在服务器的游戏时间<br />
总在线时间：指玩家在服务器的总计在线时间(except where noted) <br />
<big>命令基本格式：/ontime [子命令] <参数> {额外设置}
</big><br />
以下所有指令（有特殊注明除外）均可同时在游戏和控制台中使用<br />
子命令在大多数情况下也可被缩短至3-5个字母
例如：/ontime rewards add command warp_command 1h monthly 可以缩短为/ontime rw add com warp_command 1h mon
=== 玩家指令 ===
/ontime 玩家可以输入这个指令来查看自己的本次在线时间、日在线时间和总在线时间。（不能在控制台使用）<br />
/ontime help 玩家通过输入这个指令来查看可用的命令（如果他们不拥有执行某个命令的权限，则不会在此处列出）<br />
/ontime rewards purchase <shopID/shopTag> 玩家可以通过这个指令来购买已配置好的商品<br />
/ontime top <#> 玩家可以通过这个指令查看在线时间排行榜 #代表截止到第几名(必须在1-10之间)<br />
/referred by <playerName> 由一个被其他玩家邀请进入服务器的玩家执行，当该玩家在线时间达到一定时长时，两人均可获得由管理员指定的奖励。<br />
若玩家输入的名称在服务器记录中找不到的话，将为玩家显示一个与所提供名称相近的匹配项。<br />
=== 玩家/管理员指令 ===
/ontime <player name> {<world name> | [all]} 这个指令可以为输入者显示指定玩家在特定世界（或全部世界）的详细在线情况。如果指定的玩家在线，那么TAB补全是可用的，如果指定的玩家不在线，那么必须输入准确的名称。<br />
如果配置文件中'perWorldEnable'一项设置为'true', 那么可以通过输入指定的世界名称来查看玩家在特定世界的在线信息。如果有多个世界以指定世界名称开头，那么插件将会显示每个以指定世界名称开头的世界的信息 (例如 输入"ontime edge209 pvp" 将会显示 "pvp" 和 "pvp_nether" 两个世界的信息)。 如果输入 "all" 那么将会显示玩家所有世界的在线情况，如果该项为空，那么将会显示玩家在所有世界在线情况的总和。<br />
所有输出信息都可以在output.yml文件中配置<br />
/ontime top {<#> [afk/playtime/points/refer/vote] [total/today/week/month] {[+login/+rank/+today/+week/+month]} {[players/sites]} <br />
该指令将会提供给输入者由AFK时间/在线时间/''忠诚点数''/推荐玩家数和''提议''玩家数的排行榜。#的效果同上文，[players/sites]附加选项只有在选择vote作为排列依据时才有效，如果指定“vote”，但并未指定“players”或“sites”，则默认为“players”。<br />
排行榜的时间可以限定为总计/本日/本周/本月， 如果没有限定时间，则总计在线时间将会作为默认选择 (对于 AFK时间排名， ”total”选项即总计时间无法收集, 所以默认选择为”today”即本日AFK时间。而对于”points”排名，该参数仅支持“total”选项)。<br />
当"playertime total”被指定时，可以通过添加[+login/+rank/+today/+week/+month]等参数来在输出信息中添加玩家最近一次登录/晋级后的在线时间，或每日/周/月的在线时间按信息。每个命令只能指定一个此类参数。<br/>
“vote”选项可以显示哪些玩家或哪些网站在游戏中被提议次数最多。对于网站来说，每日/周/月参数均不被支持。<br/>
“afk“ 选项可以显示哪些玩家AFK（挂机）时间最长。 插件只会收集每日/周/月的AFK数据。 所以,，'total' 的时间限定是无效的。所以在没有限定时间时，将会默认为本日AFK时间<br/>
“points“选项将会显示哪些玩家拥有最多的''忠诚点数''.。该选项只支持“total”一种时间参数。<br/>
"afk", "points", "refer" and "vote" 四种排行榜的支持都需要在配置文件中先设置好MySQL数据库.........OvO昆<br/>
以下是一些例子：<br/>
/ontime top<br/>
/ontime top 5<br/>
/ontime top 10 play weekly<br/>
/ontime top 10 playtime total +login<br/>
/ontime top 10 vote monthly<br/>
/ontime top 5 refer today<br/>
/ontime top 10 vote sites<br/>
/ontime top 10 afk weekly<br/>

/ontime online [total]<br/>
Provides the sender with a list of players that are currently online showing their total OnTime. This is the default if neither ‘current’ nor ‘total’ is specified after the ‘online’ keyword.

/ontime online current
Provides the sender with a list of players that are currently online showing their current OnTime.(未知..我服务器里面貌似没有这个指令..等待Dalao)



/referred list <playerName>
Provides a list of all player's referred to the server for the specified player.


Example:

/referred list Edge209