> For the complete documentation index, see [llms.txt](https://docs.menanak47.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.menanak47.com/multi-framework/ak47_hud/postal-map.md).

# Postal Map

<figure><img src="/files/NTq1CD9vYyMXN9PM6Kpt" alt=""><figcaption></figcaption></figure>

#### 🗺️ Postal Map Installation & Configuration

The HUD is fully pre-configured to work out-of-the-box with the popular community postal map. Follow the steps below to get it running on your server.

#### 📥 Installation Steps

1. Download the Map: Grab the latest version of the postal map from the official GitHub repository: [Acc-Off/postal-code-map](https://github.com/Acc-Off/postal-code-map).
2. Install the Resource: Extract the downloaded file and place the folder into your server's `resources` directory.
3. Start the Resource: Open your `server.cfg` and add the following line so the map starts when your server boots:

   Plaintext

   ```
   ensure postal-code-map
   ```

   *(Note: Make sure the folder name in your resources directory exactly matches the name you put in your `server.cfg`)*

#### ✏️ Updating Custom Postal Data

If you decide to use a different map or have generated custom postal codes for your server, you will need to update the data file within the HUD so the on-screen location matches your map.

1. Navigate to your `ak47_hud` resource folder.
2. Locate the `postal.json` file and open it using a reliable text editor (such as VS Code or Notepad++).
3. Delete the default contents completely and paste in your new postal JSON data.
4. Save the file and restart the `ak47_hud` script on your server.

> ⚠️ Important: Ensure your new data is formatted as valid JSON before saving. A single missing comma or broken bracket in this file will cause the script to fail to read the postal codes.