2.032
63
2.032
63
MapLoaderAuto is a seamless XML map streaming engine for GTA V that automatically loads and unloads MapEditor maps based on the player’s location. Instead of forcing every custom map to stay loaded at once, MapLoaderAuto lets you build much larger worlds by streaming only the areas you actually enter. The result is a far cleaner, more hands-free way to use multiple custom districts, construction sites, gang areas, docklands, interiors, city expansions, and total conversion-style map setups.
Built for MapEditor XML files, MapLoaderAuto is designed to make map streaming feel natural. Once your zones are configured, there is no manual loading, no menu dependency, and no constant micromanagement. Drive into an area and the map loads automatically. Leave the area and it clears automatically. This makes it ideal for players building custom open worlds, Liberty City projects, district-based expansions, roleplay environments, mission areas, or large multi-map setups that would otherwise be too heavy to keep loaded all at once.
MapLoaderAuto is especially useful for creators who want to split large projects into multiple XML zones for better performance and smoother gameplay. Rather than relying on one massive file, you can organise your world into districts and let the script handle the streaming in the background. With properly tuned load and clear radii, transitions feel smooth and seamless while keeping performance far more manageable than traditional always-loaded map setups.
Beyond map streaming, MapLoaderAuto also allows creators to build their own dynamic ambient scenarios directly inside their maps. Using MapEditor XML files, you can place NPCs with weapons, behaviours, and relationships to create small world events and interactive situations. For example, you can stage drug deals happening in back alleys, armed gang gatherings, or even cash collection runs with stockade trucks that players can intercept and rob. These types of scenarios can turn simple map areas into living environments where the player can stumble across criminal activity, defend themselves, or create their own missions organically.
The mod supports automatic area-based streaming, configurable zone positions, adjustable load and clear distances, easy XML placement, and a simple INI-based setup that can be expanded with as many map zones as needed. Whether you are building a custom city expansion, a network of smaller locations, or a huge imported world, MapLoaderAuto gives you a much more practical way to run it in-game.
Key Features
Automatic loading and unloading of MapEditor XML maps
Seamless area-based map streaming
Hands-free operation once configured
Supports multiple zones and multiple XML map files
Create ambient world events using peds, vehicles, and props
Build scenarios such as gang activity, drug deals, or armoured cash transports
Ideal for large custom world projects
Helps reduce the overhead of keeping every map loaded at once
Simple INI setup with adjustable coordinates and radii
Perfect for district streaming, map packs, and total world expansions
Requirements
ScriptHookV
ScriptHookVDotNet
MapEditor
Important
MapLoaderAuto is built for MapEditor XML files. Your maps must be saved in MapEditor XML format for them to load correctly.
Once installed and configured, MapLoaderAuto allows you to build large custom environments that stream naturally into the game world, turning static map packs into living locations filled with activity and opportunity.
Installing MapLoaderAuto
Open your GTA V main directory.
Locate the scripts folder.
If the folder does not exist, create one.
Copy the following files into the scripts folder:
MapLoaderAuto.dll
MapLoaderAuto.ini
Your directory should now look like this:
GTA V
└── scripts
├── MapLoaderAuto.dll
└── MapLoaderAuto.ini
Create the Map Folder
Inside the scripts folder, create a new folder called:
MapLoaderAuto
Your structure should now look like this:
GTA V
└── scripts
├── MapLoaderAuto.dll
├── MapLoaderAuto.ini
└── MapLoaderAuto
This folder is where all of your MapEditor XML maps will be placed.
Installing XML Map Files
Place your MapEditor XML maps inside the new folder:
scripts\MapLoaderAuto\
Example:
GTA V
└── scripts
├── MapLoaderAuto.dll
├── MapLoaderAuto.ini
└── MapLoaderAuto
├── LittleItaly.xml
├── ConstructionYard.xml
├── BrokerDocks.xml
Important:
The MapFile name in the INI must match the XML filename exactly. (including .xml at the end)
Example:
MapFile=LittleItaly.xml
Configuring Map Zones
Open MapLoaderAuto.ini using Notepad.
Each map zone uses a section like this:
[Zone1]
Enabled=true
MapFile=ExampleMap.xml
X=0.0
Y=0.0
Z=0.0
LoadRadius=200.0
ClearRadius=250.0
What Each Setting Does
Enabled
Turns the zone on or off.
MapFile
The XML map file located in the scripts\MapLoaderAuto folder.
X Y Z
The centre coordinates of the map area. USE A TRAINER OR SCRIPT TO GET THE COORDINATES
LoadRadius
Distance from the centre where the map will automatically load.
ClearRadius
Distance where the map will unload after the player leaves.
Important rule:
ClearRadius must always be larger than LoadRadius
This prevents the map from constantly loading and unloading near the edge of the zone.
Adding Multiple Map Zones
You can add as many map zones as you want.
Example:
[Zone1]
Enabled=true
MapFile=LittleItaly.xml
X=3472.0
Y=-2907.0
Z=25.3
LoadRadius=70.0
ClearRadius=100.0
[Zone2]
Enabled=true
MapFile=BrokerDocks.xml
X=5185.0
Y=-3727.0
Z=10.0
LoadRadius=200.0
ClearRadius=250.0
[Zone3]
Enabled=true
MapFile=ConstructionYard.xml
X=4185.0
Y=-2031.0
Z=27.4
LoadRadius=60.0
ClearRadius=90.0
Each zone will automatically stream its XML map when the player enters the area.
Launching the Game
Start GTA V.
Enter Story Mode.
Travel to the zone coordinates you configured.
When you enter the LoadRadius, the map loads automatically.
When you leave the ClearRadius, the map unloads automatically.
No manual loading is required.
Creating Ambient World Events
Using MapEditor XML files you can create your own dynamic ambient scenarios.
Examples include:
Drug deals taking place in alleys
Armed gang gatherings
Security guards protecting locations
Armoured stockade cash collection trucks that players can intercept and rob
Construction sites with workers and vehicles
Dockside cargo operations
By combining props, peds, vehicles and weapons in MapEditor, you can turn simple locations into living world encounters.
Performance Tips
For best performance:
Split very large maps into multiple XML files
Use sensible load radii
Keep related objects together in one district
Test zones by driving in and out of the area
Reload the ini with Numpad *
Troubleshooting
Map does not load
Check:
XML file is inside scripts\MapLoaderAuto
MapFile name matches exactly
Enabled=true
Player enters the LoadRadius
XML file is saved from MapEditor
Map unloads too quickly
Increase ClearRadius.
Example:
LoadRadius=200
ClearRadius=250
Props appear too late - Increase LoadRadius.
Example:
LoadRadius=350
ClearRadius=450
Once configured correctly:
-map loading is automatic
-streaming is seamless
-large world projects become far more practical to run in GTA V
Install your maps, configure your zones, and explore your custom world.
Update Log
Update 1.0.01 - hotfix - xml map loaded Vehicles no longer despawn if driven outside the zone radii (once entered they will now persist outside the clearance coordinates until destroyed or abandoned by 200m)
Update 1.0.2 - File name changed to MapLoaderAuto.
xml npc's group logic and reactions rewritten and improved
Known Bugs/Caveat: xml npc companions will despawn along with their map when the clearance radii are breached - I have implemented a workaround for this with the vehicles and am rewriting the method for companion xml npcs - SOLVED in update 1.0.3
Update 1.0.3 - Companion Retention - MapLoaderAuto now detects NPCs that have been recruited using a (follow me) mod and automatically prevents them from being deleted when their original map zone unloads. Added intelligent retained ped cleanup - Retained followers are automatically cleaned up when they are clearly abandoned or killed. Added zone spawn protection - A new xml identity tracking system prevents duplicated NPC spawns (If a ped from a map zone has been retained and the player later returns to that zone MapLoaderAuto will detect the retained ped and will not spawn them again whilst they are following you). The same duplication logic as npcs now applies for vehicles.
Update 1.0.4 - npc idle actions fix. action props added
Update 1.0.5 - xml npc models occasional float bug fix - smoother streaming method implemented
Update 1.0.6 - sirens on/off xml setting fix
Update 1.0.7 - day and night cycle settings added
Update 1.0.8 - sirens on/off xml setting fix fixed
IF THE INI IS TOO COMPLICATED USE VERSION 1.0.6
Built for MapEditor XML files, MapLoaderAuto is designed to make map streaming feel natural. Once your zones are configured, there is no manual loading, no menu dependency, and no constant micromanagement. Drive into an area and the map loads automatically. Leave the area and it clears automatically. This makes it ideal for players building custom open worlds, Liberty City projects, district-based expansions, roleplay environments, mission areas, or large multi-map setups that would otherwise be too heavy to keep loaded all at once.
MapLoaderAuto is especially useful for creators who want to split large projects into multiple XML zones for better performance and smoother gameplay. Rather than relying on one massive file, you can organise your world into districts and let the script handle the streaming in the background. With properly tuned load and clear radii, transitions feel smooth and seamless while keeping performance far more manageable than traditional always-loaded map setups.
Beyond map streaming, MapLoaderAuto also allows creators to build their own dynamic ambient scenarios directly inside their maps. Using MapEditor XML files, you can place NPCs with weapons, behaviours, and relationships to create small world events and interactive situations. For example, you can stage drug deals happening in back alleys, armed gang gatherings, or even cash collection runs with stockade trucks that players can intercept and rob. These types of scenarios can turn simple map areas into living environments where the player can stumble across criminal activity, defend themselves, or create their own missions organically.
The mod supports automatic area-based streaming, configurable zone positions, adjustable load and clear distances, easy XML placement, and a simple INI-based setup that can be expanded with as many map zones as needed. Whether you are building a custom city expansion, a network of smaller locations, or a huge imported world, MapLoaderAuto gives you a much more practical way to run it in-game.
Key Features
Automatic loading and unloading of MapEditor XML maps
Seamless area-based map streaming
Hands-free operation once configured
Supports multiple zones and multiple XML map files
Create ambient world events using peds, vehicles, and props
Build scenarios such as gang activity, drug deals, or armoured cash transports
Ideal for large custom world projects
Helps reduce the overhead of keeping every map loaded at once
Simple INI setup with adjustable coordinates and radii
Perfect for district streaming, map packs, and total world expansions
Requirements
ScriptHookV
ScriptHookVDotNet
MapEditor
Important
MapLoaderAuto is built for MapEditor XML files. Your maps must be saved in MapEditor XML format for them to load correctly.
Once installed and configured, MapLoaderAuto allows you to build large custom environments that stream naturally into the game world, turning static map packs into living locations filled with activity and opportunity.
Installing MapLoaderAuto
Open your GTA V main directory.
Locate the scripts folder.
If the folder does not exist, create one.
Copy the following files into the scripts folder:
MapLoaderAuto.dll
MapLoaderAuto.ini
Your directory should now look like this:
GTA V
└── scripts
├── MapLoaderAuto.dll
└── MapLoaderAuto.ini
Create the Map Folder
Inside the scripts folder, create a new folder called:
MapLoaderAuto
Your structure should now look like this:
GTA V
└── scripts
├── MapLoaderAuto.dll
├── MapLoaderAuto.ini
└── MapLoaderAuto
This folder is where all of your MapEditor XML maps will be placed.
Installing XML Map Files
Place your MapEditor XML maps inside the new folder:
scripts\MapLoaderAuto\
Example:
GTA V
└── scripts
├── MapLoaderAuto.dll
├── MapLoaderAuto.ini
└── MapLoaderAuto
├── LittleItaly.xml
├── ConstructionYard.xml
├── BrokerDocks.xml
Important:
The MapFile name in the INI must match the XML filename exactly. (including .xml at the end)
Example:
MapFile=LittleItaly.xml
Configuring Map Zones
Open MapLoaderAuto.ini using Notepad.
Each map zone uses a section like this:
[Zone1]
Enabled=true
MapFile=ExampleMap.xml
X=0.0
Y=0.0
Z=0.0
LoadRadius=200.0
ClearRadius=250.0
What Each Setting Does
Enabled
Turns the zone on or off.
MapFile
The XML map file located in the scripts\MapLoaderAuto folder.
X Y Z
The centre coordinates of the map area. USE A TRAINER OR SCRIPT TO GET THE COORDINATES
LoadRadius
Distance from the centre where the map will automatically load.
ClearRadius
Distance where the map will unload after the player leaves.
Important rule:
ClearRadius must always be larger than LoadRadius
This prevents the map from constantly loading and unloading near the edge of the zone.
Adding Multiple Map Zones
You can add as many map zones as you want.
Example:
[Zone1]
Enabled=true
MapFile=LittleItaly.xml
X=3472.0
Y=-2907.0
Z=25.3
LoadRadius=70.0
ClearRadius=100.0
[Zone2]
Enabled=true
MapFile=BrokerDocks.xml
X=5185.0
Y=-3727.0
Z=10.0
LoadRadius=200.0
ClearRadius=250.0
[Zone3]
Enabled=true
MapFile=ConstructionYard.xml
X=4185.0
Y=-2031.0
Z=27.4
LoadRadius=60.0
ClearRadius=90.0
Each zone will automatically stream its XML map when the player enters the area.
Launching the Game
Start GTA V.
Enter Story Mode.
Travel to the zone coordinates you configured.
When you enter the LoadRadius, the map loads automatically.
When you leave the ClearRadius, the map unloads automatically.
No manual loading is required.
Creating Ambient World Events
Using MapEditor XML files you can create your own dynamic ambient scenarios.
Examples include:
Drug deals taking place in alleys
Armed gang gatherings
Security guards protecting locations
Armoured stockade cash collection trucks that players can intercept and rob
Construction sites with workers and vehicles
Dockside cargo operations
By combining props, peds, vehicles and weapons in MapEditor, you can turn simple locations into living world encounters.
Performance Tips
For best performance:
Split very large maps into multiple XML files
Use sensible load radii
Keep related objects together in one district
Test zones by driving in and out of the area
Reload the ini with Numpad *
Troubleshooting
Map does not load
Check:
XML file is inside scripts\MapLoaderAuto
MapFile name matches exactly
Enabled=true
Player enters the LoadRadius
XML file is saved from MapEditor
Map unloads too quickly
Increase ClearRadius.
Example:
LoadRadius=200
ClearRadius=250
Props appear too late - Increase LoadRadius.
Example:
LoadRadius=350
ClearRadius=450
Once configured correctly:
-map loading is automatic
-streaming is seamless
-large world projects become far more practical to run in GTA V
Install your maps, configure your zones, and explore your custom world.
Update Log
Update 1.0.01 - hotfix - xml map loaded Vehicles no longer despawn if driven outside the zone radii (once entered they will now persist outside the clearance coordinates until destroyed or abandoned by 200m)
Update 1.0.2 - File name changed to MapLoaderAuto.
xml npc's group logic and reactions rewritten and improved
Known Bugs/Caveat: xml npc companions will despawn along with their map when the clearance radii are breached - I have implemented a workaround for this with the vehicles and am rewriting the method for companion xml npcs - SOLVED in update 1.0.3
Update 1.0.3 - Companion Retention - MapLoaderAuto now detects NPCs that have been recruited using a (follow me) mod and automatically prevents them from being deleted when their original map zone unloads. Added intelligent retained ped cleanup - Retained followers are automatically cleaned up when they are clearly abandoned or killed. Added zone spawn protection - A new xml identity tracking system prevents duplicated NPC spawns (If a ped from a map zone has been retained and the player later returns to that zone MapLoaderAuto will detect the retained ped and will not spawn them again whilst they are following you). The same duplication logic as npcs now applies for vehicles.
Update 1.0.4 - npc idle actions fix. action props added
Update 1.0.5 - xml npc models occasional float bug fix - smoother streaming method implemented
Update 1.0.6 - sirens on/off xml setting fix
Update 1.0.7 - day and night cycle settings added
Update 1.0.8 - sirens on/off xml setting fix fixed
IF THE INI IS TOO COMPLICATED USE VERSION 1.0.6
First Uploaded: Sábado 14 de Marzo de 2026
Last Updated: Luns 23 de Marzo de 2026
Last Downloaded: 23 minuto
72 Comments
More mods by ChargedKILO:
MapLoaderAuto is a seamless XML map streaming engine for GTA V that automatically loads and unloads MapEditor maps based on the player’s location. Instead of forcing every custom map to stay loaded at once, MapLoaderAuto lets you build much larger worlds by streaming only the areas you actually enter. The result is a far cleaner, more hands-free way to use multiple custom districts, construction sites, gang areas, docklands, interiors, city expansions, and total conversion-style map setups.
Built for MapEditor XML files, MapLoaderAuto is designed to make map streaming feel natural. Once your zones are configured, there is no manual loading, no menu dependency, and no constant micromanagement. Drive into an area and the map loads automatically. Leave the area and it clears automatically. This makes it ideal for players building custom open worlds, Liberty City projects, district-based expansions, roleplay environments, mission areas, or large multi-map setups that would otherwise be too heavy to keep loaded all at once.
MapLoaderAuto is especially useful for creators who want to split large projects into multiple XML zones for better performance and smoother gameplay. Rather than relying on one massive file, you can organise your world into districts and let the script handle the streaming in the background. With properly tuned load and clear radii, transitions feel smooth and seamless while keeping performance far more manageable than traditional always-loaded map setups.
Beyond map streaming, MapLoaderAuto also allows creators to build their own dynamic ambient scenarios directly inside their maps. Using MapEditor XML files, you can place NPCs with weapons, behaviours, and relationships to create small world events and interactive situations. For example, you can stage drug deals happening in back alleys, armed gang gatherings, or even cash collection runs with stockade trucks that players can intercept and rob. These types of scenarios can turn simple map areas into living environments where the player can stumble across criminal activity, defend themselves, or create their own missions organically.
The mod supports automatic area-based streaming, configurable zone positions, adjustable load and clear distances, easy XML placement, and a simple INI-based setup that can be expanded with as many map zones as needed. Whether you are building a custom city expansion, a network of smaller locations, or a huge imported world, MapLoaderAuto gives you a much more practical way to run it in-game.
Key Features
Automatic loading and unloading of MapEditor XML maps
Seamless area-based map streaming
Hands-free operation once configured
Supports multiple zones and multiple XML map files
Create ambient world events using peds, vehicles, and props
Build scenarios such as gang activity, drug deals, or armoured cash transports
Ideal for large custom world projects
Helps reduce the overhead of keeping every map loaded at once
Simple INI setup with adjustable coordinates and radii
Perfect for district streaming, map packs, and total world expansions
Requirements
ScriptHookV
ScriptHookVDotNet
MapEditor
Important
MapLoaderAuto is built for MapEditor XML files. Your maps must be saved in MapEditor XML format for them to load correctly.
Once installed and configured, MapLoaderAuto allows you to build large custom environments that stream naturally into the game world, turning static map packs into living locations filled with activity and opportunity.
Installing MapLoaderAuto
Open your GTA V main directory.
Locate the scripts folder.
If the folder does not exist, create one.
Copy the following files into the scripts folder:
MapLoaderAuto.dll
MapLoaderAuto.ini
Your directory should now look like this:
GTA V
└── scripts
├── MapLoaderAuto.dll
└── MapLoaderAuto.ini
Create the Map Folder
Inside the scripts folder, create a new folder called:
MapLoaderAuto
Your structure should now look like this:
GTA V
└── scripts
├── MapLoaderAuto.dll
├── MapLoaderAuto.ini
└── MapLoaderAuto
This folder is where all of your MapEditor XML maps will be placed.
Installing XML Map Files
Place your MapEditor XML maps inside the new folder:
scripts\MapLoaderAuto\
Example:
GTA V
└── scripts
├── MapLoaderAuto.dll
├── MapLoaderAuto.ini
└── MapLoaderAuto
├── LittleItaly.xml
├── ConstructionYard.xml
├── BrokerDocks.xml
Important:
The MapFile name in the INI must match the XML filename exactly. (including .xml at the end)
Example:
MapFile=LittleItaly.xml
Configuring Map Zones
Open MapLoaderAuto.ini using Notepad.
Each map zone uses a section like this:
[Zone1]
Enabled=true
MapFile=ExampleMap.xml
X=0.0
Y=0.0
Z=0.0
LoadRadius=200.0
ClearRadius=250.0
What Each Setting Does
Enabled
Turns the zone on or off.
MapFile
The XML map file located in the scripts\MapLoaderAuto folder.
X Y Z
The centre coordinates of the map area. USE A TRAINER OR SCRIPT TO GET THE COORDINATES
LoadRadius
Distance from the centre where the map will automatically load.
ClearRadius
Distance where the map will unload after the player leaves.
Important rule:
ClearRadius must always be larger than LoadRadius
This prevents the map from constantly loading and unloading near the edge of the zone.
Adding Multiple Map Zones
You can add as many map zones as you want.
Example:
[Zone1]
Enabled=true
MapFile=LittleItaly.xml
X=3472.0
Y=-2907.0
Z=25.3
LoadRadius=70.0
ClearRadius=100.0
[Zone2]
Enabled=true
MapFile=BrokerDocks.xml
X=5185.0
Y=-3727.0
Z=10.0
LoadRadius=200.0
ClearRadius=250.0
[Zone3]
Enabled=true
MapFile=ConstructionYard.xml
X=4185.0
Y=-2031.0
Z=27.4
LoadRadius=60.0
ClearRadius=90.0
Each zone will automatically stream its XML map when the player enters the area.
Launching the Game
Start GTA V.
Enter Story Mode.
Travel to the zone coordinates you configured.
When you enter the LoadRadius, the map loads automatically.
When you leave the ClearRadius, the map unloads automatically.
No manual loading is required.
Creating Ambient World Events
Using MapEditor XML files you can create your own dynamic ambient scenarios.
Examples include:
Drug deals taking place in alleys
Armed gang gatherings
Security guards protecting locations
Armoured stockade cash collection trucks that players can intercept and rob
Construction sites with workers and vehicles
Dockside cargo operations
By combining props, peds, vehicles and weapons in MapEditor, you can turn simple locations into living world encounters.
Performance Tips
For best performance:
Split very large maps into multiple XML files
Use sensible load radii
Keep related objects together in one district
Test zones by driving in and out of the area
Reload the ini with Numpad *
Troubleshooting
Map does not load
Check:
XML file is inside scripts\MapLoaderAuto
MapFile name matches exactly
Enabled=true
Player enters the LoadRadius
XML file is saved from MapEditor
Map unloads too quickly
Increase ClearRadius.
Example:
LoadRadius=200
ClearRadius=250
Props appear too late - Increase LoadRadius.
Example:
LoadRadius=350
ClearRadius=450
Once configured correctly:
-map loading is automatic
-streaming is seamless
-large world projects become far more practical to run in GTA V
Install your maps, configure your zones, and explore your custom world.
Update Log
Update 1.0.01 - hotfix - xml map loaded Vehicles no longer despawn if driven outside the zone radii (once entered they will now persist outside the clearance coordinates until destroyed or abandoned by 200m)
Update 1.0.2 - File name changed to MapLoaderAuto.
xml npc's group logic and reactions rewritten and improved
Known Bugs/Caveat: xml npc companions will despawn along with their map when the clearance radii are breached - I have implemented a workaround for this with the vehicles and am rewriting the method for companion xml npcs - SOLVED in update 1.0.3
Update 1.0.3 - Companion Retention - MapLoaderAuto now detects NPCs that have been recruited using a (follow me) mod and automatically prevents them from being deleted when their original map zone unloads. Added intelligent retained ped cleanup - Retained followers are automatically cleaned up when they are clearly abandoned or killed. Added zone spawn protection - A new xml identity tracking system prevents duplicated NPC spawns (If a ped from a map zone has been retained and the player later returns to that zone MapLoaderAuto will detect the retained ped and will not spawn them again whilst they are following you). The same duplication logic as npcs now applies for vehicles.
Update 1.0.4 - npc idle actions fix. action props added
Update 1.0.5 - xml npc models occasional float bug fix - smoother streaming method implemented
Update 1.0.6 - sirens on/off xml setting fix
Update 1.0.7 - day and night cycle settings added
Update 1.0.8 - sirens on/off xml setting fix fixed
IF THE INI IS TOO COMPLICATED USE VERSION 1.0.6
Built for MapEditor XML files, MapLoaderAuto is designed to make map streaming feel natural. Once your zones are configured, there is no manual loading, no menu dependency, and no constant micromanagement. Drive into an area and the map loads automatically. Leave the area and it clears automatically. This makes it ideal for players building custom open worlds, Liberty City projects, district-based expansions, roleplay environments, mission areas, or large multi-map setups that would otherwise be too heavy to keep loaded all at once.
MapLoaderAuto is especially useful for creators who want to split large projects into multiple XML zones for better performance and smoother gameplay. Rather than relying on one massive file, you can organise your world into districts and let the script handle the streaming in the background. With properly tuned load and clear radii, transitions feel smooth and seamless while keeping performance far more manageable than traditional always-loaded map setups.
Beyond map streaming, MapLoaderAuto also allows creators to build their own dynamic ambient scenarios directly inside their maps. Using MapEditor XML files, you can place NPCs with weapons, behaviours, and relationships to create small world events and interactive situations. For example, you can stage drug deals happening in back alleys, armed gang gatherings, or even cash collection runs with stockade trucks that players can intercept and rob. These types of scenarios can turn simple map areas into living environments where the player can stumble across criminal activity, defend themselves, or create their own missions organically.
The mod supports automatic area-based streaming, configurable zone positions, adjustable load and clear distances, easy XML placement, and a simple INI-based setup that can be expanded with as many map zones as needed. Whether you are building a custom city expansion, a network of smaller locations, or a huge imported world, MapLoaderAuto gives you a much more practical way to run it in-game.
Key Features
Automatic loading and unloading of MapEditor XML maps
Seamless area-based map streaming
Hands-free operation once configured
Supports multiple zones and multiple XML map files
Create ambient world events using peds, vehicles, and props
Build scenarios such as gang activity, drug deals, or armoured cash transports
Ideal for large custom world projects
Helps reduce the overhead of keeping every map loaded at once
Simple INI setup with adjustable coordinates and radii
Perfect for district streaming, map packs, and total world expansions
Requirements
ScriptHookV
ScriptHookVDotNet
MapEditor
Important
MapLoaderAuto is built for MapEditor XML files. Your maps must be saved in MapEditor XML format for them to load correctly.
Once installed and configured, MapLoaderAuto allows you to build large custom environments that stream naturally into the game world, turning static map packs into living locations filled with activity and opportunity.
Installing MapLoaderAuto
Open your GTA V main directory.
Locate the scripts folder.
If the folder does not exist, create one.
Copy the following files into the scripts folder:
MapLoaderAuto.dll
MapLoaderAuto.ini
Your directory should now look like this:
GTA V
└── scripts
├── MapLoaderAuto.dll
└── MapLoaderAuto.ini
Create the Map Folder
Inside the scripts folder, create a new folder called:
MapLoaderAuto
Your structure should now look like this:
GTA V
└── scripts
├── MapLoaderAuto.dll
├── MapLoaderAuto.ini
└── MapLoaderAuto
This folder is where all of your MapEditor XML maps will be placed.
Installing XML Map Files
Place your MapEditor XML maps inside the new folder:
scripts\MapLoaderAuto\
Example:
GTA V
└── scripts
├── MapLoaderAuto.dll
├── MapLoaderAuto.ini
└── MapLoaderAuto
├── LittleItaly.xml
├── ConstructionYard.xml
├── BrokerDocks.xml
Important:
The MapFile name in the INI must match the XML filename exactly. (including .xml at the end)
Example:
MapFile=LittleItaly.xml
Configuring Map Zones
Open MapLoaderAuto.ini using Notepad.
Each map zone uses a section like this:
[Zone1]
Enabled=true
MapFile=ExampleMap.xml
X=0.0
Y=0.0
Z=0.0
LoadRadius=200.0
ClearRadius=250.0
What Each Setting Does
Enabled
Turns the zone on or off.
MapFile
The XML map file located in the scripts\MapLoaderAuto folder.
X Y Z
The centre coordinates of the map area. USE A TRAINER OR SCRIPT TO GET THE COORDINATES
LoadRadius
Distance from the centre where the map will automatically load.
ClearRadius
Distance where the map will unload after the player leaves.
Important rule:
ClearRadius must always be larger than LoadRadius
This prevents the map from constantly loading and unloading near the edge of the zone.
Adding Multiple Map Zones
You can add as many map zones as you want.
Example:
[Zone1]
Enabled=true
MapFile=LittleItaly.xml
X=3472.0
Y=-2907.0
Z=25.3
LoadRadius=70.0
ClearRadius=100.0
[Zone2]
Enabled=true
MapFile=BrokerDocks.xml
X=5185.0
Y=-3727.0
Z=10.0
LoadRadius=200.0
ClearRadius=250.0
[Zone3]
Enabled=true
MapFile=ConstructionYard.xml
X=4185.0
Y=-2031.0
Z=27.4
LoadRadius=60.0
ClearRadius=90.0
Each zone will automatically stream its XML map when the player enters the area.
Launching the Game
Start GTA V.
Enter Story Mode.
Travel to the zone coordinates you configured.
When you enter the LoadRadius, the map loads automatically.
When you leave the ClearRadius, the map unloads automatically.
No manual loading is required.
Creating Ambient World Events
Using MapEditor XML files you can create your own dynamic ambient scenarios.
Examples include:
Drug deals taking place in alleys
Armed gang gatherings
Security guards protecting locations
Armoured stockade cash collection trucks that players can intercept and rob
Construction sites with workers and vehicles
Dockside cargo operations
By combining props, peds, vehicles and weapons in MapEditor, you can turn simple locations into living world encounters.
Performance Tips
For best performance:
Split very large maps into multiple XML files
Use sensible load radii
Keep related objects together in one district
Test zones by driving in and out of the area
Reload the ini with Numpad *
Troubleshooting
Map does not load
Check:
XML file is inside scripts\MapLoaderAuto
MapFile name matches exactly
Enabled=true
Player enters the LoadRadius
XML file is saved from MapEditor
Map unloads too quickly
Increase ClearRadius.
Example:
LoadRadius=200
ClearRadius=250
Props appear too late - Increase LoadRadius.
Example:
LoadRadius=350
ClearRadius=450
Once configured correctly:
-map loading is automatic
-streaming is seamless
-large world projects become far more practical to run in GTA V
Install your maps, configure your zones, and explore your custom world.
Update Log
Update 1.0.01 - hotfix - xml map loaded Vehicles no longer despawn if driven outside the zone radii (once entered they will now persist outside the clearance coordinates until destroyed or abandoned by 200m)
Update 1.0.2 - File name changed to MapLoaderAuto.
xml npc's group logic and reactions rewritten and improved
Known Bugs/Caveat: xml npc companions will despawn along with their map when the clearance radii are breached - I have implemented a workaround for this with the vehicles and am rewriting the method for companion xml npcs - SOLVED in update 1.0.3
Update 1.0.3 - Companion Retention - MapLoaderAuto now detects NPCs that have been recruited using a (follow me) mod and automatically prevents them from being deleted when their original map zone unloads. Added intelligent retained ped cleanup - Retained followers are automatically cleaned up when they are clearly abandoned or killed. Added zone spawn protection - A new xml identity tracking system prevents duplicated NPC spawns (If a ped from a map zone has been retained and the player later returns to that zone MapLoaderAuto will detect the retained ped and will not spawn them again whilst they are following you). The same duplication logic as npcs now applies for vehicles.
Update 1.0.4 - npc idle actions fix. action props added
Update 1.0.5 - xml npc models occasional float bug fix - smoother streaming method implemented
Update 1.0.6 - sirens on/off xml setting fix
Update 1.0.7 - day and night cycle settings added
Update 1.0.8 - sirens on/off xml setting fix fixed
IF THE INI IS TOO COMPLICATED USE VERSION 1.0.6
First Uploaded: Sábado 14 de Marzo de 2026
Last Updated: Luns 23 de Marzo de 2026
Last Downloaded: 23 minuto
5mods on Discord
@Averageli5 send me your scripthookvdotnet log and maploaderauto.ini via discord (link in profile) and I'll have a look at what the problem might be
@orange1guana thanks for your comments - glad you're enjoying the mod
I'm running the following on my private version:
-weather dependence
-player model dependence
-chance percentage (execute or ignore load)
-wanted level dependence
-vehicle model dependence
I am planning on releasing a full version I just need time to make the ini settings less complicated before I do
@ChargedKILO check discord
@Averageli5 Your time setup is wrong.
You have entered:
Zone1Day
StartHour:6
EndHour:22
Zone1Night
StartHour=24
EndHour=4
24 is not a valid time. Time uses 0 to 23 only. Midnight is 0, not 24.
So your night zone is set up incorrectly from the start and probably breaking the timecycle logic in the script.
Try this:
[Zone1Day]
StartHour=6
EndHour=22
[Zone1Night]
StartHour=22
EndHour=4
NOTE: the map will still not load between 0400-0600 in these settings but this is how you should set it for the times you wanted
Important:
• Do not use 24
• Midnight is 0
• Valid hours are 0–23 only
If this is too complicated, use version 1.0.6 instead, because it is simpler and I don’t have TIME for this 😂👍
You also have several broken scripts in the screenshot of your SHVDN logs which may be a factor to other scripts not loading as intended but most likely cause is the incorrect time settings.
Hope that sorts it for you
@ChargedKILO thanks for clearing that up. But this problem has persisted in all of the versions of the mod I've used, not just the one with the day/night cycle. I've also tried using a clean copy of the game which didn't work either.
I've just now realized that when I hover over the coords of the default yourmap.xml zone template, the mod attempts to load that, so the mod definitely works just not with my maps for whatever reason 😭
I'm gonna guess that it has something to do with the xml files or maybe another flaw during installation, which I'm still unsure of what the reason might be cause I'm pretty sure I did everything as told.
@Averageli5 ok man shit thought that would solve it — paste your xml file on the discord so I can check it - I’ll help get it working for you if I can
@ChargedKILO I was finally able to get it working, turns out it was a personal issue with the ini that I had completely overlooked.
I fully appreciate you for helping me out the best you can, the mod is absolutely amazing and it is revolutionary for what it is.
@ChargedKILO Once I enter the name of the xml map I want to load in the ini are the X,Y,Z coordinates detected automatically or do I have to tediously figure 'em out on my own and enter them manually? If that's the case, where exactly within the map's xml would I find the correct X,Y,Z coordinates? There're hundreds of X,Y,Z coordinates in the xml that refer to different things, such as props and stuff like that.
@JAM102970 use a trainer to show you what the coordinates are ingame then type them in
nice to see this as a featured mod - 5 stars
great idea! any way to make the map load 24/7?
maybe like this?
StartHour=0
EndHour=24
Thisss Shvtt Hellaa Fyee Thanks G
I have 100% been waiting for something like this! Excellent job!
Do not try to use 24. That is an invalid time (midnight is 0000).
Correct way to run a map 24/7
Set a full wrap-around time:
StartHour=0
EndHour=0
This covers the entire 24-hour cycle. Hope that helps
I've noticed that the ped relationships are a bit flawed.
All peds spawned with the mod become aggressive to everyone once spooked for some of the set relationships even though they aren't supposed to.
I've tried to make law enforcement scenarios where there are bunch of cops that I can choose to start shootouts with and they typically just end up attacking eachother instead. Which doesn't happen when I manually spawn them in using mapeditor.
Same thing applies for regular peds with pedestrian relationships even though they're meant to run away once spooked
@ChargedKILO does setting the coordinates of the xml to 0 centers it on the area where it's located? or is it relative to the player's position on the map?
@Averageli5 cops should work properly if set to neutral and friendly should work with respect... I'll take a look
@ModernPlebeian314 0 isn't a valid coordinate input
@ChargedKILO So how does the coordinates work? Since XMLs don't really provide the very center of the location where the props are placed
@ModernPlebeian314 use a trainer to get the coordinates ingame - see the coords in top right of the screenshots and videos - they are from a trainer