DailyRewards999

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper purpur spigot

标签： adventure economy game-mechanics

Daily Reward GUI:
Players use the /daily command to open a sleek inventory GUI showing their daily reward progress. Each day is represented by a colored pane:

Green Pane:
Reward already claimed or currently claimable.
Red Pane:
Reward locked or missed (streak reset).
Configurable Rewards:
Easily define rewards per day in the config.yml using simple syntax. Add as many days as you want!

Cooldown System:
Rewards unlock after a configurable cooldown period (default 24 hours). Players must claim their reward before the next one unlocks or their streak resets.

Permission Support:
Control access with the daily.use permission (granted to all players by default).

Robust Claiming Logic:
Prevents multiple claims within cooldown, resets streaks on inactivity, and automatically cycles rewards after the last day.

Commands
/daily
Description: Opens the daily rewards GUI.
Usage: /daily
Permission: daily.use (default: true for all players)
Behavior:
Opens an inventory GUI showing all reward days.
Green panes indicate claimed or claimable rewards.
Red panes indicate locked or missed rewards.
Players can click the green pane for the current claimable day to receive their reward.
Configuration (config.yml)
yaml

How many seconds must pass before the next reward unlocks (default 86400 = 24 hours)
claim_cooldown_seconds: 86400

Rewards per day. Format: MATERIAL_NAME (amount)
rewards:
day1: "DIAMOND_SWORD (1)"
day2: "EMERALD (3)"
day3: "GOLDEN_APPLE (2)"
day4: "DIAMOND (2)"
Add or remove days by editing the rewards section.
Use valid Minecraft material names in uppercase.
Amount must be a positive integer.
Data Persistence
Player claim data is saved in data.yml inside the plugin folder.
Data stored per player UUID includes:
Last claim timestamp (epoch seconds)
Current streak day
How It Works
Opening the GUI:
When a player runs /daily, the plugin loads their claim data and cooldown status. It builds a GUI with one pane per reward day.

Pane Colors:

Green: Days already claimed or the current claimable day.
Red: Locked days or if the player missed claiming in time (streak reset).
Claiming Rewards:
Clicking the green pane for the current claimable day grants the configured reward, updates the player's last claim time and streak day, and closes the GUI.

Cooldown & Streak Reset:
Players must wait the configured cooldown between claims. If they miss claiming before the next reward unlocks (more than twice the cooldown passes), their streak resets to Day 1.

Reward Cycle:
After the last configured day, the streak resets to Day 1 automatically.

Permissions

daily.use

Allows use of /daily command

true

Support
For bug reports, feature requests, and anything else please join our discord!