\n
\n
\n
\n<\/p>\n
> A flexible playtime reward plugin that automatically rewards your players for their time spent on your server!<\/p>\n
## \ud83c\udf1f Features<\/p>\n
### Core Features
\n– \u23f0 **Time-Based Rewards** – Automatically reward players based on their playtime
\n– \ud83c\udf81 **Fully Configurable** – Customize everything: items, amounts, intervals, messages
\n– \ud83d\udcbe **Smart Storage System** – Stores rewards when inventory is full for later collection
\n– \ud83d\udcca **Player Tracking** – Tracks total playtime, session time, and reward history
\n– \ud83c\udfa8 **Rich Visual Feedback** – Custom messages, sounds, particles, and actionbar countdowns
\n– \ud83d\udee0\ufe0f **Admin Tools** – Comprehensive commands to manage and monitor player rewards
\n– \ud83d\udcaa **Performance Optimized** – Efficient tracking with auto-save system
\n– \ud83d\udd12 **Permission-Based** – Control who receives rewards and who has admin access<\/p>\n
### Advanced Features
\n– **Inventory Full Protection** – Never lose rewards! They’re stored automatically
\n– **Custom Item Support** – Any Minecraft item with custom names and lore
\n– **Actionbar Countdown** – Players see countdown in their actionbar
\n– **Welcome Messages** – Greet players with playtime information on join
\n– **AFK Prevention** – Minimum online time requirement before earning rewards
\n– **Maximum Storage Limit** – Configurable limit to prevent abuse
\n– **Data Persistence** – All data saved automatically and persists across restarts
\n– **Tab Completion** – All commands support tab completion for better UX<\/p>\n
—<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
### Prerequisites
\n– Paper or Spigot server running Minecraft 1.21+
\n– Java 17 or higher installed on your server<\/p>\n
### Steps
\n1. **Download** the latest `PlaytimeReward-1.0.0.jar` file
\n2. **Stop** your Minecraft server
\n3. **Place** the JAR file in your server’s `plugins` folder
\n4. **Start** your server
\n5. The plugin will create a `PlaytimeReward` folder with default configuration
\n6. **Configure** the plugin by editing `plugins\/PlaytimeReward\/config.yml`
\n7. **Reload** the plugin with `\/ptr reload` or restart the server<\/p>\n
### Verification
\nAfter installation, verify the plugin is working:
\n“`
\n> plugins
\n[10:00:00 INFO]: Plugins (1): PlaytimeReward
\n“`<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
The plugin generates a `config.yml` file in `plugins\/PlaytimeReward\/` with extensive customization options.<\/p>\n
### Basic Configuration<\/p>\n
#### Reward Settings
\n“`yaml
\nreward:
\n # Time in seconds between each reward
\n interval: 300 # 5 minutes (300 seconds)<\/p>\n
# Item to give as reward (use Minecraft material names)
\n # Examples: DIAMOND, EMERALD, GOLD_INGOT, IRON_INGOT, NETHERITE_INGOT
\n item: DIAMOND<\/p>\n
# Amount of items to give per reward
\n amount: 1<\/p>\n
# Custom display name for the reward item (optional)
\n # Use & for color codes (&a = green, &b = blue, etc.)
\n display-name: “&b&lPlaytime Reward”<\/p>\n
# Lore for the reward item (optional)
\n lore:
\n – “&7Thank you for playing!”
\n – “&7Earned from playtime”
\n“`<\/p>\n
#### Message Customization
\nAll messages support Minecraft color codes (`&` format):
\n“`yaml
\nmessages:
\n # Message when player receives reward
\n reward-received: “&a&l\u2726 &aYou received &e{amount}x {item} &afor playing!”<\/p>\n
# Message when inventory is full
\n inventory-full: “&c&l\u26a0 &cYour inventory is full! &7Reward saved. Use &e\/ptr claim &7to claim it later.”<\/p>\n
# Message when claiming stored rewards
\n rewards-claimed: “&a&l\u2726 &aYou claimed &e{amount} &astored reward(s)!”<\/p>\n
# Message when no rewards to claim
\n no-rewards: “&c&l\u2726 &cYou don’t have any stored rewards!”<\/p>\n
# Message for next reward countdown
\n next-reward: “&b&l\u23f0 &bNext reward in: &e{time}”<\/p>\n
# Welcome message on join
\n welcome: “&a&l\u2726 &aWelcome back! You’ll earn rewards every &e{interval} &aof playtime!”
\n“`<\/p>\n
#### Feature Toggles
\n“`yaml
\nfeatures:
\n # Send welcome message when player joins
\n welcome-message: true<\/p>\n
# Show actionbar with time until next reward
\n actionbar-countdown: true<\/p>\n
# Play sound when reward is received
\n reward-sound: true
\n sound: ENTITY_PLAYER_LEVELUP<\/p>\n
# Enable particle effects when giving reward
\n reward-particles: true
\n particle: TOTEM_OF_UNDYING
\n“`<\/p>\n
#### Advanced Settings
\n“`yaml
\nadvanced:
\n # Auto-save player data (in minutes)
\n auto-save-interval: 5<\/p>\n
# Reset playtime on server restart (not recommended)
\n reset-on-restart: false<\/p>\n
# Maximum stored rewards per player (prevents abuse)
\n max-stored-rewards: 100<\/p>\n
# Minimum online time to start earning (in seconds)
\n # Prevents AFK farmers at spawn
\n minimum-online-time: 60
\n“`<\/p>\n
### Configuration Examples<\/p>\n
**Example 1: Give 3 Emeralds every 10 minutes**
\n“`yaml
\nreward:
\n interval: 600
\n item: EMERALD
\n amount: 3
\n“`<\/p>\n
**Example 2: Give 1 Netherite Ingot every hour**
\n“`yaml
\nreward:
\n interval: 3600
\n item: NETHERITE_INGOT
\n amount: 1
\n display-name: “&6&l\u2b50 &ePremium Hour Reward &6&l\u2b50”
\n lore:
\n – “&7You’ve played for 1 hour!”
\n – “&eThank you for your dedication”
\n“`<\/p>\n
**Example 3: Quick rewards for testing (30 seconds)**
\n“`yaml
\nreward:
\n interval: 30
\n item: DIAMOND
\n amount: 5
\n“`<\/p>\n
### Available Items
\nYou can use any valid Minecraft material name. Common examples:
\n– `DIAMOND`, `EMERALD`, `GOLD_INGOT`, `IRON_INGOT`
\n– `NETHERITE_INGOT`, `ANCIENT_DEBRIS`
\n– `ENCHANTED_GOLDEN_APPLE`, `GOLDEN_APPLE`
\n– `ELYTRA`, `TOTEM_OF_UNDYING`
\n– `EXPERIENCE_BOTTLE`, `BEACON`<\/p>\n
See Spigot Material List for all available materials.<\/p>\n
—<\/p>\n
## \ud83d\udcdc Commands<\/p>\n
All commands use the `\/ptr` prefix (alias for `\/playtimereward`).<\/p>\n
### Player Commands<\/p>\n
| Command | Description | Permission |
\n|———|————-|————|
\n| `\/ptr info` | Displays your playtime statistics | None (default) |
\n| `\/ptr claim` | Claims your stored rewards | None (default) |<\/p>\n
### Admin Commands<\/p>\n
| Command | Description | Permission | ### Command Details<\/p>\n #### `\/ptr info` **Example Output:** #### `\/ptr claim` **Example Output:** #### `\/ptr reload` **Use Case:** After editing config.yml<\/p>\n #### `\/ptr check **Example Output:** #### `\/ptr reset #### `\/ptr save` **Use Case:** Before server maintenance or manual file edits<\/p>\n —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n | Permission | Description | Default | ### Permission Examples<\/p>\n **Give admin permission to a moderator:** **Remove receive permission from a player:** **Group permissions (in your permissions plugin):** —<\/p>\n ## \ud83d\udcd6 Usage Guide<\/p>\n ### For Players<\/p>\n #### Joining the Server #### Earning Rewards #### Full Inventory #### Checking Your Progress #### Claiming Stored Rewards ### For Admins<\/p>\n #### Monitoring Players #### Testing the System #### Changing Configuration #### Managing Player Data —<\/p>\n ## \ud83d\udcbe Data Storage<\/p>\n ### Files Created ### Player Data Structure ### Data Persistence —<\/p>\n ## \ud83d\udd27 Troubleshooting<\/p>\n ### Common Issues<\/p>\n #### Issue: Players not receiving rewards #### Issue: Invalid material error in console #### Issue: Commands not working #### Issue: Data not saving #### Issue: Rewards given too frequently\/slowly ### Getting Help<\/p>\n If you need additional support: —<\/p>\n ## \ud83d\udcca Performance<\/p>\n ### Resource Usage A powerful and flexible playtime reward plugin that automatically rewards your players for their time spent on your server!<\/p>\n","protected":false},"featured_media":122937,"template":"","meta":{"_minecraft_slug":"playtime-reward","_minecraft_project_id":"vvCygCQa","_minecraft_author":"Yenith","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":193,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"playtime-reward.zip","_minecraft_size_bytes":21294,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:47:50.854673Z","_minecraft_date_created":"2025-10-09T04:10:35.418361Z","_minecraft_date_modified":"2025-10-06T10:29:47.249530Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/playtime-reward","_minecraft_icon_attachment_id":122937,"_minecraft_imported_at":"2026-06-07T05:32:14+00:00","_minecraft_import_hash":"dca03c56c5d7fe86d0dcbfdf27d97b9f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,867],"mod_loader":[132],"minecraft_version":[62,37,73,74,38,78,79,80,81,82],"class_list":["post-122936","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-social","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/ptr reload` | Reloads the configuration | `PlaytimeReward.admin` |
\n| `\/ptr check
\n| `\/ptr reset
\n| `\/ptr save` | Manually saves all player data | `PlaytimeReward.admin` |<\/p>\n
\nShows your personal playtime information:
\n– Total playtime
\n– Current session time
\n– Time until next reward
\n– Number of stored rewards (if any)<\/p>\n
\n“`
\n=== Your Playtime Info ===
\nTotal Playtime: 2 hours 45 minutes 30 seconds
\nCurrent Session: 15 minutes 10 seconds
\nNext Reward: 4 minutes 30 seconds
\nStored Rewards: 3 (Use \/ptr claim)
\n“`<\/p>\n
\nClaims all stored rewards that were saved due to full inventory.<\/p>\n
\n“`
\n\u2726 You claimed 5 stored reward(s)!
\n“`<\/p>\n
\nReloads the plugin configuration without restarting the server.<\/p>\n
\nViews detailed statistics for any player.<\/p>\n
\n“`
\n=== Steve’s Playtime Data ===
\nTotal Playtime: 2 hours 45 minutes 30 seconds
\nTime Since Last Reward: 4 minutes 20 seconds
\nStored Rewards: 3
\nCurrent Session: 15 minutes 10 seconds
\n“`<\/p>\n
\n\u26a0\ufe0f **WARNING:** Permanently resets all playtime data for a player. Cannot be undone!<\/p>\n
\nForces an immediate save of all player data to disk.<\/p>\n
\n|————|————-|———|
\n| `PlaytimeReward.receive` | Allows receiving playtime rewards | `true` (everyone) |
\n| `PlaytimeReward.admin` | Allows using admin commands | `op` (operators only) |<\/p>\n
\n“`yaml
\n# Using LuckPerms
\n\/lp user Moderator permission set PlaytimeReward.admin true
\n“`<\/p>\n
\n“`yaml
\n# Using LuckPerms
\n\/lp user Player permission set PlaytimeReward.receive false
\n“`<\/p>\n
\n“`yaml
\ngroups:
\n default:
\n permissions:
\n – PlaytimeReward.receive
\n moderator:
\n permissions:
\n – PlaytimeReward.admin
\n“`<\/p>\n
\nWhen you join, you’ll see a welcome message (if enabled):
\n“`
\n\u2726 Welcome back! You’ll earn rewards every 5 minutes of playtime!
\n“`<\/p>\n
\nSimply play on the server! Every configured interval (default 5 minutes), you’ll automatically receive a reward:
\n“`
\n\u2726 You received 1x diamond for playing!
\n[Sound and particle effects play]
\n“`<\/p>\n
\nIf your inventory is full, the reward is automatically stored:
\n“`
\n\u26a0 Your inventory is full! Reward saved. Use \/ptr claim to claim it later.
\n“`<\/p>\n
\nUse `\/ptr info` to see:
\n– How long until your next reward
\n– Your total playtime
\n– Any stored rewards waiting<\/p>\n
\nWhen you have inventory space, use `\/ptr claim` to collect all stored rewards at once.<\/p>\n
\nCheck any player’s statistics:
\n“`
\n\/ptr check PlayerName
\n“`<\/p>\n
\nGive yourself a test reward:
\n“`
\n\/ptr check YourName # Check your current data
\n# (Wait for automatic reward or adjust config for testing)
\n“`<\/p>\n
\n1. Edit `plugins\/PlaytimeReward\/config.yml`
\n2. Run `\/ptr reload`
\n3. Changes apply immediately<\/p>\n
\n– **Check data:** `\/ptr check
\n– **Reset player:** `\/ptr reset
\n– **Force save:** `\/ptr save` (before maintenance)<\/p>\n
\n“`
\nplugins\/
\n\u2514\u2500\u2500 PlaytimeReward\/
\n \u251c\u2500\u2500 config.yml # Plugin configuration
\n \u2514\u2500\u2500 playerdata.yml # Player playtime data
\n“`<\/p>\n
\nThe `playerdata.yml` file stores:
\n– UUID-based player identification
\n– Total playtime (in seconds)
\n– Last reward timestamp
\n– Stored (unclaimed) rewards
\n– Session information<\/p>\n
\nPlayer data is automatically saved:
\n– When a player disconnects
\n– Every 5 minutes (configurable)
\n– When the server stops
\n– When `\/ptr save` is executed<\/p>\n
\n**Solutions:**
\n1. Check player has `PlaytimeReward.receive` permission
\n2. Verify config interval setting: `\/ptr reload`
\n3. Check player data: `\/ptr check
\n4. Ensure `minimum-online-time` requirement is met<\/p>\n
\n**Solutions:**
\n1. Check your `reward.item` setting in config.yml
\n2. Use valid Minecraft 1.21+ material names
\n3. See Material List
\n4. Reload config: `\/ptr reload`<\/p>\n
\n**Solutions:**
\n1. Verify permissions are set correctly
\n2. Check console for errors
\n3. Ensure player is online (for check\/reset commands)
\n4. Try using the full command: `\/playtimereward` instead of `\/ptr`<\/p>\n
\n**Solutions:**
\n1. Check file permissions on server
\n2. Look for errors in console
\n3. Manually trigger save: `\/ptr save`
\n4. Verify plugin folder exists and is writable<\/p>\n
\n**Solutions:**
\n1. Check `reward.interval` in config.yml (value is in seconds)
\n2. Use `\/ptr reload` after changing
\n3. Example: 300 = 5 minutes, 600 = 10 minutes, 3600 = 1 hour<\/p>\n
\n1. Check console logs for error messages
\n2. Verify your configuration is valid YAML syntax
\n3. Join our Discord server: https:\/\/discord.gg\/cybycQ9wGp<\/p>\n
\n– **Memory:** Minimal (<5MB for typical server)\n- **CPU:** Very light (single async task every second)\n- **Disk:** Small data file (YAML format)\n- **Network:** No network operations\n\n### Optimization Tips\n1. Adjust `auto-save-interval` based on player count\n2. Set appropriate `max-stored-rewards` limit\n3. Use `minimum-online-time` to reduce unnecessary checks\n4. Consider longer intervals for high-population servers\n\n### Tested Performance\n- \u2705 Works efficiently with 100+ concurrent players\n- \u2705 No noticeable TPS impact\n- \u2705 Fast data saving (<100ms)\n- \u2705 Minimal memory footprint\n\n---\n\n## \ud83d\ude80 Roadmap\n\nPotential features for future versions:\n- [ ] Multiple reward tiers based on total playtime\n- [ ] Discord webhook integration for milestones\n- [ ] MySQL\/PostgreSQL database support\n- [ ] PlaceholderAPI integration\n- [ ] Per-world reward configuration\n- [ ] Reward multipliers for events\/boosters\n- [ ] GUI for viewing statistics\n- [ ] Reward history tracking\n\n\n## \ud83e\udd1d Support\n\n### Bug Reports\nIf you find a bug, please report it with:\n- Plugin version\n- Server software and version\n- Steps to reproduce\n- Console errors (if any)\n\n### Feature Requests\nHave an idea? Share it with details about:\n- What you want to achieve\n- How it would benefit users\n- Example use cases\n\n### Discord Community\nJoin our Discord server for support, updates, and community discussion:\n**https:\/\/discord.gg\/cybycQ9wGp**\n\n---\n\n## \ud83d\udcdc License\n\nThis plugin is free to use for your server.\n\n### Terms\n- \u2705 Licensed for use on any server\n- \u274c Modification for personal purposes is prohibited\n- \u274c Redistribution, even with credit, is prohibited\n- \u274c Commercial resale is prohibited\n- \u274c No warranty or guarantee is provided\n\n---\n\n## \ud83d\udc68\u200d\ud83d\udcbb Author\n\n**Yenith**\n\n---\n\n## \u2b50 Thank You!\n\nThank you for using PlaytimeReward! If you enjoy this plugin:\n- Share it with other server owners\n- Leave feedback and suggestions\n- Report bugs to help improve it\n- Consider supporting future development\n- Join our Discord community: https:\/\/discord.gg\/cybycQ9wGp\n\n---\n\n**Made with \u2764\ufe0f for the Minecraft community**\n\n*Last Updated: 06 October 2025*\n<\/p>\n","protected":false},"excerpt":{"rendered":"