Installation

2 min readUpdated Today

Overview

ML PropsCarry displays weapons and props on the player's body when not in hand. Holstered weapons appear on the back, hip, or leg with correct attachments, tints, and flashlight state. Players can customize position/rotation per item via an in-game editor with 3D gizmo. Supports weapon components (scopes, suppressors, grips), multi-player sync via StateBags, and an admin config editor for adding new items in-game.

Quick Start

  1. Download from CFX Portal
  2. Extract to your resources folder as ml_propscarry
  3. Add to server.cfg:
server.cfg
1ensure oxmysql
2ensure ox_lib
3ensure ml_bridge
4ensure ml_propscarry
Load Order

ml_propscarry must start AFTER ml_bridge and oxmysql.

Database

The live admin item catalog (/carryadmin) is stored in one table, created automatically on first start:

ml_propscarry_items: Carry items added or edited live by an admin (name, prop, bone, type, male/female default offsets)

Per-Player Positions

Each player's own position tweaks are stored in FiveM KVP, not the database. They persist across restarts automatically.

Verify

After starting, items in Config.Items (and any added live via /carryadmin) appear on players' bodies when in inventory. Use /carryedit to test the player position editor and /carryadmin for the admin catalog manager.

  • Props not showing: Verify the item name in Config.Items matches your inventory item name exactly. Check that the player has the item.
  • Weapon invisible: Weapon components may need streaming. Enable Config.Debug and check F8 console for asset loading errors.
  • Position not saving: Check server console for KVP errors. Verify rate limiting isn't blocking (2s cooldown between saves).
  • Props on other players not visible: Sync range is 200m. Verify the other player's state bag is updating.