> For the complete documentation index, see [llms.txt](https://atiysus-organization.gitbook.io/aty-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://atiysus-organization.gitbook.io/aty-scripts/restaurant-creator/reference/troubleshooting.md).

# Troubleshooting

#### `/restaurantadmin` does nothing

* You lack the framework **admin** permission, or `aty_lib` isn't started.
* Check the server console for an `aty_lib not ready` warning.

#### Items don't appear / "item does not exist"

* You didn't add the items to your inventory. Paste `items/ox_items.lua` or `items/qb_items.lua` into your inventory and restart it.
* Item **names** must match exactly between `config_items.lua` and your inventory.

#### Item icons are blank in inventory

* Copy `<item>.png` images into your inventory's image folder (`ox_inventory/web/images/` or `qb-inventory/html/images/`). The script's own `.webp` icons live in `web/public/`.

#### DUI screen (microwave/espresso) looks low-resolution

* This is client-side graphics, not the script. Have the player raise **Texture Quality** and enable **Extended Texture Budget** in FiveM settings, and ensure enough VRAM. The DUI renders at a fixed resolution for everyone.

#### 3D cook/fill timer stuck at `0s`

* Fixed in current builds — timers are computed client-side and are immune to server clock skew. If you still see it, make sure you're on the latest version and did a full `restart aty_restaurant`.

#### "Missing locale: some\_key" on screen

* That key isn't in `shared/locales.lua`. Add it. NUI strings carry English fallbacks; Lua-side `_t` shows the missing marker, so add the key to fix.

#### FetchNui "Unexpected end of JSON input"

* A NUI action reached the client with no matching `RegisterNUICallback`, so it returned nothing. Ensure you're on the latest build and rebuilt the NUI (`cd web && npm run build`) if you edited `web/src`.

#### Nothing spawns / no props at a restaurant

* The player may be outside `Config.StationPropDistance`. Props only spawn within range for performance.
* Make sure `aty_restaurant_assets` is started (custom models/textures live there).

#### Prop DUI blank / wrong texture

* Confirm `aty_restaurant_assets` provides the screen textures (`script_aty_microwave`, `script_aty_coffee_machine_screen`) and the machine models. A missing embedded texture shows as blank.

#### Double food/drink progress bars

* Another script also handles consumption. Set `Config.DisableBuiltInConsumables = true`.

#### Verifying a fix

Use the live runtime check: `restart aty_restaurant`, then watch the server + F8 console for `SCRIPT ERROR` lines. Most issues surface there immediately.

#### Still stuck?

Join the community for support: <https://discord.gg/dvPMYsRFNx>