AlphaRewards

Daily login rewards and multi-day streak bonuses for AlphaStudio servers — escalating items, up to six permission-based reward tiers configurable to match your own server's rank ladder, auto-claim, and a small developer API for other plugins to hook into claims.

Start here if this is your first time on this wiki, or jump straight to Commands if you already know what you're looking for.

Paper 1.21.4 Package dev.alphastudio.alpharewards Author AlphaStudio — M19 Runtime Folia-aware

Requirements & soft-dependencies

AlphaRewards runs standalone with zero required plugins — both soft-dependencies below only unlock extra behavior when present, neither is required.

Plugin	Required?	Unlocks
—	Always	Everything else: daily/streak rewards, GUIs, auto-claim, settings, per-player YAML storage.
`PlaceholderAPI`	Optional	Registers `%alpharewards_*%` placeholders — see Placeholders.
`Vault`	Optional	Declared as a soft-dependency, but not actually used by any code path right now — see FAQ → Is Vault actually used?

Storage is YAML-only. config.yml exposes storage.type and MySQL connection fields, but nothing in the plugin reads them yet — every player's progress is saved to its own file under playerdata/ regardless of that setting. See FAQ before relying on it.

Quick start

Drop the jar in plugins/ and start the server once to generate the default config, messages, and menu files.
Open plugins/AlphaRewards/config.yml and pick reward-mode: DAILY (claim any day, no streak required) or STREAK (must claim consecutive days). See Configuration → Reward mode for the exact difference.
Edit menus/daily.yml and/or menus/streak.yml to set your own items, amounts, and command rewards per day — the shipped files ship with 7 days (daily) / 12 days (streak) as examples.
If you want permission-gated bonus tiers (VIP-style bigger rewards), add named tiers under each day's commands block with your own permission node and reward commands — list tiers lowest → highest in the file, see the tier-order note in Permissions.
Run /alpharewards reload after any config/menu edit — no restart needed.

Feature map

🎁

Daily / Streak Rewards

One config-driven reward table per mode — items, lore, and console-command rewards per day, with separate available/claimed/locked visual states.

Configuration →

🏆

Permission Tiers

Any number of named bonus tiers per reward day, each gated by its own permission node and running its own reward commands.

Permissions →

⚙️

Settings GUI

Per-player toggles for join notifications and auto-claim, persisted independently of the reward progress itself.

Commands →

🔌

Developer API

Four Bukkit events — pre-claim (cancellable), claim, streak-break, and auto-claim — for other plugins to hook into.

FAQ →

🏷️

PlaceholderAPI

Ten placeholders covering current day, streak, claimed count, remaining rewards, and per-player settings state.

Placeholders →

🧵

Folia-aware

Every scheduled task (data load/save, delayed reminders, reward commands) picks the correct Folia region scheduler automatically, with a legacy-Bukkit fallback.

What's already built

Two commands (/alpharewards with 4 subcommands, plus /setday), 4 declared permissions plus admin-configurable tier permissions, 10 PlaceholderAPI placeholders, 4 developer API events, and per-player YAML persistence. See Commands for the exhaustive list.

NextCommands →