# Installation

> Setup guide for ML PropsCarry

Category: ITEM CARRY · Source: https://miciomods.it/docs/ml-propscarry-installation · Last updated: 2026-07-28

## 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](https://portal.cfx.re)
2. Extract to your `resources` folder as `ml_propscarry`
3. Add to `server.cfg`:

**server.cfg**

```cfg
ensure oxmysql
ensure ox_lib
ensure ml_bridge
ensure ml_propscarry
```

> **WARNING:** 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)

> **INFO:** 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.

**Troubleshooting**

- 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.