ROF_LoyaltyRewards

ROF_LoyaltyRewards
ROF_LoyaltyRewards helps Minecraft server owners reward loyal players through configurable offline, online, and recurring login rewards.

Features

• Offline rewards: Reward players after they have been away for a configured amount of time. Players can claim eligible rewards through the in-game GUI when they return.
  
  
• Online rewards: Automatically grant rewards when players reach a configured amount of continuous playtime in their current session.
  
  
• Login rewards: Automatically grant rewards when players log in after a configured interval, such as daily, weekly, monthly, or another custom schedule.
  
  
• Reward GUI: Players can view their configured rewards, eligibility, and cooldown information.
  
  
• Custom commands: Execute configured commands as the console or as the player.
  
  
• Per-reward settings: Configure timing, permission requirements, messages, and commands independently for each reward.
  
  
• PlaceholderAPI support: Optional integration for using PlaceholderAPI placeholders in supported messages and commands. The plugin also provides its own placeholders.
  
  
• Flexible configuration: Adjust reward timing, minimum playtime requirements, logging, online reward behavior, and GUI settings.

Reward Types
Type How it works
Offline Rewards are based on how long a player has been away.
Online Rewards trigger when the player reaches a configured duration in their current session.
Login Rewards trigger on login after the configured interval since the previous claim.
Commands

• /rofloyaltyrewards gui — Open the reward GUI.
  
  
• /rofloyaltyrewards reload — Reload the plugin configuration.

Aliases: /rofow, /loyaltyrewards, /offlinereward, /ow, /lr

Permissions
Permission Description Default

rofow.gui Allows opening the reward GUI true
rofow.admin Allows reloading the configuration op
rofow.alert Receives reward notifications op
rofow.exempt Excludes a player from all reward types false

Time Format
Reward intervals support the following units:

• mo — Month (30 days)
  
  
• d — Day
  
  
• h — Hour
  
  
• m — Minute
  
  
• s — Second

Example: 1mo 5d 6h 30m 20s

For login rewards, the configured time is the interval between claims. It is not the amount of time a player must remain online.

Requirements and Compatibility

• Server software: Spigot / Paper. Test your target Minecraft versions before deployment.
  
  
• Java: Use the Java version required by your Minecraft server.
  
  
• PlaceholderAPI: Optional; only required for PlaceholderAPI integration.

Only select Minecraft versions and server platforms that you have actually tested when publishing a version.

Installation

1. Download the plugin JAR from the Versions section.
   
   
2. Place it in your server's plugins directory.
   
   
3. Start or restart the server.
   
   
4. Edit plugins/ROF_LoyaltyRewards/config.yml to configure your rewards.
   
   
5. Use /rofloyaltyrewards reload after changing the configuration.

Links

• Source Code
  
  
• Documentation & Wiki
  
  
• Report a Bug