Referrals
Referrals reward your existing customers for bringing in new buyers. Each customer gets a unique referral code they can share. When someone new uses that code at checkout and completes a purchase, reward commands run on your game server for the referrer.
Configuration
Set up referrals from Dashboard > Referrals:
- Enabled. Turn the referral system on or off.
- Require first purchase. When enabled (the default), only a new customer’s first purchase triggers a reward. This prevents existing customers from exploiting referral codes on repeat purchases.
- Minimum purchase amount. Optionally require the referred customer’s order to meet a minimum total before the reward triggers.
- Reward commands. The commands that run on your game server when a referral completes. Use
{player}as a placeholder for the referrer’s username.
Reward Commands
Each reward command specifies what to execute and where. You can target a specific server, a list of servers, or all connected servers at once.
Examples:
give {player} diamond 10lp user {player} parent set referrereco give {player} 500Make sure reward commands are safe to retry. If delivery fails on the first attempt, the command may be retried. Commands that give items or currency are fine, but commands that toggle a state may cause issues if run twice.
How It Works
- A customer finds their referral code on your storefront and shares it with friends.
- A new customer enters the referral code during checkout.
- When the purchase completes, FluxStore verifies eligibility (first purchase requirement, minimum amount) and sends the configured reward commands to your game servers with
{player}replaced by the referrer’s username.
Tracking
The referrals dashboard shows total referrals, a history log of each one (including the referrer, referred customer, and reward delivery status), and your top referrers. Use this to gauge how well the program is working and adjust reward values over time.
Next Steps
- Coupons for discount codes and other promotional strategies
- Command Delivery to learn how FluxStore delivers commands to your game servers