OnlineTime - 在线时长统计

OnlineTime 插件用于精确记录玩家在服务器或网络中的总在线时长。该插件基于 Mr_Minecraft15 的 OnlineTime 插件重写，功能全面且高度可定制，支持单服与跨服部署。

💡重要须知

• 本插件需要 Spigot 或 Paper 服务端，不兼容 CraftBukkit。
• 支持在 BungeeCord 或 Waterfall 上运行。
• 默认情况下，BungeeCord 与 Spigot 服务器之间没有通信。
• 若要在 BungeeCord 网络环境下使用全部功能，必须在 BungeeCord 和所有 Spigot 子服上都安装本插件，并进行正确配置。

跨服配置

• 将所有 Spigot 子服的配置模式 (mode) 设置为 slave。
• 将 BungeeCord 代理的配置模式 (mode) 设置为 master。

升级注意

若从 1.1.2 或更早版本升级，更新后生成的配置文件会恢复默认值，你需要根据备份手动调整配置。插件会自动创建旧配置的备份。

✨功能特性

• 完全可定制：所有消息（包括前缀）均可自定义。
• 多种存储方式：支持 YAML 文件或 MySQL 数据库存储数据。
• 高性能：采用多线程设计，所有 I/O 操作均不阻塞主线程，实现零延迟。
• 扩展支持：支持 PlaceholderAPI，方便在其他插件中调用在线时长数据。

🎮命令列表

• /onlinetime [玩家名或UUID] - 查看指定玩家的在线时长。
• /ot [玩家名或UUID] - 上一命令的别名。

管理命令

• /onlinetimeadmin set [玩家名或UUID] [时间] - 将玩家的在线时长设置为指定值。
• /onlinetimeadmin mod [玩家名或UUID] [时间] - 增减玩家的在线时长。
• /onlinetimeadmin reset [玩家名或UUID] - 将玩家的在线时长重置为零。
• /ota (set|mod|reset) … - 以上管理命令的别名。

时间参数格式

时间参数支持多种灵活格式

• 纯数字：将被视为秒数（例如 3600）。
• 单位组合：支持 w（周）、d（天）、h（小时）、min（分钟）等单位，可进行加减运算。
• 示例：
• 4h 3min - 4小时3分钟
• 28 d 3 h - 28天3小时
• 2w1d - 2周1天
• 1h -5min - 1小时减5分钟（即55分钟）
• -6 d - 减少6天（仅适用于 mod 命令）

🔧权限节点

• onlinetime.see - 允许玩家查看自己的在线时长。
• onlinetime.see.other - 允许玩家查看他人的在线时长。
• onlinetime.admin - 允许管理员修改所有玩家的在线时长记录。

⭐PlaceholderAPI 占位符

本插件提供丰富的 PlaceholderAPI 占位符，用于在其他插件或聊天中显示时长信息。

格式化字符串

• %onlinetime_string% - 格式化的时长字符串（与 /onlinetime 命令显示效果相同）。

各时间单位（格式化部分）

• %onlinetime_only_seconds%
• %onlinetime_only_minutes%
• %onlinetime_only_hours%
• %onlinetime_only_days%
• %onlinetime_only_weeks%
• %onlinetime_only_months%
• %onlinetime_only_years%

总时长（转换为指定单位）

• %onlinetime_all_seconds% - 总秒数
• %onlinetime_all_minutes% - 总分钟数
• %onlinetime_all_hours% - 总小时数
• %onlinetime_all_days% - 总天数
• %onlinetime_all_weeks% - 总周数
• %onlinetime_all_months% - 总月数
• %onlinetime_all_years% - 总年数

❓配置指南

单服独立模式配置

若仅在一台 Spigot/Paper 服务器上使用，配置如下：

language: 'en' # 语言，可编辑 messages.yml 查看或修改可用语言
servername: 'this server' # 服务器名称
messageformat: '&gray&[[OnlineTime](dark_aqua)] %message%' # 消息格式，支持 MineDown 语法
saveinterval: 30 # 数据保存间隔（秒）
storage: 'yaml' # 存储方式，设为 'database' 可使用 MySQL
mode: 'standalone' # 模式：单服独立运行
configversion: 2 # 配置版本号，请勿手动修改

BungeeCord 网络模式配置

若在 BungeeCord 网络中使用，需分别配置代理端和子服端。

BungeeCord (代理端) 配置：

language: 'en'
servername: 'this server'
messageformat: '&gray&[[OnlineTime](dark_aqua)] %message%'
saveinterval: 30
storage: 'yaml' # 或 'database'
mode: 'master' # 模式：主节点
configversion: 2

Spigot (子服端) 配置：

language: 'en' # 用于 PlaceholderAPI 的 %onlinetime_string% 占位符
servername: 'this server' # 此设置在此模式下未使用
messageformat: '...' # 此设置在此模式下未使用
saveinterval: 30 # 从 BungeeCord 同步数据的间隔（秒）
storage: 'yaml' # 此设置在此模式下未使用
mode: 'slave' # 模式：从节点
configversion: 2

数据库配置

若将 storage 选项设置为 'database'，重启服务器后会在插件数据文件夹中生成 database.properties 文件。你需要根据你的数据库信息进行配置：

# 参考：https://github.com/brettwooldridge/HikariCP#configuration-knobs-baby
dataSourceClassName=mr.minecraft15.onlinetime.libraries.mariadb.jdbc.MariaDbDataSource
dataSource.user=minecraft_user
dataSource.password=password
dataSource.databaseName=minecraft_database
dataSource.portNumber=3306
dataSource.serverName=127.0.0.1

注意：你可以通过提供相应的数据源类来使用其他数据库，但官方不保证提供支持。

🔧计划与致谢

• 开发计划：请查看 GitHub 仓库中标记为 enhancement 的议题。
• 特别感谢：
• yudete 贡献了日语翻译。
• hammad_alhassan 的捐赠支持。

⭐许可证

本插件基于 MIT 许可证开源

> Copyright (c) 2018 Marvin Klar, 2019 Niklas Seyfarth

>

> 特此免费授予任何获得本软件及相关文档文件（“软件”）副本的人不受限制地处理本软件的权限，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利，并允许向其提供本软件的人员这样做，但须符合以下条件：

>

> 上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。

>

> 本软件“按原样”提供，不提供任何形式的明示或暗示保证，包括但不限于对适销性、特定用途适用性和非侵权的保证。在任何情况下，作者或版权持有人均不对因本软件或本软件的使用或其他交易而产生的任何索赔、损害赔偿或其他责任负责，无论是在合同诉讼、侵权诉讼还是其他诉讼中。