XS-RestaurantSystem
Restaurants, bars and cafes for Qbox and QBCore, all built in game. Players ring up orders, cook at stations with minigames and hand the food over. There are no NPC customers.
Requirements
ox_libandoxmysql- Qbox (
qbx_core) or QBCore (qb-core)
Optional:
- A target script. Without one, every point uses E prompts
- A banking script with business accounts, so sales go somewhere: Renewed-Banking, qb-banking, okokBanking, tgg-banking, wasabi_banking, fd_banking or qb-management
pma-voicefor the drive-thru intercom- A boss menu script (
qbx_managementorqb-management) for the office button - A phone for the food app. Without one, players use
/food
Installation
- Drop
XS-RestaurantSysteminto your resources and addensure XS-RestaurantSystemafterox_libandoxmysql. - Give your staff the builder:
add_ace group.admin xs.restaurant.admin allow - For Discord logs, add
set xs_restaurant_webhook "https://discord.com/api/webhooks/..."to your server.cfg. Players never see it. - Restart the server. The tables make themselves on the first start.
- Join, type
/restaurantbuilderand build your first place.
Setting up a business
- Add the items. Food, drinks and ingredients are normal inventory items. Add them to your inventory with their pictures and eating or drinking effects.
- Make a job for the business in your framework, with a boss grade.
- New business in the builder, and pick a style. It sets the stations, menu sections and colours you start from.
- General: pick the job, and an owner if there is one.
- Look: pick a theme, the colours and a logo.
- Places: place the register, stations, kitchen screen and pickup counter. Out front, add menu boards, kiosks, a drive-thru speaker and seats.
- Menu and Recipes: what it sells and how each dish is made.
- Business: supplies, phone orders, deliveries and who can use the business account.
- Save. It is live for everyone straight away.
Themes
Every business picks one of 8 themes: Modern, Order Ticket, Pizzeria, Coffee House, Diner, Pub, Sushi Bar and Neon Night. A theme changes the register, pay prompt, kitchen, pickup counter, cooking station, kiosk, office and the screens on the wall. Every theme still uses the business colours.
The Look tab's See it full size buttons open the real screens with that business's own menu. Nothing is saved or sold, and Esc takes you back.
Registers, kitchen and pickup
- Staff pick items at the register, type a name for the order, and the customer standing there pays by card or cash on their own screen.
- The ticket shows up on the kitchen screen on the wall, turning red when it runs late. Staff tick off lines and mark it ready.
- Pickup screens show which numbers are being made and which are ready.
- At the pickup counter, staff hand the food to the customer.
- Staff mark items sold out from the register, and the menu boards, kiosks and register show it straight away.
Cooking
Stations: grill, fryer, oven, pizza oven, prep board, coffee machine, drinks machine, beer tap and cocktail station. A recipe has the dish, its ingredients, its station and up to 6 steps, and recipes can feed each other, like a patty from the grill going into a burger at the prep board.
Each step is one of 7 minigames or just a timer, and staff can make up to 5 at once. Turn the minigames off in Settings and every step is a timer.
Kiosks, drive-thru and seats
- Kiosks: customers order and pay themselves, but only while someone is on shift, with one open order each.
- Drive-thru: a car pulls up to the speaker and presses E. Staff answer from a register set to drive-thru, and with pma-voice the two talk over an intercom.
- Seats: chairs, tables, stools, benches and armchairs anyone can sit on.
Food app and deliveries
The food app works on XS-Phone, lb-phone, qs-smartphone, qs-smartphone-pro, gksphone, okokPhone and yseries, and as /food on any server. Customers see who is open, order ahead and pay by card, then pick up or get it delivered.
Deliveries are done by staff: take the order from the pickup counter, follow the GPS and hand it over. /canceldelivery gives a delivery back.
The office and money
- The boss's laptop shows sales by day, best sellers, staff and where orders come from, plus prices, sold out and the phone and delivery switches.
- Bosses change prices within a range the server sets.
- Sales go into the account named after the business job in your banking script. The business account page puts money in or takes it out, for the ranks picked in the builder.
- Supplies are paid from the business account. A van parks at the back door, or staff collect them from a warehouse you set once on the builder's Overview.
Troubleshooting
/restaurantbuilder does nothing
You do not have access. Run add_ace group.admin xs.restaurant.admin allow and restart.
The business account shows nothing
No banking script was found, or the job has no account yet. Run /restaurantdiag, which shows the bank it found and your job's account.
Staff cannot use the register
They are off duty, or the business is linked to another job. Check the job on the General tab.
An item is missing from the menu picker
It is not in your inventory's item list yet. Add it and restart your inventory.
The drive-thru has no voice
The intercom needs pma-voice. Without it the drive-thru still works.
Something else is not working
Run /restaurantdiag in game and include what it prints when you ask for help on the Discord.
Updating
- Back up the database first.
- Keep a copy of your edited
config.lua. - Replace the resource folder, merge your config back and restart.
Your businesses, menus, recipes and settings live in the database, so nothing you built is lost.
Support
Bugs and questions go to the Discord. Include your server's console output — the resource prints the reason when it refuses to do something, and that line is usually the whole answer.