Apocalypse Vending Machine

Quickstart

1. Find the Vending Machine block in the Creative inventory under the Functional blocks tab, or spawn one with /give @s apocalypse-vending-machine-ye5hytm4:vending_machine.
2. Place it anywhere — it faces toward you when placed.
3. Right-click the front face to open the shop UI and browse listings.
4. To buy an item, make sure you have enough Cash (roulette-table-j2euxdwu:cash) in your inventory, then click Buy.
5. If you are in Creative Mode or have operator permissions, right-click the back panel to open the admin configuration screen and set up your own listings.

---

Overview

Apocalypse Vending Machine adds a tall, post-apocalyptic vending machine block to your world. It functions as a fully configurable shop: admins stock it with any item, set prices in Cash, and control how much inventory is available and how quickly it restocks. Regular players walk up, check what's for sale, and spend their Cash to receive items immediately — complete with sounds, light flashes, and feedback messages.

Each machine is independent: it remembers its own listings, current stock levels, and restock timers persistently across sessions. Multiple machines can run simultaneously in multiplayer without conflict.

---

What It Adds

The machine emits a soft ambient glow (brighter when powered/stocked) and occasionally plays a quiet hum. Indicator lights flash green on a successful purchase and red when a transaction fails.

---

How To Use

As a Shopper

1. Approach the front of the machine and right-click it.
2. The shop UI opens, showing a scrollable list of listings. Each row displays:
   • Item icon and name
   • Quantity you receive per purchase
   • Price in Cash
   • Current stock count
   • Status badge: READY or SOLD OUT
3. Click Buy on any READY listing.
   • If you have enough Cash, the cost is deducted, the items are added to your inventory, and the machine plays a cash-accepted and dispense sound with a green flash.
   • If you are short on Cash, you see "Not enough Cash." and the machine flashes red.
   • If the item is out of stock, you see "Out of Stock." and the machine flashes red.

As an Admin (Creative / Operator)

1. Right-click the back panel of the machine.
2. The configuration UI opens with the title Vending Machine Configuration.
3. Use the panel to add, remove, or edit listings. For each listing you can set:
   • Item — use the searchable item picker (shows icons, display names, and registry IDs including modded items and roulette-table-j2euxdwu:cash) or type a registry ID directly.
   • Quantity — how many items the buyer receives per purchase.
   • Price — cost in Cash per purchase.
   • Max Stock — maximum number of units available before restock.
   • Restock Time — ticks until a sold-out item refills (default: 72,000 ticks = 3 in-game days). Can be set to infinite stock instead.
4. Click Save to apply changes. A confirmation message appears and the machine updates immediately.
5. Use Clear to remove all listings at once.

Only Creative Mode players or server operators (permission level 2+) can open the configuration screen. Regular survival players only see the shop UI.

---

Abilities And Mechanics

Stock and Restocking

• Each listing tracks its own stock count independently.
• When a unit is purchased from a finite-stock listing, a restock countdown begins for that listing.
• Once the timer expires, the stock refills to its max value and a restock sound plays.
• Listings set to infinite stock never deplete and never need restocking.

Indicator Lights

• The machine's indicator lights reflect real-time state:
  • Green flash — successful purchase.
  • Red flash — failed transaction (not enough Cash or out of stock).
• The block also has a READY state: it glows slightly brighter when at least one listing is in stock.

Sounds

Multiplayer Safety

All transactions and configuration changes are validated server-side. Players must be within 8 blocks of the machine for actions to register. Cash is consumed and items are granted atomically, preventing duplication or loss.

---

Progression And Strategy

• Currency: The Vending Machine uses Cash (roulette-table-j2euxdwu:cash) as its sole currency — the same Cash item from the Roulette Table mod. Accumulate Cash through that mod's gameplay to fuel your purchases.
• Server economy: Operators can deploy multiple machines around a world or server, each selling different goods at different prices, creating a distributed economy.
• Restock timing: Set short restock timers on cheap consumables and long timers (or low max stock) on rare or powerful items to control supply naturally.
• Infinite stock listings: Useful for items you want always available (e.g., food, basic materials) without any management overhead.
• Item picker: When configuring listings, use the search field to find any loaded item — including items from other installed mods — by name or registry ID. This makes cross-mod shops straightforward to set up.