Installation

2 min readUpdated Today

Overview

ML LootZones creates dynamic loot areas where specific props spawn for players to search and collect. Zones, categories, loot tables, and prop placements are configured through an in-game admin panel. Supports category-based zone rotation, fixed and random prop spawning, tool requirements, minigames, dispatch alerts, loot box stashes, and optional ml_skills XP rewards.

Quick Start

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

ml_lootzones must start AFTER ml_bridge.

Database

Tables are created automatically on first start:

ml_lootzones_areas: Zone configurations and prop placements

ml_lootzones_categories: Loot categories and reward pools

ml_lootzones_settings: Global creator settings

ml_loot_types: Loot type definitions (fixed/probability loots)

ml_world_props: Persistent world prop configurations

ml_prop_categories: World prop category cycling rules

Verify

After starting, the console will print:

lua
1[ml_lootzones] Database initialized successfully.
2[ml_lootzones] Loot active. Loaded 0 areas.

Open the admin panel with /mlloot (requires admin permissions via your framework).

  • 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.
  • Props not spawning. Verify "Spawn Props" is enabled in the zone config and valid prop models are assigned.
  • Density warning in console. Too many props configured for the zone radius. Reduce count or increase radius.
  • Loot unavailable right after a restart. The Dynamic System startup delay is active. Wait for it to elapse, or set it to 0 in the Settings tab.