🎁 Loop Rewards

On this page, you will find how loop rewards are created and what every option of a loop reward does.

#Reward On Loop

Loop rewards are reached from the Reward On Loop button in the main editor. Each one runs on its own timer, so several can fire on completely different schedules.

#Add Loop Reward

Creates a new loop reward and opens it for editing. There is no limit on how many you can have, and a new one starts on its interval right away.

#Display Item

The icon and name the reward is listed under in the editor. It is never given to anyone, but its name is what %reward% prints in the win message.

#Win Items

The physical items handed to each player when the reward fires.

#Win Commands

The commands run when the reward fires, once per receiving player.

#Win Message

The message each receiving player is sent. Leaving it empty sends nothing at all, which is the way to make a reward arrive silently.

#Interval (seconds)

How long between two firings of this reward. Changing it restarts the countdown, so the next reward is a full interval away rather than carrying over what had already elapsed.

An interval of 0 stops the reward from ever firing, which is how a loop reward is paused without deleting it.

#Timer Mode

Whether the countdown is shared or personal. Changing it restarts the countdown the same way the interval does.

Mode	Behaviour
Global	One countdown for the whole server, so everyone is rewarded at the same moment. This is the default.
Per Player	Each player has their own countdown, starting the moment they join.

A Per Player countdown is dropped when the player disconnects, so they begin a fresh interval on their next join instead of resuming where they left off. A player who reconnects often enough never reaches the reward.

#Required Permissions

Restricts the reward to players holding at least one of the listed permissions. An empty list, which is the default, gives it to everyone.

#Max Win Item Amount

Caps how many of the win items are actually delivered per firing. Unlimited hands over the whole list.

#Max Win Command Amount

The same cap for the win commands.

#Max Wins Per Player

How many times one player may receive this reward before being skipped for good.

Win counts are held in memory only, so a server restart lets everyone win up to the cap again. Renaming the reward's identifier clears them the same way.

#Identifier

The internal name the countdown placeholders address the reward by. It cannot contain spaces, and renaming it restarts the countdown.

#Delete

Permanently removes the loop reward after a confirmation prompt.

With the IP Limit add-on installed, a loop reward reaches only a limited number of accounts per IP address each time it fires. That cap is set under Global Limits and cannot be overridden per key or crate.

Last updated 11 days ago