Rank multipliers and Discord

1.2.0+ · both are off until you turn them on.
Rank multipliers
Players with a rank get more from their rewards: a VIP gets x1.5 money, an MVP x2. Turn it on in config.yml (or /referrals settings → Rank multipliers):
multipliers:
enabled: true
ranks:
vip: 1.5
mvp: 2
items: false
rewards:
inviter: true
welcome: false
milestones: true
active-friends: true
period-top: false
Then give the permission flarereferrals.multiplier.<name> to the rank, for example with LuckPerms:
/lp group vip permission set flarereferrals.multiplier.vip
/lp group mvp permission set flarereferrals.multiplier.mvp
What happens: Alex is VIP and invites Steve. The inviter reward gives $500, Alex gets $750 and reads
Rank bonus: x1.5
- A player with more ranks gets the highest multiplier, not the sum.
- It works on money and every currency (MobCoins, tokens, PlayerPoints...). Items are multiplied only with
items: trueand only by whole numbers (x2, x3): x1.5 gives the normal items. Commands are not multiplied. rewardschooses which rewards get it: the inviter reward, the welcome reward of the new player, milestones, active friends and the weekly / monthly top.- With a reward event running both count: event x2 and VIP x1.5 = x3.
- Operators don't get it automatically: only players (or groups) that really have the permission. A wildcard (
*orflarereferrals.*, often given to owners) gives no multiplier: give the node itself. - Removed a rank from
ranks? It stays removed (the plugin doesn't addvip/mvpback). - The multiplier of the moment the reward is given counts (the player must be online, so his rank is known): a reward waiting in
/referrals collectgets the rank the player has when he collects it.
Discord
Messages in a channel of your Discord server: new invites, milestones and the winners of the week. Create a webhook in Discord (channel settings → Integrations → Webhooks → New webhook → Copy URL) and paste it:
discord:
enabled: true
url: "https://discord.com/api/webhooks/123.../abc..."
username: "Referrals"
embed: true
color: "#FF7A6B"
messages:
referral: "**{inviter}** invited **{player}** to the server! ({invites} invites)"
milestone: "**{player}** reached **{milestone} invites**!"
period-top: "**{period-name} TOP** is over: {winners}"
In the channel it looks like this:
Alex invited Steve to the server! (4 invites)
Alex reached 5 invites!
WEEKLY TOP is over: 1. Alex (6), 2. Steve (4), 3. Bob (1)
- A message with
""is not sent (e.g.milestone: ""to send only the invites). Milestones turned off are not announced. embed: true= a colored box,false= plain text. Discord markdown works (**bold**,*italic*).- Player names are sent as they are (an
_in a name doesn't turn into italic), and no mention is ever sent:@everyone, roles and users are not pinged. - The
period-topmessage needsperiod-top.enabled: true(Weekly top) and is sent once also on a network. - Keep the URL secret: anyone with it can write in that channel. If it leaks, delete the webhook in Discord and make a new one. The plugin never writes it in the console or in the logs.
- Messages are sent in the background; if Discord says "too many messages" a few are skipped instead of slowing the server. A wrong URL is reported once in the console.
Last updated