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

# Troubleshooting

Fixes for the problems that come up most often with Hoverboard.

## The player steps on with GTA's getting-in animation

They have moved GTA's enter-vehicle key. In **Settings > Key Bindings > FiveM**, set **Hoverboard: step on** to the same key.

## The board does not lift or fly

* The board only flies with its engine running. A fuel script that empties its tank stops the engine: leave the hoverboards out of it, or keep their fuel up.
* Leave `fPetrolTankVolume` in `data/handling.meta` above zero.

## The rider sits instead of standing

* Check that `Config.Stance.Enabled` is `true`.
* Check that the board's spawn name is in `Config.Models`.

## Other players do not see the poses, the ribbons or the boost

* OneSync has to be enabled on the server.
* Check that `Config.Stance.Sync` and `Config.Effects.Enabled` are `true`.

## The underglow has the wrong colour

The board's light colour is not in `Config.Underglow.Colours`, so it gets `Default`. Add it there, see [Boards and colours](/organized-chaos-docs/hoverboards/boards-and-colours.md).

## The board is too fast, too slow or turns badly

Change `Config.Flight`. To find values first, stand on a board and use `/hoverboardtune`, see [Commands and permissions](/organized-chaos-docs/hoverboards/commands-and-permissions.md).

## /hoverboard does nothing

* The command is for admins by default: `add_ace group.admin command.hoverboard allow`.
* A name that is no board shows a message. Use a spawn name, the part after `hoverboard_`, or a number from 1 to 10.

## A changed colour set does not show

The game reads `data/carvariations.meta` only when it loads the resource. Restart the server and reconnect.

## The item has no Use option

* The item has to be in your inventory's item list, see [Items](/organized-chaos-docs/hoverboards/items.md). For ESX, check that `install/esx_items.sql` has been run.
* ESX marks an item usable when a player joins. Players who were already on the server when `hoverboard` started are told again by the script; if one still sees no **Use**, they reconnect once.
* With ox\_inventory on its own, the item needs `server = { export = 'hoverboard.useItem' }`.
* The server console says `the hoverboard item is not usable` when the framework did not start within a minute.

## Pick up Hoverboard does not show

* It needs ox\_target, and `Config.Item.PickUp.Enabled` and `Target = 'ox_target'`.
* It only shows on a board that came out of an inventory and that nobody stands on. With `OwnOnly = true`, only for the player who set it down.

Still stuck? See [Support](/organized-chaos-docs/support.md).