DailyGifts

DailyGifts is a fully configurable daily reward plugin that gives players a reason to log in every day. Players open a clean, customizable GUI and claim from any number of gifts you define — each with its own cooldown, unlock requirements, and chance-based reward pool.

Features

• Unlimited configurable gifts — ship with Common, Rare, Epic, Legendary, and Mystery gift examples, each fully editable in gifts.yml
• Chance-based rewards — every reward entry has its own drop chance and can run multiple console commands (give items, eco payouts, XP, crate keys — anything)
• Per-gift cooldowns — set an independent cooldown per gift, from hourly claims up to a daily reset at midnight
• Three display states per gift — Available, Claimed, and Locked each have their own item material, custom skull texture, name, and lore
• Custom skull textures — player heads render with base64 texture data, with a safe fallback if a texture is invalid
• Live reset timer — a configurable clock item in the GUI shows the next reset time and time remaining
• Playtime gating — lock gifts behind required playtime so new players can't rush the best rewards (configurable per gift)
• Placeholder support in lore — {time}, {time_until_reset}, {reset_time} placeholders built in
• Fully translatable — every player-facing message lives in messages.yml, including gift claim, cooldown, and lock messages
• Daily auto-reset — a scheduled task resets all gifts at a fixed time, with an optional broadcast
• Persistent player data — claims and cooldowns are stored per player and survive restarts

Commands

• /gifts (aliases: /dailygifts, /gift) — open the daily gifts GUI

Permissions

• dailygifts.use — allows players to open and claim gifts (default: everyone)
• dailygifts.admin — access to admin functionality (default: op)

Configuration

Everything is file-driven and hot-editable: config.yml for GUI layout, title, filler items, and the reset clock; gifts.yml for every gift's slots, states, cooldowns, and reward tables; messages.yml for all text. Add as many gifts as you like — just copy an example block, change the slot, and define your rewards.

Compatibility

Built for Paper/Spigot 1.20+ on modern Minecraft versions. Lightweight, no external dependencies required.