Upgrading to 1.8

Upgrading to 1.8

1.8 makes every default match ox_inventory's: the keys, the hotbar, ammunition, money, markers, drops, shops and item use. A fresh install needs nothing from this page. A server that is updating should read it once, before players join.

In this order

1. Ammunition: boxes become rounds

One ammo item is now one round (Config.Ammo.mode = 'single', as in ox). What a server already holds was stored as boxes, so on the first start the console prints a red block and loading and adding ammunition is held until it is settled — nothing can be spent at the wrong rate in the meantime.

invammoconvert            dry run: every stack, what it becomes, bags that end up heavy
invammoconvert confirm    convert (server empty; add `online` to run it with players on)

confirm writes ammo_before_convert_<time>.json first — put one container back with invrestore <file> <id> confirm — then multiplies every stored stack by the rounds one box held (ammo_pistol 24, ammo_smg / ammo_rifle 30, framework ammo Config.Ammo.boxSize). It refuses a second run. If it is interrupted, running confirm again finishes only what it had not reached.

• Already ran single mode before: invammoconvert skip records it and converts nothing.
• Keeping boxes: set Config.Ammo.mode = 'box'; nothing is converted or held.

Converted bags weigh more — 250 boxes of 9mm are 6,000 rounds, 42 kg. Nothing is lost; an overweight bag takes nothing more until it is lighter.

2. Values saved from the admin panel

A setting saved from the panel wins over shared/config.lua, so it keeps its old value after the update.

invsettings                 lists every panel value and what the file says
invsettings clear <path>    returns one to the file's (new) default
invoverride                 item fields changed from the panel (use time, cooldown, portions)

Likely ones: Hotbar.mode, Drop.maxWeight, Give.playerList, Search.*, Consume.*, Shops_Restock.every, and the dumpster values (PropPoints.dumpster.*, the Dumpsters tab).

3. Stash expiry

As in ox (inventory:clearstashes), stashes and evidence lockers nobody has changed for 6 months are deleted when the resource starts. The first start after the update only counts them and prints the number; deleting begins with the next start. Player bags, worn kit, boots, gloveboxes, bags and placed objects are never touched. Config.ClearStashes = false keeps everything.

4. Keys

Every player's inventory keys are reset once: F2 opens, K opens what is in front of you, TAB shows the quick slots. FiveM keeps a player's key for a binding forever, so the bindings were renamed to reach players who already joined. Players who had moved them set them again under Settings > Key Bindings > FiveM. Quick-slot keys 1-5 keep theirs.

5. Money

Money is an item by default (Config.Money.mode = 'mirror'). A server that ran framework has loose cash in bags that is in no wallet — looted, handed over, given by an admin. The first time the mirror sees each character, that cash is added to the account once instead of being replaced by it; the console names each character. A server whose mirror already ran is recognised from its ledger and left as it was. invmoneyadopt cash on|off overrides that decision.

What players will notice

Bringing an old behaviour back