Playtime Rewards 1.7.3

Changes Since 1.6.0

Version 1.7.3 expands Playtime Rewards from a leaderboard-focused mod into a complete graphical progression system.

Added Personal Profile GUI

/playtime and /playtime me now open a personal player profile.

The profile displays:

• Player name
• Total playtime
• Current rank
• Current rank icon
• Next rank
• Progress percentage
• Remaining time
• Leaderboard position
• Rank browser button
• Claim rewards button
• Leaderboard button

The original text display remains available through:

/playtime text

Added Rank and Reward Browser

/playtime ranks now opens a graphical rank browser.

Each rank entry displays:

• Rank name
• Required playtime
• Locked or unlocked status
• Configurable display icon
• A prompt to view its rewards

Rank entries are clickable.

Added Individual Reward Detail Screens

Clicking a rank opens a dedicated reward screen.

The new screen displays:

• The rank name
• The rank display item
• Every configured reward
• Real reward item icons
• Configured reward quantities
• Claimed or unclaimed status
• A button to return to the rank list

Ranks without rewards display a configurable empty-state message and item.

Shortened Rank Hover Text

The rank list no longer displays every reward in one large tooltip.

Rank hover text now focuses on:

• Rank
• Requirement
• Status
• Click instruction

The full reward list is moved into the dedicated reward page.

Added Configurable Rank Display Items

Every rank can now define a unique display item.

Example:

{
  "name": "Veteran",
  "seconds": 86400,
  "displayItem": "minecraft:diamond_sword",
  "luckPermsGroup": "veteran",
  "luckPermsPrefix": "&4[Veteran]&r ",
  "luckPermsPrefixPriority": 300,
  "rewards": []
}

The configured item is used in:

• The rank browser
• The personal profile
• The reward-detail header

Display items are visual only and are not granted as rewards.

Added Default Rank Icons

Default rank icons are now:

Nomad   → minecraft:leather_boots
Noble   → minecraft:golden_helmet
Veteran → minecraft:diamond_sword
Legend  → minecraft:nether_star

Server owners can replace them with any registered vanilla or modded item.

Added Global Rank Icon Fallback

A new global fallback option is available:

"rankDefaultDisplayItem": "minecraft:book"

This is used when:

• A rank has no display item
• An older config is being migrated
• A configured item ID is invalid
• A configured modded item is unavailable

Invalid item IDs generate a console warning.

Expanded Leaderboard Pagination

The leaderboard now supports multiple pages.

Each page can display up to 45 players.

New controls allow players to:

• Move to the previous page
• Move to the next page
• Return to their profile

Added Leaderboard Sorting

The leaderboard can now be sorted by:

• Total playtime
• Rank
• Online players first
• Alphabetical order

Clicking the sort control cycles through the available modes.

Added Profile Navigation

The progression interfaces are now connected.

Players can navigate between:

• Personal profile
• Rank browser
• Reward detail screen
• Leaderboard
• Reward claiming

This creates a unified progression menu rather than a collection of separate commands.

Added Administrative Commands

New operator commands:

/playtime admin set <player> <time>
/playtime admin add <player> <time>
/playtime admin remove <player> <time>
/playtime admin reset <player>
/playtime admin reload

Supported time formats include:

3600
6h
30m
2d12h
1d6h30m

Added Playtime Set Command

/playtime admin set <player> <time>

Sets a player’s total tracked playtime to an exact value.

The player’s rank and progression are recalculated afterward.

Added Playtime Add Command

/playtime admin add <player> <time>

Adds time to a player’s tracked playtime.

Added Playtime Remove Command

/playtime admin remove <player> <time>

Removes tracked playtime without allowing the value to fall below zero.

Added Player Reset Command

/playtime admin reset <player>

Resets:

• Tracked playtime
• Current rank
• Progression
• Claimed reward history

This allows the player to restart the progression system completely.

Added Configuration Reload Command

/playtime admin reload

Reloads supported configuration settings without requiring a complete server restart.

Added New GUI Placeholders

New configurable placeholders include:

{player}
{position}
{playtime}
{seconds}
{rank}
{nextRank}
{remaining}
{progress}
{required}
{status}
{rewards}
{claimed}
{totalRewards}
{count}
{item}
{page}
{pages}
{sort}

These placeholders can be used throughout the profile, rank, reward, and leaderboard interfaces.

Added Reward Detail Configuration

New settings include:

"rewardDetailGuiTitle": "&b&l{rank} Rewards",
"rewardDetailItemText": "&e{count}x &f{item} &7| {status}",
"rewardDetailClaimedText": "&aClaimed",
"rewardDetailUnclaimedText": "&eUnclaimed",
"rewardDetailEmptyItem": "minecraft:barrier",
"rewardDetailEmptyText": "&7This rank has no item rewards.",
"rewardDetailBackText": "&eBack to Ranks"

Improved GUI Safety

The new profile, rank, reward, and leaderboard menus all use protected display slots.

Players cannot:

• Remove menu items
• Insert their own items
• Shift-click items into menus
• Drag items across menu slots
• Lose cursor items through GUI interaction

Improved Server-Side Compatibility

All new interfaces remain completely server-side.

Players do not need:

• A client mod
• A resource pack
• A custom launcher

The menus use vanilla inventory interfaces.

Configuration Migration

Older configurations are automatically updated with new GUI and rank-display fields.

Existing values are preserved whenever possible.

New fields receive safe defaults.

Upgrade Notes

When upgrading from 1.6.0:

1. Stop the server.
2. Back up config.json.
3. Back up players.tsv.
4. Replace the previous JAR.
5. Start the server.
6. Review the newly generated GUI settings.
7. Review every rank’s new displayItem value.
8. Restart after making configuration changes.

Existing player playtime, ranks, LuckPerms data, and claimed rewards remain compatible.

Playtime Rewards 1.6.0

GUI Changes Since 1.3.2

This changelog covers only the leaderboard GUI and GUI-configuration features added after version 1.3.2.

Added Leaderboard GUI

/playtime top now opens an in-game chest-style leaderboard instead of only displaying leaderboard entries in chat.

The GUI displays:

• Leaderboard position
• Player name
• Total playtime
• Current rank
• Special podium icons for first, second, and third place
• The viewing player’s own overall position

The leaderboard uses saved player data, allowing offline players to remain visible.

No client-side mod is required.

Added Text Leaderboard Fallback

The original chat-based leaderboard remains available through:

/playtime top text

This gives server owners and players access to both the visual GUI and the classic text output.

Added Podium Display Items

The top three leaderboard positions use special display items.

Original defaults:

#1 Gold Ingot
#2 Iron Ingot
#3 Copper Ingot

All remaining players use the configured default player item.

The viewer’s own position is displayed using a separate configurable item.

Added Configurable GUI Items

Leaderboard display items can now be changed through config.json without rebuilding the mod.

Available settings:

"leaderboardFirstPlaceItem": "minecraft:gold_ingot",
"leaderboardSecondPlaceItem": "minecraft:iron_ingot",
"leaderboardThirdPlaceItem": "minecraft:copper_ingot",
"leaderboardDefaultPlayerItem": "minecraft:player_head",
"leaderboardYourPositionItem": "minecraft:clock"

Example custom podium:

"leaderboardFirstPlaceItem": "minecraft:nether_star",
"leaderboardSecondPlaceItem": "minecraft:diamond",
"leaderboardThirdPlaceItem": "minecraft:emerald"

Any valid vanilla or modded item ID can be used.

Invalid item IDs fall back safely and generate a console warning.

Added Configurable GUI Text

All primary leaderboard text can now be edited through the configuration.

Available settings include:

"leaderboardGuiTitle": "&6&lPlaytime Leaderboard",
"leaderboardEntryText": "&6#{position} &f{player} &7| &e{playtime} &7| &b{rank}",
"leaderboardYourPositionText": "&eYour position: &6#{position} &7| &e{playtime} &7| &b{rank}",
"leaderboardUnrankedText": "&7Your position: Unranked"

Supported placeholders:

{position}
{player}
{playtime}
{rank}
{seconds}

This allows server owners to completely restyle the title and player-entry text.

Added Classic Color Formatting

GUI text supports standard Minecraft ampersand formatting codes:

&6 Gold
&7 Gray
&a Green
&b Aqua
&c Red
&d Light Purple
&e Yellow
&f White

Formatting codes are also supported:

&l Bold
&o Italic
&n Underline
&m Strikethrough
&r Reset

Example:

"leaderboardGuiTitle": "&6&lPlaytime Leaderboard"

Added Hex Color Support

GUI text can now use six-digit hex colors.

Example:

"leaderboardGuiTitle": "&#fbbf24&lPlaytime Leaderboard"

Hex colors can be mixed with classic formatting codes.

Added Per-Character Gradient Support

Custom gradients can be created using a different hex color for each character.

Example:

&#fbbf24P&#fabc22l&#fab81fa&#f9b51dy

A full formatted title can be placed directly into the configuration:

"leaderboardGuiTitle": "&#fbbf24&nP&#fabc22&nl&#fab81f&na&#f9b51d&ny&#f9b21a&nt&#f8af18&ni&#f7ab15&nm&#f7a813&ne&r"

The final &r resets the color and formatting state.

This format works well with external Minecraft gradient-text generators.

Improved GUI Safety

The leaderboard interface is now fully read-only.

Players can no longer:

• Remove leaderboard display items
• Place inventory items into leaderboard slots
• Shift-click items into the GUI
• Drag items across GUI slots
• Use item-transfer actions on display slots
• Lose cursor items by clicking the GUI

Earlier GUI builds could allow an item-transfer attempt to begin even though the backing inventory rejected the final write. This could make player items appear to disappear.

The GUI now uses non-interactive display slots, preventing the transfer from starting.

Improved Offline Player Display

Leaderboard entries are generated from stored player records rather than only the current online-player list.

Offline players therefore continue to display with:

• Last known username
• Saved playtime
• Saved rank
• Overall leaderboard position

Added Viewer Position Display

The bottom section of the leaderboard shows the requesting player’s overall position.

Example:

Your position: #14 | 4d 7h | Veteran

The text and display item are both configurable.

An alternate unranked message is shown when the viewer does not yet have a leaderboard position.

Server-Side Compatibility

The leaderboard continues to use a vanilla inventory interface.

This means:

• No client-side companion mod is required
• Vanilla clients can open the leaderboard
• The feature remains compatible with the server-side design of Playtime Rewards

Command Summary

/playtime top

Opens the leaderboard GUI.

/playtime top text

Displays the classic chat leaderboard.

Upgrade Notes

After upgrading from 1.3.2:

1. Stop the server.
2. Back up the existing configuration and player data.
3. Replace the old JAR.
4. Start the server.
5. Review the new leaderboard settings in config.json.
6. Fully restart after editing the GUI configuration.

Existing player playtime, ranks, LuckPerms groups, and claimed rewards are unaffected by the GUI update.

Playtime Rewards 1.3.2

Changes Since 1.2.0

Version 1.3.2 expands Playtime Rewards beyond ranks and LuckPerms integration by introducing fully configurable physical item rewards, reward recovery commands, modded-item support, and reliable duplicate protection.

Added Item Rewards

Each playtime rank can now contain its own configurable item reward bundle.

Rewards support:

• Vanilla Minecraft items
• Items added by other mods
• Custom item quantities
• Unlimited items per rank
• Automatic inventory delivery
• Overflow item drops
• Individual reward claim tracking

Example reward configuration:

"rewards": [
  {
    "item": "minecraft:diamond",
    "count": 8
  },
  {
    "item": "minecraft:experience_bottle",
    "count": 32
  }
]

Modded Item Support

Rewards can use any valid registered item ID available on the server.

Example:

{
  "item": "goml:withered_claim_anchor",
  "count": 1
}

The mod now looks up items directly through Minecraft’s item registry and creates real item stacks for the player.

If a configured item is unavailable, that specific reward remains unclaimed and can be retried later.

New Legend Rank

A new default rank has been added:

Legend — 25 Days

Twenty-five days of playtime equals:

2,160,000 seconds

Default Legend rewards:

• 1 Withered Claim Anchor
• 1 Elytra
• 1 Nether Star
• 1 Shulker Box
• 64 Experience Bottles

Default LuckPerms configuration:

{
  "name": "Legend",
  "seconds": 2160000,
  "luckPermsGroup": "legend",
  "luckPermsPrefix": "&d&l[Legend]&r ",
  "luckPermsPrefixPriority": 400
}

The Withered Claim Anchor requires Get Off My Lawn and uses:

goml:withered_claim_anchor

Server owners can replace this item with any other valid item ID.

Default Rank Rewards

Nomad — 1 Hour

• 16 Bread
• 1 Iron Pickaxe
• 1 Iron Axe
• 1 Shield
• 16 Torches

Noble — 6 Hours

• 4 Diamonds
• 1 Golden Apple
• 16 Experience Bottles
• 1 Name Tag
• 1 Saddle

Veteran — 24 Hours

• 1 Totem of Undying
• 1 Enchanted Golden Apple
• 32 Experience Bottles
• 1 Netherite Upgrade Smithing Template
• 8 Diamonds

Legend — 25 Days

• 1 Withered Claim Anchor
• 1 Elytra
• 1 Nether Star
• 1 Shulker Box
• 64 Experience Bottles

New /playtime claim Command

Players can now use:

/playtime claim

This command checks every rank milestone the player has reached and grants any missing item rewards.

It is useful for:

• Existing players who passed milestones before item rewards were introduced
• Rewards that failed because a modded item was unavailable
• Players who believe they missed a reward
• Recovery after server or configuration changes

Successfully delivered rewards cannot be claimed again.

New Admin Recovery Command

Server operators can trigger reward recovery for another online player:

/playtime claim <player>

The command respects existing claim history and does not duplicate successfully delivered items.

Reliable Reward Delivery

Version 1.3.2 no longer relies on command execution to give items.

The mod now:

1. Resolves the configured item from Minecraft’s registry
2. Creates a real ItemStack
3. Inserts the stack directly into the player’s inventory
4. Drops remaining items at the player’s location when necessary
5. Records the reward only after successful delivery

This fixes an issue in earlier 1.3.x builds where players could receive a success message without receiving the actual items.

Per-Item Claim Tracking

Rewards are tracked individually instead of marking an entire rank bundle as claimed at once.

For example, if a Legend player successfully receives an Elytra but the Withered Claim Anchor is temporarily unavailable:

• The Elytra remains permanently claimed
• The Elytra will not be duplicated
• The Withered Claim Anchor remains available to retry
• /playtime claim can deliver the missing anchor later

This provides safer recovery for modded servers.

Automatic Reward Delivery

Eligible rewards are checked automatically when:

• A player reaches a new rank
• A player joins the server
• A player uses /playtime claim
• An operator uses /playtime claim <player>

Existing players can receive rewards for milestones they reached before upgrading.

Inventory Overflow Handling

The mod attempts to insert rewards directly into the player’s inventory.

When the inventory cannot hold the entire reward stack, the remaining items are dropped at the player’s current location.

Rewards are only recorded after the inventory insertion or item drop succeeds.

LuckPerms Improvements

The LuckPerms integration continues to support:

• Automatic group creation
• Automatic player group assignment
• Removal of previous managed playtime groups
• Preservation of unrelated groups
• Configurable prefixes
• Configurable prefix priorities
• Login synchronization
• Rank-up synchronization
• /playtime refresh synchronization

Default managed groups:

nomad
noble
veteran
legend

Groups such as staff, administrator, moderator, donor, booster, and builder remain untouched.

Configurable Prefixes

Each rank can define its own LuckPerms prefix:

{
  "luckPermsPrefix": "&d&l[Legend]&r ",
  "luckPermsPrefixPriority": 400
}

The mod applies prefixes to both newly created and existing managed groups.

A compatible chat, tab-list, or nametag formatting mod is still required to display LuckPerms prefixes in-game.

Configuration Migration

Older command-based configurations using the following format:

"thresholds": [
  {
    "seconds": 3600,
    "group": "nomad"
  }
]

can be migrated to the newer per-rank configuration format:

"ranks": [
  {
    "name": "Nomad",
    "seconds": 3600,
    "luckPermsGroup": "nomad",
    "luckPermsPrefix": "&7[Nomad]&r ",
    "luckPermsPrefixPriority": 100,
    "rewards": []
  }
]

The newer format allows every rank to control its group, prefix, priority, and item rewards independently.

Data Compatibility

Existing player playtime data remains compatible.

Player storage now also records individual claimed reward identifiers to prevent duplicated rewards.

Existing players retain:

• UUID
• Player name
• Total playtime
• Current rank
• Previously awarded groups
• Existing progression

Fixes

• Fixed items being reported as delivered when no item was actually received
• Fixed reward delivery using unreliable server commands
• Fixed Minecraft 26.2 command execution compatibility
• Fixed Minecraft 26.2 operator permission checks
• Fixed configuration migration regex escaping
• Fixed older configurations not receiving new prefix fields
• Fixed only the current LuckPerms group being created
• Fixed some LuckPerms updates not being saved reliably
• Fixed LuckPerms startup-order synchronization
• Fixed duplicate item rewards during retries
• Fixed failed custom items incorrectly blocking successful rewards
• Fixed overflow items not being delivered reliably

Upgrade Instructions

1. Stop the server.
2. Back up:

world/config/playtime-rewards/config.json
world/config/playtime-rewards/players.tsv

1. Remove the previous Playtime Rewards JAR.
2. Install Playtime Rewards 1.3.2.
3. Start the server.
4. Review the updated configuration.
5. Have existing players run:

/playtime claim

Players can also use:

/playtime refresh

to refresh their playtime rank and LuckPerms group.

Summary

Playtime Rewards 1.3.2 adds a complete configurable item-reward system while preserving the rank, leaderboard, LuckPerms, prefix, and playtime-tracking features introduced in 1.2.0.

The update adds meaningful milestone rewards, support for modded items, reliable delivery, missed-reward recovery, and strong duplicate protection for long-term Minecraft servers.

Updated for Minecraft 26.2! Config folder is found in World > Config > PlaytimeRewards.