1 / 17QBCoreESXQBOXOpen Source
OsmFX Referral Hub
Reward the players who grow your city — beautifully.
One-time payment · every future update included
- Instant delivery
- Lifetime updates
- 24/7 support
- Secure checkout
Everything it does
Full script, your rules
Open source delivery — you own the files. Rebrand, rebalance, or extend without waiting on us; ideal if you vet everything that touches your economy.
Fair for alts & mains
One referral identity per player license — the welcome screen runs once, rewards stick with them across characters, and veterans aren’t spammed every time they roll a new toon
Creator & partner codes
Extra labelled links (“YouTube”, “TikTok”, “Partner”) with their own stats so you know which shout-outs actually fill the server
Tiers & milestones
Bronze through Legend — bigger multipliers as referrers level up, plus one-shot milestone payouts when they hit the numbers you celebrate
Bounties & events
Limited-time pushes with clear goals, dates, and optional caps — perfect for launch week, anniversaries, or collab drops
Streak bonuses
Reward consistency — consecutive referral days add extra juice on top of normal payouts so your grinders feel seen
Surveys that inform RP
Ask multiple-choice, rating, or short-answer questions on entry or inside the dashboard — read responses where you already manage the server
Leaderboard & receipts
Friendly competition with a live top referrers board plus a searchable history every time money or items move
Themes & branding
Five ready-made looks plus your server name, logo, and accent — so the hub matches your city’s vibe without hiring a designer
How it works
A first impression that feels like your server
New players see your name, logo, and rewards before they finish creating a character — they can enter a friend’s code or skip, always knowing what’s in it for them. Returning players aren’t pestered on every alt; the flow respects how real communities actually play.
- Works with QBCore, QBox, and ESX first-character flows — the README walks through exactly where to hook so your existing spawn pipeline stays intact
- Clear reward messaging on the entry screen so newcomers understand the deal in seconds, not patch notes
- Designed for multi-character servers — one fair account experience without repeat popups for the same player
Surveys — hear how players actually found you
Stop guessing whether TikTok, Discord, or a friend brought someone in. Ask short, friendly questions when they arrive or from the dashboard — then read answers in admin alongside the rest of your referral data.
- Multiple-choice, rating, and short-answer questions you can turn on or off as your season changes
- Show surveys on entry, inside the player hub, or both — so you catch newcomers and engaged promoters
- Responses live where staff already work — no exporting CSVs just to learn what marketing actually worked
Player dashboard — everything promoters care about
Your community opens one place to copy their code, claim what they’ve earned, watch bounties tick down, climb tiers, and brag on the leaderboard — with a full reward history when they want receipts.
- One-tap copy for the main referral code
- Pending rewards they claim when they’re ready — you control timing and amounts from admin
- Tier progress so superfans see the next multiplier they’re grinding for
- Big-screen friendly — the UI scales up on wide monitors so it still feels premium on a desktop stream overlay
Admin panel — run the program, not the spreadsheet
Staff tune branding, themes, rewards, surveys, bounties, milestones, and safety tools from inside the game — change the economy’s behaviour when your season changes, without waiting on a developer for every number.
- Live overview — who’s joining, who’s referring, what’s pending
- Branding & themes — logo, copy, colours, and preset looks that go beyond a simple recolour
- Surveys & responses — ask better questions and read answers where decisions get made
- Player tools — search, inspect, reset, or clean up rows when something goes sideways
Rewards & reliability — built for real economies
Pay people the way your server already thinks about money and items — with optional Discord heads-up when you want the team to see joins and redemptions in real time.
- Fair payout flow — welcome bonuses and referrer earnings follow rules you set, including tier multipliers and streak bonuses
- Optional Discord logging when you want staff channels in the loop
- Database starter kit — sensible defaults for tiers, milestones, and branding so day one isn’t an empty shell
- Open codebase — when you need a deeper change, it’s all there in your download
The details
- Setup
- In-game admin panel — rewards, tiers, themes and toggles, no file edits
- Requires
- oxmysql (all frameworks)
- QBCore: qb-core, qb-interior (hook target)
- QBox: qbx_core, ox_lib, ox_inventory
- ESX: es_extended, esx_multicharacter, esx_skin, skinchanger
- Install
- 01Unpack the Tebex download into
resources/[osmfx]/osm-referrals— the directory name must stayosm-referralsfor FiveM. - 02Add the character-creation hook for your framework (qb-interior, qbx_core
character.lua×2, or esx_multicharacter) per the README inside the archive. - 03Import
referral.sqlinto your database (safe to re-run; uses IF NOT EXISTS / INSERT IGNORE). - 04Edit
config.lua: setConfig.Framework,Config.CharCreationEvent, admin groups, and optional Discord webhook. - 05Start your framework and dependencies first, then
ensure osm-referrals. Console should report the framework adapter loaded.
- 01Unpack the Tebex download into
Questions,
answered
Version history
- Initial OsmFX Referral Hub release — open source Lua + React 18 + TypeScript NUI (player dashboard + admin panel)
- Tiers, milestones, bounties, streak bonuses, tracking codes, surveys, leaderboard, reward history
- Five theme presets (Obsidian, Midnight, Carbon, Ember, Arctic) with admin-selectable branding
- Full adapter pattern for QBCore, QBox (qbx_core), and ESX with documented character-creation hooks
- 13-table MySQL schema with seeded defaults; optional Discord webhooks; 2K/4K UI scaling
OsmFX Referral Hub
