​

Map

Config.map = {
    image       = 'assets/map.png',
    aspectRatio = { width = 1600, height = 2400 },
    worldBounds = { minX = -4279, maxX = 4966, minY = -5173, maxY = 8456 },
}

​

Swap the atlas

​

Replace in place

​

Or use a different file path

Config.map.image = 'assets/my-custom-map.png'

​

Or host externally

Config.map.image = 'https://your-cdn.com/map.png'

​

Match the aspect ratio

Config.map.aspectRatio = { width = 1024, height = 1024 }

​

Calibrate pin positions

Config.map.worldBounds = { minX = -4279, maxX = 4966, minY = -5173, maxY = 8456 }

1. Pick a known landmark (e.g. LSIA at (-1037, -2737)).
2. Compare where its pin lands vs where you can see it on the image.
3. Nudge:
   • Pin too far left → decrease minX and maxX
   • Pin too far right → increase both
   • Pin too high → increase minY and maxY
   • Pin too low → decrease both
4. Repeat with a landmark in a different corner. If that one’s off, narrow or widen only the X or Y range.

​

Calibration wizard

• Single-click any empty spot on the map → prints a pin = { x = %, y = % } snippet for that spot
• Two-point wizard — click Legion Square, then Sandy Shores → computes a full worldBounds block ready to paste

​

Cache note