Installation

2 min readUpdated 3 weeks ago

Overview

ML LootProps turns any GTA world prop or dead ped/animal into a lootable object. Supports weapon-based kill rewards (different loot per weapon for hunting), tool requirements with durability, minigame locks, dispatch alerts, no-loot zones, loot box stashes, and optional ml_skills XP rewards. All configured through an in-game admin panel.

Quick Start

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

ml_lootprops must start AFTER ml_bridge. Incorrect order causes startup errors.

Database

Auto Import

All tables are created on first startup. No SQL to run manually.

The script auto-creates these tables:

  • ml_lootprops_configs: Prop configurations
  • ml_lootprops_categories: Loot categories
  • ml_lootprops_settings: Global settings
  • ml_lootprops_noloot_zones: Restricted loot areas

Verify

Start the server and check for:

lua
1[ml_lootprops] [INFO] Database tables verified/created successfully
2[ml_lootprops] [INFO] ML LootProps initialized

Open the admin panel:

lua
1/mllootprops
Admin Access

Requires admin permissions through your framework (ace perms for QBCore/QBox, admin group for ESX).

  • Script not starting. Verify all dependencies are running. Check ensure order in server.cfg.
  • Admin command not working. Confirm admin permissions in your framework. Check console for permission errors.
  • Prop not lootable. Open the admin panel and verify the model hash is configured with loot tables.
  • Dead ped not showing target. The scanner only detects dead non-player peds. Verify the ped model is configured.