(1)(3)(1).png "Big Bank Heists")
1.926
63
1.926
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.
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.
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
Primo Caricamento: 14 marzo 2026
Ultimo Aggiornamento: 23 marzo 2026
Last Downloaded: 3 minuti fa
66 Commenti
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.
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.
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
Primo Caricamento: 14 marzo 2026
Ultimo Aggiornamento: 23 marzo 2026
Last Downloaded: 3 minuti fa
Created an account just to post this - This is absolutely amazing! Thank you for your work on this I can't wait for more updates. MapLoaderAuto is honestly one of those mods that completely changes how GTA V feels. Being able to stream in custom maps seamlessly as you move around the world makes everything feel alive again — no more manual loading or breaking immersion. I’ve been running a mix of different map packs and it’s like playing a totally new game every session. The fact it handles zones automatically is a game changer, especially for larger setups. Genuinely feels like it’s pushing GTA V into a whole new era while we wait for GTA 6. Absolute must-have for anyone serious about modding. I found one small bug with the guard animation but everything else works flawlessly. I noticed that the file says is public release... what sort of settings do you have running on your private version? Hopefully we'll get to see them released sometime soon but seriously great work so far 10/10 - If you're a map builder like me you must download this mod - my game is now full of gang hideouts and custom random event type maps for robberies drug deals hitchhikers all sorts - download now and get creating
Really loving this mod! But have a question, I have the latest version but I am noticing the siren lights still don't stay on for the police cars when the maps loads, any suggestions?
@AdamHall sirens on/off should be fixed in day&night cycle version now
@Creezzy sirens should be working now in the latest day&night cycle version (1.0.8) and 1.0.6
@ChargedKILO you are amazing! Thank you so much, it works perfectly!
For whatever reason I can't get this mod to work for the life of me. I followed the install instructions and put the map files (that I made myself and saved through mapeditor xml) into the empty folder as followed. I put in the exact title of the xml as I configured the ini and even double checked to ensure there weren't any typos. Yet when I go to the exact coords where I directly set it, it doesn't seem to register and nothing happens. I'm not sure what I'm doing wrong for it to not work at all. Any ideas?
@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