PlayTimed

Minecraft 版本： 1.13 1.13.1 1.13.2 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： folia paper purpur

标签： economy social utility

PlayTimed

Simple Paper/Folia plugin that exposes player playtime from Minecraft statistics.

What it provides

• PlaceholderAPI placeholder:
  • %playtime_timed%
  • %playtime_playtime%
• Public Java API for other plugins (for example, leaderboard plugins) to read playtime values.

Playtime is read from Minecraft's built-in statistic (PLAY_TIME / PLAY_ONE_MINUTE) and returned as ticks or seconds.

Using the API from another plugin

1) Add dependency

You can consume PlayTimed from JitPack.

Gradle Kotlin DSL (build.gradle.kts)

repositories {
    mavenCentral()
    maven("https://jitpack.io")
}

dependencies {
    compileOnly("com.github.OPmasterLEO:PlayTimed:main-SNAPSHOT")
}

If your project centralizes repositories in settings.gradle.kts, add JitPack there:

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>

If resolution fails initially, trigger a JitPack build once at:
https://jitpack.io/#OPmasterLEO/PlayTimed/main-SNAPSHOT

2) Get API instance

PlayTimed registers its API in Bukkit ServicesManager.

import net.opmasterleo.playtimed.api.PlayTimedApi;

PlayTimedApi api = PlayTimedApi.get();
if (api == null) {
    // PlayTimed is not installed or not enabled yet
    return;
}

You can also resolve manually:

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) Read playtime values

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) Format playtime

String formattedA = api.formatPlaytime(ticksFromPlayer);  // e.g. "2h 15m"
String formattedB = api.getFormattedPlaytime(offlinePlayer);

Current output format:

• Xd Yh for 1+ days
• Xh Ym for 1+ hours
• Xm Ys for 1+ minutes
• Xs for under 1 minute

API reference

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

If PlaceholderAPI is installed, PlayTimed auto-registers placeholders:

• %playtime_timed%
• %playtime_playtime%

Both return the same formatted playtime string.