ReferralTrack

Know which source really brings players in.

Awaiting approvalPaidGrowth

Self-hosted referral attribution: see which server list, video or friend brought each player, with optional rewards.

  • Paper
  • Spigot
  • Folia
Coming soonDocumentation

Submitted to BuiltByBit and awaiting approval. The purchase button appears once it is approved.

A real referral confirmation from ReferralTrack 1.3.0 on Paper 1.21.11.

Features

  • Players enter a source code or a friend's name with /referral; typos in known codes are matched.
  • Rewards through Vault and console commands, with per-IP limits and a same-IP check on friend invites.
  • Stats menu and Discord instant cards, daily and weekly reports.
  • SQLite or MySQL/MariaDB storage in your own database.
  • Permanent personal invite codes, optional verified referrals and fraud review.
  • Campaigns, Reward Rescue, presets, themes and a developer API.

Usage example

Players name their source or a friend; staff open the stats menu.

text
/referral youtube
/referral <a friend's name>
/referralstats

Requirements and compatibility

Platforms
Paper, Spigot, Folia
Minecraft
1.21 or newer
Java
21
Required
None
Optional
Vault, PlaceholderAPI, HeadDB
Category
Growth
Documented version
1.3.0

The documentation describes version 1.3.0.

Limitations

  • SQLite is not shared storage; a network needs MySQL/MariaDB.
  • Behind a proxy, enable IP forwarding or the per-IP checks cannot tell players apart.

Frequently asked questions

Is any data sent outside my server?

Referral data stays in your database. Outbound requests occur only for the Discord integration or optional update checker you enable.

Does it work on a network?

Yes, with a shared MySQL/MariaDB database: track joins on one entry server and deliver rewards on the server with your economy.

Changelog

No release has been published yet.

Support

Ask in the Discord or in the plugin's discussion area on BuiltByBit.

Get ReferralTrack

The purchase link appears here once the plugin is approved on BuiltByBit.

Coming soonDocumentation