VMS Documents - Advanced Metadata Document & Badge System

VMS Documents revolutionizes how your FiveM server handles identification, licenses, and law enforcement credentials. This metadata-based document system creates realistic, fully customizable ID cards, driver licenses, weapon permits, boat licenses, and police badges that players can view, issue, and verify in-game. Unlike static image-based systems, VMS Documents uses metadata technology to generate dynamic documents with real player data, photos, and unique serial numbers that integrate seamlessly with modern inventory systems.

What's Included

You'll receive a complete document management ecosystem supporting ID cards, driving licenses (multiple classes), weapon licenses, boat licenses, business licenses, and law enforcement badges. The system includes issuing interfaces for government jobs, viewing UIs for players, verification tools for police, and admin commands for document management. Every document type is fully configurable with custom fields, requirements, validity periods, and design templates. The metadata architecture ensures documents contain real player information that updates dynamically and can't be easily duplicated.

Key Features

• Metadata-Based Architecture - Documents store player information in item metadata rather than static images. This means photos, names, dates, and serial numbers are generated dynamically and tied to actual player data, preventing simple duplication exploits.
• Multiple Document Types - Includes ID cards (state identification), driver licenses with class categories (motorcycle, car, truck, commercial), weapon carry permits, concealed carry licenses, boat operator licenses, business licenses, and professional certifications.
• Law Enforcement Badges - Realistic police, sheriff, FBI, and custom agency badges with rank, badge number, department name, and officer photo. Supports different badge designs per department or rank level.
• Inventory Integration - Natively supports ox_inventory, qs-inventory, qb-inventory, quasar-inventory v2, and core-inventory. Documents appear as physical items players can carry, show, or lose if searched.
• Issuing System - Government jobs (DMV, police, city hall) can issue documents through dedicated UIs. Set requirements like citizenship checks, background checks, written tests, or fees before issuing.
• Verification Tools - Law enforcement can verify document authenticity, check expiration dates, and cross-reference against database records. Fake or expired documents are instantly flagged.
• Customizable Design - Modify document templates, colors, logos, watermarks, and field layouts. Support for state/province variations, multiple languages, and server-specific branding.
• Photo System - Automatic player photo capture using in-game camera or mugshot systems. Photos are embedded in document metadata and display on ID/license views.
• Expiration & Renewal - Set validity periods for licenses (30 days, 90 days, 1 year). Expired documents can be flagged during police checks, creating renewal roleplay at DMV.
• Serial Number System - Each document receives a unique serial number for tracking and verification. Admins can query databases to check issuance history and validity.
• Multi-Framework Support - Full compatibility with ESX Legacy, QBCore, QBOX with framework-specific job checks and database integration.

Perfect For

• Serious roleplay servers requiring realistic identification systems
• Government roleplay with DMV, city hall, and licensing departments
• Law enforcement servers needing verifiable credentials and badges
• Whitelist communities tracking player certifications and permits
• Economy servers where licenses have value and can be revoked
• Immigration/citizenship roleplay requiring documentation
• Servers wanting to prevent metagaming through anonymous characters

How It Works

Players visit designated locations (DMV, police station, city hall) to apply for documents. Government workers access issuing interfaces where they input player information, capture photos, select document type, and set validity periods. The system generates a unique metadata-based document item that appears in the player's inventory. When examined, the document displays a realistic card interface with the player's photo, personal information, issue date, expiration, and serial number.

Law enforcement can request to see documents during traffic stops or investigations. When a player shows their license, officers can verify authenticity by checking the serial number against the database, confirming the photo matches the player, and ensuring it hasn't expired. The system flags fake, stolen, or expired documents instantly. Admins can revoke documents, check issuance logs, and manage templates through commands or admin panels.

For badges, police departments issue credentials with specific badge numbers, ranks, and department assignments. These function as both identification and proof of law enforcement authority, essential for warrant service, arrests, and accessing restricted areas.

Technical Details

• Performance: Lightweight metadata system with minimal database queries. Documents load instantly from inventory metadata.
• Compatibility: ESX Legacy, QBCore, QBOX - Works with ox_inventory, qs-inventory, qb-inventory, quasar-inventory v2, core-inventory
• Database: Stores issuance records, serial numbers, and expiration tracking in optimized tables
• Photo System: Integrates with popular mugshot/camera scripts or includes built-in capture
• Security: Metadata validation prevents client-side document forgery
• Customization: HTML/CSS templates for document designs, Lua configs for requirements and permissions

Installation

1. Extract VMS Documents to your resources folder
2. Import the SQL file to create document tracking tables
3. Configure framework (ESX/QBCore/QBOX) in config.lua
4. Set up inventory compatibility (ox_inventory recommended)
5. Configure document types, validity periods, and requirements
6. Customize document templates and agency badges in html/css folders
7. Set job permissions for DMV workers, police, city hall staff
8. Add issuing locations (coordinates or target zones)
9. Add 'ensure vms-documents' to server.cfg
10. Restart server and test document issuance/verification

Framework Compatibility

• ✅ ESX - Full integration with ESX jobs, identity, and society systems
• ✅ QBCore - Native QB player data, job permissions, and money handling
• ✅ QBOX - Compatible with QBOX framework and inventory systems

Supported Inventory Systems

• ✅ ox_inventory - Full metadata support with custom item displays
• ✅ qs-inventory - Complete integration with QuasarInventory metadata
• ✅ qb-inventory - Native QBCore inventory compatibility
• ✅ quasar-inventory v2 - Advanced metadata handling
• ✅ core-inventory - Core-inventory metadata system support

Document Types Available

• State ID Card - Basic identification with photo, name, DOB, address, and ID number
• Driver License - Includes license class (motorcycle, car, truck, CDL), endorsements, restrictions, and points
• Weapon License - Firearm carry permit with registered weapons list and carry type (open/concealed)
• Boat License - Watercraft operator permit with vessel class restrictions
• Business License - Company registration with business name, owner, type, and tax ID
• Police Badge - Law enforcement credentials with badge number, rank, department, and jurisdiction
• Professional Licenses - Medical, legal, contractor, or other professional certifications
• Custom Documents - Create unlimited custom document types with unique fields and requirements

What Makes It Stand Out

Most document scripts use static images or basic inventory items that are easy to duplicate and don't contain real player data. VMS Documents uses modern metadata technology to create dynamic, verifiable credentials tied to actual player information. The serial number system, expiration tracking, and database verification make forgery nearly impossible. Multi-inventory support means it works with whatever inventory system your server uses. The badge system gives law enforcement realistic credentials beyond just job checks. Combined with the extensive customization options for templates and requirements, this creates the most complete and realistic document management system available for FiveM.

Use Cases & Roleplay Scenarios

• Traffic Stops - Officers can request license and registration, verify validity, check for warrants linked to license number
• DMV Roleplay - Government workers process applications, administer tests, collect fees, issue/renew licenses
• Weapon Permits - Police verify carry permits during stops, courts can revoke after convictions
• Business Registration - City hall tracks business licenses for taxation, zoning compliance, and legal operations
• Immigration - Border patrol checks ID cards for citizenship status, visa stamps, and travel documents
• Background Checks - Employers verify certifications, licenses, and professional credentials before hiring
• Identity Theft - Create criminal roleplay around stolen documents, fake IDs, and document fraud investigations
• Badge System - Separate credentials for different agencies (LSPD, BCSO, FIB), track badge numbers, and manage rank insignia

Related ESX Scripts

• ESX Ultra Full Parking
• VVS Gun Pack
• Staff Portal (Web Panel) - Warn, Kick, Ban, Command
• S4 Phone