Skip to main content

Custom Rewards

What are custom rewards?

Custom rewards are a feature that allows you to create your own rewards for the guilds.
An example is the ORANGE TAG color, which is originally available only for VIP guild leaders.

As other features, you can find the dedicated configuration file: rewards.yml.

How to configure the rewards system

rewards.yml
tags:
orange:
color: ORANGE
display-name: Orange
conditions:
- RANK:MASTER
- MC_PERMISSION:guilds.mvp++

In this example, we can see how to create a custom TAG color reward.
We have set the color, display name and the conditions to use it.
The RANK:MASTER is set to allow only the guild leader to be checked for the condition.

info

Check the Supported types section to check all the supported types.

Supported types

The conditions are available for all the rewards.

SectionTypeOptionsDescription
tagsGuild TAGcolor, display-nameThe color and display name of the TAG.

Condition types

Each condition type has its own format.
Usually, the format is TYPE:VALUE.

TypeDescriptionFormatValuesExample
RANKThe rank of the player.RANK:{type}MASTER, DEFAULT, rank nameRANK:admin
RANK_PERMThe permission of the player's rank.RANK_PERM:{permission}Guild Rank PermRANK_PERM:modify-tag
MC_PERMISSIONThe permission of the player.MC_PERMISSION:{permission}Any permissionMC_PERMISSION:guilds.mvp