# F.A.Q

> Frequently asked questions for ML Display Zone

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

## Setup

**How do I change the language?**

Set `Config.Language` to the desired locale code:

**shared/config.lua**

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

**How do I disable zone notifications for specific areas?**

Add the GTA zone code to `Config.DisabledZones`:

**shared/config.lua**

```lua
Config.DisabledZones = {
    JAIL = true,
    CHIL = true,
    AIRP = true, -- disable airport notifications
}
```

Zone codes can be found using the `/viewzonename` command with `Config.DebugMode = true`.

**How do I set up a custom font?**

Set `Config.CustomFontUrl` to a Google Fonts CDN link and add the font to `Config.AvailableFonts`:

**shared/config.lua**

```lua
Config.CustomFontUrl = 'https://fonts.googleapis.com/css2?family=Press+Start+2P&display=swap'
Config.AvailableFonts = {
    { name = 'Press Start 2P', value = "'Press Start 2P', cursive" },
    -- keep other fonts too
}
```

## Display

**How do I use game time instead of real-world time?**

**shared/config.lua**

```lua
Config.UseGameTime = true
```

This reads the GTA in-game clock instead of the server's real-world time.

**How do I shift the displayed date for roleplay?**

Use the date offset values to shift the display without affecting the actual clock:

**shared/config.lua**

```lua
Config.DateOffsetYears = -50
Config.DateOffsetMonths = 0
Config.DateOffsetDays = 0
```

Or force a fixed year entirely:

**shared/config.lua**

```lua
Config.FixedYear = 1985
```

**How do I hide the date or time from the notification?**

Toggle each part independently:

**shared/config.lua**

```lua
Config.SeeDate = false -- hide date
Config.SeeYear = false -- hide year from date
Config.SeeTime = false -- hide time
```

**Can players reposition the UI?**

Yes. Players open the settings panel with the command (default `/zonesettings`) and click the drag mode button. They can reposition and resize the display using mouse and scroll wheel.

## Custom Zones

**How do I add a custom zone?**

Add an entry to `Config.Locations` with the zone type and parameters:

**shared/config.lua**

```lua
Config.Locations = {
    {
        type = 'sphere',
        label = 'Trading Post',
        coords = vector3(100.0, 200.0, 30.0),
        radius = 25.0,
    },
}
```

Supported types: `'sphere'` (center + radius), `'box'` (center + size + rotation), `'poly'` (points + thickness).

**Do custom zones override native GTA zones?**

Yes. When a player enters a custom zone, its label takes priority over the GTA native zone label for that area.

## Integration

**How do I hide the display from another script?**

```lua
exports['ml_display_zone']:hide()   -- hide
exports['ml_display_zone']:show()   -- show again
```

**How do I show a custom notification from another script?**

```lua
exports['ml_display_zone']:showMessage('My Location', 'January 1, 2030 - 00:00')
```

The second parameter is optional. If omitted, the current time is used.

**How do I restrict which settings players can change?**

Disable specific options in `Config.PlayerSettings`:

**shared/config.lua**

```lua
Config.PlayerSettings = {
    EnableSettingsCommand = true,
    AllowFontChange       = false,
    AllowAnimationChange  = true,
    AllowSoundToggle      = true,
    AllowStreetNameToggle = false,
    AllowCoordsToggle     = false,
    AllowIconToggle       = true,
}
```

## Updates

**How do I update the script?**

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

No database, nothing to migrate. KVP data (player settings, visit counts) persists automatically on the client.