> For the complete documentation index, see [llms.txt](https://acestudios.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://acestudios.gitbook.io/docs/jobs-and-economy/p2p-vehicle-marketplace/troubleshooting.md).

# Troubleshooting & FAQ

Read the marketplace console logs and fix common problems.

## Reading the logs

Every failure is logged to the server console, and to the client F8 console for client-side steps. Each line has the **`[ACE VEHICLE MARKET]`** prefix, the operation, the reason, and the player, plate or listing involved.

| Tag                                 | Area                                  |
| ----------------------------------- | ------------------------------------- |
| `[CONFIG]`                          | Detected and validated settings       |
| `[DATABASE]`                        | Schema check, installation, migration |
| `[VERSION]`                         | Update notices                        |
| `[LISTING]` / `[SALE]` / `[RENTAL]` | Marketplace actions                   |
| `[TEST DRIVE]` / `[PHOTO]`          | Test drives and photo booth           |
| `[GARAGE]` / `[KEYS]`               | Integrations                          |
| `[EARNINGS]` / `[PAYMENT]`          | Money                                 |
| `[CALLBACK]`                        | NUI ↔ server communication            |

Errors and warnings always print. Set `Config.Debug = true` or `set ace_marketplace_debug true` to also see successful steps.

## Troubleshooting

<details>

<summary>"the marketplace is DISABLED (database)" / players see "Marketplace Unavailable"</summary>

The database check, installation, migration or self-test failed. The console lines **just above** say exactly what, for example a missing table or column, missing `CREATE`/`ALTER` permission, or a wrong vehicle-table column. Nothing in the marketplace runs until you fix it and **restart the resource**.

Common fixes:

* Import `sql/install.sql`.
* Give your database user `CREATE` and `ALTER` permissions.
* If your vehicle table has renamed columns, set `Config.ESXVehicleTable` or `Config.QBVehicleTable`.

</details>

<details>

<summary>"es_extended did not return its shared object" / framework not detected</summary>

Start your framework (`es_extended`, `qb-core` or `qbx_core`) **before** `ace_p2pmarketplace` in `server.cfg`. The framework is detected when the resource starts, so it can't be listed as a manifest dependency.

</details>

<details>

<summary>"resource integrity check failed: … has been tampered with"</summary>

A shipped web file (`web/index.html`, `web/css/style.css` or `web/js/*.js`) was modified. Reinstall the original files and restart the resource. Only `web/assets/branding/server_logo.png` can be replaced freely.

</details>

<details>

<summary>"transaction was rolled back … ace_marketplace_guard"</summary>

A state check failed at commit time, for example the vehicle was taken out of the garage in the middle of a sale. Nothing was changed and the buyer was refunded. This is expected protection, not a bug.

</details>

<details>

<summary>Rows with status "paying" in ace_marketplace_payments</summary>

The server stopped while paying someone. Check whether the player got the money, then set the row to `paid` or `pending`.

</details>

<details>

<summary>A vehicle doesn't show up in the Sell/Rent list</summary>

Only vehicles that are **stored** (the stored column equals `StoredValue`), **not impounded** and **not spawned** in the world can be listed. Store the vehicle in a garage first. A vehicle that is already listed, rented out or in another transaction can't be listed again.

</details>

<details>

<summary>"Take Photos" is missing or photos fail to upload</summary>

* Photos need `screenshot-basic` started **before** the marketplace.
* With `Storage = 'resource'`, keep the `web/uploads/` folder.
* With Fivemanage, check the `ace_marketplace_fivemanage_key` convar (set with `set`, not `setr`).

</details>

<details>

<summary>Test drives don't spawn a vehicle</summary>

* OneSync must be on (`set onesync on`).
* `Config.TestDrive.SpawnLocation` must be clear. Add `SpawnLocations` for several drives at once.
* With `RequireNearLocation = true`, the player must be near a marketplace location.
* Players must wait `Cooldown` seconds between drives.

</details>

<details>

<summary>Buyer or renter gets no keys</summary>

Check the `[KEYS]` lines in the console. Make sure your key resource starts before the marketplace, or set `Config.Keys.Resource` manually. See [Garage & Key Integrations](/docs/jobs-and-economy/p2p-vehicle-marketplace/integrations.md#vehicle-keys).

</details>

<details>

<summary>"Garage" warnings on start</summary>

No supported garage resource was detected, so vehicles are stored with plain vehicle-table updates. That works, but you can set `Config.Garage.Resource` or write a [custom adapter](/docs/jobs-and-economy/p2p-vehicle-marketplace/integrations.md#custom-garage-adapter).

</details>

## FAQ

<details>

<summary>Can I charge a fee on every sale?</summary>

Yes. Set `Config.TransactionFeePercent` (default `2.5`) and add your identifier to `Config.MarketplaceOwner.Identifiers`. You claim the fees from the **Fees** tab.

</details>

<details>

<summary>Does it work without screenshot-basic?</summary>

Yes. Photos are turned off automatically, and listings don't require them.

</details>

<details>

<summary>Can I change the UI?</summary>

You can replace the server logo (`web/assets/branding/server_logo.png`) and add vehicle preview images (`web/assets/images/<model>.png`). Other web files are integrity-checked and must stay unmodified.

</details>

<details>

<summary>Which languages are included?</summary>

English, German, Spanish, French, Portuguese and Arabic, with a right-to-left layout for Arabic.

</details>