?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
Starplaytime

Starplaytime

A best Lightweight playtime reward GUI plugin

4downloads
0followers
4downloads
0followers

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Creators

Details

Licensed ARR
Published 2 days ago
Updated 2 months ago

⭐ StarPlaytime

A milestone-based playtime rewards plugin with a paginated GUI menu — players open a rewards menu, see every playtime milestone at a glance (locked, claimable, or already claimed), and click to claim money and/or item rewards as they play. Download it if you want a polished, click-to-claim playtime rewards system instead of chat-command-only reward plugins.

👤 Author Info

  • Author: StarOG__

✅ Versions / Compatibility / Software Support

  • API Version: 1.21
  • Server software: Paper and forks
  • Folia support: ✅ Supported (folia-supported: true)
  • Soft dependencies (optional):
    • Vault — required for money rewards to be paid out
    • PlaceholderAPI — enables placeholders below

🔐 Permissions

Permission Default Purpose
starplaytime.use true Open the rewards menu and claim rewards
starplaytime.admin op Access to admin commands (reload, reset)

⌨️ Commands

Command Usage Description
/playtime /playtime Opens the playtime rewards menu
/levels /levels Opens the playtime rewards menu (alias)
/starplaytime /starplaytime <reload|reset> [player] Reloads the config, or resets a player's tracked playtime/claimed rewards

🎯 Uses

  • 📖 Paginated rewards GUI showing every milestone's status — locked, ready to claim, or already claimed — each with its own icon and lore.
  • 💰 Configurable money rewards (via Vault) and item rewards per milestone.
  • 📊 A stats item in the menu shows the player's current playtime, next reward, and claimed/available reward counts at a glance.
  • ⏱️ Choice of tracking real playtime or in-plugin tracked time, with the option to count time accrued before the plugin was installed.
  • 🔔 Title, subtitle, and action bar notifications for playtime updates.
  • 🎒 Configurable behavior for what happens when a reward can't fit in a full inventory.
  • 🎨 Fully customizable GUI layout, item icons, lore, and every message, with hex color (&#RRGGBB) support throughout.
  • 💾 Autosaves player playtime/claim data on a configurable interval.

🧩 PlaceholderAPI Placeholders

Placeholder Returns
%starplaytime_playtime% Player's tracked playtime, in seconds
%starplaytime_playtime_formatted% Player's tracked playtime, formatted (e.g. 3h 12m)
%starplaytime_next_reward% ID of the player's next unclaimed reward
%starplaytime_rewards_claimed% Number of rewards the player has claimed
%starplaytime_rewards_available% Number of rewards currently available for the player to claim
%starplaytime_reward_<id>_claimed% Whether a specific reward ID has been claimed (true/false)

⚙️ Key Config Areas (config.yml / Rewards.yml)

  • settings.* — real vs. tracked playtime, counting pre-install playtime, autosave interval, full-inventory reward policy
  • gui.* — menu title, size, fill/background item, pagination buttons, stats item styling
  • reward-lore-* — icon/name/lore templates for locked, claimable, and claimed reward states
  • messages.* — every user-facing plugin message
  • Rewards.yml — the actual milestone list: time required, money reward, and item reward per milestone