Vames Documents | ID Card Mugshot System - Professional Identity Documentation
Bring authentic identity documentation to your FiveM server with Vames Documents, a comprehensive ID card and mugshot system that creates realistic government-issued identification complete with player photographs, personal information, and official formatting. This professional documentation system allows players to obtain ID cards, driver licenses, weapon permits, and other official documents featuring their character's mugshot photo and validated information, creating immersive roleplay opportunities for identity verification, traffic stops, age-restricted purchases, and government services. Perfect for servers emphasizing realism where showing ID is required for banking, purchasing firearms, entering clubs, or any situation requiring identity proof.
What's Included
Vames Documents provides a complete identity documentation infrastructure with a sophisticated mugshot capture system featuring pose controls and photo quality settings, customizable document templates for ID cards, licenses, and permits, real-time document generation with player data and photos, and an inspection system allowing other players or police to view documents. The system integrates with your framework's identity system to automatically populate names, birthdates, and character information.
Players visit government offices (DMV, police stations, city hall) to obtain documents, undergo the mugshot photography process with professional backdrop and lighting, and receive official documents they can carry in inventory. Law enforcement officers can request to see documents during interactions, view the information and photo, and verify authenticity. The system prevents document forgery while allowing administrators to issue special permits or revoke documents for rule violations.
Key Features
- Professional Mugshot System - High-quality photo capture with clean background, proper lighting, and pose controls that create realistic ID photos
- Multiple Document Types - Generate ID cards, driver licenses, weapon permits, work permits, professional licenses, and custom document types
- Auto-Population - Documents automatically fill with character information from framework identity (name, DOB, sex, nationality, etc.)
- Visual Document Display - Modern UI displays documents with official formatting, government logos, barcodes, and security features
- Document Inspection - Players can show documents to others, police can request and view IDs during traffic stops or investigations
- Photo Requirements - Configure whether documents require mugshot photos or can be issued without (for flexibility)
- Issuance Costs - Set prices for document applications to create government revenue and prevent spam applications
- Renewal System - Documents can expire after configured periods, requiring renewal to stay valid
- Validation Checks - System prevents duplicate documents, validates age requirements for licenses, and enforces eligibility rules
- Job Integration - Restrict document issuance to government jobs (DMV workers, police for permits, etc.) for roleplay
- Document Revocation - Authorities can suspend or revoke licenses/permits for rule violations, creating consequences
- Customizable Templates - Edit document designs, colors, logos, and layouts to match your server's aesthetic or government branding
- Multi-Language Support - Translation files allow documents in multiple languages for international servers
- Framework Integration - Works with ESX and QBCore identity, job, and inventory systems seamlessly
Perfect For
- Realistic Roleplay Servers - Communities emphasizing authentic interactions where identity verification is standard procedure
- Government Roleplay - Servers with active DMV departments, government offices, and bureaucratic systems
- Law Enforcement Focus - Police departments that conduct proper traffic stops with license/registration checks
- Legal Systems - Servers where operating without proper documentation results in fines, tickets, or arrests
- Age-Restricted Activities - Servers requiring ID checks for alcohol purchases, gun sales, casino entry, or club admission
- Immigration Roleplay - Communities with citizenship systems where documentation proves legal residency
Mugshot Capture Process
Photo Station Setup: Players approach designated photo stations at DMV offices, police stations, or government buildings. The system positions the character against a clean background (configurable color - typically neutral blue or grey) with proper lighting to eliminate shadows. Camera angles automatically frame the character's face and upper torso in a professional government ID photo composition.
Pose Controls: Before capturing, players can adjust their character's facial expression and head angle. Remove hats, glasses, or masks for clear facial visibility (configurable requirement). The preview shows exactly how the photo will appear on the final document, allowing players to retake if unsatisfied with the initial capture.
Photo Quality: Captured images are processed and optimized for document display, creating clear, professional-looking ID photos. The system stores photos in the database linked to player identifiers, ensuring the same photo appears across all documents until a new photo is taken during renewal.
Document Types & Uses
State ID Card: Basic identification for citizens without driver licenses. Shows name, date of birth, address, sex, and photo. Required for opening bank accounts, purchasing age-restricted items, or proving identity to authorities. Non-drivers use this as their primary identification.
Driver License: Official authorization to operate vehicles on public roads. Includes all ID card information plus license class (motorcycle, car, commercial), issue and expiration dates, and driving restrictions. Police check licenses during traffic stops to verify the driver is legally permitted to operate the vehicle.
Weapon Permit: Authorization to purchase, carry, or possess firearms. Shows permit type (concealed carry, open carry, purchase permit), weapon restrictions, and validity period. Gun stores verify permits before selling firearms. Police check permits when encountering armed individuals.
Professional Licenses: Work authorization for regulated professions like medical practitioners, lawyers, pilots, or commercial drivers. Employers verify professional licenses before hiring. These can be job-specific or profession-based depending on configuration.
Custom Documents: Server owners can create additional document types for visas, fishing licenses, business permits, or any other documentation their roleplay requires. Each custom type supports the same features as standard documents.
Technical Specifications
- Framework Support: ESX and QBCore compatible
- Photo Storage: Database storage of mugshot images using Base64 encoding
- Performance: Optimized photo processing and rendering (0.01-0.02 ms resmon)
- UI Technology: Modern HTML/CSS/JavaScript document display with smooth animations
- Photo Resolution: Configurable quality settings (higher resolution = larger database size)
- Document Templates: Customizable HTML/CSS templates for each document type
- Database Tables: Stores documents, photos, and issuance/revocation history
- Inspection System: Real-time document viewing with permission-based access controls
- Expiration System: Automatic validation of document expiration dates
- Job Restrictions: Configurable job requirements for document issuance
Installation
- Download the Vames Documents package from your purchase confirmation
- Extract the resource folder to your FiveM server's resources directory
- Import the provided SQL file to create document database tables
- Configure document settings in config.lua (types, costs, expiration periods, photo requirements)
- Set up framework integration (ESX or QBCore) for identity data and inventory
- Add
ensure vames-documents (or provided resource name) to server.cfg
- Place document issuance points at DMV offices, government buildings, or police stations
- Configure which jobs can issue each document type (DMV workers, police, etc.)
- Customize document templates if desired to match your server branding
- Restart server and test mugshot capture, document issuance, and inspection features
Framework Compatibility
- ✅ ESX - Full ESX support using esx_identity for character data and standard inventory for document items
- ✅ QBCore - Complete QBCore compatibility with qb-core player data and qb-inventory integration
- ✅ QBOX - Compatible with QBOX framework identity and inventory systems
- ✅ MugShotBase64 - Dependency for photo capture functionality (included or documented)
- ✅ Job Systems - Integrates with framework job systems for DMV, police, and government employee roles
- ✅ Custom Identity - Can adapt to custom identity scripts with configuration changes
Inspection & Verification System
The document inspection system allows realistic identity verification roleplay. When a player shows their ID, nearby players (within configurable range) receive a notification that [Player Name] is showing identification. Authorized viewers (police, the requesting individual, or nearby players) can then view the document, seeing the full information display including photo, name, birthdate, and document-specific details.
Police officers conducting traffic stops can request to see license and registration. The driver opens their inventory, selects their driver license, and chooses Show ID. The officer's screen displays the license with all information, allowing them to verify the driver is licensed, check for warrants by name, or identify discrepancies. The photo helps officers confirm the license belongs to the person presenting it, preventing ID theft roleplay.
Business owners checking age for alcohol or weapon sales can request ID, view the birthdate, and verify the customer meets age requirements before completing transactions. Bouncers at clubs verify age before allowing entry. The system creates countless interaction opportunities where identity verification becomes standard procedure.
Expiration & Renewal Mechanics
Documents can be configured to expire after real-time periods (30 days, 90 days, 1 year, etc.) or never expire. When expiration is enabled, players receive notifications as expiration approaches: Your driver license expires in 7 days. Expired documents show as invalid when inspected, appearing with red indicators and EXPIRED stamps.
Operating with expired documents can result in fines, tickets, or arrests depending on server rules. Driving with an expired license becomes a ticketable offense. Carrying an expired weapon permit while armed is illegal. This creates recurring government revenue as players must periodically renew documentation and maintain valid paperwork.
Renewal processes can require new mugshots (capturing character appearance changes) or reuse existing photos. Renewal fees are typically lower than initial issuance costs. Some servers make renewals automatic with payment, while others require visiting government offices for realistic bureaucratic roleplay.
What Makes It Stand Out
Vames Documents excels through its combination of visual polish and functional depth. The mugshot system creates professional-quality photos rather than awkward screenshots, making documents look authentic. The UI design resembles real government-issued IDs with proper formatting, security features, and official aesthetics. Integration with framework identity ensures consistency - documents always reflect current character data without manual entry.
The inspection system creates organic roleplay interactions where showing ID becomes natural and frequent rather than forced. Police traffic stops, age verification, identity confirmation - all become seamless through intuitive mechanics. The system scales from simple ID cards to complex multi-document ecosystems with professional licenses, permits, and specialized documentation.
Customization Options
Server owners extensively customize documents through config files and HTML templates. Adjust document colors, logos, and layouts to match your server's government branding or aesthetic preferences. Add custom fields to documents (employee ID numbers, blood type, organ donor status). Configure which information appears on each document type - some servers show full addresses while others protect privacy with partial information.
Set issuance costs appropriate to your server economy - expensive documents create value, cheap ones ensure accessibility. Configure age requirements for licenses (16 for cars, 18 for weapons, 21 for concealed carry). Enable or disable photo requirements per document type. Create tiered license systems (learner permits → full licenses) with different requirements and privileges.
Administrative Controls
Administrators have powerful document management tools. View all issued documents across the server to monitor usage. Manually issue special documents for events or unique scenarios. Revoke documents as punishment for rule violations (suspend driver licenses for reckless driving, revoke weapon permits for improper gun use). Reset player documents to clear errors or fresh starts. Modify document expiration dates or costs without code editing.
Admin logging tracks document issuance, renewals, and revocations for accountability. If players report missing documents, admins can verify issuance history and restore lost items. The system maintains integrity while giving admins flexibility to handle edge cases.
Roleplay Integration Examples
DMV Department: Create government jobs for DMV workers who process license applications, administer driving tests, and issue documents. This becomes a legitimate job with consistent activity as players need documentation.
Traffic Enforcement: Police conduct proper traffic stops requesting license and registration instead of immediately arresting drivers. This creates realistic police interactions and consequences for unlicensed operation.
Gun Control: Implement weapon permit requirements where gun stores verify permits before sales and police arrest individuals carrying without permits. Document-based gun control creates legal frameworks beyond simple ownership.
Immigration Systems: Use custom documents as visas or citizenship papers where undocumented individuals face deportation if caught without proper identification.
Age Restrictions: Liquor stores, casinos, and clubs verify age through ID checks, preventing minors from accessing restricted content and creating realistic gatekeeping.
Performance & Security
Despite storing photo data, the system maintains excellent performance through optimized database queries and efficient Base64 encoding. Photos are compressed to balance quality with storage size. Caching reduces database calls when repeatedly viewing the same documents. Server-side validation prevents client manipulation of document data - players can't fake IDs or alter information through code injection.
The photo requirement feature helps prevent identity fraud as documents include visual confirmation. Combined with framework identity integration, the system creates a reliable, secure identification infrastructure that enhances roleplay without creating exploitable vulnerabilities.
Establish professional identity documentation on your server with Vames Documents - where every player carries official, verifiable identification complete with their character's photo and validated information.
Related ESX Scripts
