F.A.Q

Set Config.Locale in shared/config.lua:

1Config.Locale = 'en'

Add an entry to Config.Items with the item name, prop model, bone hash, and default positions for male/female:

1{
2    name = 'my_item',
3    prop = 'prop_my_model',
4    bone = 24818,
5    isWeapon = false,
6    defaultPosition = {
7        male   = { x = 0.0, y = 0.0, z = 0.0, rx = 0.0, ry = 0.0, rz = 0.0 },
8        female = { x = 0.0, y = 0.0, z = 0.0, rx = 0.0, ry = 0.0, rz = 0.0 },
9    },
10}

Or use /carryadmin in-game to add, edit or remove items visually. Catalog changes apply to every player live with no restart, and persist in the database.

Yes. /carryadmin opens the catalog manager. It lists every carry item (config and live), and lets you add a new one, re-edit an existing one's position with the 3D editor, or delete a live one. Saves write to the ml_propscarry_items table and reach every connected player at once, without a restart.

Anyone your framework treats as an admin, read through ml_bridge. On standalone there is no framework check, so grant access in open/server.lua with Handlers.IsAdmin, for example through an ACE.

Use /carryedit [itemName]. A 3D gizmo appears on the prop: drag the arrows to move it, grab the rings to rotate it, and orbit the camera to check it from every side. Save or cancel from the editor panel. Positions are stored per player on the server.

Click Reset to Default in the /carryedit editor and confirm, or run /carryreset [itemName]. Both delete the player's saved position, and the prop goes back to the current default, including one an admin set later with /carryadmin.

Yes, when Config.WeaponComponents = true. Scopes, suppressors, grips and other attachments come from the item metadata and show on the holstered weapon.

The script reads the attachment and tint metadata of each inventory ml_bridge supports. If an inventory stores nothing on the weapon, it shows without attachments.

Yes, when Config.FlashlightPersist = true. The on/off state is tracked per weapon serial number and preserved across holster/draw cycles.

Yes. Props sync to players within 200 meters through state bags. Other players see the same props with the same positions.

Yes. Up to 20 items per player are synced to other players.

1. Download latest from CFX Portal
2. Backup shared/config.lua
3. Replace all files except config
4. Restart the resource

Player positions are stored in KVP and the live catalog in the ml_propscarry_items table: both survive updates, nothing to migrate.