Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for TMDevelopment

Referral rewards, milestones, custom currencies and a full in-game editor

Report FlareReferrals?

R

1.0.23

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-hint in 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 invited lists 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>.
  • 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, permission flarereferrals.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.yml and menus/admin.yml lost 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 resetclaimed also 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:64 could end up in one slot on some servers.
  • network.sync-seconds is 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

Information

Published
October 30, 2026
2Downloads

Platforms

Paper
Paper
1.16.5–26.3

Dependencies

PaperPaper

Dependencies: Paper

Plugins and libraries a server needs for this version to run.

No dependencies

Add anything a server has to install alongside this version.