Rewards
A daily reward with a streak that grows each day, and automatic rewards for playtime milestones.
The Rewards module brings players back every day. Each day they claim a reward with /daily, and the reward gets better as their streak grows. On top of that, players automatically earn rewards when they reach playtime milestones (1 hour, 5 hours and so on).
Features
- Daily reward with a streak: one reward per day, a different reward for each day of the streak.
- Grace days: optionally let players miss a few days without losing their streak.
- Four styles for the daily reward: a classic menu, a custom full screen interface, a hologram in the world, or an instant claim.
- Claim effects: totem animation, firework, particles, or nothing.
- Playtime milestones given once, automatically, when a player reaches a playtime. Time spent AFK does not count.
- Money and commands as rewards: money in any currency of the economy, plus any console commands (give items, a rank, crate keys and so on).
- Network wide: streaks and claims are shared by all the servers of your network. A player cannot claim twice by switching servers.
- Reminder on join when today's reward is waiting.
Setting it up
Open the Rewards module in the web editor.
Overview tab
Reward style picks how /daily works:
| Style | How it works |
|---|---|
| Classic menu | /daily opens a menu with 7 days of the streak. The player clicks today's reward to claim it. |
| Custom interface | A full screen menu with a background and no player inventory, fully editable in the menus editor. It is created for you the first time you pick this style. Edit the interface opens it in the menu editor, Recreate the interface puts it back to its original look. Needs the Menus module, otherwise the classic menu opens. |
| Hologram | A hologram in the world with the 7 days spinning. Players click or hit it to claim. /daily also claims directly. Place it in game with /daily hologram where you stand. Needs Minecraft 1.19.4 or newer. |
| Instant | /daily gives the reward right away, with the day shown big on screen. |
Below the styles you find:
- Statistics: Claimed today, Active streaks, Total claimed and Milestones unlocked.
- Best streaks: the 10 players with the longest active streak.
- Rewards per day: one card per day of the streak. For each day set the Icon, the Money and its Currency (main currency when empty), and Commands, one per line, run by the console. Use
{player}for the name of the player. Add a day to make the streak longer. - Animations and effects: the Claim effect (Totem, Firework, Particles or None), and for the hologram style the Day animation (Wave, Spin, Float, Orbit, Pulse or None), the Particles around it and the Title effect (Rainbow, Golden pulse or None).
By default the streak lasts 7 days, from 50 coins on day 1 up to 500 coins on day 7.
Settings tab
Daily reward
| Setting | What it does | Default |
|---|---|---|
| Enabled | Turns the daily reward on or off. | On |
| Grace days | Days a player can miss without losing the streak (0 to 7). | 0 |
| After the last day | What happens when the streak goes past the last day: Start again from day 1 or Keep the last reward. | Start again from day 1 |
| Reminder on join | Tells players on join that today's reward is waiting. | On |
| Time zone | When the new day starts, for example Europe/Paris or America/Montreal. Empty uses the time zone of the server. |
Empty |
The style and the rewards per day are also found here, but they are easier to set in the Overview tab.
Playtime
| Setting | What it does | Default |
|---|---|---|
| Enabled | Turns playtime milestones on or off. | On |
| Milestones | One row per milestone: an ID, the Playtime to reach (for example 10h), the Money, its Currency (main currency when empty) and Commands separated by ; with {player} for the player. |
1h, 5h, 24h and 100h, from 100 to 10,000 coins |
Milestones are checked every minute and each one is given only once per player. Playtime counts on every server of the network, without the time spent AFK.
Commands
| Command | What it does | Permission |
|---|---|---|
/daily |
Opens the daily reward or claims it, depending on the style. Aliases: /reward, /rewards. |
inglis.rewards.daily (everyone) |
/daily hologram |
Places the daily reward hologram where you stand, or moves it. | inglis.rewards.admin (operators) |
/daily hologram remove |
Removes the hologram. | inglis.rewards.admin (operators) |
You can also remove the hologram from the Overview tab. Each server of your network has its own hologram.
Placeholders
| Placeholder | Shows |
|---|---|
%ingliscore_daily_streak% |
Current streak of the player, in days. |
%ingliscore_daily_available% |
true when today's reward can be claimed, false otherwise. |
%ingliscore_daily_total% |
Total number of daily rewards the player has claimed. |
Tips
- Keep the ID of a milestone once players have earned it. A milestone with a new ID counts as a new one, and players who already reached that playtime get it again.
- With the custom interface style, you can move the days, change the background or add buttons in the menu editor. The days, the streak and the claim button fill themselves for each player.
- Use Keep the last reward if your last day is a big reward you want loyal players to keep getting.