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-minutesthat is when the new player played enough, not when he wrote the name. Invites added with/referrals admin addare 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
timezoneon every server. - Changing
timezoneorweek-startsduring 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: falsethey give no goals, withtruethey 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.
Actualizat ultima data pe