Installation

2 min readUpdated 2 days ago

Overview

Props Carry shows weapons and props on the player's body when they are not in hand. A slung rifle sits on the back, a pistol on the hip, a bag on the leg, each with the attachments, tint and flashlight state the weapon actually has. Positions are set from inside the game: staff build the defaults with /carryadmin, every player fine-tunes their own with /carryedit, and what a player carries is visible to the players around them.

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:

Table — Purpose

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.