References System

References System - Player Reputation & Review Management

Elevate your FiveM server's roleplay quality with the References System, a comprehensive reputation management solution that allows players to leave feedback, reviews, and references for each other. This script creates accountability and trust within your community by tracking player interactions, job performance, business transactions, and overall behavior through a structured reference system.

What's Included

The References System provides a complete framework for managing player reputations through written references, star ratings, and detailed feedback mechanisms. Players can view reference histories, filter by category, and make informed decisions about who they interact with in-game. The system includes moderation tools for administrators to manage inappropriate content and ensure the reference system maintains integrity.

Key Features

• Multi-Category References - Separate reference types for jobs, businesses, personal interactions, and transactions for organized feedback
• Star Rating System - Visual 1-5 star ratings provide quick reputation assessment at a glance
• Written Reviews - Detailed text feedback allows players to explain specific experiences and interactions
• Reference History - Complete searchable database of all references received and given by each player
• Moderation Tools - Admin panel to review, edit, or remove inappropriate references and maintain system integrity
• Privacy Controls - Players can choose visibility settings for their reference profiles
• Notification System - Alerts when new references are received, encouraging engagement
• Anti-Abuse Protection - Cooldowns and verification prevent spam and malicious reference bombing
• Integration Ready - Hooks for job systems, business scripts, and marketplace plugins

Perfect For

• Serious roleplay servers emphasizing accountability
• Business and economy-focused communities
• Job-oriented servers with player-run services
• Whitelisted servers maintaining quality standards
• Communities wanting to reward positive behavior

How It Works

After interactions, players can access the References System through a command or UI element to leave feedback for the other party. They select the reference category (job performance, business transaction, personal interaction, etc.), assign a star rating, and write detailed feedback about their experience. The recipient receives a notification and the reference appears on their profile. Over time, players build reputation scores based on accumulated references, creating tangible consequences for behavior and incentives for quality roleplay.

Installation

1. Download and extract the References System files to your resources folder
2. Import the included SQL file to create necessary database tables
3. Configure settings in the config.lua file (cooldowns, categories, permissions)
4. Add ensure references-system to your server.cfg
5. Restart your server and configure admin permissions
6. Optionally integrate with existing job and business scripts

Technical Details

• Database: MySQL/MariaDB with optimized queries for fast reference lookups
• UI Framework: Modern, responsive interface with filtering and search capabilities
• Performance: Efficient caching system minimizes database calls
• Security: SQL injection protection and input sanitization
• Exports: Full API for third-party script integration

Reference Categories

The system supports multiple customizable categories including employee performance reviews for job scripts, customer service ratings for business owners, transaction feedback for marketplace deals, rental/property tenant references, service provider ratings (mechanics, doctors, lawyers), and general interaction references. Each category can have different weight in calculating overall reputation scores.

What Makes It Stand Out

Most servers rely on informal word-of-mouth or have no structured reputation system at all. The References System creates a formal, transparent framework that makes player behavior and reliability visible to the entire community. The multi-category approach prevents single negative experiences from destroying reputations while still highlighting patterns of behavior. The moderation tools ensure the system can't be abused while maintaining player trust in its accuracy.

Framework Compatibility

• ✅ ESX - Full integration with ESX society and job systems
• ✅ QBCore - Compatible with QB jobs, gangs, and business management
• ✅ QBOX - Works with QBOX framework implementations
• ✅ Standalone - Can operate independently with basic player identification

Related QBCore Scripts

• Origen Police (QBCore)
• CD Garage
• ID Card Script
• ATM Robbery (C4 explosion, Drilling animation)