PlayTime - Plguin

PlayTime - Professional Playtime Tracker
Java Version: 21

Tested on: 1.21.4

[DEUTSCH]
PlayTime ist ein hochperformantes Plugin, das die Spielzeit deiner Spieler sekundengenau trackt. Mit einem interaktiven Top-Ranking GUI, flexiblen Datenbank-Optionen (SQLite & MySQL) und voller PlaceholderAPI-Unterstützung ist es das perfekte Tool für jeden Server.

✨ Funktionen

• Präzises Tracking: Speichert alles sekundengenau.
  
  
• ️ Datenbank-Flexibilität: Wähle zwischen lokaler SQLite oder externem MySQL-Server.
  
  
• Top-Listen GUI: Ein interaktives Menü mit den Köpfen der 28 besten Spieler (Lore & Name 100% anpassbar).
  
  
• Welt-Blacklist: Pausiere das Tracking automatisch in AFK-Bereichen oder Lobbys.
  
  
• ️ Admin-Tools: Spielzeit hinzufügen oder abziehen mit intelligentem Zeitparsing (z.B. 1d, 5h, 10m).
  
  
• Custom Formate: Bestimme selbst, wie die Zeit angezeigt wird (mit oder ohne Sekunden, eigenes Format für Tage/Stunden/Minuten).
  
  
• PlaceholderAPI Support: Zeige die Zeit in Scoreboards, Tablisten oder Hologrammen an.
  
  
• Multi-Language: Vollständig anpassbar (Deutsch & Englisch vorkonfiguriert).
  

Befehle & Rechte
Befehl Beschreibung Berechtigung
/playtime Zeigt deine eigene Spielzeit. keine
/playtime top Öffnet das Top-Ranking Menü. keine
/playtime see <P> Prüfe die Zeit eines anderen Spielers. playtime.see.others
/playtime give <P> <Z> Zeit hinzufügen (z.B. 10h). playtime.admin
/playtime take <P> <Z> Zeit abziehen (z.B. 30m). playtime.admin
/playtime reload Lädt Konfiguration, Datenbank & Sprache neu. playtime.admin
Platzhalter (PAPI)

• %playtime_time% – Deine formatierte Spielzeit.
  
  
• %playtime_alltime% – NEU: Die gesamte Spielzeit aller Spieler kombiniert (inkl. Jahre!).
  
  
• %playtime_topX% – Name des Spielers auf Platz X der Rangliste.
  

[ENGLISH]
PlayTime is a high-performance plugin designed to track your players' playtime with second-by-second precision. Featuring an interactive Top Ranking GUI, dual database support (SQLite & MySQL), and full PlaceholderAPI integration, it’s the ultimate solution for any Minecraft network.

✨ Features

• Precise Tracking: Reliable second-by-second data collection.
  
  
• ️ Database Options: Support for local SQLite (.db) or high-performance MySQL.
  
  
• Top Ranking GUI: Interactive inventory displaying the top 28 players with custom heads and lore.
  
  
• World Blacklist: Disable tracking in specific worlds like Lobbies or AFK zones.
  
  
• ️ Admin Tools: Add or remove playtime using intuitive formats (e.g., 1d, 5h, 10m).
  
  
• Flexible Formatting: Toggle seconds on/off and define your own time strings in the config.
  
  
• PlaceholderAPI Support: Easily display stats in scoreboards or tablists.
  
  
• Multi-Language: Fully translatable (English & German files included).
  

Commands & Permissions
Command Description Permission
/playtime Shows your own playtime. none
/playtime top Opens the interactive ranking menu. none
/playtime see <P> Check another player's time. playtime.see.others
/playtime give <P> <T> Add playtime (e.g., 5h). playtime.admin
/playtime take <P> <T> Remove playtime. playtime.admin
/playtime reload Reloads config, database settings & languages. playtime.admin
Placeholders (PAPI)

• %playtime_time% – Your formatted playtime.
  
  
• %playtime_alltime% – NEW: Total server playtime of all players combined (including years!).
  
  
• %playtime_topX% – Name of the player at Rank X.