Installation

Requirements

Required

• oxmysql - Database driver (GitHub (opens in a new tab))
• ox_lib - UI and utility library (GitHub (opens in a new tab))
• Your chosen framework (QBox, QB-Core, or ESX)

Optional

• ox_target (for NPC interaction)
• Discord webhook (for admin logging)

Installation Steps

Step 1: Download the Resource

Download legends_tax from your Keymaster grants or the store.

Step 2: Extract to Resources

Place the legends_tax folder into your server's resources directory.

resources/
└── legends_tax/
    ├── fxmanifest.lua
    ├── config.json
    ├── permissions.lua
    ├── client/
    │   ├── config.lua
    │   └── main.lua
    ├── server/
    │   ├── core/
    │   ├── database/
    │   ├── tax/
    │   ├── admin/
    │   └── events/
    ├── shared/
    │   ├── framework.lua
    │   └── vehicles.lua
    └── html/
        └── (UI files)

Step 3: Add to Server Config

Add the following to your server.cfg:

ensure oxmysql
ensure ox_lib
ensure qbx_core   # or qb-core or es_extended

ensure legends_tax

Step 4: Configure Admin Permissions

Edit permissions.lua to set up admin access.

Option 1: ACE Permissions (Recommended)

Add to your server.cfg:

add_ace group.admin tax.admin allow

Ensure in permissions.lua:

Permissions.UseAcePermissions = true
Permissions.AcePermission = "tax.admin"

Option 2: Whitelist Specific Players

Edit permissions.lua:

Permissions.UseWhitelist = true
 
Permissions.Whitelist = {
    "steam:11000010000000",        -- Steam ID
    "discord:123456789012345678",  -- Discord ID
    "license:abcdef1234567890",    -- Rockstar License
}

Option 3: Both Methods

Enable both for flexible access:

Permissions.UseAcePermissions = true
Permissions.UseWhitelist = true
Permissions.RequireBoth = false  -- Player needs only ONE to access

Step 5: Database Setup (Automatic)

The resource creates these tables automatically:

• player_tax_data
• tax_invoices
• tax_audit_logs
• tax_exemptions
• tax_statistics

Step 6: Configure Tax Settings

You have two options:

Option A: In-Game Admin Panel (Recommended)

1. Start the server
2. Join as admin
3. Use /taxadmin to open the admin panel
4. Configure all settings through the UI

Option B: Edit config.json Edit config.json directly for initial configuration. See Configuration for all options.

Step 7: Restart Server

Restart your server or use refresh and ensure legends_tax.

Verification

After installation:

1. Join the server as admin
2. Use /taxadmin to open the admin panel
3. Check "Dashboard" tab for statistics
4. Use "Configuration" tab to verify settings
5. Check server console for framework detection message

Commands

Troubleshooting

"No supported framework found"

Ensure your framework resource is started before legends_tax in server.cfg.

Admin panel not opening

1. Check permissions in permissions.lua
2. Verify ACE permissions in server.cfg
3. Check server console for permission errors

Database tables not created

1. Ensure oxmysql is running
2. Check database connection in your server config
3. Look for SQL errors in server console

Need help? Join our Discord (opens in a new tab) and open a support ticket!