ReferralTrack
Know which source really brings players in.
Self-hosted referral attribution: see which server list, video or friend brought each player, with optional rewards.
- Paper
- Spigot
- Folia
Submitted to BuiltByBit and awaiting approval. The purchase button appears once it is approved.
Gallery
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.
/referral youtube
/referral <a friend's name>
/referralstatsRequirements 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.