PlayTimed
一个简单的 Paper/Folia 插件,用于从 Minecraft 统计数据中暴露玩家游戏时长。
功能特性
- PlaceholderAPI 占位符:
%playtime_timed%%playtime_playtime%
- 供其他插件(例如排行榜插件)读取游戏时长的公共 Java API。
游戏时长数据来源于 Minecraft 内置的统计项(PLAY_TIME / PLAY_ONE_MINUTE),并以刻(ticks)或秒为单位返回。
在其他插件中使用 API
1) 添加依赖
你可以通过 JitPack 获取 PlayTimed。
Gradle Kotlin DSL (build.gradle.kts)
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
compileOnly("com.github.OPmasterLEO:PlayTimed:main-SNAPSHOT")
}
如果你的项目在 settings.gradle.kts 中集中管理仓库,请在此处添加 JitPack:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
mavenCentral()
maven { url = uri("https://jitpack.io") }
}
}
Maven (pom.xml)
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.github.OPmasterLEO</groupId>
<artifactId>PlayTimed</artifactId>
<version>main-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
</dependencies>
如果初始解析失败,请在以下地址触发一次 JitPack 构建:
https://jitpack.io/#OPmasterLEO/PlayTimed/main-SNAPSHOT
2) 获取 API 实例
PlayTimed 会在 Bukkit ServicesManager 中注册其 API。
import net.opmasterleo.playtimed.api.PlayTimedApi;
PlayTimedApi api = PlayTimedApi.get();
if (api == null) {
// PlayTimed 未安装或未启用
return;
}
你也可以手动解析:
import net.opmasterleo.playtimed.api.PlayTimedApi;
import org.bukkit.Bukkit;
import org.bukkit.plugin.RegisteredServiceProvider;
RegisteredServiceProvider<PlayTimedApi> provider =
Bukkit.getServicesManager().getRegistration(PlayTimedApi.class);
PlayTimedApi api = provider == null ? null : provider.getProvider();
3) 读取游戏时长数值
import java.util.UUID;
import org.bukkit.OfflinePlayer;
OfflinePlayer offlinePlayer = Bukkit.getOfflinePlayer(uuid);
UUID playerId = offlinePlayer.getUniqueId();
long ticksFromPlayer = api.getPlaytimeTicks(offlinePlayer);
long ticksFromUuid = api.getPlaytimeTicks(playerId);
long secondsFromPlayer = api.getPlaytimeSeconds(offlinePlayer);
long secondsFromUuid = api.getPlaytimeSeconds(playerId);
4) 格式化游戏时长
String formattedA = api.formatPlaytime(ticksFromPlayer); // 例如 "2h 15m"
String formattedB = api.getFormattedPlaytime(offlinePlayer);
当前的输出格式如下:
Xd Yh:表示 1 天及以上Xh Ym:表示 1 小时及以上Xm Ys:表示 1 分钟及以上Xs:表示不足 1 分钟
API 参考
net.opmasterleo.playtimed.api.PlayTimedApi
static PlayTimedApi get()long getPlaytimeTicks(OfflinePlayer player)long getPlaytimeTicks(UUID playerId)long getPlaytimeSeconds(OfflinePlayer player)long getPlaytimeSeconds(UUID playerId)String formatPlaytime(long ticks)String getFormattedPlaytime(OfflinePlayer player)
PlaceholderAPI
如果已安装 PlaceholderAPI,PlayTimed 会自动注册占位符:
%playtime_timed%%playtime_playtime%
两者均返回相同格式化的游戏时长字符串。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧