# Installation

> Setup guide for ML Display Zone

Category: ZONE DISPLAY · Source: https://miciomods.it/docs/ml-display-zone-installation · Last updated: 2026-07-09

## Overview

ML Display Zone shows an animated zone notification when players enter new areas. Supports GTA native zones, custom polygon/sphere/box zones, 5 animation styles, 5 themes, visit tracking, street names, real-world or game time, and a player settings panel for UI customization.

## Quick Start

1. Download from [CFX Portal](https://portal.cfx.re)
2. Extract to your `resources` folder as `ml_display_zone`
3. Add to `server.cfg`:

**server.cfg**

```cfg
ensure ox_lib
ensure ml_bridge
ensure ml_display_zone
```

> **WARNING:** Load Order
>
> `ml_display_zone` must start AFTER `ml_bridge`.

## Database

> **INFO:** No Database
>
> `ml_display_zone` does not create any database tables. Player settings and visit data are stored client-side using KVP (Key-Value Pairs).

## Verify

After starting, the console will print:

```lua
[ml_display_zone] Resource started
[ml_display_zone] Developed by Micio Mods | miciomods.it
```

**Troubleshooting**

- Zone notification never appears. Check `Config.DisabledZones` and verify the zone is not excluded. Ensure `Config.UseNativeZones = true` if relying on GTA zones.
- Settings command does nothing. Verify `Config.PlayerSettings.EnableSettingsCommand = true` and the command name in `Config.CommandSettings`.
- No sound on zone entry. Confirm `Config.UseSoundEffect = true` and that the sound file exists in `web/`.
- Custom zones not triggering. Verify `Config.Locations` entries have correct `type`, `coords`, and `radius`/`size`/`points`.
- Time display is wrong. If using real time, check `Config.TimezoneOffset`. If using game time, set `Config.UseGameTime = true`.