转载 开源 工具 SimplePlaytime 1.1.1

[MD]
# SimplePlaytime

总在线时长、会话追踪与可配置在线奖励

---

## 语言说明

SimplePlaytime 当前仅支持中文。默认配置文件注释、管理员反馈信息及控制台输出均以中文书写。

---

## 简介

SimplePlaytime 是一款专为 Paper 26.2 服务端设计的轻量级在线时长追踪插件，具备以下核心能力：

- 记录每位玩家的累计在线时长
- 实时追踪当前游戏会话时长
- 通过 PlaceholderAPI 变量与计分板、菜单、全息文字及其他兼容插件集成

可在指定会话分钟数达到阈值时触发里程碑奖励，奖励指令支持以玩家身份或控制台身份执行。

---

## 兼容性

| 项目 | 要求 |
|---|---|
| 服务端 | 仅支持 Paper 26.2 |
| Java | 25 或更高版本 |
| 必要依赖 | PlaceholderAPI 2.11.6 或更高版本 |
| 实测环境 | Paper 26.2 生产服务器 |

> Spigot 兼容性未经测试，不作兼容性声明。

---

## 主要功能

- 为每位玩家持久记录累计在线时长
- 实时追踪当前游戏会话时长
- 紧凑的中文会话时间格式显示
- 可配置断线续接保护期，默认 60 秒
- 在保护期内重连将延续同一会话，断线期间不计入在线时长
- 可在任意会话分钟数设置奖励里程碑
- 奖励指令支持以玩家身份或控制台身份执行
- 奖励指令支持玩家信息、PlaceholderAPI 变量、颜色与格式代码
- 累计在线时长前 10 名排行榜变量
- 累计在线时长数据安全存储

---

## 断线续接保护

临时断线不会立即重置当前会话。玩家断开连接后，SimplePlaytime 暂停会话计时；若在配置的保护期内重新连接，之前的会话时长与已领取的奖励里程碑均会恢复，断线期间的时间不计入在线时长。

---

## 在线奖励

可设置任意数量的奖励里程碑，每个阈值在每次游戏会话中仅触发一次。若多个阈值同时达到，所有未执行的奖励将按阈值从小到大依次执行。

---

## PlaceholderAPI 集成

SimplePlaytime 提供以下类型的变量：格式化会话时长、数值型会话时长、累计在线时长及前 10 名排行榜。完整变量列表见文档说明。

---

## 数据兼容性

SimplePlaytime 1.0.x 与 1.1.0 的累计在线时长数据与 1.1.1. 完全兼容，无需手动转换数据格式。

---

## 相关链接

- [Source Code](https://github.com/yangzijian52/SimplePlaytime)
- [Downloads](https://github.com/yangzijian52/SimplePlaytime/releases)
- [Support and Issues](https://github.com/yangzijian52/SimplePlaytime/issues)

---

## 中文说明

SimplePlaytime 当前仅支持中文，已在 Paper 26.2 + Java 25 环境下完成生产服务器实测，使用前须安装 PlaceholderAPI 2.11.6 或更高版本。

插件支持累计在线时长、当前会话时长、60 秒断线续接、在线分钟奖励及排行榜变量。详细安装步骤、指令、变量说明及配置方法请参阅文档。
[/MD]