🆕What's New in v3
BurgerShot v3.0.0 is a full rebuild of the script. The kitchen is no longer a handful of menus bolted onto counters — it's a real, multi-station fast-food simulation with its own NUI, a relational database, and a companion delivery app. This page explains what changed, what you need to do to upgrade, and what each new system actually does.
Migrating from v2
Install and start pl_lib (see pl_lib installation) — it must be running before
pl_burgershotstarts.Pull the new v3 files over your old install.
Leave
Config.AutoInstallSQL = true. On first boot, the script automatically:Creates the two new tables it needs (
pl_burgershot_orders,pl_burgershot_shifts) if they don't exist.Upgrades your existing
pl_burgershot_fridgetable from the old multi-row schema to the new single-row JSON schema, carrying your existing stock numbers over — nothing is lost.Widens
order_idtoVARCHAR(36)and adds apaid_accountcolumn topl_burgershot_ordersif you're upgrading from an earlier v3 build.
Re-register your items — the v3 item catalog is smaller and renamed, and no longer needs the DJ Collections prop pack (see below). Copy the new snippets from
Installfolder/items-*into your inventory, don't just keep your old v2 item list — and copy the icons fromInstallfolder/images/into your inventory's own image folder (e.g.ox_inventory/web/images/), which is separate from the NUI's own icons.Install the extra resources v3 needs that aren't enforced by
fxmanifest.lua:pl_restaurant_props, plus copying sounds intoxsoundand animations into your emote resource. See Installation → Required manual steps — these are easy to miss and the shop will look/sound broken without them.Read through
shared/config.luatop to bottom — most v2 settings were renamed, removed, or moved into pl_lib. Don't copy your old config file over the new one.
Breaking changes
Standalone 'autodetect' framework/UI/target/notify glue built into the script's own config
Delegated to pl_lib (new hard dependency) — see pl_lib docs
One flat pl_burgershot table (stock + state)
Four tables: main, _fridge (JSON stock), _orders (full history), _shifts (clock in/out) — all self-installing/self-migrating
Item defs hard-coded per station
Declarative shared/recipe.lua (ItemDefinitions) — one place to add/edit menu items
~50-item sprawling menu (many burger/wing variants), relying on the external DJ Collections prop pack
Streamlined ~25-item core menu, intentionally simplified for v3, built entirely on the script's own pl_restaurant_props — no external prop pack needed
No NUI app
Full NUI (web/) for the kiosk, boss menu, fridge, order queue, receipts, drink fill, supplier ordering, and the order display board
No companion phone app
pl_restaurantapp — order/delivery app for lb-phone and gksphone
New features
🧑🍳 Duty / Clocking system — employees clock in/out, shift time and items-cooked are tracked in the database, survives disconnects/crashes. Gated by
Config.RequireDuty.🧼 Kitchen cleanliness — the kitchen gets dirty after
Config.Kitchen.DirtyAfterCooksitems cooked and must be cleaned (CleanDuration) before staff can keep cooking.🧽 Hand-wash requirement — optional pre-cooking hygiene step (
Config.RequireHandWash).🎮 Interactive cooking with skill checks — a proper mini-game-driven cook loop (
Config.SkillCheck) with burn timers on the grill and fryer.🧾 Custom billing — staff can send a customer an ad-hoc bill from the kiosk, paid via a bank/cash dialog with an optional tip slider.
💵 Tipping — percentage-based customer tips, split between employee and business (
Config.Tip).🧻 Printed receipts — customers get a receipt item after checkout that shows an itemized order, visible to them and anyone standing nearby.
📺 Order display board — a TV prop near the kitchen shows live Pending / Cooking / Ready queues, like a real fast-food order screen.
🍔 Inbuilt consumables — eating/drinking animations and hunger/thirst are handled by the script itself (
Config.Consumables), no inventory-side status config needed for BurgerShot items.🗺️ Location auto-detect —
Config.location = 'auto'picks whichever supported MLO you actually have running; adds support for the free Giant Burger Shot map.🧱 Custom props & animations — dedicated food/kiosk models (
pl_restaurant_props) and bespoke carry/cooking animation dictionaries.📱 Delivery app integration — BurgerShot exposes a kiosk callback contract (
getKioskData/placeKioskOrder/client:notify) thatpl_restaurantappuses to sell BurgerShot food through lb-phone/gksphone, including a full delivery-driver gig job.
See the Feature Guide for a deep dive into each of these, and Exports & Events if you're integrating another resource with BurgerShot's kiosk.
Last updated