TMDevelopmentTinulica & Maiky

Rank multipliers and Discord

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: true and only by whole numbers (x2, x3): x1.5 gives the normal items. Commands are not multiplied.
  • rewards chooses 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 (* or flarereferrals.*, often given to owners) gives no multiplier: give the node itself.
  • Removed a rank from ranks? It stays removed (the plugin doesn't add vip / mvp back).
  • 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 collect gets 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-top message needs period-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

Sign in

New here? Just enter your email: the account is created when you click the link. No password needed.

or

We send you a link that signs you in with one click. It works for new and existing accounts.

Sign in with a password instead

By continuing you accept the Terms & Conditions and the Privacy policy.

Staff: open “Sign in with a password instead” and type your username instead of the email. After the password we ask for your 2FA code.