SMP Rewards

SMP Rewards
Daily Rewards, Playtime Rewards, Streak Menus, Weighted Chances, Rank Bonuses, and Configurable Reward Actions

Daily streaks. Automatic playtime rewards. Crate key rewards. Economy command rewards. Item rewards. Rank-based chances. Bonus rewards. Bundle reward icons. Persistent player data. MiniMessage colors. Clean admin commands. Full server-owner control.

Bukkit • Spigot • Paper • Purpur • Folia • SMP Ready

What is SMP Rewards?

SMP Rewards gives your server a complete configurable rewards system for daily logins, streak progression, and automatic playtime rewards.

Players can claim daily rewards from a polished inventory menu, build a 7-day streak, and receive automatic playtime rewards after staying active on the server. Server owners can configure reward commands, item rewards, messages, chances, rank pools, bonus amounts, menu items, cooldowns, and formatting.

It is designed for SMP owners who want better player retention, better rank value, cleaner crate-key delivery, and simple reward automation without building a custom reward system from zero.

Built for Servers That Need Better Retention

Reward returning players — give players a clear reason to come back every day.
Reward active players — grant rewards automatically after real playtime.
Create rank value — use permission-based reward pools and bonus rewards for higher ranks.
Support your economy — run your existing economy, crate, kit, shard, voucher, or custom server commands as rewards.
Make rewards feel polished — use a clean daily rewards GUI with claimed, available, cooldown, and locked states.
Reduce staff work — automate daily and playtime rewards while still giving staff reset and reload commands.
Keep progress persistent — player daily streaks and playtime reward timers are saved locally.

Core Features

Daily rewards system — players claim one configured reward per cooldown cycle.
7-day streak menu — default setup includes seven daily reward days.
Automatic playtime rewards — default interval is 3600 seconds and can be changed.
Weighted reward chances — playtime rewards use configurable weighted selection.
Permission-based reward pools — give different reward chances to different ranks or groups.
Bonus reward amounts — give extra reward amounts to players with bonus permissions.
Command rewards — run configurable reward commands.
Item rewards — give configured items with material, amount, name, lore, and enchantments.
Message rewards — send clean reward messages with placeholders.
Persistent player data — tracks daily streaks, daily cooldowns, and playtime reward timing.
MiniMessage support — messages, item names, lore, and menu titles support modern formatting.
Legacy color support — traditional & and § color formats are also supported.
Bundle menu icons — daily menu rewards can use bundle materials on supported versions.
Inventory overflow handling — item rewards that do not fit are dropped at the player's location.
Reload command — reload reward configuration without restarting the server.

Daily Rewards System

SMP Rewards includes a player-facing daily rewards menu.

/daily — opens the daily rewards menu.
Configurable cooldown — default daily cooldown is 86400 seconds.
Configurable streak start — choose the default starting day.
Optional reset after the final day — completed streaks can reset back to Day 1.
Cooldown bypass permission — staff or selected ranks can bypass the daily cooldown.
Claim validation — players cannot claim locked days or already claimed days.
Menu close button — default close item is included.
Background item support — fill empty menu slots with a configured item.
Custom day slots — choose where each daily reward appears in the menu.
Custom day materials — each day can use its own material and fallback list.
Configurable menu states — claimed, available, cooldown, and locked states can be styled.
Placeholders — daily menu text supports player, day, streak, time, and reward placeholders.

Default Daily Reward Setup

The default configuration includes a complete seven-day streak setup.

Day 1 — economy command reward.
Day 2 — crate key command reward.
Day 3 — item reward with material fallback support.
Day 4 — custom server command reward.
Day 5 — crate key command reward.
Day 6 — special item reward with configurable enchantments and fallback material.
Day 7 — special kit voucher command reward.

The default reward commands are examples. Replace them with the commands used by your economy, crate, kit, voucher, shard, or custom reward plugins.

Daily Reward Menu

Clean inventory GUI — players can see their current daily streak and next claim.
Claimed state — already claimed days show as claimed.
Available state — the current claimable day shows as available.
Cooldown state — the current day shows remaining time when the player is still on cooldown.
Locked state — future days show as locked until previous days are claimed.
Configurable title — style the menu title with MiniMessage or legacy colors.
Configurable rows — control the size of the menu.
Configurable fill item — add a clean background to the menu.
Configurable close item — let players close the menu through a clear button.
Bundle reward look — supported versions can use bundle items for a premium reward-pack style.

Automatic Playtime Rewards

SMP Rewards also includes automatic playtime rewards. Players are rewarded after reaching the configured playtime interval.

Default hourly interval — rewards are granted every 3600 seconds by default.
Minecraft playtime statistic support — uses the server's playtime statistic where available.
Configurable check interval — control how often online players are checked.
Configurable save interval — control automatic data saves.
Max rewards per check — prevent large catch-up bursts.
Retroactive option — choose whether first-seen players can receive rewards from already accumulated playtime.
Weighted selection — rewards are selected from configured chances.
Enabled-only rewards — disabled reward entries are ignored.
Reward timer command — players can check how long remains until their next reward.

Default Playtime Reward Table

The default setup is crate-key focused and fully configurable.

Common Crate Key — default chance 78.
Rare Crate Key — default chance 8.
Crimson Crate Key — default chance 5.
Gold Crate Key — default chance 4.
Prime Crate Key — default chance 3.
Amethyst Crate Key — default chance 2.
Special Crate Key — included as a configurable reward entry, default chance 0.

The system is not limited to crate keys. Any playtime reward can run commands, give items, and send messages.

Permission-Based Reward Pools

SMP Rewards lets you create different playtime reward chances for different ranks.

Default pool — used when no higher-priority permission pool matches.
Rank pool examples — default config includes example elite and legend pools.
Priority system — higher-priority matching pools are selected first.
Optional inheritance — pools can inherit default reward chances or override them.
Per-reward chance override — change individual reward weights per pool.
Rank-specific control — make higher ranks feel better without hardcoding rewards.

Bonus Reward System

Bonus rewards let you give extra reward amounts to players with specific permissions.

Permission based — each bonus can require its own permission.
Priority based — highest-priority bonus can be selected.
Sum mode support — bonuses can be summed when configured to do so.
Extra amount — increase the amount received from playtime rewards.
Message suffix — show players why they received extra rewards.
Rank perk ready — useful for donor ranks, vote ranks, event passes, and progression tiers.

Reward Actions

Every reward is built from configurable actions.

Command action — run a server command with placeholders.
Console or player execution — commands can run as console or as the player.
Item action — give an item with material, amount, name, lore, and enchantments.
Message action — send a formatted message to the player.
Multiple actions per reward — combine commands, item rewards, and messages.
Placeholder support — use player, reward, amount, bonus, day, streak, time, and reward display placeholders where relevant.
Inventory overflow handling — leftover items are dropped if inventory space is missing.

Commands

/daily — open the daily rewards menu.
/dailyreset <player> — reset a player's daily cooldown and streak.
/rewardtime — check how long remains until the next playtime reward.
/playtime — alias for /rewardtime.
/playtimereward — alias for /rewardtime.
/smprewards reload — reload SMP Rewards configuration.
/smpreward reload — alias for /smprewards reload.
/rewards reload — alias for /smprewards reload.

Permissions

smprewards.daily.use — allows opening the daily rewards menu.
smprewards.daily.reset — allows resetting a player's daily cooldown and streak.
smprewards.daily.bypass — allows bypassing the daily reward cooldown.
dailcd.bypass — compatibility alias for daily cooldown bypass.
smprewards.playtime.use — allows checking playtime reward cooldown.
smprewards.admin — allows reloading SMP Rewards.
smprewards.pool.elite — example elite playtime reward pool permission.
smprewards.pool.legend — example legend playtime reward pool permission.
smprewards.bonus.elite — example elite bonus reward permission.
smprewards.bonus.legend — example legend bonus reward permission.

Permissions are simple enough for small servers and flexible enough for rank-based reward progression.

Configuration Control

Everything important can be configured.

Daily rewards enabled state.
Daily cooldown seconds.
Default daily streak.
Reset after last day behavior.
Daily bypass permissions.
Daily menu title, rows, fill item, close item, slots, and status item text.
Daily day materials, fallback materials, reward displays, and actions.
Playtime rewards enabled state.
Playtime interval seconds.
Check interval and save interval.
Max rewards per check.
Base playtime reward amount.
Retroactive first-seen behavior.
Reward message toggle.
Weighted reward definitions.
Permission-based pools.
Pool priority and inheritance.
Bonus reward mode, permissions, priority, extra amount, and message suffix.
Command, item, and message actions.
Materials and fallback material names.
Item display names, lore, amounts, and enchantments.
All user-facing messages.
MiniMessage, legacy &, and legacy § color formats.

Default Configuration

This is the default config.yml included with SMP Rewards. Server owners can edit messages, daily rewards, playtime rewards, reward pools, bonus rewards, menus, cooldowns, materials, commands, and item actions from this file.

Code:

# SMP Rewards 1.0.0
# MiniMessage, legacy &, and legacy § colors are supported.

messages:
  prefix: '<gradient:#ff55ff:#ffaa00><bold>SMP Rewards</bold></gradient> <dark_gray>»</dark_gray> '
  no-permission: '<red>You do not have permission.'
  player-only: '<red>Only players can use this command.'
  reloaded: '<green>Configuration reloaded.'
  usage-daily-reset: '<red>Usage: /dailyreset <player>'
  daily-reset: '<green>Successfully reset <white>{target}</white> daily cooldown and streak.'
  rewardtime-loading: '<gray>Calculating your playtime reward timer. Try again in a moment.'
  rewardtime-disabled: '<red>Playtime rewards are disabled.'
  rewardtime-left: '<gray>You have <aqua>{time}</aqua> left until your next playtime reward.'
  rewardtime-ready: '<green>Your next playtime reward is ready.'
  playtime-reward: '<green>You received <white>{reward}</white><green>{bonus_suffix}.'
  playtime-reward-disabled: '<red>No playtime reward could be selected. Check config.yml.'
  daily-already-claimed: '<red>You have already claimed this day.'
  daily-cooldown: '<red>You must wait <white>{time}</white> before claiming your next reward.'
  daily-locked: '<red>You must claim the previous days first.'
  daily-security-cooldown: '<red>Security check failed. Cooldown active.'
  daily-streak-complete: '<yellow>Your 7-day streak is complete and has reset back to Day 1.'
  inventory-full-drop: '<red>Your inventory was full. The reward was dropped at your feet.'

settings:
  save-delay-ticks: 20

playtime-rewards:
  enabled: true
  use-minecraft-statistic: true
  grant-retroactive-on-first-seen: false
  interval-seconds: 3600
  check-interval-seconds: 1
  save-interval-seconds: 60
  max-rewards-per-check: 1
  base-amount: 1
  reward-message:
    enabled: true
  pools:
    default:
      display-name: 'Default'
      priority: 0
      inherit-default-rewards: true
    elite:
      display-name: 'Elite'
      permission: 'smprewards.pool.elite'
      priority: 100
      inherit-default-rewards: false
      rewards:
        common: 78
        rare: 8
        crimson: 5
        gold: 4
        prime: 3
        amethyst: 2
        special: 0
    legend:
      display-name: 'Legend'
      permission: 'smprewards.pool.legend'
      priority: 200
      inherit-default-rewards: false
      rewards:
        common: 70
        rare: 10
        crimson: 7
        gold: 5
        prime: 5
        amethyst: 3
        special: 0
  bonus-rewards:
    enabled: true
    mode: highest
    bonuses:
      elite:
        permission: 'smprewards.bonus.elite'
        priority: 100
        extra-amount: 1
        message-suffix: ' <gray>(<green>Elite +1</green>)'
      legend:
        permission: 'smprewards.bonus.legend'
        priority: 200
        extra-amount: 2
        message-suffix: ' <gray>(<gold>Legend +2</gold>)'
  rewards:
    common:
      enabled: true
      display-name: '<green>Common Crate Key'
      chance: 78
      actions:
        - type: command
          command: 'crates givekey {player} common-crate {amount}'
        - type: message
          text: '<green>You received <white>{amount}x Common Crate Key</white>{bonus_suffix}.'
    rare:
      enabled: true
      display-name: '<dark_green>Rare Crate Key'
      chance: 8
      actions:
        - type: command
          command: 'crates givekey {player} rare-crate {amount}'
        - type: message
          text: '<green>You received <white>{amount}x Rare Crate Key</white>{bonus_suffix}.'
    crimson:
      enabled: true
      display-name: '<red>Crimson Crate Key'
      chance: 5
      actions:
        - type: command
          command: 'crates givekey {player} crimson-crate {amount}'
        - type: message
          text: '<green>You received <white>{amount}x Crimson Crate Key</white>{bonus_suffix}.'
    gold:
      enabled: true
      display-name: '<gold>Gold Crate Key'
      chance: 4
      actions:
        - type: command
          command: 'crates givekey {player} gold-crate {amount}'
        - type: message
          text: '<green>You received <white>{amount}x Gold Crate Key</white>{bonus_suffix}.'
    prime:
      enabled: true
      display-name: '<aqua>Prime Crate Key'
      chance: 3
      actions:
        - type: command
          command: 'crates givekey {player} prime-crate {amount}'
        - type: message
          text: '<green>You received <white>{amount}x Prime Crate Key</white>{bonus_suffix}.'
    amethyst:
      enabled: true
      display-name: '<light_purple>Amethyst Crate Key'
      chance: 2
      actions:
        - type: command
          command: 'crates givekey {player} amethyst-crate {amount}'
        - type: message
          text: '<green>You received <white>{amount}x Amethyst Crate Key</white>{bonus_suffix}.'
    special:
      enabled: true
      display-name: '<light_purple>Special Crate Key'
      chance: 0
      actions:
        - type: command
          command: 'crates givekey {player} special-crate {amount}'
        - type: message
          text: '<green>You received <white>{amount}x Special Crate Key</white>{bonus_suffix}.'

daily-rewards:
  enabled: true
  cooldown-seconds: 86400
  default-streak: 1
  reset-after-last-day: true
  bypass-permissions:
    - 'smprewards.daily.bypass'
    - 'dailcd.bypass'
  menu:
    title: '<dark_gray><bold>Daily Rewards</bold>'
    rows: 3
    fill:
      enabled: true
      material:
        names: ['GRAY_STAINED_GLASS_PANE', 'STAINED_GLASS_PANE']
        damage: 7
      name: '<gray>'
    close:
      enabled: true
      slot: 22
      material:
        names: ['BARRIER']
      name: '<red><bold>Close Menu</bold>'
    day-slots: [10, 11, 12, 13, 14, 15, 16]
    status-items:
      claimed:
        material:
          names: ['BARRIER']
        name: '<green><bold>Day {day}</bold> <gray>(Claimed)'
        lore:
          - '<gray>Reward: {reward}'
          - ''
          - '<gray>You have already claimed this.'
      available:
        name: '<yellow><bold>Day {day}</bold> <gray>(Available)'
        lore:
          - '<gray>Reward: {reward}'
          - ''
          - '<green>Click to claim your reward!'
      cooldown:
        name: '<red><bold>Day {day}</bold> <gray>(Cooldown)'
        lore:
          - '<gray>Reward: {reward}'
          - ''
          - '<gray>Available in: <red>{time}'
      locked:
        name: '<red><bold>Day {day}</bold> <gray>(Locked)'
        lore:
          - '<gray>Reward: {reward}'
          - ''
          - '<gray>Claim day {streak} first.'
  days:
    '1':
      reward-display: '<green>$100,000'
      material:
        names: ['BUNDLE', 'CHEST']
      actions:
        - type: command
          command: 'eco give {player} 100000'
        - type: message
          text: '<green><bold>[!]</bold> <green>Claimed Day 1: <white>$100,000!'
    '2':
      reward-display: '<red>1x Crimson Crate Key'
      material:
        names: ['BUNDLE', 'CHEST']
      actions:
        - type: command
          command: 'crates givekey {player} crimson-crate 1'
        - type: message
          text: '<green><bold>[!]</bold> <green>Claimed Day 2: <white>1x Crimson Crate Key!'
    '3':
      reward-display: '<dark_gray>1x Netherite Ingot'
      material:
        names: ['BUNDLE', 'CHEST']
      actions:
        - type: item
          material:
            names: ['NETHERITE_INGOT', 'DIAMOND']
          amount: 1
        - type: message
          text: '<green><bold>[!]</bold> <green>Claimed Day 3: <white>1x Netherite Ingot!'
    '4':
      reward-display: '<light_purple>500 Shards'
      material:
        names: ['BUNDLE', 'CHEST']
      actions:
        - type: command
          command: 'shard give {player} 500'
        - type: message
          text: '<green><bold>[!]</bold> <green>Claimed Day 4: <white>500 Shards!'
    '5':
      reward-display: '<gold>1x Gold Crate Key'
      material:
        names: ['BUNDLE', 'CHEST']
      actions:
        - type: command
          command: 'crates givekey {player} gold-crate 1'
        - type: message
          text: '<green><bold>[!]</bold> <green>Claimed Day 5: <white>1x Gold Crate Key!'
    '6':
      reward-display: '<aqua><bold>sᴄʀɪᴍᴢ ᴍᴀᴄᴇ</bold>'
      material:
        names: ['BUNDLE', 'CHEST']
      actions:
        - type: item
          material:
            names: ['MACE', 'DIAMOND_SWORD']
          amount: 1
          name: '<aqua><bold>sᴄʀɪᴍᴢ ᴍᴀᴄᴇ</bold>'
          enchantments:
            - 'MENDING:1'
            - 'WIND_BURST:1'
            - 'FIRE_ASPECT:2'
            - 'DURABILITY:3'
            - 'UNBREAKING:3'
            - 'DENSITY:5'
        - type: message
          text: '<green><bold>[!]</bold> <green>Claimed Day 6: <aqua><bold>sᴄʀɪᴍᴢ ᴍᴀᴄᴇ</bold><green>!'
    '7':
      reward-display: '<yellow><obfuscated>???</obfuscated> <gold>Mystery <yellow><obfuscated>???</obfuscated>'
      material:
        names: ['YELLOW_BUNDLE', 'BUNDLE', 'CHEST']
      actions:
        - type: command
          command: 'kit givevoucher special {player}'
        - type: message
          text: '<green><bold>[!]</bold> <green>Claimed Day 7: <white>Special Kit Voucher!'

MiniMessage and Formatting

SMP Rewards is built with modern formatting support while keeping old-style color compatibility.

MiniMessage support — use modern tags for gradients, bold, colors, and styled text.
Legacy ampersand support — existing & color formats can still be used.
Legacy section support — § color formats are also supported.
Menu titles — format inventory titles from config.
Item names — format reward item display names.
Item lore — format reward lore lines.
Messages — format command, daily, playtime, and reward messages.

Bundles and Item Rewards

SMP Rewards can use bundle items in the daily menu on supported Minecraft versions.

Bundle reward icons — daily reward days can use Bundle and colored Bundle materials where supported.
Material fallbacks — fallback materials can be listed for servers that do not support newer materials.
Item rewards — give configured materials, amounts, display names, lore, and enchantments.
Inventory overflow fallback — rewards that do not fit are dropped at the player's location.

Persistent Data

Player reward state is saved locally. No external database is required.

Daily streak — tracks the player's current daily reward day.
Last daily claim — tracks daily cooldown timing.
Last playtime reward — tracks when the next playtime reward becomes due.
Automatic saves — data saves periodically and during important plugin lifecycle moments.
Save on quit — player state is saved when players leave.
Save on disable — data is saved when the plugin disables.

Compatibility and Server Support

SMP Rewards is designed for Bukkit-family SMP servers that need clean reward automation.

Bukkit-family support — built for Bukkit, Spigot, Paper, Purpur, and compatible forks.
Folia support — declares Folia support and uses compatibility handling for scheduled work.
Material fallback support — newer materials can fall back to older alternatives.
No separate menu plugin required — the daily rewards GUI is included.
No database required — persistent reward data is stored locally.

Why Server Owners Choose SMP Rewards

More returning players — daily streak rewards create a simple reason to log in every day.
More active players — playtime rewards encourage players to stay online and participate.
Better rank perks — permission pools and bonus rewards give higher ranks real reward value.
Cleaner reward setup — daily and playtime rewards live in one plugin.
Stronger economy control — tune chances, amounts, commands, and item rewards from config.
Polished presentation — menus, bundle icons, MiniMessage formatting, and clear cooldown text make rewards feel premium.
Simple administration — reload config and reset daily rewards without manual data editing.

Best Uses

Survival SMP — reward daily logins and regular playtime.
Lifesteal SMP — add progression rewards without changing core gameplay.
Box/SMP Hybrids — give crate keys, money commands, and item rewards over time.
PvP Survival — reward active players with useful progression items.
Crate Servers — deliver keys through daily and playtime rewards.
Ranked Servers — make higher ranks more valuable with better chances and bonus rewards.
Seasonal Servers — configure event rewards for limited-time seasons.
Economy Servers — distribute economy command rewards and item rewards in a controlled way.
Network Hubs — keep players returning with streak-based rewards.

FAQ

What kind of server is this for?
Survival SMP, Lifesteal SMP, Box/SMP hybrids, PvP survival, economy servers, crate servers, seasonal servers, and Bukkit-family networks that need daily and playtime rewards.

Does it include daily rewards?
Yes. Players can use /daily to open a configurable daily rewards menu with streak progression.

Does it include playtime rewards?
Yes. Playtime rewards are automatic and default to a 3600-second interval. You can change the interval in config.

Can I change the daily rewards?
Yes. Each day has configurable display text, material, fallback materials, and actions.

Can I use crate keys?
Yes. The default setup uses crate-key command examples, and you can replace them with your own crate plugin commands.

Can I give money, shards, vouchers, or kits?
Yes. Use command actions with your existing economy, shard, voucher, kit, crate, or custom server plugins.

Can I give custom items?
Yes. Item actions support material, amount, display name, lore, and enchantments.

Can higher ranks get better rewards?
Yes. Permission-based reward pools can change the weighted playtime chances for different ranks.

Can higher ranks get extra rewards?
Yes. Bonus rewards can add extra amounts and show a custom suffix in reward messages.

Can players check their reward timer?
Yes. Players can use /rewardtime, /playtime, or /playtimereward.

Can staff reset daily rewards?
Yes. Staff can use /dailyreset <player>.

Does it support MiniMessage?
Yes. MiniMessage, legacy &, and legacy § colors are supported.

Does it support Folia?
Yes. SMP Rewards declares Folia support and includes compatibility handling.

Does it need a database?
No. Player reward data is stored locally.

Does it require another menu plugin?
No. The daily rewards menu is included.

Reward daily logins. Reward real playtime. Keep your SMP active.
Install SMP Rewards, configure your daily streaks and playtime chances, and give players a clean reason to come back every day.

SEO keywords: SMP Rewards, Minecraft rewards plugin, daily rewards plugin, playtime rewards plugin, hourly rewards plugin, Bukkit rewards plugin, Spigot rewards plugin, Paper rewards plugin, Purpur rewards plugin, Folia rewards plugin, SMP rewards plugin, Minecraft daily rewards, Minecraft playtime rewards, crate key rewards plugin, streak rewards plugin, daily streak plugin, Minecraft retention plugin, reward menu plugin, configurable rewards plugin, MiniMessage rewards plugin, Bukkit daily rewards, Minecraft rank rewards, permission reward pools, weighted rewards plugin, reward chances plugin, Minecraft economy rewards, Minecraft crate rewards, SMP plugin, Lifesteal rewards plugin, Box SMP rewards plugin.

SMP Rewards v1.0.0

Overview History