原创 工具 每日在线占位符Time —— 支持1.8 - 1.21.1 3.4

插件简介​

主要功能​

1. 实时在线时间统计​

• 自动记录：每秒钟更新玩家的在线时间，确保记录的准确性。
• 每日统计：支持每天自动重置在线时间，并在玩家下次登录时显示前一天的总在线时间。

2. 多种存储模式​

• 本地文件存储：无需额外配置，插件默认将玩家的在线时间数据保存在 YAML 文件中，每天生成一个新的数据文件。
• MySQL 数据库支持：对于大型服务器，可以启用 MySQL 数据库来存储和管理在线时间数据，确保数据的稳定性和跨服务器共享。

3. 自动任务管理​

• 每日重置任务：插件自动计算到午夜的剩余时间，并在午夜时分自动重置当天的在线时间数据。
• 定期数据保存：每隔5分钟自动保存一次在线时间数据，以防服务器崩溃或意外关闭导致的数据丢失。
• 异步操作：大部分数据保存和加载操作都在异步线程中进行，确保不会影响服务器的性能。

4. PlaceholderAPI 集成​

• 动态占位符：支持多个 PlaceholderAPI 占位符，允许您在聊天、记分板或其他支持 PlaceholderAPI 的插件中显示玩家的在线时间。
• 多种格式：提供月、周、小时、分钟、秒数、格式化和简洁显示等多种占位符格式，满足不同的显示需求。

5. 离线玩家支持​

• 数据缓存：在玩家下线时，插件会自动将其在线时间保存到缓存中，并在适当的时候将数据持久化到文件或数据库中。

6. 在线奖励​

• 玩家在线奖励占位符，当玩家在线达到配置文件中设置的时间，则会让对应的占位符返回true，没有到达在线时长则返回false

配置选项​

1. 基础配置 (config.yml)​

# 是否使用数据库（true 表示使用，false 表示不使用）
use-database: false

# 数据库相关配置
database:
# 数据库类型（这里是 MySQL）
type: mysql
# 数据库主机地址
host: your-database-host
# 数据库端口号，MySQL 默认是 3306
port: 3306
# 数据库名称
database: playtime
# 数据库用户名
username: your-username
# 数据库密码
password: your-password

# HikariCP 连接池相关配置
HikariCP:
# 最大连接池大小
maximum-pool-size: 10
# 最小空闲连接数
minimum-idle: 2
# 获取数据库连接的最大等待时间（毫秒），超时将抛出异常
connection-timeout: 30000
# 空闲连接的最大存活时间（毫秒），超时将被释放
idle-timeout: 600000
# 连接的最大存活时间（毫秒），超时后连接将被关闭并重新创建
max-lifetime: 1800000

# 在线时间奖励配置
rewards:
- name: 'reward_30_minutes'
    time: 1800  # 30分钟
    rewardName: '30分钟奖励'
    message: '&a恭喜你！你已在线 {minutes} 分钟，获得了 {rewardName} 的奖励！'
  - name: 'reward_1_hour'
    time: 3600  # 1小时
    rewardName: '1小时奖励'
    message: '&b恭喜你！你已在线 {hours} 小时，获得了 {rewardName} 的奖励！'

• use-database：设置是否使用 MySQL 数据库进行数据存储。如果关闭，将使用本地文件存储。
• database：数据库连接的详细配置，包括主机、端口、数据库名、用户名、密码以及 HikariCP 连接池的配置选项。

2. 占位符配置​

• %playtimetracker_hours% - 显示玩家当天在线的小时数。
• %playtimetracker_minutes% - 显示玩家当天在线的分钟数。
• %playtimetracker_seconds% - 显示玩家当天在线的秒数。
• %playtimetracker_formatted% - 显示玩家当天在线的时间，格式为“XX小时 XX分 XX秒”。
• %playtimetracker_condensed% - 显示玩家当天在线的时间，格式为“HHMMSS”。
• %playtimetracker_weekly% - 显示玩家在线累计的周和天数 例如：2周 3天
• %playtimetracker_weekly_plain% - 显示玩家在线累计的周和天数 例如：2周 3天转换2 3
• %playtimetracker_monthly% - 显示玩家在线累计的月和天数 例如：1月 5天
• %playtimetracker_monthly_plain% - 显示玩家在线累计的月和天数 例如：1月 5天转换1 5

• %playtimetracker_reward_30_minutes% - 显示玩家是否达到了30分钟的奖励条件（true 或 false）
• %playtimetracker_reward_1_hour% - 显示玩家是否达到了1小时的奖励条件（true 或 false）。

安装与使用指南​

1. 下载并安装插件
   • 将 Time.jar 文件放入服务器的 plugins 目录中。
   • 启动服务器，插件将自动生成配置文件和数据文件夹。
2. 配置插件
   • 停止服务器，打开 plugins/Time/config.yml 文件，根据需求调整配置选项。
   • 如果启用 MySQL 数据库，请确保填写正确的数据库连接信息。
   • 启动服务器以应用配置。
3. 检查安装
   • 通过 PlaceholderAPI 支持的插件测试占位符功能。
4. 定制使用
   • 根据服务器的需求，您可以在聊天、记分板或其他插件中展示玩家的在线时间数据，或者使用每日统计功能为玩家提供奖励。

使用场景​

• 在线时间奖励：通过统计玩家的在线时间，您可以设置特定的奖励或权限，激励玩家更多地参与服务器活动。
• 服务器管理：作为管理员，您可以监控活跃玩家的在线时间，识别出最常在线或最不活跃的玩家，为制定管理策略提供依据。
• 社区活动：在社区活动期间，记录和展示玩家的在线时间，增加竞争性和参与感。

常见问题​

• QQ : [761070659]