Tax System
This is a step-by-step installation guide, configuration preview, and full explanation of all settings for legends_tax.
If you lack programming experience, ensure you read each step thoroughly without skipping, as all documentation is essential!
Before submitting a support ticket or following the guides in this documentation, please make sure that you are running the latest version of the resource.
What is legends_tax?
legends_tax is a comprehensive tax collection system that automatically taxes players based on their vehicles, properties, and bank balance. The system features an in-game admin panel for easy configuration, supports multiple frameworks, and includes interest on unpaid taxes, automatic payment, and detailed audit logging.
Non-technical users: This resource includes an in-game admin panel. Most configuration can be done through the UI without editing files!
Key Features
- Multi-Framework Support - Compatible with QBox, QB-Core, and ESX
- In-Game Admin Panel - Configure all settings without editing files
- Three Tax Types:
- Vehicle Tax - Based on vehicle value and class
- Property Tax - Based on owned properties
- Bank Tax - Percentage of bank balance
- Flexible Tax Intervals:
- Global interval for all taxes
- Separate intervals per tax type
- Testing mode with seconds instead of days
- Unpaid Tax System:
- Interest accumulation on overdue taxes
- Configurable maximum interest cap
- Auto-pay from bank after grace period
- Job-Based Discounts - Configure tax discounts per job
- Tax Exemptions - Exempt specific players with permanent or time-limited exemptions
- Player Interaction Mode - Choose between NPC interaction or
/taxuicommand - Inactive Player Bypass - Automatically skip taxation for players who haven't logged in recently
- Audit Logging - Track all admin actions
- Discord Webhook - Log admin actions to Discord
- Database Auto-Setup - Tables created automatically on first start
Permission System
The resource supports multiple permission methods:
- ACE Permissions - Use FiveM's ACE system
- Identifier Whitelist - Steam, Discord, License, FiveM ID
- CitizenID Whitelist - For legacy support
Supported Housing Scripts
Property tax works with the following housing systems, which are automatically detected:
| Housing Script | Description |
|---|---|
| NoLag Properties | Uses properties and properties_owners tables |
| PS-Housing | Uses properties table with owner_citizenid |
| QB-Houses | Classic QB housing with player_houses and houselocations tables |
| QS-Housing Advanced | Extended housing with rental support via house_rents table |
No configuration is needed — the resource automatically detects which housing script is installed and adapts accordingly.
Database Tables
The system automatically creates these tables:
player_tax_data- Player tax timestamps and last seen trackingtax_invoices- All tax invoices (pending and paid)tax_invoices_archive- Archived paid invoicestax_audit_logs- Admin action logstax_exemptions- Exempt players (with optional expiry)tax_statistics- Aggregated statistics
Need help? Join our Discord (opens in a new tab) for support!