> 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/skateboards/troubleshooting.md). # Troubleshooting Fixes for the problems that come up most often with Skateboard. ## The item has no Use option * The item has to exist in your framework's item list: on ESX, run `install/esx_items.sql`. See Items. * Check that `Config.Item.Enabled` is `true` and the item is in `Config.Item.Items`. * With another inventory than ESX's, QBCore's or ox\_inventory, set `Config.Item.Framework = false` and call `exports.skateboard:throwBoard` from it. ## There is no Pick up Skateboard option * Only boards that came out of an inventory can be picked up, not boards from `/skateboard`, `/car` or a garage. * ox\_target has to be running, and `Config.Item.PickUp.Target` set to `'ox_target'`. * With `OwnOnly = true` only the player who took the board out sees the option. ## The player steps on with GTA's getting-in animation They have moved GTA's enter-vehicle key. In **Settings > Key Bindings > FiveM**, set **Skateboard: step on** to the same key. ## 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 or the tricks * OneSync has to be enabled on the server. * Check that `Config.Stance.Sync` is `true`. ## A key does nothing The player may have moved it, or another script uses it. Look in **Settings > Key Bindings > FiveM** under "Skateboard: ...", see Commands and permissions. A flip key pressed in the air just before the board lands also does nothing on purpose: there is no air left for the flip to come round, and the rider would bail (`Config.Tricks.MinFlipShare`). ## The board tips back or rocks when braking The board's centre of mass in `data/handling.meta` (`vecCentreOfMassOffset`) has to be as it came, just under the ground. Lower, every brake and push tips the board onto its back wheels and it swings on after it stops; higher, it can roll over in tight curves. After changing or updating `data/handling.meta`, restart the server and have everyone reconnect: a board that was already out in the world keeps its old values until it is spawned again. ## The pushing bar or the ollie meter does not show * Check that `Config.PushTiming.Enabled` is `true` and `Config.Ollie.Meter` is not `false`. * Both are drawn in the resource's own interface page. Check that `fxmanifest.lua` lists `html/bars.js` and `html/bars.css`, and that no other resource covers the screen with a page of its own. ## The board sounds like a car, or an engine is heard The board's own audio data, which makes it silent as a vehicle, loads as a player connects. After installing or updating, restart the server and have everyone reconnect. Check that `fxmanifest.lua` and `data/vehicles.meta` are as they came, and that no other resource replaces the boards' vehicle data. ## There are no skateboard sounds * Check that `Config.Sound.Enabled` is `true` and `Config.Sound.Volume` is above 0. * A sound whose level in `Config.Sound` is 0 is off. The push sound is off by default. * The sounds are heard up to `Config.Sound.Distance` (35 m) from the camera. See Sounds. ## The sounds are too loud or too quiet `Config.Sound.Volume` sets all of them, and each sound has its own level beside it (`Roll`, `Brake`, `Pop`, `Land`, `Bail`, `Push`). ## The rider bails too often, or never Raise or lower `Config.Air.LandAngle` (degrees off a half turn that still land) and `Config.Bail.CrashSpeed`. `Config.Bail.Enabled = false` turns bails off. ## The board is too fast, too slow, or too hard uphill Change `Config.Ride` (`PushSpeed`, `PushMaxSpeed`, `RollDrag`, `SlopeUp`) and `Config.PushTiming.MaxSpeed`. To find values first, stand on a board and use `/skateboardtune`, see Configuration. ## /skateboard does nothing * The command is for admins by default: `add_ace group.admin command.skateboard allow`. * A name that is no board shows a message. Use a spawn name, the part after `skateboard_`, or a number from 1 to 10. ## Players see an old model or a missing board, or hear old sounds Players who are on the server while the files in `stream/`, `data/` or `audio/` change keep the old ones until they reconnect. Restart the server after an update and have everyone reconnect. ## Custom boards show a bare wooden deck * Up to 12 custom boards nearby show their pictures at once, within `Config.Custom.Range` (60 m). A board further away, or the 13th, shows bare wood until it comes closer. * After the update to 2.0 everyone has to reconnect once: the custom boards' models load as a player connects. * The decks on a shop's deck wall give their places to boards close by first. ## A picture from a link is refused * The link has to come from one of the sites in `Config.Custom.Images.Hosts` and point to a PNG, JPG or WebP picture. * It is larger than `MaxBytes`, or the player loaded more than `PerMinute` links in a minute. * `Config.Custom.Images.Enabled` is `false`. ## The shop's stations are not there * They have to be placed first: `/skateshop place kiosk` (and `bench`, `rack`). `/skateshop list` names the ones placed. * They stand there for players within 120 m. * The stations are used with ox\_target: it has to be running. ## Nobody can build an order at the bench * With a `Job`, only its employees of `MinGrade` or higher build orders. With nobody of the job at work, `Alone` decides: `'wait'` keeps the order for an employee. * A board built faster than `MinBuildSeconds` is not accepted. ## The deck wall shows only house designs * No board with artwork has been finished at that shop yet. * `Config.Shop.Wall.Customers` is `false`. ## There is no Use this design for a customer's board Its owner did not tick **Others may use my design** in the builder, or the shop's `Design` is `false`. ## Custom boards are lost after a restart Without oxmysql they are kept in the server's KVP (`Config.Custom.Storage`). If you want them in MySQL, check that oxmysql starts before Skateboard and that the database user may create tables. Still stuck? See Support.