OSMFX REFERRAL HUB (Open Source)
Advanced Referral & Tracking System for QBCore · QBox · ESX
Turn your player invites into a fully interactive progression system with OSM-Referrals v2.0 — a premium referral experience designed specifically for FiveM communities.
Built for QBCore, QBox, and ESX, this script gives your players a reason to invite friends while giving staff powerful tools to manage campaigns, rewards, branding, and engagement directly in-game.
✨ Player Features
🔗 Unique Referral Codes
Every player automatically receives their own referral code on first character creation. Friends can redeem it during onboarding and both players are rewarded.
📈 Tracking Codes
Players can create additional custom tracking codes like:
- YouTube
- TikTok
- Discord
- Twitch
Each code tracks:
- Uses
- Earnings
- Performance stats
Perfect for creators, streamers, and community promoters.
🏆 Tier Progression System
Keep players engaged with a full progression ladder:
Bronze → Silver → Gold → Diamond → Legend
Each tier can provide:
- Increased reward multipliers
- Custom thresholds
- Unique colors & names
- Long-term progression goals
🎯 Milestones & Referral Goals
Reward players for reaching referral milestones with:
- Money rewards
- Item rewards
- Custom progression roadmaps
🔥 Referral Streaks
Daily successful referrals build streak bonuses, rewarding active promoters with extra payouts.
🥇 Global Leaderboard
Competitive server-wide leaderboard showing your top referrers directly in the player dashboard.
📜 Reward History
Players can view a complete history of:
- Referral rewards
- Milestone claims
- Event rewards
- Pending earnings
🎉 Event & Community Features
⏳ Bounties / Referral Events
Create limited-time referral campaigns with:
- Goal requirements
- Countdown timers
- Winner caps
- Special rewards
- Live progress tracking
Perfect for:
- Server launches
- Wipe days
- Seasonal events
- Creator competitions
📝 Built-In Surveys
Collect feedback directly from players using:
- Text questions
- Multiple choice
- Rating systems
Surveys can appear:
- On first join
- Inside the dashboard
- During events
🎨 Premium UI & Branding
OSM-Referrals includes a fully custom React-based UI with:
- Smooth modern design
- Responsive scaling for 2K/4K displays
- Animated dashboards
- Sidebar navigation
- Theme system
Includes 5 complete visual themes:
- Obsidian
- Midnight
- Carbon
- Ember
- Arctic
Admins can also customize:
- Server branding
- Logos
- Taglines
- Accent colors
- Entry screen text
All directly from the admin panel — no coding required.
🛠 Admin Features
Full Admin Control Panel
Manage everything in-game:
- Players
- Rewards
- Tiers
- Milestones
- Bounties
- Surveys
- Branding
- Settings
Live Configuration
Most settings update instantly without requiring restarts or manual refreshes.
Discord Webhooks
Optional Discord logging for:
- New referrals
- New players
- Referral activity
⚙ Framework Support
✔ QBCore
✔ QBox
✔ ESX Legacy
Built using a framework adapter system for clean compatibility and long-term maintainability.
💾 Additional Features
- Multi-character support
- Database-driven architecture
- Persistent reward tracking
- Claim-based reward system
- Configurable money/item/vehicle rewards
- Optimized UI scaling
- Full reward logging
- One-time referral redemption system
📦 Dependencies
-
oxmysql
Framework-specific requirements are included in the full documentation.
💬 Support & Updates
Discord
Store
Regular updates, active support, and continued feature improvements included.