Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Referral rewards, milestones, custom currencies and a full in-game editor
FlareReferrals 1.0.23
"Reminder, invited players list, reward events and important fixes.
The new features are all off until you turn them on.
- Who invited you? (
invite-hintin config.yml or/referrals settings): new players who didn't write/referrals <name>yet get a reminder in chat (clickable), title, action bar, boss bar and with a sound, as you choose.- How often, how many times, only on the first join or only for players who joined in the last days: all in the config.
- It waits for the minimum playtime and stops when they wrote it or when the time to do it is over. Admins never get it.
- New button for the main menu (add it in the editor): click and write the name in chat.
- Invited players:
/referrals invitedlists the players you invited, the newest first, with the date and whether the invite counts already. Menu with pages (menus/invited.yml) or/referrals invited chat.- Turn it on with
player-access.invited: true. Staff:/referrals invited <player>.
- Turn it on with
- Reward events:
/referrals event start 2 48h Weekend!doubles the rewards of the invites made during the event.- Currencies (money, tokens, XP levels...) and, if you want, items. Choose which rewards: inviter, welcome, milestones.
- Message, title and sound when it starts, boss bar with the time left, messages to players who join.
- A reward keeps its multiplier also when it is collected later. Survives restarts, runs on every server of a network.
- Needs
events.enabled: true, permissionflarereferrals.event(admins have it).
- New placeholders:
position,top_<n>_line,invited_count,pending_invites,referred,can_enter,event_active,event_multiplier,event_time,event_reason. /referrals by <player>: for inviters called like a command (Top, Menu...).- Your files stay as you wrote them: the editors and settings save only the values that changed, and the new texts of an update are added with their explanation. Your quotes and comments stay, also on 1.16.5 - 1.17 (before,
lang/en.ymlandmenus/admin.ymllost their comments there). %luckperms_primary_group_name%in the top works for offline players too.- data.yml is written in the background: no more lag spikes on servers with many players.
Fixed
- A player could read PlaceholderAPI placeholders by writing them as a name (
/referrals %placeholder%). - A wrong name made the server read every saved player from the disk: spamming it caused lag on big servers.
- Repeating milestones were given again for the same number after an admin removed invites.
/referrals admin resetclaimedalso deleted rewards still waiting in the collect menu.- Network: two players on two servers could invite each other at the same moment.
%flarereferrals_next_milestone%was wrong for repeating milestones.- Rewards like
ENDER_PEARL:64could end up in one slot on some servers. network.sync-secondsis used right away after/referrals reload.
Update: replace the jar and restart. Your files are kept, new options and texts are added by themselves. Guide: FlareReferrals wiki on tmstudio.dev (new pages "Who invited you and invited players" and "Reward events").
Supported: Paper / Spigot / Purpur 1.16.5 – 26.3, Java 8+.
SHA-256: ff46cccae795fdce2fde6830708f421da1efc553db92dae93f7669229e3e2d34
Platforms
Paper
1.16.5–26.3
Dependencies
Paper
- PlaceholderAPI Optional
- Vault Optional