Jixryo Restaurants

Jixryo Restaurants turns any job into a working restaurant. City staff mark the restaurant's area and lay out its stations as props or points; its managers do the rest from inside the area. Customers order at the register, a kiosk, the drive-thru or the Takeout app on the phone and tablet, pay on their own screen, and the ticket shows on the kitchen screen. Cooks make each dish by hand at a griddle, a fryer, a fridge, a prep table and a drinks fountain that everyone near can watch, and every dish comes out stamped with its quality. Menu boards play designs on real screens, supplies arrive by Jixryo Freight or a courier, and managers run it all from the Restaurant app on Jixryo Computers. The server decides everything; the pages only show what the server sent.

#What players get

• A restaurant is its stations. A clock-in, storage (a fridge, a freezer, dry storage and the trash, each an ox_inventory stash the restaurant's people open), registers, a kiosk, a kitchen screen, a packing pass, a pickup counter, menu boards, a drive-thru speaker and window, a delivery dock, and the kitchen itself: griddles, fryers, prep tables, drinks and dessert stations. Each is a prop (the resource's own models or the game's) or a point on something already in the map.
• The prompt is the resource's own. Look at a station within 2.6 m and E uses the marked line; the wheel moves between lines. A line you may not use shows a padlock and why. Nothing is handed to ox_target.
• Front of house. Clock in at the clock-in. At a register, ring up an order for someone within 4 m; they pay on their own screen in cash or by card with a tip (none, 10, 15 or 20 percent), and have 90 seconds before the order lapses. The ticket goes to the kitchen screen. Cooks pack it at the pass, all or none, and the customer collects it at the pickup counter. A kiosk takes orders without a cashier. Whoever rang the order up gets the tip and a 5 percent commission from the business.
• The kitchen, by hand. The griddle has three zones with knobs from 0 to 450 degrees; put a patty on a spot, flip it, drag it off the edge into your pockets, scrape the grease into the trough and spray degreaser once every zone is at or under 300 degrees. The fryer has two wells from 300 to 375 degrees: drop a basket, lift it, tip it out, filter the oil, drain a well into the pan, pour in a fresh jug of fryer_oil, boil it out with water and scrub it with the brush. The fridge warms while its door is held open, spoils stock when it is warm or dirty, and is sprayed and wiped. The prep table's make page chops, slices and builds; the resource's own fountain is poured at in 3D, with the lever pushed, the stream in its colour and a puddle on the tray when a cup runs over, while any other fountain gets the pour page. Everyone near sees the knobs, patties, oil, baskets, doors, dirt layers, smoke, bubbles and steam.
• Quality and skill. Every dish is stamped perfect, good, okay, raw or burnt. Eating a perfect dish gives 10 hunger and takes 5 stress, a good one 5 and 2. Cooking earns the Cooking skill of Jixryo Skills through Jixryo Core when it runs: 12 XP for a perfect dish, 8 good, 4 okay, 1 raw or burnt, 3 a chop, 4 a build, 2 a fill.
• Hygiene. Every station has a cleanliness that falls with use; bands at 70, 40, 15 and 0 change what comes out of it. The trash empties itself every 15 minutes.
• Takeout. The Takeout app on Jixryo Phone and Jixryo Tablet lists the restaurants that are open, takes a pickup or a delivery order, quotes the fee (4 dollars plus 2 per road kilometre, at most 30) to where you stand or to your waypoint, and is paid from your Checking account. Two orders open at once per customer. A driver on duty takes a packed delivery at the pickup counter, gets a blip with the route, carries the bag on foot, and hands it over with E within 3 m. Not handed over within 45 minutes, it is all refunded.
• The drive-thru. Stop in the speaker's lane and the staff on duty are told; a cashier rings the order up to the car from a register; at the window the pay screen comes up, you pay from the car, and E takes the packed order. A passenger gets nothing; on foot, the speaker says to drive up.
• Orders from the city, off by default: in quiet hours, a restaurant that is open and delivers gets orders phoned in from addresses its managers added, delivered to a customer who waits at the door.
• Menu boards. A design is 1 to 8 slides of 5 to 60 seconds each, with layouts, regions (the menu, the meals, the order numbers, promos, hours, a ticker), colours and pictures from allowed hosts. The resource's own rail plays three designs on its three screens; the single board one; a point board plays on its four corners; a kitchen screen shows the tickets.
• Supplies. Mutiny Road Food Distribution sells 14 cases (beef, chicken, potatoes, cheese, cups, oil and the rest) into the restaurant's fridge, freezer or dry storage, by Jixryo Freight to the restaurant's dock when it runs, else by courier in 10 minutes (5 express).

#What staff get

• City staff (group.god and group.admin, Config.staff) make restaurants with /restaurants: a job, a radius of 35 m around where they stand (10 to 120 m, 15 m high), up to 40 stations each. They lay out any restaurant, rename and remove it.
• Managers are the job's isboss grades in qbx_core. They lay out their own restaurant inside its area, and run it from the Restaurant app on Jixryo Computers: the dashboard with the account balance, the menu (prices 1 to 500, up to 40 items, sold-out lines, availability), stock with pars and auto-order, the kitchen's health, waste and who made what, sales, settings (open or closed, hours, commission up to 20 percent, sold-out lines on the boards, phone orders and delivery and its radius), supplies, menu board designs and what each screen shows, and the city's delivery addresses.
• The creator. A station is a prop or a point. Props follow your aim, solid, with their doors on them; the wheel turns them (Shift for 1 degree steps), Tab opens the gizmo (Tab moves or rotates, the right mouse button looks, Space drops it to the floor), E or Enter places, Esc or Backspace goes back. A point is a box: the wheel sets its width (Shift height, Ctrl depth), the arrows turn it, F pins the prompt spot, G sets it, H clears it; a point board takes its four corners with E at each. The pointer shows red where it cannot go and green inside the restaurant.
• Every change is audited through Jixryo Core: restaurants.new, edit, remove, place, move, paid, design, designRemove, screen, menu, autoOrder, supplies, settings, phoneOrder, deliveryOut, delivered, deliveryBack, refunded, cityOrder, cityDelivered, cityAddress and cityAddressRemoved.
• Version 0.8.1, from the CHANGELOG: a right click no longer ends a kitchen game, so the fridge's door can be held open with the right mouse button.
• Not working yet, marked so in shared/kinds.lua: the oven, coffee, seating, sink, locker and computer kinds.

#Install

1. What it replaces. The README names nothing it replaces.

2. Order. It depends on ox_lib, oxmysql, qbx_core, ox_inventory and Jixryo Core, and uses Jixryo Bank for money and cards, Jixryo Computers for the Restaurant app, Jixryo Freight for supplies to a dock, and Jixryo Phone and Jixryo Tablet for the Takeout app. Start it after them.

   ensure ox_lib
   ensure oxmysql
   ensure qbx_core
   ensure ox_inventory
   ensure jixryo_core
   ensure jixryo_bank
   ensure jixryo_computers
   ensure jixryo_trucking
   ensure jixryo_restaurants

   Copy

   Jixryo Computers is optional: without it there is no Restaurant app and everything else works. Jixryo Freight is optional: without it, or without a dock, every supply order comes by courier. Jixryo Phone and Jixryo Tablet are optional: each that runs gets the Takeout app in its store; without either, a customer's order messages come on the HUD. Each of them started later or restarted gets its app again.

3. Jobs. A restaurant needs a qbx job. burgershot, rexsdiner and henhouse are already in qbx_core's jobs.lua; the job's isboss grades are its managers.

4. Money. Payments go into Jixryo Bank's business account for the restaurant's job. If the Bank is not started, or its account refuses, the payment is refused and nothing is charged. Cards need Jixryo Bank 2.1.0 or later; without it the card button says cards are not taken and cash still works.

5. Items. A new restaurant's menu is its job's template in Config.menus (Burger Shot's is there, on the bzzz_fastfood_burgershot_* items); a job with no template starts with an empty menu. The kitchen's ingredients (ground_beef, potato, cheddar_block, chickenbreast_breaded, drink_cup and the rest), the dishes and fryer_oil are in the Jixryo ox_inventory fork (data/items/food_ingredients.lua, data/shops.lua and web/images/fryer_oil.png); its Ingredients Shop sells the raw ingredients and fryer_oil at 15 dollars to the restaurant jobs. Upload the fork with this resource.

6. Database. The tables make themselves on the first start, as six Jixryo Core migration steps: jixryo_rest_restaurants, _stations, _menu, _orders, _kitchen, _designs, _screens, _settings, _log and _supplies.

7. The Cooking skill is Jixryo Skills' cooking, through Jixryo Core. Without it, cooking works the same with no XP and no perks.

8. Props. The resource streams its own griddle, fryer, fridge, fountain, tables, kiosk and boards from stream/; nothing else to upload.

9. Restart the whole server the first time, so every resource sees the items and every game downloads the props.

#How other scripts' calls behave

• It answers as itself only. Its one export lives under jixryo_restaurants; nothing is provided under another name.
• qbx_core. Jobs and their grades are read with GetJob and GetJobs, the clock-in sets duty with SetJobDuty, and GetDutyCountJob counts who is on.
• ox_inventory. The storage stashes are registered through Jixryo Core as jxrest_<restaurant>_fridge, _freezer, _dry and _trash, for the job's grades; an openInventory hook on ^jxrest_ lets only the restaurant's people open them, and the server opens them with forceOpenInventory. Dishes come out through AddItem, ingredients go in through RemoveItem, and eating is caught on ox_inventory:usedItem.
• Jixryo Bank. Cash goes in and out of the job's account with AddGroupMoney and RemoveGroupMoney, the dashboard reads GetGroupBalance, and a card payment runs on the Bank's terminal with Charge after HasCardTerminal says one is there.
• Jixryo Computers. It adds the app jixryo_restaurants ("Restaurant", web/build/manage.html) for the jobs that have a restaurant, again when they change and when the computers restart.
• Jixryo Phone and Jixryo Tablet. It adds the app jixryo_takeout ("Takeout", web/build/order.html, folded and open on the phone) to each that runs, pushes order changes into it with SendAppMessage, and notifies the customer through the phone's Notify as that app.
• Jixryo Freight. A supply order going to a dock is posted with the Freight resource's Post export, as a restaurant job with its cases, and Freight reports back through this resource's FreightEvent export.
• ox_target. With the Jixryo ox_target fork's look mode on, stations are never given to ox_target; the prompt is the resource's own.
• Jixryo Core. It uses the database, inventory, permission, validation, rate limit, player, HUD, audit and skills modules.
• Global state. Every game reads jxrest_<restaurant> (the queue: tickets and ready orders), jxrest_k<station> (a station's equipment), jxrest_f<restaurant> (the fridge), jxrest_b<restaurant> (the boards) and jxrest_m<restaurant> (the menu).

#Its own API

Server export:

Events:

The pages' calls go through 56 server callbacks named jixryo_restaurants:server:<name> (the world, the creator, duty, storage, the register, paying, packing, pickup, the kiosk, cooking, boards, the app, supplies, the Takeout app, deliveries, the drive-thru and city orders); they are not an API, and the server checks every one.

#Commands and keybinds

There are no keybinds to rebind: the resource registers none.

#Configuration

config.lua:

#Security

• Every callback checks the caller. City staff by ACE or a boss grade of the job for the layout; for use, the restaurant's people from the station's grade, on duty when the station says, within reach of it. Values come from fixed lists, every call is rate limited, and every change is audited.
• Prices are the server's. An order's total comes from the server's menu, never the page. Only the customer pays, near the counter, once: a per-order lock stops a double charge. Cash is taken first and refunded if the account refuses. A card goes through the Bank's terminal; this resource never sees the PIN, only paid or not and the last four digits.
• Packing and pickup. The pass takes the dishes all or none, slot by slot with their stamps, and only the customer collects.
• Cooking. One callback, the server's clock, minimum seconds for every step, cleaning strokes rate limited to 0.2 s (a stroke too soon answers counted = false, never an error), and a spill only from a drink in Config.cooking.drinks.
• Designs are rebuilt from the fields passed: colours as #rrggbb, known layouts, regions and backgrounds, 1 to 8 slides of 5 to 60 seconds, pictures over https from the allowed hosts, and no characters that escape CSS.
• The app checks the player on every call; the employee dashboard carries no money.
• Supplies are priced and paid on the server, and only jixryo_trucking may call FreightEvent.
• Takeout. Totals are computed on the server and the page's expect must match; "here" is the server's position, a waypoint must be inside the radius, it is paid from Checking first, the delivery money is held on the order, one delivery out per driver and never their own, and the refund after 45 minutes runs even while the customer is offline.
• The drive-thru checks from the server's entities that the driver sits in the driver's seat of a car inside the lane.
• City orders need both switches, addresses from the server's position at least 400 m from the restaurant, and a handover no sooner than 30 seconds per road kilometre.
• Nothing leaks. The register never sends names, stashes open only through the server's hook, and every query is parameterised.

#Tests

Three suites in dev-tools/luarun/tests, sharing jixryo_restaurants.setup.lua (a real database with Jixryo Core's real modules, qbx_core's jobs, ox_inventory's stashes, Jixryo Bank, Jixryo Computers, Jixryo Phone, Jixryo Tablet and Jixryo Freight stood in). All three run on 2026-10-31.

cd dev-tools/luarun
node run.mjs ../../jixryo_scripts/jixryo_restaurants tests/jixryo_restaurants.lua
node run.mjs ../../jixryo_scripts/jixryo_restaurants tests/jixryo_restaurants.takeout.lua
node run.mjs ../../jixryo_scripts/jixryo_restaurants tests/jixryo_restaurants.client.lua

#Check it in game

1. As city staff, stand in the middle of Burger Shot, type /restaurants, press +, pick the job burgershot and make it. Its storage and its menu come with it.
2. Place a clock-in point, a register, a kitchen screen, a packing pass and a pickup counter, then the kitchen: the resource's own griddle, fryer, fridge and drinks fountain, and a prep table.
3. As a Burger Shot employee, look at the clock-in and press E. With a second player at the counter, ring up a Cheeseburger meal: they pay on their own screen, the business account gets it, and the ticket shows on the kitchen screen.
4. Cook it from the restaurant's storage: the patty on the griddle, the fries in the fryer, a big drink at the fountain, and the burger built at the prep table after cutting what it needs. Each comes out stamped.
5. Pack it at the pass; the customer takes it at the pickup counter.
6. Put the three-screen rail on the wall over the counter: the menu, the meals and the order numbers play on its three screens.
7. With Jixryo Computers, open the Restaurant app on a manager's computer and change a price: the register and the boards show it at once.

If a prompt sits off a station, a cooking camera sits wrong, or an effect looks too big or small, the values are in shared/kinds.lua, client/rigs.lua and Config.cooking.looks.fx.