原创 娱乐 Cyutime | 支持跨服同步的在线时长奖励标识插件|支持Folia[1.16-26.x] 1.2.0

CyuTime | 在线时间统计 | 在线奖励/排行榜 | 日周月年

一套围绕玩家在线时长设计的统计与奖励系统

CyuTime 不只是简单记录玩家在线了多久

从每日、每周、每月、每年的周期统计

到在线奖励、排行榜、实时进度、连续在线与奖励补领

都可以围绕玩家在线时长自由配置

单服可以直接使用 SQLite

群组服也可以切换 MySQL 共享玩家在线数据

---

主要功能

● 日 / 周 / 月 / 年 / 总在线统计
● 在线时间奖励
● 自动发放与手动领取
● 在线奖励领取记录
● 连续在线奖励
● 双倍在线时段
● 周期排行榜结算
● 随机奖励池
● 跨周期奖励补领
● 奖励到点提醒
● BossBar / ActionBar 实时显示
● 在线排行榜
● PlaceholderAPI
● SQLite / MySQL
● 自定义时区与每日刷新时间
● 自定义 GUI 菜单
● AFK 在线判定
● 在线数据 CSV 导出
● 全服在线统计
● 支持 Folia / Luminol

---

五种在线时间统计

CyuTime 会同时记录：

今日在线

本周在线

本月在线

本年在线

总在线

日、周、月、年会随着周期自动刷新

总在线则永久累计

不会因为新的一天、新的一周或者新的一年开始而清零

玩家即使跨越周期持续在线

插件也会自动把时间拆分到对应周期中

周统计使用 ISO 周规则

---

每日刷新时间也可以自己定

默认每天 00:00:00 刷新

也可以按照服务器自己的运营习惯修改

例如：

04:00:00

那么每天凌晨 4 点才会进入新的统计日

对于习惯凌晨维护或者凌晨进行日常结算的服务器来说

可以直接按照自己的运营时间设置

---

在线奖励

在线时间可以直接变成服务器奖励

例如：

每日在线 30 分钟

每日在线 60 分钟

每周在线 300 分钟

每月在线若干小时

玩家达到指定在线时长后

就可以领取对应奖励

奖励还会记录自己的领取状态

已经领过的奖励不会重复领取

---

奖励不只是一件物品

在线奖励可以执行各种动作

包括：

发放物品

执行控制台命令

让玩家执行命令

发送聊天消息

发送 ActionBar

发送 Title

播放音效

全服广播

甚至继续打开其他菜单

因此在线奖励可以直接接入服务器原有的经济、权限、任务和活动系统

---

自动领取与手动领取

每组奖励都可以单独决定领取方式

自动发放

达到在线时间后直接发放

手动领取

达到时间后进入奖励菜单自己领取

两种模式可以同时存在

例如每日奖励自动领取

每周大奖需要玩家手动领取

把普通日常奖励和高价值奖励分开处理

---

连续在线奖励

除了单纯统计今天在线多久

CyuTime 还可以记录连续在线达成的天数

每天达到指定在线分钟数

即可计入连续在线

同时可以设置断签后扣除多少连续天数

于是可以做出：

连续 3 天在线

连续 7 天在线

连续 30 天在线

等长期活跃奖励

玩家不只是为了今天的奖励上线

也会有继续保持连续在线的目标

---

双倍在线时段

某些时间段可以让在线时间按照倍率增长

例如：

周末晚上

活动时间

服务器周年庆

节日活动

都可以设置额外在线倍率

进入指定时间段后

玩家的在线时间会按照配置倍率计算

这样可以直接做出：

周末在线双倍

活动期间三倍在线

之类的限时活动

---

周期排行榜结算

在线时间不只是自己看

还可以变成服务器排行榜

可以按照：

今日在线

本周在线

本月在线

等周期进行排名

周期结束后

还可以对上一周期排名靠前的玩家进行奖励结算

玩家离线时没有立即收到的结算奖励

也可以暂存在待领取数据中

下一次上线再补发

这样就能直接做成服务器的活跃排行榜玩法

---

随机奖励池

在线奖励并不一定每次都发固定内容

奖励规则可以改成随机奖池

不同奖励设置不同权重

玩家达到领取条件后

按照权重随机抽取其中一档奖励

例如：

普通奖励高概率

稀有奖励低概率

特殊奖励极低概率

让在线奖励也可以带一点随机性

---

跨周期补领

玩家没有及时领取之前周期的奖励

也可以配置允许补领过去若干个周期的未领取奖励

例如：

允许补领前 2 个周期

玩家这周回来后

依然可以领取之前错过的奖励

避免玩家只是因为一段时间没上线

就直接永久丢失已经达成的奖励

---

奖励提醒

距离下一档在线奖励还有一段时间时

可以提前进行提醒

奖励已经达到领取条件时

可以发送可领取提示

玩家重新进入服务器后

如果还有未领取奖励

也可以进行提醒

领取成功后还可以通过 ActionBar 与音效反馈

让整个在线奖励系统拥有完整的反馈流程

---

在线时间实时显示

不需要一直打开菜单

也可以直接把在线时间显示在屏幕上

支持：

BossBar

ActionBar

显示内容完全可以自己配置

例如：

今日在线 01:25:32

总在线 126:18:44

也可以结合 PlaceholderAPI

直接显示自己想要的在线数据

---

在线奖励菜单

玩家输入：

/cyutime menu

即可打开在线奖励主菜单

每日

每周

每月

每年

总在线

都可以拆成不同菜单

也可以继续设计多页菜单

每一个奖励按钮都可以显示：

所需在线时间

当前在线时间

是否已经领取

奖励内容

点击后直接执行领取

还可以提供一键领取当前周期所有已经达成的奖励

---

菜单完全可以自己改

CyuTime 使用独立的 menus 配置

服主可以自己调整：

菜单布局

按钮位置

物品材质

名称

Lore

领取条件

点击动作

分页

跳转

不需要固定使用默认菜单样式

甚至可以把每日、每周、每月奖励做成完全不同的页面

---

条件系统

菜单按钮可以根据条件决定是否允许执行

支持：

>=

<=

==

!=

>

<



并且会先解析 PlaceholderAPI

例如：

今日在线达到 60 分钟

并且奖励还没有领取

两个条件同时满足后

按钮才允许执行领取动作

因此菜单不仅可以展示

还可以直接承担完整的奖励逻辑

---

AFK 判定

在线并不一定代表玩家真的在玩

所以 CyuTime 也提供 AFK 相关设置

可以控制玩家进入挂机状态后的计时处理

同时还可以配置：

挂机前预警

暂停与恢复提示

拾取物品是否算活动

进食是否算活动

钓鱼是否算活动

让服主可以按照自己的服务器玩法决定

什么才算真正的有效在线时间

---

PlaceholderAPI

支持 PlaceholderAPI

可以读取：

今日在线时间

本周在线时间

本月在线时间

本年在线时间

总在线时间

在线秒数

在线分钟数

在线小时数

当前奖励领取状态

连续在线天数

双倍倍率状态

以及在线排行榜

可以继续接入：

计分板

TAB

BossBar

ActionBar

菜单

其他插件

让在线时间真正成为服务器其他系统可以调用的数据

---

SQLite / MySQL

单服使用 SQLite 即可

不需要额外数据库

数据会保存在插件自己的数据目录中

如果是群组服

则可以切换 MySQL

让多个服务器读取同一份玩家在线数据

例如：

大厅

生存服

RPG服

资源服

都可以共享玩家的在线时间

不同子服之间也就不需要分别统计

---

在线数据管理

管理员可以直接查询玩家在线时间

查看全服在线统计

查看不同周期排行榜

管理奖励领取标记

导出周期在线数据

方便服务器做：

运营统计

活跃度分析

活动复盘

奖励核对

需要数据时也可以直接导出 CSV

---

外部材质与资源包

在线奖励菜单的按钮并不只能使用原版材质

也可以配合资源包使用 CustomModelData

或者直接调用：

CraftEngine

ItemsAdder

Oraxen

Nexo

因此可以把在线奖励菜单做成自己的视觉风格

外部物品读取失败时

还可以自动使用原版材质作为回退

不会因为一个外部图标导致菜单无法打开

---

可以做出的玩法

● 每日在线奖励
● 每周活跃奖励
● 月度在线礼包
● 年度在线奖励
● 连续在线签到
● 周末双倍在线
● 活动期间在线倍率
● 全服在线排行榜
● 周期排名奖励
● 随机在线奖池
● 多服共享在线时长
● 长期活跃玩家奖励

---

与服务器其他系统联动

CyuTime 本身不强制规定奖励一定要发什么

在线时间只负责提供：

玩家在线多久

是否达到奖励条件

当前属于哪个周期

奖励是否已经领取

至于最后发什么

可以交给服务器自己的经济、权限、任务、活动与商城系统处理

因此可以把在线时间直接变成整个服务器长期活跃体系的一部分

---