Configuration
Most options are also in /referrals settings. After editing the file: /referrals reload (storage and network changes need a restart; the plugin tells you).
referral
| Option | Default | |
|---|---|---|
enabled | true | master switch for /referrals <player> |
block-same-ip | true | can't enter an inviter who plays from the same IP (IPs are stored only as a hash) |
prevent-circular | true | if B entered A, A can't enter B back |
min-playtime-minutes | 0 | minutes to play before entering the inviter (0 = off) |
broadcast | false | message to the whole server (whole network) on every referral |
max-days-after-first-join | 0 | days after the first join in which the inviter can still be entered (0 = no limit) (1.0.21+) |
verify-after-minutes | 0 | the invite counts only after the new player played these minutes (0 = right away) (1.0.21+) |
player-access
What normal players can open (false = only admins): info, menu, rewards, top, preview, collect (off = rewards are given right away).
rewards
| Option | Default | |
|---|---|---|
collect-menu | true | rewards wait in /referrals collect; false = given right away (1.0.21+) |
notify.chat / title / actionbar / sound | on / off / on / on | how players are told a reward is waiting (1.0.21+) |
remind-minutes | 10 | reminder every X minutes while something waits (0 = off) (1.0.21+) |
offline-queue | true | keep the rewards of offline players and give them at the next join |
drop-if-full | true | rewards given right away: items that don't fit are dropped on the ground (false = lost) |
other options
| Option | Default | |
|---|---|---|
language | en | language file in lang/ |
milestones.enabled | true | give milestone rewards |
sounds.* | enabled, click, success, reward, error (Minecraft sound names; empty = no sound) | |
input.cancel-word | cancel | word to cancel a chat prompt of the menus |
input.timeout-seconds | 60 | seconds before a chat prompt expires |
auto-install | PlaceholderAPI, Vault | download missing plugins (hangar:, modrinth:, github:, url: sources) |
currencies | see Currencies | |
storage, network | yaml, off | see Storage and migration and Network (1.0.21+) |
stats | true | anonymous statistics (Statistics and update check) |
update-check | true | check GitHub for a new version (Statistics and update check) (1.0.21+) |
Last updated 25 October 2026