Lyra Billing

Lyra Billing - Professional Invoice System for QBCore Law Enforcement

Enhance your QBCore server's law enforcement capabilities with this comprehensive billing system that enables police officers to issue professional invoices for crimes, violations, and civil infractions. Rather than handling fines through confusing manual cash transfers or unrealistic instant payments, this script creates an authentic citation and billing workflow that mirrors real-world legal processes. Officers document violations, issue itemized invoices with specific charges, and the system tracks payment status while integrating seamlessly with your server's banking infrastructure. This isn't just a fine script—it's a complete accountability system that adds depth to legal roleplay and creates meaningful financial consequences for criminal behavior.

What's Included

This complete billing package provides law enforcement with professional invoice management tools that handle everything from traffic violations to serious criminal penalties. Officers access an intuitive interface where they select the violator, choose from configurable violation categories, and generate detailed invoices that appear in the recipient's banking system. The customizable fee structure allows server owners to balance fines with economic realities—setting appropriate penalties that punish violations without bankrupting players.

The system tracks all issued invoices with detailed records including the issuing officer, violation descriptions, amounts owed, payment status, and timestamps. This creates accountability on both sides: civilians know exactly what they're being charged for, and supervisors can audit officer activity to ensure proper procedure. Payment processing integrates with QBCore banking systems, automatically deducting funds when citizens pay their bills while notifying officers of payment completion. Unpaid invoices accumulate, creating financial pressure and potential legal consequences for habitual offenders.

Key Features

• Professional Invoice Generation - Officers create detailed billing documents with specific violation descriptions and amounts
• Customizable Violation Categories - Configure unlimited violation types with preset amounts (traffic, property damage, assault, drug offenses, etc.)
• Player Selection Interface - Easy targeting system lets officers select nearby players to issue citations
• Itemized Billing - Multiple violations can be combined into a single invoice with line-item details
• Banking Integration - Seamlessly connects with QBCore banking systems for automatic payment processing
• Payment Tracking - Real-time status updates show which invoices are paid, pending, or overdue
• Invoice History - Complete record of all citations issued by each officer for accountability and auditing
• Notification System - Players receive notifications when invoices are issued and payment confirmations when settled
• Configurable Penalties - Set custom amounts for each violation type to match your server's economy balance
• Officer Accountability - Supervisors can review billing activity to ensure officers follow department policy
• Clean UI Design - Professional interface that's intuitive for both officers and civilians
• Performance Optimized - Lightweight script that doesn't impact server performance

Perfect For

• Traffic Enforcement - Issue citations for speeding, reckless driving, illegal parking, and vehicle violations
• Property Crimes - Bill violators for vandalism, trespassing, and property damage with appropriate penalties
• Civil Infractions - Handle noise complaints, public intoxication, loitering, and minor violations
• Criminal Penalties - Impose fines for assault, drug possession, weapons charges, and serious offenses
• Court Ordered Payments - Process restitution, bail amounts, and court-imposed fees
• Regulatory Compliance - Fine businesses for licensing violations, health code infractions, or permit issues
• Accountability Systems - Track financial consequences and create meaningful deterrents for repeat offenders

Realistic Billing Workflow

Picture this scenario: An officer pulls over a speeding vehicle. After running the driver's license and conducting the traffic stop, the officer opens the billing system and selects the violator from nearby players. The interface displays configurable violation categories—the officer chooses Speeding (20+ over limit) with a preset $500 fine and adds Failure to Signal for an additional $100. The system generates a professional invoice totaling $600 with itemized violations.

The driver receives an immediate notification: You have received an invoice from Officer J. Smith - Total: $600. Reason: Traffic Violations. Payment due within 30 days. The invoice appears in their banking app with full details. The driver can pay immediately using their bank account, or defer payment if they're short on cash. The system tracks the unpaid balance and can trigger consequences if ignored—license suspension, arrest warrants, or additional penalties.

Meanwhile, the officer's billing history updates with the new citation. Supervisors reviewing officer activity see the invoice with all details: who was charged, for what violations, and the amounts. This creates accountability—officers can't issue arbitrary fines because their activity is documented and reviewable. If a citizen disputes a charge, the detailed records support fair resolution through role-played hearings or administrative review.

Installation

1. Download the Lyra Billing script from your purchase confirmation
2. Extract the resource folder to your QBCore server's resources directory
3. Add to your server.cfg: ensure [lyra-billing]
4. Configure violation categories and fine amounts in the config.lua file
5. Set permissions to restrict billing access to police job roles
6. Configure banking integration to match your server's banking system (qb-banking, okokBanking, etc.)
7. Adjust notification settings and UI preferences
8. Set up invoice expiration timers and late payment consequences (optional)
9. Test the system with police and civilian players to verify proper functionality
10. Restart your server and train officers on proper billing procedures

Technical Specifications

• Framework - Built specifically for QBCore with native qb-core integration
• Performance - Lightweight operation with negligible resource usage (0.00-0.01ms)
• Database - Uses QBCore database structure for invoice storage and player data
• Banking Compatibility - Works with qb-banking, qb-management, okokBanking, and other popular banking systems
• UI Framework - Clean, responsive interface that works across all screen resolutions
• Permissions - Job-based access control ensures only authorized personnel can issue invoices
• Notification System - Compatible with qb-core notifications or custom notification scripts
• Data Storage - Persistent invoice records stored in database with complete history tracking

Framework Compatibility

• ✅ QBCore - Purpose-built for QBCore framework with full integration for all core systems
• ✅ QB-Banking - Native integration with default QBCore banking for payment processing
• ✅ okokBanking - Also compatible with okokBanking if you've upgraded from default banking
• ✅ QB-Policejob - Integrates with qb-policejob for permission control and officer management
• ✅ QB-Management - Compatible with management systems for invoice administration
• ✅ Custom Banking - Configurable to work with custom banking scripts through simple export functions

Configuration Flexibility

The config.lua file provides complete control over violation categories and fine structures. Create unlimited violation types organized by severity—traffic infractions, misdemeanors, felonies, civil violations, and regulatory offenses. Each category can have preset amounts or allow officers to enter custom values within configured ranges.

Example configuration: Traffic violations might range from $50 (broken taillight) to $1,500 (extreme reckless driving). Property damage could scale from $200 (minor vandalism) to $10,000 (serious destruction). Drug offenses might impose $500 for possession, $2,500 for distribution, and $10,000 for manufacturing. These configurable ranges ensure fines match your server's economic balance and progression systems.

Payment terms can be customized with due dates, late fees, and consequences for non-payment. Set invoices to expire after 7 days, 30 days, or any timeframe that matches your roleplay pace. Configure automatic late fees that accumulate daily for unpaid invoices. Integrate with warrant systems where unpaid fines above certain thresholds generate arrest warrants. The flexibility ensures billing consequences align with your server's legal roleplay intensity.

What Makes It Stand Out

Unlike simple fine scripts that instantly deduct money with no documentation, Lyra Billing creates a professional accountability system that enhances roleplay quality. Officers take their enforcement actions more seriously when they must document violations properly. Citizens understand exactly why they're being charged and can make informed decisions about payment. The paper trail creates roleplay opportunities around disputes, payment plans, and legal proceedings.

The integration with banking systems feels natural and realistic. Instead of awkward cash transfers or magical instant deductions, players receive formal invoices they can review, question, and pay through normal banking channels. This mirrors real-world processes and adds legitimacy to law enforcement interactions. Unpaid invoices creating financial consequences motivates compliance without requiring officers to constantly chase payments.

The supervisor audit capabilities prevent abuse and maintain department standards. Command staff can review officer billing patterns, identify potential discrimination or excessive force hidden in citation patterns, and ensure department policies are followed. This accountability layer transforms billing from a simple game mechanic into a meaningful component of law enforcement roleplay with real oversight.

Law Enforcement Applications

Traffic units use this system extensively for moving violations, equipment infractions, and parking enforcement. The itemized billing allows officers to cite multiple violations from a single traffic stop—speeding, expired registration, broken headlight, and no insurance all appear on one invoice. This reduces administrative overhead while creating comprehensive documentation.

Detectives can issue invoices for restitution in criminal cases. When investigating vandalism, the property owner's losses are documented and the perpetrator receives an invoice for damages. In assault cases, medical bill restitution gets billed to the attacker. These financial consequences add weight to criminal investigations beyond just jail time.

Regulatory enforcement benefits significantly. Code enforcement officers can fine businesses for health violations, licensing issues, or permit infractions. Fire marshals can cite property owners for safety violations. Environmental officers can bill for pollution or waste disposal violations. The configurable categories support any enforcement specialty your server includes.

Citizen Payment Experience

When civilians receive invoices, they access full details through their banking interface. The invoice shows the issuing officer's name (creating personal accountability), the specific violations charged, individual amounts for each violation, and the total due. This transparency prevents confusion and reduces disputes over unclear charges.

Payment is straightforward—players open their banking app, view pending invoices, and select Pay Invoice to process payment from their bank account. The system automatically deducts funds and updates the invoice status to Paid. Both the citizen and the issuing officer receive confirmation notifications. If funds are insufficient, the system displays an error and the invoice remains in pending status.

For players unable to pay immediately, the unpaid invoice serves as a persistent reminder and can be configured to trigger escalating consequences. First a warning notification after 7 days, then late fees after 14 days, and finally a warrant or license suspension after 30 days. This graduated response creates urgency without being punitive to players experiencing temporary financial hardship.

Integration with Court Systems

Smart servers can integrate this billing system with court roleplay scripts. When citizens dispute invoices, the billing records provide evidence for hearings. Judges can review the original citation, see the violations charged, and determine if the fine was appropriate. If the judge rules in favor of the citizen, the invoice can be voided through the administrative interface.

Court-ordered payments beyond simple fines work perfectly with this system. Bail amounts, restitution orders, probation fees, and civil judgments can all be issued as invoices. The payment tracking ensures compliance monitoring—probation officers verify their subjects are current on fees, bail bondsmen track outstanding bail balances, and civil plaintiffs confirm judgment payments.

Public defender offices and legal aid organizations can review their clients' invoice histories to understand the full scope of financial obligations. This information helps lawyers negotiate payment plans, argue for fine reductions based on financial hardship, and ensure their clients aren't being over-charged. The detailed records support authentic legal roleplay across the entire justice system.

Economic Balance Considerations

Setting appropriate fine amounts requires balancing deterrence with economic reality. Fines too low won't discourage violations—a $10 speeding ticket is just a minor inconvenience. Fines too high create frustration—a $50,000 parking ticket feels absurdly punitive. Study your server's economy: What do players earn hourly? What are typical bank balances? Price fines to represent meaningful but not catastrophic costs.

Consider progressive fine structures where repeat offenders pay more. The first speeding ticket costs $500, the second within 30 days costs $1,000, the third costs $2,500 and triggers license suspension. This escalation discourages habitual violators without punishing one-time mistakes too harshly. The billing system's history tracking makes implementing these progressive consequences straightforward.

Remember that fines should complement, not replace, other consequences. Serious crimes should still result in jail time, property seizure, or license revocation. Fines add financial impact but shouldn't be the sole punishment for major offenses. Use billing to add realism and accountability rather than as the primary deterrent for crime.

Administrative Features

Server administrators and police command staff access advanced features for invoice management. The administrative panel displays all active invoices with filtering by officer, date range, violation type, or payment status. This enables monthly reporting on ticket revenue, officer productivity, and violation trends.

Invoice voiding capabilities handle situations where citations are issued in error or dismissed through legal processes. Authorized personnel can access any invoice and mark it as voided, immediately removing the financial obligation. The invoice remains in historical records for accountability but no longer impacts the citizen's balance.

Bulk operations support mass invoice management. During special events or policy changes, administrators might need to void multiple citations, adjust fine amounts retroactively, or extend payment deadlines. The system supports these operations while maintaining complete audit trails of who made changes and when.

Support and Documentation

Your purchase includes the complete billing script with all necessary files for immediate implementation on your QBCore server. Configuration documentation explains all settings, violation setup, and integration options. Example configurations help you establish appropriate fine structures based on server type and economic scale.

Need assistance configuring categories or integrating with your specific banking system? Our support team can provide guidance on setup procedures and customization options. The one-time purchase grants lifetime access to the files—download them whenever needed for server migrations or backup restoration.

Related Crime & Gang Mods

• ESX ATM Robbery
• Core Drugs (qbCore)
• Zip-Tie Script
• ESX Drug System Bundle – Complete Narcotics Framewo...