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