How to Add an MLO to Your FiveM Server
Adding a custom MLO (Map Location Object) to your FiveM server replaces or adds a new interior or exterior map location, such as a police station, nightclub, or player housing. This guide walks you through the exact steps to get your MLO running on your server, from downloading the files to verifying it in-game. You’ll need basic file management skills and access to your server’s files.
What You’ll Need
- A FiveM server (either hosted or local) that you can access via FTP or a file manager.
- An MLO file pack (usually a .zip or folder containing .ytyp, .ymap, and sometimes .ybn files).
- A text editor like Notepad++ or VS Code (for editing server.cfg).
- Optional: a FiveM artifact (server build) that supports the MLO format (most modern builds do).
Step-by-Step
- Download the MLO files. Get the MLO pack from a trusted source (e.g., a FiveM forum or a paid creator). Make sure it’s compatible with your server’s game build (e.g., 1604, 2189, etc.).
- Extract the files. Unzip the MLO pack to a folder on your computer. You should see a folder containing at least a .ytyp file and .ymap files, and often a folder named
streamormaps. - Rename the folder (optional but recommended). Rename the main folder to something descriptive like
mlo_police– this makes it easier to manage multiple MLOs. - Upload the folder to your server. Using FTP (FileZilla) or your hosting panel’s file manager, navigate to your server’s
resourcesdirectory (usually/resources/or/resources/[local]/). Upload the entire MLO folder there. - Create a resource file (if not included). Inside the MLO folder, check for a
fxmanifest.luafile. If it’s missing, create a new text file namedfxmanifest.luaand add the following basic content:fx_version 'cerulean' game 'gta5' this_is_a_map 'yes'
If the MLO includes custom scripts (e.g., for doors or props), you may need to add
client_scriptsandserver_scriptslines, but most map-only MLOs just need thethis_is_a_mapline. - Ensure the folder structure is correct. The .ytyp and .ymap files should be placed inside a
streamsubfolder within the resource folder. If they’re loose in the root, move them into astreamfolder. Example:resources/mlp_police/stream/. - Add the resource to your server.cfg. Open your
server.cfgfile (usually in the server root). Add a line to start the resource. Useensureorstart(depending on your server version). For example:ensure mlo_police. - Restart your server. Restart the server completely (not just a resource restart) to load the new map. If you’re using a hosting panel, click the restart button. If local, stop and start the server process.
- Verify in-game. Join your server and teleport to the MLO’s coordinates (if known) or use a map editor to find it. If the MLO doesn’t appear, check the server console for errors.
- Test for collisions and props. Walk around the MLO to ensure walls, floors, and objects are solid. If something is missing, the MLO may require additional files or a different game build.
Common Mistakes
- Missing
fxmanifest.lua: Without this file, FiveM won’t recognize the resource. Many MLOs include it, but some don’t. - Wrong folder structure: Placing .ytyp files outside the
streamfolder can cause the map to not load. - Using
startinstead ofensure: While both work,ensureis the modern standard and avoids conflicts. - Forgetting to restart the server: A simple resource restart often won’t load new map files; a full server restart is required.
- Game build mismatch: An MLO built for an older game build may not work on newer servers. Check the MLO’s description for compatibility.
Tips
- Use a version control system: Keep a backup of your server files before adding MLOs, so you can revert if something breaks.
- Test on a local server first: If you have a local test server, try the MLO there before uploading to your live server.
- Check for dependencies: Some MLOs require additional resources (like a custom stream folder or a specific game build). Read the MLO’s documentation.
- Use a map editor: Tools like CodeWalker can help you preview the MLO and get exact coordinates for teleporting.
- Keep resources organized: Put all MLOs in a subfolder like
[maps]to keep your resources tidy.
Troubleshooting
MLO doesn’t appear in-game: Check the server console for errors like “Failed to load map” or “Unknown map”. Common causes: missing fxmanifest.lua, incorrect folder structure, or the resource not being started. Verify the resource is listed in server.cfg and that the path is correct.
Game crashes when loading the MLO: This often indicates a corrupted file or a game build mismatch. Re-download the MLO and ensure it’s compatible with your server’s game_build setting in server.cfg.
MLO loads but objects are invisible or missing: The MLO may rely on additional asset files (like .ydr or .ytd) that are missing. Check the MLO folder for a stream subfolder with all required files. If the MLO uses custom textures, they must be in the same stream folder.
Collision issues (walking through walls): Some MLOs have separate collision files (.ybn). Ensure they are included and placed in the stream folder. If not, the MLO may be incomplete.
Resource fails to start: Look at the console for a specific error message. It might be a syntax error in fxmanifest.lua or a missing dependency. Double-check the file for typos.
Frequently Asked Questions
Q: Do I need to convert MLOs for FiveM? Most MLOs are already in FiveM-ready format. If they are in .rpf format, you’ll need to extract them using OpenIV first.
Q: Can I add multiple MLOs at once? Yes, just add each as a separate resource in server.cfg. Make sure they don’t conflict (e.g., two MLOs replacing the same location).
Q: How do I find the coordinates of an MLO? Use a map editor like CodeWalker or use in-game commands (if you have a teleport admin menu) to fly around and note coordinates via the debug HUD.
Q: Will an MLO work on any server? It depends on the game build. Older MLOs may not work on newer builds. Check the MLO’s requirements and your server’s game_build.
Q: Can I remove an MLO later? Yes, simply remove the ensure line from server.cfg and delete the resource folder. Restart the server to revert.
Q: What if the MLO includes a script (like doors)? The fxmanifest.lua will need to include client_scripts and server_scripts lines pointing to those script files. Follow the MLO’s instructions.
Related
Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.