🗺️ LMX Minimap Creator

The first visual, in-game minimap editor for FiveM. Open it with /minimap, design your map (zones, labels, postal codes, custom imagery), hit Export, restart the server — your custom minimap is live. No CodeWalker. No Folders2YTD. No external tools.

🔧 Core Features

🖌️ In-Game Visual Editor

• Pan, zoom, drag, undo/redo — feels like a real graphics tool, not a config file
• Multi-layer system (base, zones, streets, icons, masks, custom layers)
• Live preview of every change at any zoom level
• Properties panel on the right with full per-element controls

🧩 Multiple Built-In Tile Sets

• Stock GTA V minimap
• Oulsen Satmap (satellite view, MIT-licensed)
• Kustoms Postal Code Map
• Oulsen Satmap (no postals — clean satellite imagery)
• Switch sets live in the toolbar — no restart needed
• Imported tile sets: drop any minimap_sea_*.ytd pack into import/<MapName>/ and it auto-discovers on resource start

🪄 Built-In YTD Exporter

• Writes drop-in minimap_sea_*.ytd + minimap_*.ytd files directly into the resource's stream/ folder
• BC3 (DXT5) compression, 1024 or 4096 per tile (auto-detect from source)
• LOD tile (minimap_lod_128.ytd) generated automatically
• Plus 65 YDD drawable stubs that suppress the vanilla 3D map

🎨 Quick Edit (Q)

• Drag a rectangle over a baked-in label
• Auto-samples the surrounding background color so your mask blends invisibly
• Type your replacement text → done in one motion
• Perfect for replacing postal codes / street names on baked-label tile sets

🩹 AI Heal Tool (H)

• Paint over an unwanted feature on the base tile
• ONNX in-paint model fills it with surrounding terrain (roads, water, grass)
• Local inference — no API calls, no per-use costs
• Model auto-fetched on first use (~49 MB, cached forever after)

📍 One-Click Generators

• Defaults — populates every canonical GTA V zone label
• Streets — drops every major street name in the right place
• Postals — every postal number across the map

🖼️ Image Paste (Ctrl+V)

• Paste any image from your clipboard onto the canvas
• Move, resize, rotate, restyle
• Auto color-match button shifts the image's tone toward the surrounding map (one-click "make it look native")

💾 Project Save / Autosave

• Name your projects, switch between drafts
• Autosave every 2 minutes
• "Restore Autosave" button in the load dialog brings back your last 2-minute snapshot if the editor closes unexpectedly

🌐 Lightweight Footprint

• Base PNG tiles + AI heal model are pulled from a CDN on first use
• Resource folder stays under 10 MB instead of 350 MB
• Per-server cached forever after first fetch

📦 Framework & Compatibility

Auto-detects your framework on startup — no config edit needed.

🔗 Dependencies

None. Fully standalone. No ox_lib, no ox_target, no MySQL, no inventory dependency. Drop the folder in, add ensure, you're done.

⚙️ Technical Specs

• Idle CPU: 0.00 ms client / 0.00 ms server
• Editor active: ~0.05 ms client (only while NUI focused)
• Export size: ~5 MB per tile (1024) or ~21 MB per tile (4K)
• Network: chunked latent events for tile uploads — bandwidth-capped + serialized so it doesn't hitch your server during export
• Texture format: RAGE-native YTD with BC3 (DXT5) compression, exact spec match to vanilla GTA tiles
• NUI tech: pure JS canvas, custom YTD writer, no external libraries on hot paths

📋 What's Included

• 4 bundled base tile sets (Vanilla, Satmap, Postal, Satmap-No-Postals)
• Built-in YTD writer
• AI heal tool
• Documentation: in-resource readme.md + online docs
• Discord support

🔑 Permissions

Grant editor access via ACE in server.cfg:

add_ace identifier.steam:11000010ABCDEF lmx_minimap.editor allow

…or rely on framework admin groups (ESX admin/superadmin, QBCore/Qbox admin/god) — fully configurable.

🚀 Installation

1. Drop lmx_minimapcreator/ into your [standalone]/ resources folder
2. Add ensure lmx_minimapcreator to server.cfg
3. Add an add_ace line for your admin's identifier
4. Restart server, run /minimap in-game, design your map, hit Export
5. Restart the server one more time → custom minimap live for everyone

Full guide, troubleshooting, and keyboard shortcuts: lmx-development.gitbook.io

💬 Support

Join the LMX Development Discord — I personally answer support tickets, take feature requests, and post update news.