Aesir Utils Library - The Ultimate Anchoring & Positioning Tool

Stop Hardcoding Coordinates. Start using Native Math.

Every FiveM developer has faced this problem: you design a perfect HUD on your 1080p screen, but as soon as a player with a 21:9 Ultrawide monitor or a custom Safe Zone setting joins, your UI is stretched, cut off, or floating in the wrong place.

Aesir Utils Library solves this permanently.

The ultimate standalone resource for precise HUD anchoring. Synthesizing years of research into GTA V’s native Scaleform engine, this script offers the lightweight solution developers need to master screen positioning and coordinate conversion.

✨ Key Features

• Ultrawide Native Support: Automatically detects and adjusts for 21:9 and 32:9 screens. No more stretched rectangles.
• Safezone Compliance: Your UI will respect the user’s “Safe Zone” setting in GTA Options, just like the native HUD.
• Resolution Independent: Write your code once using normalized values (0.0-1.0) or pixels, and it works on 720p, 1080p, 1440p, and 4K.
• Comprehensive Converters: Easily convert between Screen Coords, Pixel Coords, and Scaleform (1280x720) Coords.

---

The “Magic Number” Problem (Why your current script is broken)

If you have been developing for FiveM for a while, you have definitely seen (or used) this function to get the Minimap position:

-- The "Old Way" found in 90% of HUD scripts
function GetMinimapAnchor()
    -- ...
    Minimap.height = yscale * (res_y / 5.674) -- ⚠️ MAGIC NUMBER
    Minimap.width = xscale * (res_x / (4 * aspect_ratio)) -- ⚠️ GUESSWORK
    -- ...
end

Why is this code “bad”?

1. Magic Numbers: Where does 5.674 come from? It’s a hardcoded value that works okay on 1080p screens but breaks mathematically on 4K, 720p, or custom resolutions.
2. No Ultrawide Logic: It treats the screen linearly. On a 21:9 monitor, this function stretches the UI or floats it in the middle of the screen because it doesn’t know how to “clamp” the 16:9 HUD space like the game engine does.
3. Fake Safezones: The math (math.abs(safezone - 1.0)) * 10 is a rough approximation. It doesn’t reflect the actual Safe Zone mechanics of the RAGE Engine.

✅ The Aesir Solution

Aesir Utils Library does not guess. This open source script has nothing to hide and shows exactly how Math can be fun and usefu when dealing with HUD positioning!

---

🚀 Installation

1. Download the resource.
2. Add ensure aesir_utils to your server.cfg.
3. Use the exports in your own scripts!

The script is open source, and protected under CC BY-NC-SA 4.0, use it as you want! As long as everything is done the way it should be and the author is credited

---

📖 Developer Guide & Examples

1. The Core Function: GetAnchorScreenCoords

This is the main tool you will use. It calculates the exact absolute screen coordinates for an element, handling all the complex math (Aspect Ratio, Safezones, Alignment) for you.

Example Usage:
You want to place a status bar on the Bottom Right, with a small margin.

local UI = exports['aesir_utils']

-- Align: "R" (Right), "B" (Bottom)
-- Offset X, Y: 0.01 (Small margin)
-- Width, Height: 0.2, 0.05
local anchor = UI:GetAnchorScreenCoords("R", "B", 0.01, 0.01, 0.2, 0.05)

-- Now you have the calculated absolute coordinates to draw your UI
DrawRect(anchor.CenterX, anchor.CenterY, anchor.Width, anchor.Height, 255, 0, 0, 255)

-- Or for NUI, pass anchor.LeftX and anchor.TopY to your Javascript
SendNUIMessage({
    type = "updatePosition",
    left = anchor.LeftX * 100 + "%",
    top = anchor.TopY * 100 + "%"
})

Gallery

The screenshot below shows a full DrawRect around the scaleform along with smaller Rects to show the main returned coordinates

It works at any resolution and aspect ratios combination
For example this one was taken on a 800 x 600 resolution with a 5:3 aspect ratio.

2. Positioning with Pixels: GetAnchorResolutionCoords

If you prefer working with specific pixel values (e.g., “I want this 20px from the left”), use this.

-- Align: Left, Top
-- Offset: 20px, 20px
-- Size: 200px width, 50px height
local anchor = UI:GetAnchorResolutionCoords("L", "T", 20, 20, 200, 50)

---

📚 API Documentation

Core Anchoring

Coordinate Converters

Useful for converting mouse clicks or specific resolution logic.

Coordinate Converters

Useful for converting mouse clicks, specific resolution logic, or drawing on the Scaleform canvas.

Every function below returns a vector2

Size Converters

Essential when calculating width/height for different rendering methods.

---

Minimap Manipulation

Directly control the game’s radar component with native-safe logic.

Download

LINK TO GITHUB

Credits:

• Special thanks to @manups4e for the original Scaleform utils research.
• @GlitchDetector - Original minimap anchor maker and inspiration.