P_Tempo

插件

· 作者 Mr_Haruki

P_Tempo 追踪玩家在线时长

0 本站下载 0 关注 更新于 4 个月前

最新 1.3.1 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

P_Tempo

适用于 Paper 服务器的完整在线时长、奖励、排名与进度插件。

P_Tempo 追踪玩家在线时长,在菜单中显示统计数据,构建全球排行榜,并允许根据累积的在线时长自动发放奖励。该插件的开发重点在于性能、数据安全、可定制性以及与其他插件的集成。

一般信息

信息 详情
版本 1.3.1
平台 Paper 1.21.3 或更高版本
Java Java 21
作者 Pedro
主命令 /ptempo
别名 /tempojogado
数据库 SQLite 或 MySQL

主要功能

在线时长追踪

  • 仅追踪玩家的在线时长。
  • 实时更新当前会话时长,无需频繁查询数据库。
  • 以批量方式异步保存玩家数据。
  • 允许管理员查看、添加、设置、移除或重置在线时长。
  • 支持在线玩家和已知(已加入过服务器)的玩家。
  • 防止因输入错误的玩家名称而意外创建记录。
  • 在管理员修改后刷新排行榜。

数据库与防数据丢失保护

  • 原生支持 SQLite 和 MySQL。
  • 最终插件文件中包含 HikariCP 连接池。
  • 插件中包含 SQLite 和 MySQL 驱动程序。
  • 异步保存以防止主线程卡顿。
  • 对在线玩家进行批量保存。
  • 在临时数据库故障后自动重试。
  • 重试尝试之间具有渐进式延迟。
  • 启用时,迁移前自动备份 SQLite 数据库。
  • 版本化迁移,安全升级旧数据库。
  • 本地紧急日志,用于保留尚未得到数据库确认的数据。
  • 当数据库再次可用时,自动恢复待处理的保存操作。
  • 启动时数据库与日志之间的数据核对。
  • 版本化快照,防止旧数据覆盖新状态。
  • 合法的行政调整在线时长也会被保留。
  • 在服务器关闭期间保护最新的玩家状态。

本地恢复文件名为 pending-player-saves.dat。在数据等待数据库确认期间,不应手动删除此文件。

主菜单

主菜单显示:

  • 玩家头像和名字。
  • 累计总在线时长。
  • 短时格式的在线时长。
  • 可用奖励的数量。
  • 距离下一个奖励的剩余时间。
  • 当前的奖励筛选器。
  • 当前的“隐藏已领取奖励”设置。
  • 数据加载状态。
  • 访问奖励菜单的入口。
  • 访问全球排行榜的入口。

所有标题、物品、材质、名称、描述、槽位、填充物以及自定义模型都可以在 menus.yml 中进行更改。

奖励菜单

  • 按所需在线时长排序的奖励。
  • 自动分页。
  • 可配置的槽位数量。
  • 显示所有奖励的筛选器。
  • 仅显示可用奖励的筛选器。
  • 仅显示已领取奖励的筛选器。
  • 仅显示未解锁奖励的筛选器。
  • 隐藏已领取奖励的选项。
  • 每个玩家单独保存的筛选器偏好。
  • 每个玩家单独保存的“隐藏已领取”偏好。
  • 可用、已领取和未解锁奖励的不同外观。
  • 仅在物品实际发生变化时进行优化更新。
  • 防止未经授权的物品移动。

可配置奖励

每个奖励可以拥有:

  • 自己的标识符。
  • 所需的在线时长。
  • 自定义名称。
  • 自定义材质。
  • 自定义纹理的玩家头像。
  • 自定义 Model Data。
  • 自定义描述。
  • 一个或多个命令。
  • 由控制台或玩家执行的命令。
  • 领取后的聊天消息。
  • 标题和副标题。
  • 自定义标题淡入、停留和淡出持续时间。
  • 自定义 ActionBar 消息。

在奖励命令中可以使用 {player} 标记来代表领取奖励的玩家名称。

示例奖励可能使用经济、箱子或权限相关的命令。这些命令仅在服务器上安装了负责处理它们的插件时才有效。

安全的奖励发放

P_Tempo 追踪每一个发放阶段,以降低重复发放或丢失的风险:

  • 在命令执行之前注册发放操作。
  • 每个命令都有一个数据库检查点。
  • 只有在状态更新后才会运行下一个命令。
  • 安全发放可以从最后一个已确认的点继续。
  • 处于模糊状态的情况会被阻止,等待管理员审查。
  • 插件不会自动重复执行可能导致金钱、物品、钥匙或权限重复发放的命令。
  • 只有确认为已发放的奖励才算作已收集。
  • 即使奖励已从配置中移除,旧的发放记录仍然可用。

管理员可以检查发放状态,并选择确认、重试或重置记录。

全球排行榜

  • 在聊天中显示前 10 名。
  • 可视化的排名菜单。
  • 排名菜单中的玩家头像。
  • 可配置的位置数量。
  • 异步缓存,避免重复查询数据库。
  • 可配置的排行榜占位符最大位置。
  • 如果数据库更新失败,最新的有效缓存仍然可用。
  • 支持注册的在线和离线玩家。

排行榜全息图

当安装 DecentHolograms 时,插件可以创建一个包含以下内容的全球全息图:

  • 自定义标题。
  • 每位玩家的位置。
  • 玩家名称。
  • 短时或完整在线时长。
  • 可配置的位置数量。
  • 空位置的自定义文本。
  • 保存在配置中的位置。
  • 基于时间的自动间隔更新。
  • 通过命令手动更新。

在线时长 NPC

当安装 Citizens 时,插件可以创建一个提供系统访问权限的 NPC:

  • 可配置的名称。
  • 持久化的位置。
  • 由管理员创建或移动。
  • 手动更新。
  • 安全移除。
  • 点击时打开菜单。
  • 可配置的更新间隔。
  • 完全可选的集成。

PlaceholderAPI

当安装 PlaceholderAPI 时,P_Tempo 为记分板、TAB 列表、聊天、全息图和其他兼容插件提供占位符。

其他插件的 API

P_Tempo 通过 Bukkit 的服务管理器注册了一个公共服务。其他插件可以利用此集成来:

  • 读取在线玩家的当前游戏时长。
  • 异步读取离线玩家的游戏时长。
  • 获取缓存的排名位置。
  • 设置玩家的游戏时长。
  • 为玩家增加游戏时长。

可能访问数据库的操作均以异步方式处理。

库存安全

菜单受到以下方面的保护:

  • 用于移动物品的普通点击。
  • Shift 点击。
  • 跨多个槽位拖拽物品。
  • 快捷栏数字键。
  • 副手交换。
  • 双击。
  • 创造模式交互。
  • 菜单更新时的重复点击。
  • 同时收集同一奖励。

还提供可配置的两次点击之间的最小延迟。

皮肤系统

  • 个人资料中的玩家自己的头颅。
  • 排名中的玩家头颅。
  • 可选地通过 Mojang 服务查找皮肤。
  • 异步请求。
  • 可配置的超时时间。
  • 带有大小限制和过期的缓存。
  • 可配置的备用用户名。
  • 奖励的自定义纹理。

安全重载

重载命令:

  • 在应用更改之前验证文件。
  • 重载消息、菜单、奖励、皮肤和集成。
  • 使用新的间隔重启任务。
  • 防止重复任务。
  • 当新配置无效时取消操作。
  • 当新配置无法应用时保留之前的配置。
  • 在服务器运行时阻止数据库更改。
  • 在等待确认的关键快照期间阻止重载。

对数据库类型、SQLite 文件、MySQL 地址、端口、数据库名称、用户名或密码的更改需要完全重启服务器。

依赖项与集成

插件 必需 用途
PlaceholderAPI 否 提供外部占位符
DecentHolograms 否 将排名显示为全息图
Citizens 否 创建用于打开菜单的 NPC

HikariCP、Gson 和数据库驱动程序已包含在正确编译的最终插件文件中。无需单独安装。

安装

  1. 仅使用名为 P_Tempo.jar 的最终文件。
  2. 将文件放入服务器的 plugins 文件夹中。
  3. 启动服务器前移除任何旧版本的 P_Tempo。
  4. 切勿安装名为 original-P_Tempo.jar 的文件,因为它不包含捆绑的依赖项。
  5. 启动服务器以生成配置文件。
  6. 配置数据库、菜单、奖励和集成。
  7. 更改任何数据库设置后重启服务器。

生成的文件

文件 用途
config.yml 数据库、游戏时长、排名、消息、缓存、皮肤和集成
menus.yml 完整的菜单布局
recompensas.yml 奖励、要求、物品、命令和通知
dados.db 默认 SQLite 数据库
pending-player-saves.dat 未保存数据的紧急恢复

玩家命令

命令 描述 权限
/ptempo 打开主菜单 ptempo.use
/tempojogado 主命令的别名 ptempo.use
/ptempo top 在聊天中显示前十名 ptempo.use

管理员命令

命令 描述
/ptempo reload 验证并重载支持的配置更改
/ptempo open <player> 为在线玩家打开菜单
/ptempo holograma set 将当前位置保存为全息图位置
/ptempo holograma update 立即更新全息图
/ptempo npc set 创建或将 NPC 移动到当前位置
/ptempo npc update 更新配置的 NPC
/ptempo npc remove 移除配置的 NPC
/ptempo tempo add <player> <time> 为玩家增加游戏时长
/ptempo tempo set <player> <time> 设置玩家的总游戏时长
/ptempo tempo remove <player> <time> 移除玩家的部分游戏时长
/ptempo tempo reset <player> 重置玩家的总游戏时长
/ptempo recompensa reset <player> <id> 重置特定的一项奖励
/ptempo recompensa reset <player> all 重置玩家的所有奖励
/ptempo recompensa status <player> <id> 显示详细的交付状态
/ptempo recompensa resolve <player> <id> delivered 管理员确认交付已完成
/ptempo recompensa resolve <player> <id> retry 从记录的检查点恢复交付
/ptempo recompensa resolve <player> <id> reset 删除记录并允许从头开始重新收集

奖励解决

解决方式 推荐用途
delivered 在确认玩家正确收到奖励后使用
retry 仅在确定下一个命令可以无重复地再次运行时使用
reset 用于删除整个交付记录并允许从头开始重新收集

retry 选项要求奖励在 recompensas.yml 中仍然存在。如果已被移除,请使用 delivered 或 reset。

接受的时间格式

格式 含义
45s 45 秒
30m 30 分钟
2h 2 小时
1h30m 1 小时 30 分钟
2d 2 天
1d2h30m45s 1 天 2 小时 30 分钟 45 秒

单位必须保持天、小时、分钟和秒的顺序。不完整的条目、重复的单位、错误的顺序以及超出支持限制的值将被拒绝。

权限

权限 描述 默认
ptempo.use 允许玩家打开菜单并查看排名 所有玩家
ptempo.admin 允许管理游戏时长、奖励、NPC、全息图和重载 操作员

PlaceholderAPI 占位符

玩家数据

占位符 结果
%ptempo_seconds% 总游戏时长(秒)
%ptempo_time_seconds% 总游戏时长(秒)的别名
%ptempo_time% 完整可读的游戏时长
%ptempo_time_full% 完整可读的游戏时长
%ptempo_time_formatted% 用于显示的格式化游戏时长
%ptempo_time_short% 简短格式的游戏时长
%ptempo_ready_rewards% 可领取奖励的数量
%ptempo_next_reward% 距离下一个奖励或完成所需的时间信息

排行榜

将 <position> 替换为所需的排名位置。最大值在 config.yml 中定义。

占位符 结果
%ptempo_top_<position>_name% 该位置的玩家名称
%ptempo_top_<position>_nick% 该位置玩家名称的别名
%ptempo_top_<position>_seconds% 该位置的游玩时长(秒)
%ptempo_top_<position>_time% 该位置的简短格式游玩时长
%ptempo_top_<position>_time_short% 该位置的简短格式游玩时长
%ptempo_top_<position>_time_full% 该位置的完整格式游玩时长

也可以接受 top 后面没有下划线的形式。例如,%ptempo_top1_name% 和 %ptempo_top_1_name% 返回相同的结果。

当某个位置没有玩家时,名称占位符会返回 No player,数值占位符会返回零。

内部菜单占位符

这些占位符用于 menus.yml 中。

玩家资料

占位符 结果
{player} 玩家名称
{time} 完整游戏时长
{time_short} 简短游戏时长
{seconds} 以秒为单位的游玩时长
{ready_rewards} 可领取的奖励数量
{next_reward_time} 距离下一个奖励所需的时间
{filter} 当前菜单筛选条件
{hide_collected} 是否隐藏已领取的奖励
{data_status} 数据加载状态

资料页也支持内部排行榜占位符,如 {top_1_name}、{top_1_time}、{top_1_time_full} 及其位置变体。

奖励物品

占位符 结果
{reward_id} 奖励标识符
{reward_name} 奖励名称
{reward_lore} 插入为该奖励定义的描述文本行
{reward_time} 所需游玩时长的简短格式
{reward_time_full} 所需游玩时长的完整格式
{remaining} 解锁前剩余的时间
{status} 当前奖励状态
{commands} 配置好的命令列表
{collected} 是否已被领取
{available} 是否可用
{locked} 是否被锁定

分页与筛选

占位符 结果
{page} 当前页码
{max_page} 总页数
{total_rewards} 当前筛选条件下的奖励数量
{filter} 当前筛选条件名称
{toggle_status} 隐藏已领取奖励的设置状态

排行榜菜单与全息图

占位符 结果
{rank} 排名位置
{player} 玩家名称
{nick} 玩家名称的别名
{seconds} 以秒为单位的游玩时长
{time} 简短游戏时长
{time_full} 完整游戏时长

奖励配置

系统支持任意数量的奖励。奖励会自动加载并按其所需的游玩时长排序。

你可以自定义:

  • 奖励 ID。
  • 所需游玩时长。
  • 名称和材质。
  • 头颅纹理。
  • 自定义模型数据(Custom Model Data)。
  • 描述文本(Lore)。
  • 由控制台或玩家执行的命令。
  • 领取消息。
  • 标题、副标题及时长。
  • ActionBar。

时间值无效的奖励将被忽略。材质无效时会使用安全的回退物品并产生控制台警告。重复的 ID 也会被报告。

菜单配置

menus.yml 文件允许自定义以下内容:

  • 物品栏标题和大小。
  • 填充物物品。
  • 单个槽位。
  • 材质。
  • 名称和描述文本。
  • 自定义模型数据。
  • 奖励槽位。
  • 排名位置槽位。
  • 返回按钮。
  • 分页按钮。
  • 筛选按钮。
  • 隐藏已领取奖励的按钮。
  • 可用、已领取和锁定奖励的外观。
  • 已填充和空的排名位置的外观。

超出物品栏大小的槽位会被忽略,以防止错误。

奖励通知

插件可以在玩家在聊天中达到新奖励所需的游戏时长时通知他们。激活方式和消息内容均可配置。

领取时还可以同时显示:

  • 聊天消息。
  • 标题。
  • 副标题。
  • ActionBar。

重要提示

  • 仅使用经过验证的最终 JAR 文件 P_Tempo.jar。
  • 请勿将 original-P_Tempo.jar 放入 plugins 文件夹。
  • 从 SQLite 切换到 MySQL 或从 MySQL 切换到 SQLite 之前,请务必备份。
  • 数据库更改需要完全重启服务器。
  • 数据库故障期间不要删除 pending-player-saves.dat。
  • 在向所有玩家开放之前,请先测试奖励命令。
  • 外部命令依赖于相应插件的安装和配置。
  • 谨慎使用管理员手动解决奖励功能,以避免手动重复发放。

P_Tempo — 奖励奉献,重视成长。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源