> For the complete documentation index, see [llms.txt](https://docs.gercstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gercstudio.com/other-components/minimaps.md).

# Minimaps

### Creation

To add a minimap to your game do the following:

* Add the [**Game** **Manager**](broken://pages/-Lr8UMD-DWS1nrk6KT0f) (single-player) or [**Room** **Manager**](/multiplayer/rooms.md) (multiplayer) component to your scene
* Open the <mark style="color:orange;">**Mini-map**</mark> <mark style="color:orange;">**tab**</mark> and activate the <mark style="color:green;">**"Use"**</mark> checkbox
* Place there your texture (read [**here**](/other-components/minimaps/texture-recommendations.md) about recommendations) and press the <mark style="color:orange;">**Adjust**</mark> <mark style="color:orange;">**Map**</mark> button

![](https://3854890582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lf4aWZpqUiSipiEh-D6%2Fuploads%2FoEEp2QUsw6B5RoW5Udeu%2FAdjust%20Minimap.png?alt=media\&token=c726f3eb-6b12-49ca-bc74-7569b4e7c20d)

* Now you should adjust the size, position, and rotation of the <mark style="color:green;">**"Map**</mark> <mark style="color:green;">**Example"**</mark> plane to fit your map in the scene

![](https://3854890582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lf4aWZpqUiSipiEh-D6%2F-MIzJddTigl6qnEaHgV2%2F-MJ1L4H_kAxZphQ2avWs%2Fminimap%20position.png?alt=media\&token=d340fb1a-8c3c-4d41-a96b-2bbd9edfb3e9)

* After that, the mini-map is ready and you can customize different parameters for it:

| Value                        | Meaning                                                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Rotate Mini-map**          | The minimap will rotate with the camera view                                                                       |
| **Rotate Blips**             | Opponents blips will rotate with their parents                                                                     |
| **Blips are Always Visible** | If a blip is outside the mini-map, it still visible                                                                |
| **Scale by Distance**        | If a blip is outside the mini-map, it still visible and is scaled relative to the **'Visible** **Distance'** value |

### UI Placeholder Adjustment

In the <mark style="color:green;">**UI**</mark> <mark style="color:green;">**Manager**</mark>, you can adjust a minimap placeholder and its form.

![](https://3854890582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lf4aWZpqUiSipiEh-D6%2Fuploads%2FyXNJ3p1URJiOW6Z4vzrx%2FScreenshot%202021-12-19%20at%2002.47.48.png?alt=media\&token=118adf63-e90c-40ef-ae2e-5dc710fa4d21)

### Blips

#### Characters & Enemies

You can set a blip texture for characters and enemies in the <mark style="color:green;">**Controller**</mark> and <mark style="color:green;">**AIController**</mark> scripts respectively.

![](https://3854890582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lf4aWZpqUiSipiEh-D6%2Fuploads%2FLUFWlWQRZFeT39QESb7Q%2FBlips.png?alt=media\&token=9426e1e0-7847-49af-a9ab-4d06cefbd308)

#### Pickup Items

There is the ability to set blips in the <mark style="color:green;">**Pickup**</mark> <mark style="color:green;">**Item**</mark> script (for weapons in the <mark style="color:green;">**Weapon Controller**</mark> script)

![](https://3854890582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lf4aWZpqUiSipiEh-D6%2F-MJ1L78Lta-nihiOTI6J%2F-MJ1Om213mDOFcJbgheR%2Fpickup%20items%20blips.png?alt=media\&token=7314ccfa-70b8-447f-944d-c85229cb9684)

#### Other Objects

If you need to mark any other object in your scene (a target for example) use the <mark style="color:green;">**Blip**</mark> script for that - just add it to an object and set an <mark style="color:green;">**Icon**</mark>.

<mark style="color:green;">**Use**</mark> <mark style="color:green;">**Rotation**</mark> parameter means whether the icon will rotate with the object.

![](https://3854890582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lf4aWZpqUiSipiEh-D6%2F-MJ1PwpGT252QTj1xt4R%2F-MJ1RuMe9os0cZf8b56l%2Fblip%20script.png?alt=media\&token=b8bfead4-64a7-4239-9f30-78a9cde37737)