# Dependencies

> Required resources, framework and inventory setup, and minimap compatibility.

Category: CARTOGRAPHY · Source: https://miciomods.it/docs/ml-custommap-dependencies · Last updated: 2026-10-05

## Required resources

- `ml_bridge` handles player identity, inventory access, usable items, permissions and 3D waypoints.
- `ox_lib` provides keybinds, notifications, model loading and clipboard access.
- `oxmysql` stores map annotations and discovered areas in MySQL. It is required in both storage modes.

## Framework and inventory

Use the framework and inventory supported by your `ml_bridge` installation. Start those resources before `ml_bridge`. Map items must be registered in the inventory before players can use them.

For QBCore, start `qb-core`; for Qbox, start `qbx_core`; for ESX, start `es_extended`. A standalone setup needs the corresponding player and inventory support in `ml_bridge`.

**server.cfg**

```cfg
ensure oxmysql
ensure ox_lib
ensure ml_bridge
ensure ml_custommap
```

## Minimap and HUD

The circular minimap and its border run inside `ml_custommap`. They do not require `ml_hud` or a separate minimap switcher.

Set `Config.MinimapControl = false` if another resource should control minimap styling, visibility and position. The item maps, DUI mode, fog of war, compass and waypoints remain available.

When minimap control is enabled, keep other resources from replacing the same radar textures or moving its components.

## Item definitions

The package includes item examples in `_INSTALL/items.lua` and ten map icons in `_INSTALL/images`. Adapt the item definitions to your inventory format and copy the icons to its image directory.