fivem

---
name: fivem
description: Fix, create, or validate FiveM server resources for QBCore/ESX (config.lua, fxmanifest.lua, items, housing/furniture, scripts, MLOs). Use when asked to debug resource errors, convert ESX↔QB, update fxmanifest versions, add items, or source scripts from GitHub. Also use for SSH key generation for SFTP access.
---

# FiveM (QBCore/ESX)

## Overview
Handle end‑to‑end FiveM resource work: validate/fix configs, update fxmanifest, convert ESX↔QBCore, add items, set up housing/furniture, debug errors, and scaffold simple scripts/MLO notes. Use references for checklists and patterns.

## Workflow Decision Tree
1) **Locate files**: ask for exact path or upload if not in workspace.
2) **Classify task**:
   - fxmanifest update → use `references/fxmanifest_checklist.md`
   - config.lua fix/validation → use `references/config_patterns.md`
   - ESX↔QB conversion → use `references/qb_esx_conversion.md`
   - items add/update → use `references/items.md`
   - housing/furniture → use `references/housing_furniture.md`
   - debug errors → use `references/debugging.md`
   - GitHub script search → use `references/github_search.md`
   - SSH key generation → use `references/ssh_keys.md`
3) **Apply fixes**: edit precisely, preserve structure, keep comments.
4) **Summarize changes** + provide next steps/testing.

## Core Tasks

### 1) Fix/validate config.lua
- Open file, scan for syntax errors (missing commas/brackets, mismatched quotes, duplicate keys).
- Ensure tables are properly closed and item lists are consistent.
- If unclear, ask for error logs or expected behavior.

### 2) Update fxmanifest.lua
- Normalize to recommended fxmanifest version, ensure `fx_version`, `game`, dependencies, and shared/client/server scripts are correct.
- Make sure exports/imports match resource usage.

### 3) Convert ESX ↔ QBCore
- Map framework hooks, player object access, items, jobs, money, inventory, notifications.
- Keep API differences explicit and document changes.

### 4) Add items
- Insert items into the correct shared items file for the target framework (QB/ESX). Keep weight, stack, image references consistent.

### 5) Housing/Furniture setup
- Validate furniture categories, prices, prop names, and placements; ensure config entries match resource expectations.

### 6) Debug errors
- Ask for console error snippet. Trace to file/line and fix; if a dependency is missing, flag it.

### 7) GitHub script search
- Search by resource name + framework + “fivem” + “qbcore/esx”. Provide top 3 candidates with notes.

### 8) SSH key generation (SFTP)
- Generate ed25519 keypair, provide public key for server, and safe storage guidance.

## References
- `references/fxmanifest_checklist.md`
- `references/config_patterns.md`
- `references/qb_esx_conversion.md`
- `references/items.md`
- `references/housing_furniture.md`
- `references/debugging.md`
- `references/github_search.md`
- `references/ssh_keys.md`
- `references/ox_lib.md`
- `references/menanak47.md`
- `references/qb_target.md`
- `references/qb_core.md`