bazq map

Interactive map script that allows players to use a physical map item in-game. When used, the character views a map with custom bounds and potential zones of interest.

Features

Immersive Usage

• Item Trigger: Uses the tourist_map item to trigger the view.

• Animation: Character holds a map prop (prop_tourist_map_01) with animation while viewing.

Customization

• Custom Map Support: Configurable bounds (minX, maxX, minY, maxY) to support custom map images (e.g., Cayo Perico, Liberty City).

• Zone Blips: Displays blips only when the player is within specific zones.

Installation

1

Download the resource

Download the resource.

2

Ensure resource is started

Add the following line to your server.cfg:

ensure bazq-map

3

Register inventory item

Ensure the tourist_map item is registered in your inventory (for example, ox_inventory).

Configuration

Edit config.lua to define the item name, map image, and physical bounds.

config.lua

Config = {}
Config.MapItem = 'tourist_map'
Config.MapImage = 'map.png' -- Located in html/img/

-- World to Map mapping
Config.MapBounds = {
    minX = -3000.0,
    maxX = 3000.0,
    minY = -3000.0,
    maxY = 3000.0
}

-- Visible Zones for blips
Config.Zones = {
    {
        coords = vector3(200.0, -900.0, 30.0),
        radius = 100.0
    }
}