PlayTimed

插件

· 作者 OPmasterLEO

一款轻量级的游戏时长插件,可自动将玩家的游戏时长格式化为简洁、易读的时长表示,风格与 DonutSMP 完全一致。

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

需要前置:PlaceholderAPI

最新 3.2.1 · 26.2 · Folia / Paper

一键开服(送7天)

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%

两者均返回相同格式化的游戏时长字符串。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源