> For the complete documentation index, see [llms.txt](https://laot7490.gitbook.io/ltbridge/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://laot7490.gitbook.io/ltbridge/daily-use/troubleshooting.md).

# Troubleshooting

## LTBridge says "not compiled"

Run this in the LTBridge source repo (not your FiveM resource):

```bash
npm run build
```

If you installed via npm globally, reinstall: `npm install -g @laot/bridge`

## No autocomplete for LT.\*

1. Run `ltbridge api` in your resource folder
2. Confirm `ltbridge/api.lua` exists
3. Add VS Code ignore for bundled output — see [IDE Setup](/ltbridge/getting-started/ide-setup.md)

## "No supported framework found"

Your framework resource isn't started or isn't supported. LTBridge supports:

* `es_extended`
* `qb-core`
* `qbx_core`

Make sure one is running **before** your script.

## Inventory / Target / Notify not working

1. Check the adapter resource is started (e.g. `ox_inventory`, `ox_target`)
2. See [Supported Resources](/ltbridge/how-it-works/supported-resources.md) for the full list
3. Use `LT.<Category>.GetResource()` to see what was detected

## Module included but I didn't ask for it

Run:

```bash
ltbridge why <module-name>
```

Dependencies are automatic — if you use Inventory server functions, Framework modules may be required too.

## Watcher not updating

1. Stop the watcher (Ctrl+C) and restart: `ltbridge build -w`
2. Run a manual build: `ltbridge build`
3. Check that your `LT.*` call is spelled correctly

## Duplicate intellisense warnings

Add to `.vscode/settings.json`:

```json
"Lua.workspace.ignoreDir": ["**/ltbridge/modules/**"]
```

## Still stuck?

Open an issue on [GitHub](https://github.com/laot7490/ltbridge/issues) with your `ltbridge/config.json` and the error message.