If your WoW private server crashes on startup with errors like “Correct .map files not found in path ‘./maps'” or “VMap height checking disabled,” you are dealing with missing VMAPS and MMAPS files. I have helped our community of server admins through this exact error dozens of times, and the fix always comes down to three things: correct DataDir configuration, properly extracted map files, and matching extractor versions.
This guide covers the complete troubleshooting workflow for fixing missing maps on WoW servers running TrinityCore, Mangos, CMaNGOS, or similar emulators. Whether you are on Windows or Linux, on your first setup or migrating an existing server, the steps below will get your maps loaded and your NPCs moving properly.
Table of Contents
What Are VMAPS and MMAPS and Why Do They Go Missing?
VMAPS (Visual Maps) and MMAPS (Movement Maps) are extracted data files your WoW private server reads at runtime to handle spatial operations. Without them, your server cannot tell where buildings are, whether a creature is standing on solid ground, or how an NPC should walk around an obstacle.
Visual Maps (VMAPS) Explained
VMAPS give the server height information about terrain and the geometry of world objects like buildings, bridges, and trees. They enable collision detection so creatures do not walk through walls, fall through the floor, or get stuck inside solid objects. When VMAPS are missing, you see NPCs running in straight lines through structures instead of around them, or players falling through the world when they approach certain map features.
Movement Maps (MMAPS) Explained
MMAPS provide the pathfinding mesh that NPCs use to calculate routes across terrain. Your server uses MMAPS to answer questions like “how do I get from Stormwind to Goldshire?” or “what is the shortest path that avoids this lake?” Without MMAPS, creatures either stand completely still or take erratic paths that ignore the terrain. The mmaps_generator tool builds these files from your client data and the VMAPS files.
Common Causes of Missing Maps Errors
I have seen the missing maps error triggered by four underlying issues. The DataDir path in worldserver.conf does not point to where the extracted files actually live. The extractors themselves crashed mid-run, leaving partially built directories. The extractor version does not match the client expansion or the server core. Or the user simply forgot to run one of the three extractors (mapextractor, vmap4extractor, vmap4assembler, or mmaps_generator). Linux file permission problems round out the common causes, especially on dedicated servers running under restricted user accounts.
How to Fix Missing Maps WoW Server: DataDir Configuration
The first fix to try is the DataDir setting in worldserver.conf. This single variable tells the worldserver binary where to look for your dbc, maps, vmaps, and mmaps directories. Mismatched DataDir values cause roughly half of the missing maps errors our admin team encounters.
Locating worldserver.conf
The worldserver.conf file lives in the same directory as your worldserver.exe (Windows) or worldserver (Linux) binary. Open it with any text editor. Search for the line starting with DataDir. You will see something like DataDir = "." by default, which means the server expects the maps, vmaps, and mmaps folders to sit right next to the binary itself.
Setting the Correct DataDir Path
If you keep your extracted map files somewhere else (and most admins do, because the binary directory gets cluttered fast), update the DataDir line. For example, if your maps live in ../data relative to the worldserver binary, set DataDir = "../data". On Linux servers, an absolute path like DataDir = "/home/wow/server/data" removes any ambiguity about working directories.
Verifying Path Resolution
After saving the file, double-check the path resolves correctly. On Windows, run the worldserver from the command line (not Explorer) so the working directory is predictable. On Linux, run pwd in the terminal where you launch worldserver and confirm the relative path math. The server reads the DataDir path relative to the current working directory at startup, so a small working directory mistake turns into a confusing missing maps error.
How to Extract Maps From Your WoW Client
If the DataDir configuration checks out and you still see missing maps errors, the next step is to extract (or re-extract) the map files directly from your WoW client. The client contains all the raw data needed; the extractor tools convert it into the format the server expects.
Running the Map Extractor
Copy your mapextractor.exe (Windows) or mapextractor (Linux) binary from your server source into your WoW client directory, the same folder that contains Wow.exe. Run the extractor and wait for it to finish. It creates three new folders inside the client directory: maps, dbc, and cameras. Extraction time depends on your hardware; a modern SSD finishes in 10 to 20 minutes, while a mechanical drive can take over an hour.
Checking the Output Files
Open the maps folder after extraction. You should see thousands of .map files with numeric names. TrinityCore and Mangos servers expect these files in the maps subdirectory of your DataDir. Missing or zero-byte .map files indicate the extractor crashed before completion, which happens when disk space runs out or the client files are corrupted.
Moving Files to the Correct Directory
Move (or copy) the maps and dbc folders to the directory specified by DataDir in your worldserver configuration. The cameras folder is optional for most modern cores but does not hurt to include. After moving, confirm your layout looks like this: [DataDir]/maps/0000000.map, [DataDir]/dbc/Spell.dbc, and so on.
VMap Extraction and Assembly Process
Visual maps require two steps: extraction and assembly. Skipping the assembler step is one of the most common reasons the worldserver logs “VMap height checking disabled” and shuts down.
Running vmap4extractor
Copy vmap4extractor.exe from your server source into the WoW client directory, the same place you ran mapextractor. Run it and let it finish completely. It creates a Buildings folder containing raw model data. Interrupting this step leaves you with an incomplete Buildings folder, which you should delete entirely before re-running.
Assembling VMap Tiles with vmap4assembler
Once vmap4extractor completes, run vmap4assembler.exe from the same directory. This tool takes the raw Buildings data and assembles it into the tile-based structure the server reads. The assembler creates a new vmaps folder containing .vmtree and .vmtile files. Without this step, you have raw data the server cannot use, which is why so many admins see “VMap height checking disabled” even after running the extractor.
Placing the VMap Directory Correctly
Move the assembled vmaps folder into your DataDir so the layout matches the maps and dbc folders. You can now safely delete the Buildings folder from your client directory to save disk space. The vmaps folder is what the server references, not the raw Buildings data.
How to Generate MMap Files for Pathfinding
Movement maps are generated from both the client data and the assembled VMAPS. The generation step is the longest of the three, but it runs unattended once started.
Running mmaps_generator
Copy mmaps_generator.exe into your WoW client directory and run it. It creates a mmaps folder and begins building the movement mesh. Full generation typically takes 2 to 6 hours depending on hardware, expansion, and whether you include the hardest mesh settings. TrinityCore recently added a “parallel” build option that cuts this time by 50 to 70 percent on multi-core machines.
Linux vs Windows Generation Differences
On Linux, the mmaps_generator binary requires read access to your client files and write access to the output directory. If your WoW client lives under a different user account than the generator, run the generator as the same user or pre-set permissions with chmod -R. Windows users typically avoid permission issues but should run the generator from a path without spaces or special characters.
Verifying Successful MMap Generation
When mmaps_generator finishes, you should see an mmaps folder containing numbered subdirectories (like 000, 001, etc.), each filled with .mmtile files. Move this entire mmaps folder into your DataDir. If the generator crashes partway, simply delete the partial mmaps folder and re-run, picking up from a clean slate.
Common VMAPS and MMAPS Errors and Their Fixes
After helping hundreds of admins troubleshoot these errors, I have noticed the same handful of messages appear over and over. Here is how to handle the most common ones.
“VMap height checking disabled” Error
This message means the server loaded but cannot read your VMAPS files. Check three things. First, confirm the vmaps folder is inside your DataDir, not at the client directory or some other location. Second, confirm you ran vmap4assembler after vmap4extractor, not just the extractor alone. Third, verify the vmtree and vmtile files exist and are not zero bytes. If the files look correct and the error persists, your extractor version does not match your client expansion. Re-download the extractors from your server core’s official source to fix the mismatch.
“Correct .map files not found” Error
The worldserver looks for .map files in a specific subdirectory and reports this error when it cannot find them. The fix is usually one of two things. Either DataDir points to the wrong directory, or your extraction was incomplete. Re-check DataDir first because configuration mistakes are easier to fix than re-running a 30-minute extraction. If DataDir is correct, delete the partial maps folder and re-run mapextractor.
Linux Permission Troubleshooting
On Linux, the server can locate the files but still fail to read them when file permissions block access. Run ls -la on your DataDir. The user running worldserver needs at least read access to all map files. Use chmod -R 755 /path/to/data for typical setups, or chown -R wowserver:wowserver /path/to/data if you want to lock down ownership. Sticky bits and ACLs are usually unnecessary; standard Unix permissions work fine for WoW server file structures.
How to Verify Your Map Files Are Working?
After completing all extractions and placing files in DataDir, restart the worldserver and watch the startup log carefully. A successful map load shows lines like “Loading maps… loaded N map tiles” and “VMap loaded.” If you see those messages, the visual maps are working.
Server Startup Log Checks
Look for explicit “VMap height checking disabled” or “MMAP disabled” messages in the log. These indicate either the files are missing or path resolution failed. Successful map loading produces a count of loaded tiles that should match or exceed the expected count for your expansion. For Wrath of the Lich King, you should see well over 100,000 tiles loaded. Lower counts suggest partial extraction.
In-Game Verification Steps
Log in and walk around a city like Stormwind or Orgrimmar. With VMAPS working, creatures and players cannot walk through buildings. Try using a grappling hook or blink ability near terrain edges; with MMAPS working, your character should navigate the path correctly. Spawn an NPC far from its spawn point and watch whether it takes a sensible route. If NPCs get stuck against invisible walls, MMAPS is probably incomplete or missing.
FAQs
How do I fix the VMap height checking disabled error on WoW server?
The VMap height checking disabled error means your vmaps folder is missing, incomplete, or in the wrong location. Run vmap4extractor followed by vmap4assembler from your WoW client directory, then move the resulting vmaps folder into the directory specified by the DataDir setting in worldserver.conf.
Where do I put map files in TrinityCore?
Map files go in the directory set by the DataDir variable in worldserver.conf. By default this is the worldserver binary directory. Place your extracted maps, vmaps, mmaps, and dbc folders directly inside that DataDir path so the server can read them at startup.
Why is DataDir important for WoW server configuration?
DataDir tells the worldserver where to find dbc, maps, vmaps, and mmaps folders. If DataDir points to the wrong path, the server cannot locate your map files and shuts down with missing maps errors. Always use a clear absolute path on Linux to avoid working directory confusion.
How long does mmaps generation take?
Full mmaps generation takes 2 to 6 hours on most hardware, depending on expansion and mesh settings. Modern TrinityCore cores offer a parallel generation mode that cuts the time by 50 to 70 percent on multi-core machines. Plan to run the generator overnight or while you handle other server setup tasks.
Can I delete the Buildings folder after extracting vmaps?
Yes. The Buildings folder contains raw data produced by vmap4extractor. Once vmap4assembler finishes building the final vmaps folder, the Buildings folder is no longer needed. Deleting it frees several gigabytes of disk space and prevents confusion about which folder the server actually uses.
Final Thoughts on Fixing Missing Maps on WoW Servers
Learning how to fix missing maps WoW server errors comes down to a repeatable checklist. Verify your DataDir in worldserver.conf points to the directory holding your dbc, maps, vmaps, and mmaps folders. Run the three extractors in order: mapextractor, vmap4extractor with vmap4assembler, then mmaps_generator. Use extractor versions that match your client expansion and server core. On Linux, confirm the worldserver user has read access to all extracted files.
If you have followed this guide and still see errors, the next step is checking your server core’s issue tracker and community forums for version-specific problems. The errors covered here account for the vast majority of missing maps cases our admin team sees, but specific expansion versions occasionally introduce new quirks that need project-specific fixes.