inventory

Last updated on

Holds every item a character carries. I opens a grid of slots with a weight bar; beside the bag the screen can show a second container: a stash, a vehicle's trunk or glovebox, a pile on the ground, or (for staff) another player's bag. Items are dragged between the two, used, split, sorted, handed to a nearby player or dropped. Weapons in the bag are drawn by using them; ammunition is loaded into the drawn weapon the same way. The server decides every move; the screen only sends what the player asked for. Use it whenever your code gives, takes, counts or checks items.

Containers

A container is a (kind, owner) pair. Positive id: a database row. Negative id: lives only in memory, never written.

• A vehicle nobody owns (no plate known to vehicles) gets memory-only storage that lives as long as the vehicle.
• TRUNK_OWNER_ONLY (default true) refuses an owned trunk to anyone but its owner, with not_yours.
• A locked vehicle refuses its trunk to everyone, with locked. An open trunk closes when the vehicle is locked. The lock is the host's own lock state (Open77.vehicles.isLocked); vehiclekeys moves it. The glovebox ignores both rules: it opens only from a seat.
• Reach is measured on the server: REACH.DISTANCE to a stash, pile or player; REACH.VEHICLE from a vehicle's centre to its trunk. A second container out of reach is closed by a sweep every second.
• A pile is swept after DROPS.LIFETIME_MINUTES untouched; nothing in it survives a restart.
• A client only draws and offers the piles of its own routing bucket. The server tells it which bucket it is in (opx:net:inventory:bucket).
• Changes are written SAVE.DELAY_MS after the last change, in batches. Any number of stacks is saved (12 item rows per INSERT, at most 64 statements per transaction); a batch that fails is retried one container at a time.
• While a use handler runs, its slot is held: moving, splitting, sorting or using it again is refused with in_use, and removing by name skips it.
• An item whose use plays a timed gesture (eating, drinking) holds the next use until the gesture ends: four hotbar presses inside one bite eat one item.

Give and drop

• Count. Give or Drop on a stack of more than one opens the count dialog (Give how many? / Drop how many?), starting at 1; its button says Give or Drop and is the confirm step. A single item goes in one click.
• Who. The give list shows people within arm's reach as where they stand and how far, To your left · 1.2 m / À votre gauche · 1,2 m, with their server id (#12). Never a name: in roleplay a name is learnt by meeting someone (opx:net:inventory:nearby). Only the giver sees the list; it is fetched again every time a bag slot's card opens.
• The receiver says yes first. Give makes an offer; nothing moves yet. The giver reads You offered 2x Water. Waiting for an answer. The receiver gets a menu card (SOMEBODY HANDS YOU SOMETHING) with the item, the count and where the giver stands (To your left · 1.2 m, never a name), and picks Accept or Refuse; closing the card is a refusal.
  • The offer stands 15 s. Unanswered, it is withdrawn from the receiver's screen and the giver reads Your offer of … was not answered.
  • On Accept the server checks everything again: both players can act, they are still in reach, the same stack is still in the giver's slot, the receiver has room. Only then does the stack move: You were handed 2x Water. / the giver's success line. Notes handed over are told to both as money.
  • One offer out per giver (give_pending), one in per receiver (give_busy), 3 s between two offers from one giver. The answer counts against RATE_LIMIT. Only the receiver can answer an offer, and a replayed answer moves nothing.
  • A staff give (/opx.inventory.give) asks nobody.
• Refusals. A refused move, split, sort or drop toasts the server's reason (full trunk, no room…) once; the page's own "That did not work." is only for a timeout or a request that did not get through. The cooldown stays silent.
• Secondary panel. Its Close button closes it on the server too. A trunk shut by its lock says "That vehicle is locked."
• Money notes. You took 1,000,000 €$ out as notes. / You put 4,500 €$ in notes back in your wallet., formatted with OPX.Locale.Money; /withdraw adds no second toast (the bag's +N line leaves notes out).
• Weapons. Drawing a weapon from the bag closes the screen, as eating does; putting it away leaves it open.
• A stash loaded by name (by the stash functions) or opened by a player is saved and put away after SERVER.EXPORTS.STASHES.IDLE_MS (60 s) without use; a sweep runs every 15 s. A stash is never put away while someone has it open; its idle time counts from the last sweep that saw it open.
• Deleting a character deletes all its containers and their items.

Weight and slots

• Weight is in whole grams. A change that would pass maxWeight is refused too_heavy; one that finds no slot, no_room.
• A stackable item holds up to MAX_STACK units per slot. An ammunition slot holds at most the ammo item's AMMO.MAX (rounds per box, e.g. 500 for handgun), never above MAX_STACK.
• A non-stackable item and every weapon hold one per slot.
• Two stacks merge only when their metadata is equal.
• A stored item the catalogue no longer has weighs DEFAULT_ITEM_WEIGHT per unit.

Medical items

An item named in HEALING heals on use: the server reads the player's health and raises it by that share of the maximum, capped at the maximum.

• Refused at full health (full_health, You are already at full health.) and while down (dead): none of them revives.
• The unit is consumed only when the heal went through; nothing is used up otherwise.
• A use handler registered for the item (RegisterUsableItem) replaces the heal.

Eddies as an item

When CURRENCY is on, cash can be carried as the eddies item. The balance stays the real money; the item is a note drawn against it.

• /withdraw <amount> (or Withdraw) takes the amount from the EDDIES balance, then puts that many eddies in the bag. If the item cannot be added, the money is refunded.
• Using an eddies stack (or Deposit) removes the units, then credits the balance. If the credit fails, the units are put back.
• Shops, garages and the dealership read the balance only. Notes in a bag cannot be spent until deposited.
• eddies weighs 0 and has DROP = false: it cannot be left on the ground or put in a memory-only trunk.
• The bridge does not wire itself (boot warning) when CURRENCY.ITEM is not in the catalogue, MONEY_TYPE is not a declared money type, or there is no character contract.

Commands

Staff commands are audited (inventory.give, inventory.remove, inventory.clear, inventory.search, inventory.holders).

Keys

Players rebind them in Pause → Settings → KEY BINDINGS.

Configuration

config/inventory.lua sets OPX.Config.MODULES.inventory. Shared script. Out-of-range values fall back to the default with a boot warning.

Live tunables (operator panel): INVENTORY_SAVE_DELAY_MS (2000), INVENTORY_RATE_REQUESTS (20), INVENTORY_DROP_LIFETIME_MIN (30), INVENTORY_USE_COOLDOWN_MS (750).

Refusal codes

Toasted to the player as locale inventory.error.<code> (commands use inventory.command.error.<code>). An unknown code shows inventory.error.failed.