Installation

2 min readUpdated 2 weeks ago

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
  2. Extract to your resources folder as ml_display_zone
  3. Add to server.cfg:
server.cfg
1ensure ox_lib
2ensure ml_bridge
3ensure ml_display_zone
Load Order

ml_display_zone must start AFTER ml_bridge.

Database

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
1[ml_display_zone] Resource started
2[ml_display_zone] Developed by Micio Mods | miciomods.it
  • 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.