> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rageon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Minimap

> Edit the pause menu map and the radar as one image, or generate a styled map from the Map tab.

A **Minimap** edit treats the pause menu map and the radar as a single image. You paint on it like any texture, or let Rageon draw it from the Map in a style you choose. The app writes the files; how the minimap looks and behaves in game has not been confirmed yet, so check it on your server.

A project has one minimap. Choosing **Minimap** again reopens it.

## Edit the minimap

**1. Choose Minimap**

In **New edit**, select **Minimap** under **HUD** and click **Continue**. The dialog tells you how many parts of the pause menu map it holds and the size of the image. Export also writes the radar parts from it.

**2. Paint or generate**

The stage shows the sheet with the seams between the map parts. Add layers ([Layers and tools](/projects/texturing/layers-and-tools.md)), or click **Generate from the Map** to draw it from the game map.

![Minimap stage showing the six map parts of the sheet with their seams](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/textures/texturing-minimap-stage.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=3e2773a0688f447955a0d8a2528c0596)

The minimap sheet with the seams between its parts.

The **AI** tab is not available on the minimap.

## Generate from the Map

**Generate from the Map** draws the minimap from the Map seen from above, in the style you choose, and puts the result on a new layer on top. It uses the map you generated or downloaded on this computer ([Library](/map/library.md)).

**1. Choose a Style**

Pick a preset: **Satellite**, **Game map**, **Light satellite**, **Flat colors**, **Monochrome**, **Atlas**, **Streets**, or **Gray**, or one of your own. The cards are rendered with the same preview. **Modified** appears under a card once you change its recipe. **Game map** is the default.

![Generate minimap dialog with style cards, Region, Output, and the preview grid showing Updating](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/textures/texturing-minimap-generate.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=d14621b7a3bb6af862398c5e27abf772)

Generate minimap with a style, a region, and the preview.

**2. Choose the Region**

**Whole grid** draws everything. **Tile** draws one tile. **Rectangle** draws an area you drag on the preview, or type as **Corner (px)** and **Size (px)**.

**3. Set Resolution and Quality**

**Resolution** is pixels per tile: `1×` or `2×`, `2×` by default. Quality is samples per pixel, from `1×1` to `4×4`; `3×3` is the default. Each step takes longer: `4×4` costs sixteen times `1×1`. The preview always uses `2×2`.

If the minimap is at a different resolution, the dialog warns that generating moves it to the new one and the existing layers follow.

**4. Tune the recipe (optional)**

Under **Base and satellite**, choose **Satellite** for aerial imagery or **Flat** for a land-color base. **Satellite** has **Time**, **Weather**, **Saturation**, **Brightness**, and **Contrast** controls. Tune **Land**, then enable the layers your map needs: **Relief**, **Vegetation**, **Water**, **Buildings**, **Game streets**, **Roads by class**, and **Labels**.

![Recipe sections for Water and Roads by class with colors, widths, and outline settings](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/textures/texturing-minimap-recipe.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=8406655c97cd0a2b22cad75094e7321b)

The Water and Roads by class sections open.

**5. Click Generate**

A progress bar shows elapsed time and a remaining-time estimate when available. **Cancel** requests a stop; **Canceling…** appears while it finishes stopping. On successful completion, the dialog closes and the new layer appears on top, named after the style and covering the region.

![Generate minimap dialog with a progress bar and elapsed and remaining time](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/textures/texturing-minimap-progress.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=f96e344c466105116f7a0b4cfccadbf3)

A capture in progress.

To keep a recipe on this computer, click **Save as preset**, enter a **Preset name**, and click **Save**. **Delete** removes a selected custom preset after confirmation; its recipe stays on screen until you switch styles.

> [!WARNING]
>
> Saving under an existing custom preset's name replaces that preset.

## Use it in game

Export writes pause menu textures (`minimap_sea_*.ytd`), radar textures (`minimap_*.ytd`), and radar replacements (`minimap_*.ydd`) under `stream/`. It also adds `client.lua`, which reapplies radar zoom every ten seconds. Install the resource as described in [Export a project](/projects/export.md).

> [!WARNING]
>
> Other scripts that change radar zoom can conflict with this resource. Check the radar on foot, in vehicles, and after entering or leaving interiors. For single-player installation, use only the `.ytd` files; the `.ydd` replacements depend on the FiveM script.

## Limits and plans

Generation reads the Map library on your computer, so the Map must be prepared or downloaded first. The extra map folders it can include follow your plan. If a message says the Map on your plan loads only the base game, or only some extra folders, the layers of the rest are not drawn. See [rageon.dev/pricing](https://rageon.dev/pricing).

## Troubleshooting

> **The map on this computer is not ready. Generate or download the map in the Map tab and try again.**
>
> Prepare the Map first ([Generate the map](/map/library.md)), then open **Generate from the Map** again.
>
> ![Generate minimap dialog with the message that the map on this computer is not ready](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/textures/texturing-minimap-not-ready.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=bb034f6e9b65813f960094fa57708a73)
>
> The not-ready message in the dialog.

> **The map on this computer is still being generated or downloaded in the Map tab. Wait for it to finish and try again.**
>
> Wait for the Map to finish, then try again.

> **The map on this computer is switching DLC level. Wait for it to finish and try again.**
>
> Wait for the switch to finish, then try again.

> **The Map is still closing. Wait a few seconds and try again.**
>
> Wait a few seconds, then try again.

> **The minimap is already being generated. Wait for it to finish and try again.**
>
> Only one generation runs at a time. Wait for the current one.

> **Could not read the game map's water, streets and names. … This style depends on them; Satellite without layers is still available.**
>
> The styles that draw water, streets, and names cannot run. Choose **Satellite** and switch its layers off.

> **Choose a style.**
>
> Click a style card before you click **Generate**.

> **Could not generate the minimap. …**
>
> The text after the message says what failed. Try again; if it persists, contact support.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.