Installation

2 min readUpdated 2 weeks ago

Overview

Props Carry shows inventory weapons and props on the player's body when they are not in hand. Weapon props can display the attachments, tint and flashlight state stored for that weapon. Staff set default positions with /carryadmin, and players adjust their own with /carryedit. Nearby players see the props and their positions.

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 and female default offsets)
Per-Player Positions

Each player's own positions are stored in the server's FiveM KVP and survive restarts.

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 the server console for errors. Saves are limited to one every 2 seconds per player.
  • Props on other players not visible: Sync range is 200m. Verify the other player's state bag is updating.