{"id":193237,"date":"2025-08-18T16:30:52","date_gmt":"2025-08-18T14:30:52","guid":{"rendered":"https:\/\/fivemx.com\/?p=193237"},"modified":"2025-12-23T13:27:48","modified_gmt":"2025-12-23T12:27:48","slug":"ajuste-de-peso-do-inventario","status":"publish","type":"post","link":"https:\/\/fivemx.com\/pt\/inventory-weight-tuning\/","title":{"rendered":"Ajuste de invent\u00e1rio e peso: de items.lua para metadados"},"content":{"rendered":"\n
\n

TL;DR<\/strong>: This guide gives you production\u2011ready weight\/slot presets, item budget tables, copy\u2011pasteable items.lua<\/code> definitions (ESX\/QBCore\/ox_inventory), and safe migration playbooks between popular inventories. Use it to eliminate over\u2011encumbrance drama, stop item bloat, and keep your economy coherent.<\/p>\n<\/blockquote>\n\n\n\n

\n\n\n\n

Why inventory tuning matters<\/h2>\n\n\n\n

A stable RP economy depends on scarcity, friction, and meaningful choices. Inventory rules (slots, weight, stack limits, metadata like durability\/serials) are the levers that make those choices real. If everyone can carry everything, prices collapse and loops break. Tune inventory first, then iterate your prices, payouts, and sinks. For broader economics, see our pillar: Designing a Balanced GTA RP Economy: Prices, Sinks, Progression<\/a><\/strong>.<\/p>\n\n\n\n

\n\n\n\n

Models: Slots vs. Weight vs. Hybrid<\/h2>\n\n\n\n

Slots-only<\/strong><\/p>\n\n\n\n

    \n
  • Simple cognitive model; each item = 1 slot or defined by size classes.<\/li>\n\n\n\n
  • Weak at differentiating heavy vs. light stacks; exploits via many tiny high-value items.<\/li>\n<\/ul>\n\n\n\n

    Weight-only<\/strong><\/p>\n\n\n\n

      \n
    • Each item has a weight (usually grams). Players have maxWeight<\/code> per container. Strong realism; needs thoughtful defaults.<\/li>\n<\/ul>\n\n\n\n

      Hybrid<\/strong> (recommended)<\/p>\n\n\n\n

        \n
      • Global weight cap and<\/strong> slot cap. Prevents both micro\u2011item and mega\u2011item exploits. Works best for RP.<\/li>\n<\/ul>\n\n\n\n
        \n

        Tip<\/strong>: Keep numbers human\u2011readable. If you model in grams, use whole numbers (e.g., water = 500g<\/code>) and round player caps (e.g., maxWeight = 120,000<\/code>).<\/p>\n<\/blockquote>\n\n\n\n

        \n\n\n\n

        Default Presets (copy & adapt)<\/h2>\n\n\n\n

        Below are battle\u2011tested starting points<\/strong>. Adjust \u00b110\u201320% after a week of in\u2011city telemetry.<\/p>\n\n\n\n

        Player Inventory (on\u2011person)<\/h3>\n\n\n\n
        Server Scale<\/th>Model<\/th>Max Weight (g)<\/th>Slots<\/th>Notes<\/th><\/tr><\/thead>
        New\/Small (\u226440 pop)<\/td>Hybrid<\/td>80,000<\/td>30<\/td>Faster onboarding; fewer early pain points.<\/td><\/tr>
        Mid (40\u2013150)<\/td>Hybrid<\/td>120,000<\/td>35<\/td>Balanced for general RP; good for diverse jobs.<\/td><\/tr>
        High\u2011Pop (150+)<\/td>Hybrid<\/td>150,000<\/td>32<\/td>Tighten slots to curb hoarding; keep weight fair.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

        Vehicles (common defaults)<\/h3>\n\n\n\n
        Container<\/th>Max Weight (g)<\/th>Slots<\/th>Rationale<\/th><\/tr><\/thead>
        Glovebox<\/td>10,000<\/td>5<\/td>Small stash, encourages planning.<\/td><\/tr>
        Sedans Trunk<\/td>80,000<\/td>20<\/td>Baseline.<\/td><\/tr>
        SUV\/Van Trunk<\/td>120,000<\/td>25<\/td>Utility vehicles become meaningful.<\/td><\/tr>
        Truck (utility)<\/td>180,000<\/td>28<\/td>Logistics gameplay.<\/td><\/tr>
        Motorcycle Storage<\/td>8,000<\/td>3<\/td>Minimal pocketing.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

        Stashes & Special Containers<\/h3>\n\n\n\n
        Type<\/th>Max Weight (g)<\/th>Slots<\/th>Notes<\/th><\/tr><\/thead>
        House Stash (Tier 1\/2\/3)<\/td>120k \/ 180k \/ 240k<\/td>40 \/ 60 \/ 80<\/td>Incentivizes housing upgrades.<\/td><\/tr>
        Job Locker<\/td>80,000<\/td>20<\/td>Prevent carryover exploits.<\/td><\/tr>
        Evidence Locker<\/td>240,000<\/td>120<\/td>Admin\/LEO convenience; audit logging required.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \n\n\n\n

        Item Weight Budgets (by class)<\/h2>\n\n\n\n

        Use this to assign consistent weights. Think relative friction<\/strong> not realism.<\/p>\n\n\n\n

        Class<\/th>Examples<\/th>Suggested Weight (g)<\/th><\/tr><\/thead>
        Very Light<\/td>Lockpick blade, USB, SIM<\/td>5\u201350<\/td><\/tr>
        Light<\/td>Pistol ammo (10), bandage, snack<\/td>100\u2013250<\/td><\/tr>
        Medium<\/td>Water bottle, burger, repair kit<\/td>400\u2013800<\/td><\/tr>
        Heavy<\/td>Rifle ammo box (30), oxy tank, material crate<\/td>1,500\u20134,000<\/td><\/tr>
        Very Heavy<\/td>Weapon crate, money bag (marked)<\/td>6,000\u201312,000<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \n

        Ammo<\/strong>: Budget per unit<\/strong> for pooled stacks (e.g., 9mm = 15g<\/code> each \u2192 30 rounds \u2248 450g) or represent as boxes (e.g., 9mm box (30) = 500g<\/code>).<\/p>\n<\/blockquote>\n\n\n\n

        \n\n\n\n

        Stack Sizes & Slot Strategy<\/h2>\n\n\n\n
          \n
        • Commodities<\/strong> (food, meds): stack 5\u201320 to reduce tedium.<\/li>\n\n\n\n
        • Ammo<\/strong>: stack 30\u201360 for pistols; 60\u2013120 for rifles when boxed.<\/li>\n\n\n\n
        • Crafting Mats<\/strong>: stack 100\u2013250; keep weight meaningful.<\/li>\n\n\n\n
        • Weapons<\/strong>: stack = 1<\/code>, unique metadata (serial, durability).<\/li>\n<\/ul>\n\n\n\n
          \n\n\n\n

          Metadata Patterns (durability, serials, attachments, quality)<\/h2>\n\n\n\n

          Design metadata like a small schema. Keep fields minimal, typed, and validated.<\/p>\n\n\n\n

          Canonical Metadata Schema (recommendation)<\/h3>\n\n\n\n
          {\n  \"serial\": \"string\",          \/\/ weapon unique id\n  \"owner\": \"citizenid|identifier\",\n  \"durability\": 0.0,            \/\/ 0.0\u20131.0; decay per use\/time\n  \"quality\": 100,               \/\/ 0\u2013100; repairable threshold 25\n  \"ammo\": 0,                    \/\/ integer; weapon mags\n  \"tint\": 0,                    \/\/ integer (game tint index)\n  \"attachments\": [\"flashlight\", \"scope\"],\n  \"expiry\": 0,                  \/\/ unix timestamp; perishable items\n  \"notes\": \"\"                 \/\/ small text; avoid bloat\n}\n<\/pre>\n\n\n\n
          Durability & Decay<\/h3>\n\n\n\n
            \n
          • Weapons<\/strong>: decay 0.5\u20131.5% per magazine; jam chance <5% below 20% quality.<\/li>\n\n\n\n
          • Tools<\/strong> (lockpicks, drill): consume % on use; break at 0.<\/li>\n\n\n\n
          • Perishables<\/strong>: expiry<\/code> check at use; stale penalty or block.<\/li>\n<\/ul>\n\n\n\n
            Security & Performance<\/h3>\n\n\n\n
              \n
            • Validate metadata server\u2011side; never trust client writes.<\/li>\n\n\n\n
            • Cap metadata size (e.g., <512 bytes). Large blobs hurt save\/load and network payloads.<\/li>\n\n\n\n
            • Use enumerations for attachments and tints.<\/li>\n<\/ul>\n\n\n\n
              \n\n\n\n
              Code: items.lua<\/code> \/ item definitions by framework<\/h2>\n\n\n\n
              ESX (es_extended) example<\/h3>\n\n\n\n
              -- esx items.lua (example) \u2014 weight in grams; negative weight means not counted in legacy modes\n['water'] = { label = 'Water Bottle', weight = 500, stack = true, close = true, description = 'Stay hydrated.' },\n['bandage'] = { label = 'Bandage', weight = 150, stack = true, close = true },\n['lockpick'] = { label = 'Lockpick', weight = 50, stack = true, close = true },\n['pistol_ammo'] = { label = 'Pistol Ammo (30)', weight = 450, stack = true, close = true, description = '9mm, box of 30.' },\n['weapon_pistol'] = { label = 'Pistol', weight = 1500, stack = false, close = true, degrade = 0.01, unique = true },\n<\/pre>\n\n\n\n
              \n
              For ESX variants that still use limit<\/strong> instead of weight<\/strong>, set limit = -1<\/code> (unlimited) and switch economy balance via weight globally.<\/p>\n<\/blockquote>\n\n\n\n
              QBCore (shared\/items.lua<\/code>) example<\/h3>\n\n\n\n
              -- qb-core shared\/items.lua\n['water'] = { name = 'water', label = 'Water Bottle', weight = 500, type = 'item', image = 'water.png', unique = false, useable = true, shouldClose = true, description = 'Stay hydrated.',\n  combinable = nil },\n['bandage'] = { name = 'bandage', label = 'Bandage', weight = 150, type = 'item', image = 'bandage.png', unique = false, useable = true, shouldClose = true },\n['lockpick'] = { name = 'lockpick', label = 'Lockpick', weight = 50, type = 'item', image = 'lockpick.png', unique = false, useable = true, shouldClose = true },\n['pistol_ammo'] = { name = 'pistol_ammo', label = 'Pistol Ammo (30)', weight = 450, type = 'item', image = 'pistol_ammo.png', unique = false, useable = true, shouldClose = true },\n['weapon_pistol'] = { name = 'weapon_pistol', label = 'Pistol', weight = 1500, type = 'weapon', image = 'weapon_pistol.png', unique = true, useable = false, shouldClose = true,\n  info = { serial = '', durability = 1.0, ammo = 12, attachments = {} } },\n<\/pre>\n\n\n\n
              ox_inventory (data\/items.lua<\/code>) example<\/h3>\n\n\n\n
              return {\n  water = {\n    label = 'Water Bottle',\n    weight = 500,\n    stack = true,\n    client = { status = { thirst = 25000 }, anim = { dict = 'mp_player_intdrink', clip = 'loop_bottle' } },\n  },\n  bandage = { label = 'Bandage', weight = 150, stack = true },\n  lockpick = { label = 'Lockpick', weight = 50, stack = true },\n  pistol_ammo = { label = 'Pistol Ammo (30)', weight = 450, stack = true },\n  weapon_pistol = {\n    label = 'Pistol', weight = 1500, stack = false, allowArmed = true,\n    consume = 0, -- handled by durability system\n    ammo = { type = 'AMMO_PISTOL', count = 12 },\n    metadata = { serial = true, durability = true, attachments = true },\n  },\n}\n<\/pre>\n\n\n\n
              \n
              ox_inventory<\/strong> supports rich client\/server<\/code> behaviors in item definitions\u2014prefer built\u2011ins over ad\u2011hoc scripts to standardize behavior.<\/p>\n<\/blockquote>\n\n\n\n
              \n\n\n\n
              Hybrid Enforcement Examples<\/h2>\n\n\n\n
              QBCore container config (example)<\/h3>\n\n\n\n
              -- qb-inventory\/server\/config.lua (illustrative)\nConfig.PlayerMaxWeight = 120000\nConfig.PlayerMaxSlots = 35\nConfig.Vehicle = {\n  glovebox = { weight = 10000, slots = 5 },\n  trunk = function(class)\n    if class == 'sedan' then return 80000, 20 end\n    if class == 'suv' or class == 'van' then return 120000, 25 end\n    if class == 'truck' then return 180000, 28 end\n    return 60000, 18\n  end\n}\n<\/pre>\n\n\n\n
              ox_inventory stash setup (example)<\/h3>\n\n\n\n
              -- ox_inventory\/server\/custom\/stashes.lua\nlib.addstash('house_tier1', 40, 120000)\nlib.addstash('house_tier2', 60, 180000)\nlib.addstash('house_tier3', 80, 240000)\n<\/pre>\n\n\n\n
              \n\n\n\n
              Migration Playbooks (safe & reversible)<\/h2>\n\n\n\n
              \n
              Principles<\/strong><\/p>\n\n\n\n
                \n
              1. Snapshot DB first. 2) Migrate items\/metadata with idempotent scripts. 3) Run side\u2011by\u2011side in a staging server. 4) Provide rollback SQL.<\/li>\n<\/ol>\n<\/blockquote>\n\n\n\n
                A) qb-inventory<\/code> \u2192 ox_inventory<\/code><\/h3>\n\n\n\n
                Map fields<\/strong><\/p>\n\n\n\n