> For the complete documentation index, see [llms.txt](https://rickys-organization-6.gitbook.io/hwc-documentions/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rickys-organization-6.gitbook.io/hwc-documentions/bl-blips.md).

# BL Blips

### 📥 Downloading Your Resource

After purchasing **BL Blip Creator**, you must download it via the **CFX Portal**:

1. Go to: <https://portal.cfx.re/>
2. Log in with your purchase account
3. Open:

```
Granted Assets
```

4. Find:

```
BL Blip Creator
```

5. Click **Download**

***

### 📂 Installing The Resource

#### 1️⃣ Extract The Download

* Extract the `.zip` file
* You will get a folder:

```
BL_Blip_Creator
```

***

#### 2️⃣ Add To Your Server

Place it inside your resources folder:

```
resources/[standalone]/BL_Blip_Creator
```

***

#### 3️⃣ Start The Resource

Add this to your `server.cfg`:

```
ensure BL_Blip_Creator
```

***

#### 4️⃣ Restart Your Server

***

### ⚙️ Configuration

This resource is **fully plug & play** — no setup required.

***

#### 🗂️ Categories System

controlled in:

```
config.lua
```

```
Config.EnableCategories = true
```

If enabled:

* Blips are grouped into categories in the UI

If disabled:

* Uses a simple flat list

***

#### 📁 Default Categories

You can edit categories here:

```
Config.Categories = {
    { id = 'general', name = 'General', icon = 'fa-map-marker-alt' },
    { id = 'transport', name = 'Transportation', icon = 'fa-car' },
    { id = 'services', name = 'Services', icon = 'fa-briefcase' },
    { id = 'shops', name = 'Shops', icon = 'fa-shopping-cart' },
    { id = 'entertainment', name = 'Entertainment', icon = 'fa-gamepad' },
    { id = 'government', name = 'Government', icon = 'fa-landmark' },
    { id = 'emergency', name = 'Emergency', icon = 'fa-exclamation-triangle' },
    { id = 'other', name = 'Other', icon = 'fa-question-circle' }
}
```

You can:

* Rename categories
* Add new ones
* Change icons

***

### 🎮 How To Use

Open the blip creator menu in-game using:

```
/blips
```

***

#### 💡 What The Resource Does (V1)

* Create custom blips on the map
* Assign them to categories
* Save them (stored in `blips.json`)
* Manage them through the UI

***

### 📁 Data Storage

All created blips are saved in:

```
BL_Blip_Creator/blips.json
```

👉 This means:

* Blips persist after restart
* No database required

***

### ⚠️ Important Notes

* Do NOT rename the resource
* Make sure `blips.json` has write permissions
* Resource is standalone (no framework required)

***

### ✅ Done

Your **BL Blip Creator** is now installed and ready to use.