| UI Element | Data Source | Update Frequency | |---|---|---| | Current Money | Module D | Real-time | | Daily Customers | Module C | Per spawn/leave | | Stock Alerts | Module B | When shelf < 20% | | Customer Thoughts | Module C | Floating text above head | | Day / Time | System clock | Every 60 sec |
| Function Name | Parameters | Description | |---|---|---| | CheckShelfLevel(shelfID) | Shelf identifier | Returns % full (0.0 to 1.0). | | RestockShelf(shelfID, productType) | Shelf ID, product ID | Increases stock on shelf by 1 unit (or bulk). | | RemoveItemFromShelf(shelfID) | Shelf ID | Called when customer picks an item – reduces stock. | | GetStorageStock(productID) | Product ID | Returns how many boxes left in back room. | | OrderNewStock(productID, quantity) | Product ID, quantity | Deducts money, adds to storage after delivery delay. | supermarket simulator script
| Function Name | Parameters | Description | |---|---|---| | SpawnCustomer() | None | Creates a new customer at entrance with random patience & budget. | | ChooseShoppingList(customer) | Customer object | Generates 3-6 random products from available store items. | | NavigateToProduct(productID) | Product ID | Moves character to shelf location (pathfinding). | | PickUpItem(productID) | Product ID | Animates grab, removes from shelf, adds to cart. | | ReactToEmptyShelf() | None | Reduces happiness, may leave store early. | | MoveToCheckout() | None | When shopping list complete → goes to shortest queue. | | UI Element | Data Source | Update
function Cashier:ScanItem(item) self.totalBill = self.totalBill + item.price self.itemsScanned = self.itemsScanned + 1 game.ReplicatedStorage.Events.UpdateBill:FireAllClients(self.totalBill) | | GetStorageStock(productID) | Product ID | Returns
| Function Name | Parameters | Description | |---|---|---| | AddDailyIncome(amount) | Money earned | Updates bank balance. | | PayDailyExpenses() | None | Deducts rent, salaries, electricity. | | UpgradeCashierSpeed(cost) | Upgrade cost | Reduces scan time per item. | | UnlockNewProduct(productID, cost) | Product ID, cost | Adds new item to supplier list. | | ExpandStoreArea(areaID, cost) | Area ID, cost | Unlocks new shelves and floor space. | | GetDailyReport() | None | Shows profit/loss, customer count, top selling item. |
| Function Name | Parameters | Description | |---|---|---| | StartTransaction(customer) | Customer object | Opens the checkout UI, scans items one by one. | | ScanItem(item) | Item ID, price | Adds item to current bill, updates total. | | CalculateTotal() | None | Returns total price + tax. | | ProcessPayment(paymentMethod) | "cash" or "card" | Checks if customer has enough money; handles change. | | BagItems() | None | Animates bagging, removes items from counter. | | CompleteTransaction() | None | Gives receipt, spawns next customer in line. |