ClaimCycle

ClaimCycle is a lightweight and highly configurable rewards plugin for Minecraft servers.

It allows server owners to create as many recurring rewards as they want, each with its own cooldown, playtime requirement, permission, icon, items, and commands.

Players can view and claim their available rewards through a clean in-game GUI.

Features

• Unlimited configurable rewards
• Clean GUI with pagination
• Real-time cooldowns
• Playtime-based cooldowns
• Cumulative or consecutive playtime requirements
• Item rewards
• Console-command rewards
• Individual permissions for each reward
• VIP and rank-based rewards
• English and French support
• In-game administration
• Automatic migration from the previous DailyRewards plugin
• Protection against duplicate reward claims
• Safe player-data saving

How does it work?

Each reward can be configured independently.

You can decide how long a player must wait before claiming a reward again.

For example, you can create:

• A reward every few hours
• A daily reward
• A weekly reward
• A VIP-only reward
• A reward unlocked after a certain amount of playtime
• Special rewards requiring specific permissions

Cooldowns can use real time or player playtime.

With playtime-based rewards, you can choose between:

Cumulative playtime — the player's playtime is accumulated over multiple sessions.

Consecutive playtime — the player must remain connected for the required amount of time.

Rewards

Rewards can contain Minecraft items or execute console commands.

This makes ClaimCycle compatible with many other server systems.

For example, rewards can be used to give:

• Items
• Money through another economy plugin
• Crate keys
• Permissions or ranks
• Custom server rewards
• Anything that can be given through a console command

Command rewards support placeholders such as %player% and %uuid%.

Permissions and ranks

Every reward can have its own permission.

This allows you to create different rewards depending on a player's rank.

For example, regular players can have access to standard rewards while VIP players can receive additional or improved rewards.

ClaimCycle can be used with permission-management plugins such as LuckPerms.

In-game GUI

Players can access their rewards through a configurable graphical interface.

Each reward can have its own:

• Minecraft item icon
• Display name
• Description
• Availability conditions
• Cooldown
• Permission
• Reward contents

The GUI also supports pagination, allowing servers to create a large number of rewards without overcrowding the interface.

Configuration

ClaimCycle is designed to be configurable without modifying the plugin itself.

Server administrators can configure rewards, timers, permissions, icons, items, commands and other options through the plugin configuration files.

The main configuration files are located inside:

plugins/ClaimCycle/

Installation

1. Stop your Minecraft server.
2. Place ClaimCycle-1.0.0.jar inside the plugins folder.
3. Start the server.
4. ClaimCycle will automatically generate its configuration files.
5. Configure your rewards and restart or reload the plugin.

If you previously used the old DailyRewards version of the plugin, ClaimCycle can automatically migrate the existing data during its first startup.

Do not keep the old DailyRewards JAR installed alongside ClaimCycle.

Compatibility

ClaimCycle supports:

• Bukkit
• Spigot
• Paper
• Purpur

Minecraft versions:

1.16.5 → 1.21.x

The plugin uses Java 11-compatible bytecode.

Your server must still use the Java version required by the Minecraft server version you are running.

Folia is currently not officially supported.

Languages

ClaimCycle currently includes:

• English
• French

Support

If you encounter a bug, need help configuring ClaimCycle, or have a question about the plugin, you can join the Discord server.

Discord: https://discord.gg/nnAkDnVfZd

A website and additional documentation may be added in the future.