For the complete documentation index, see llms.txt. This page is also available as Markdown.
Postal Map
🗺️ 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
Download the Map: Grab the latest version of the postal map from the official GitHub repository: Acc-Off/postal-code-map.
Install the Resource: Extract the downloaded file and place the folder into your server's resources directory.
Start the Resource: Open your server.cfg and add the following line so the map starts when your server boots:
Plaintext
(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.
Navigate to your ak47_hud resource folder.
Locate the postal.json file and open it using a reliable text editor (such as VS Code or Notepad++).
Delete the default contents completely and paste in your new postal JSON data.
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.
