OSM Referrals

Referral codes, ranks and rewards that grow your server on their own.

Every player gets a personal code. When a friend joins and enters it, both are rewarded: the newcomer receives a welcome bonus and the inviter earns a payout that grows with every person they bring in.

Around that loop sits ranks, streaks, milestones, bounties, creator tracking codes, surveys, a leaderboard and a full in-game admin panel. It works on a brand-new server and on one that already has hundreds of characters.

🎟️ How It Plays

• Get a code. Every player has a short personal code, one click to copy in /referrals.
• Share it. In Discord, on a stream, in a TikTok comment, or out loud.
• A friend joins. A calm welcome screen appears before character customisation and asks if they have a code. A mistyped code can simply be corrected.
• Both are rewarded. The newcomer's welcome bonus arrives after a short wait, and the inviter is notified straight away.
• Claim and climb. The inviter's pending balance grows, ranks and streaks multiply it, and milestones and bounties add prizes on top.

✨ Player Features

• A personal code per player, shared by all of their characters.
• Welcome screen with retry on a wrong code, skip for now and an optional "how did you find us?" question.
• One-time late redemption for existing players, from a card in the dashboard.
• Pending balance with a single-click claim.
• Five editable ranks from Bronze to Legend with payout multipliers and a progress bar.
• Streaks for inviting on consecutive days, with a capped bonus.
• Milestone roadmap with one-time prizes in money, items or vehicles.
• Time-limited bounties with live progress, countdowns and winner caps.
• Tracking codes labelled "YouTube", "TikTok" or anything else, each with its own uses and earnings.
• Leaderboard with medals, recent activity feed and a full rewards history.
• Surveys with text, multiple choice and star-rating questions.
• Scales automatically from 1080p to 2K and 4K.

📣 Built for Campaigns

• Launch week on a live server. Turn on the existing-player reminder and announce it. The admin overview counts late redemptions so you can measure it.
• Double reward weekends. Give a bounty a multiplier and every inviter payout is boosted while it runs. A banner announces it in every dashboard.
• Creator partnerships. Give each partner a tracking code with its own reward amounts and read their numbers.
• Find your best channel. Ask new players how they found you and compare it with tracking code results.
• Close the window. One switch ends late redemption when your campaign is over.

🛡️ Fair and Safe

• One redemption per player, enforced in the database.
• Claims are all-or-nothing, so repeated clicks cannot pay twice.
• Rewards are paid only by the server. A modified client has nothing to trigger.
• Self-referral blocked, including your own tracking codes.
• All input trimmed, length-limited and range-checked.
• Admin actions are re-checked on the server.
• Item rewards that can't be delivered are not consumed, and the player can try again.
• Optional Discord webhook for new players and every referral used.

🛠️ Admin Panel

Open the panel with /referraladmin and run the whole system from inside the game.

• Overview: players, referrals, total earned, pending balance, codes redeemed and late redemptions.
• Branding: server name, tagline, logo, texts, theme and accent colour.
• Bounties, Milestones, Tiers, Surveys: visual editors with validation.
• Players: search by name, code, citizen ID or license. Reset stats, allow code entry again or delete.
• Settings: reward amounts, wait time, currency, code length, limits and an on/off switch for every major system.
• Changes apply instantly, no restart needed.

🎨 Your Server, Your Look

• Five complete themes that change shapes, fonts and patterns, not just colours.
• Pick your own accent colour. Text on top of it stays readable.
• Every message and interface label comes from a language file. Anything not translated falls back to English.
• Rewards can be money (bank or cash), items or vehicles.

⚙️ Compatibility

• QBox, QBCore and ESX Legacy.
• ox_inventory, qb-inventory and the ESX inventory.
• Hooks into character creation right before your clothing or skin menu.
• Fully open source: every Lua, interface and SQL file is readable and editable.
• Requires oxmysql. Database tables are created and upgraded automatically.
• No background loops. The script reacts to events only.

⭐ Why Server Owners Choose It

• Turns your existing players into your best advertising.
• Gives newcomers a warm welcome and a reason to stay.
• Gives creators numbers they can see and a reason to promote you.
• Runs itself from the first start, with ranks, milestones and rewards ready to go.

🔗 Links

🌐 Website
https://www.osmfxmods.com/product/7446595

💬 Discord and Support
https://www.osmfxmods.com/discord