# F.A.Q

> Frequently asked questions for ML LootZones

Category: LOOT ZONES · Source: https://miciomods.it/docs/ml-lootzones-faq · Last updated: 2026-07-28

## Setup

**How do I change the language?**

**shared/config.lua**

```lua
Config.Language = 'en'
```

**Why is the target not showing on a prop?**

1. Confirm `ox_target` or `qb-target` is running
2. The player must be within `Config.Settings.InteractionDistance`
3. Verify the zone is inside the player's render distance

**Why is the admin panel not opening?**

1. Admin permissions are required (ace perms or framework admin group)
2. Wait for `Loot active. Loaded` in console before using `/mlloot`
3. Check the F8 console for interface errors

**Why are props not spawning in the zone?**

1. Make sure "Spawn Props" is enabled in the zone configuration
2. Verify valid prop models are assigned to the zone
3. Check the density warning, the zone may be too small for the configured prop count

## Creation

**Can I place props manually?**

Yes. Open the creator, enter a zone, and use the prop placement tools. Fixed props spawn at exact coordinates. Dynamic props spawn randomly inside the zone radius each regeneration cycle.

**How does dynamic spawning work?**

When "Dynamic Props Count" is set to X, the script randomly picks X props from the selected list and scatters them inside the zone radius. They respawn in different locations when the zone regenerates.

**What are loot boxes?**

When a zone is configured to use loot boxes, looting a prop opens an `ox_inventory` stash instead of giving items directly. Stash size is configured in `Config.Stash`.

## Zones

**How does zone rotation work?**

Zones grouped under a category cycle between active and inactive. The category sets how many zones stay active at once (a minimum and maximum count) and reshuffles them on a random timer between two values. A category set to **Always Active** keeps every zone on and only refreshes their loot each cycle.

**Why is loot disabled right after a server restart?**

The Dynamic System has a startup delay. On every server start, zones stay disabled for a random time between a minimum and maximum, set in the **Settings** tab. This stops the first players online from clearing every known spot. Set both values to `0` to remove the delay.

## Cooldowns

**What is the difference between zone and prop regeneration?**

**Zone regeneration:** The entire zone resets. All props re-roll positions (if dynamic) and loot tables.

**Prop regeneration:** When a player loots a specific prop, only that prop goes on cooldown. Other props remain available.

**What is the difference between global and personal cooldown?**

**Global:** One player loots a prop, ALL players must wait before it can be looted again.

**Personal:** Each player has their own timer for that prop.

## Minigames

**What minigames are available?**

Built-in `ox_lib` skill checks (4 difficulties) are always available. Optional resources add more options:

- `bd-minigames`: Lockpick (easy/medium/hard), thermite
- `ps-ui`: Scrambler

Minigames are selected per-zone or per-category in the admin panel.

## Progression

**How do I give XP for looting?**

Install `ml_skills` and start it before `ml_lootzones`. In the loot editor, open a prop and assign an XP amount and a target skill or category. Each successful loot grants that XP. `Config.Skills.MaxXpPerLoot` in `server/config_server.lua` caps the amount per loot.

**Can I lock loot behind a skill?**

Yes. Assign a required skill to a prop in the editor. Players who have not unlocked that skill in `ml_skills` cannot loot it, and the check is enforced on the server. Props with no required skill stay open to everyone.

**What happens without ml_skills installed?**

Looting works normally. No XP is awarded and skill requirements are ignored. The integration is a clean no-op, nothing errors.

## Updates

**How do I update the script?**

1. Download latest from CFX Portal
2. Backup `shared/config.lua` and `server/config_server.lua`
3. Replace all files except config
4. Restart the resource

Zones, categories, and placements are stored in the database and survive updates.