TMDevelopmentTinulica & Maiky

Weekly top and active friends

Weekly top and active friends

1.1.0+ · both give rewards only when you turn them on.

Weekly and monthly top

/referrals top weekly
/referrals top monthly

They show the invites of this week / this month, with pages like /referrals top. Since 1.2.0 the top menu has three buttons too: All time, This week, This month (the one shown glows, the week / month ones say when it ends). They always work (same permission as the top, flarereferrals.top). What a player sees:

 WEEKLY TOP · ends in 3d 7h

 #1 Alex - 6 invites
 #2 Steve - 4 invites
 #3 Bob - 1 invites

 [All time] [Week] [Month]

Rewards when the week / month ends. Turn them on in config.yml (or /referrals settings → Weekly and monthly top):

period-top:
  enabled: true
  weekly-rewards: true
  monthly-rewards: true
  # message to everyone with the first 3 when it ends
  announce: true
  announce-lines: 3
  week-starts: MONDAY
  # "" = time zone of the server
  timezone: "Europe/Rome"

The rewards are in rewards.yml > period-top, one block per position (as many as you want, up to 100). They work like every other reward: items, currencies, commands, messages, title, delivery, servers.

period-top:
  weekly:
    '1':
      name: "&#ff7a6b#1 of the week"
      currencies:
        money: 5000
      commands:
        - "lp user {player} permission settemp group.vip true 7d"
      messages:
        - "{prefix}&aYou were &f#1 &aof the week with &f{period-invites} &ainvites!"
    '2':
      name: "&#ff7a6b#2 of the week"
      currencies:
        money: 2500
  monthly:
    '1':
      name: "#1 of the month"
      items:
        - "NETHERITE_INGOT:1"

Placeholders in these rewards: {player}, {position}, {period} (week / month), {period-invites} (his invites in that week).

How it works:

  • An invite counts in the week in which it counted: with referral.verify-after-minutes that is when the new player played enough, not when he wrote the name. Invites added with /referrals admin add are not in it.
  • When the week ends, the best inviters get their reward: right away if they are online, otherwise at their next join (or in /referrals collect, as you set). Players with 0 invites that week get nothing.
  • A server that was off at midnight gives the rewards when it starts again (without the message to everyone).
  • On a network the rewards are given once, by the first server. Use the same timezone on every server.
  • Changing timezone or week-starts during a week doesn't end the week early.

When the week ends everyone sees (texts in lang/en.yml > period):

 WEEKLY TOP · the week is over!
 #1 Alex - 6 invites
 #2 Steve - 4 invites
 #3 Bob - 1 invites

Placeholders for scoreboards and holograms: %flarereferrals_top_weekly_1_name%, %flarereferrals_top_weekly_1_invites%, %flarereferrals_top_weekly_1_line%, %flarereferrals_weekly_invites%, %flarereferrals_weekly_position%, %flarereferrals_weekly_time% (time left), and the same with monthly (Placeholders).

Active friends

The inviter gets a reward when the friend he invited keeps playing: 1 hour, 5 hours, 10 hours... after the invite. It rewards real friends, not accounts made only for the invite. Turn it on:

active-friends:
  enabled: true
  old-invites: false

The goals are in rewards.yml > active-friends. The key is the playtime in minutes (60 = 1 hour):

active-friends:
  '60':
    name: "&#ff7a6bFriend played 1 hour"
    currencies:
      money: 250
    messages:
      - "{prefix}&f{invited} &7played &f{goal}&7: &a+$250 &7for inviting him!"
  '300':
    name: "&#ff7a6bFriend played 5 hours"
    currencies:
      money: 1000

A reward for the friend too (1.2.0+). Add invited: inside a goal: the invited player gets it when he reaches that playtime, so new players have one more reason to stay.

active-friends:
  '60':
    name: "&#ff7a6bFriend played 1 hour"
    currencies:
      money: 250
    invited:
      name: "&#ff7a6bYou played 1 hour"
      currencies:
        money: 100
      messages:
        - "{prefix}&7You played &f{goal} &7since &f{inviter} &7invited you: &a+$100&7!"

Placeholders in invited: rewards: {player} (the new player), {inviter}, {goal}. Each one is given once. The invited: part has its own enabled: (turning off the goal doesn't turn it off), and the rank multiplier of multipliers.rewards.active-friends works on it too.

Example: Steve invited Alex. When Alex has played 1 hour after writing /referrals Steve, Steve gets the first reward (now, or at his next join if he is offline):

Alex played 1h: +$250 for inviting him!
  • Only the playtime after the invite counts: a player who played 12 hours before entering his inviter doesn't pay all the goals at once. On a network it is the playtime of the whole network.
  • Each goal is given once for every invited player. Placeholders: {invited} (the friend), {goal} (1h, 5h), {player} (the inviter).
  • Invites made before 1.1.0 don't know the playtime they started from: with old-invites: false they give no goals, with true they count all the playtime of the friend (turning it on can pay many goals at once).
  • Every goal given is written in logs/referrals.log.

Ultimo aggiornamento:

Accedi

Nuovo? Scrivi solo la tua email: l'account nasce quando clicchi il link. Nessuna password.

oppure

Ti mandiamo un link che ti fa entrare con un clic. Vale per account nuovi ed esistenti.

Entra con la password

Continuando accetti i Termini e condizioni e la Privacy policy.

Staff: apri “Entra con la password” e scrivi il tuo nome utente al posto dell’email. Dopo la password ti chiediamo il codice 2FA.