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

3. Remove the previous Playtime Rewards JAR.
4. Install Playtime Rewards 1.3.2.
5. Start the server.
6. Review the updated configuration.
7. 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.