MapLoaderAuto 1.0.6
796
37
796
37
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
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
Carregat per primera vegada: fa 5 dies
Actualització més recent: fa 1 dia
Últim descarregat: fa 2 minuts
45 Comentaris
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
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
Carregat per primera vegada: fa 5 dies
Actualització més recent: fa 1 dia
Últim descarregat: fa 2 minuts
5mods on Discord
@thalilmythos thanks. My private version has a day and night cycle - works as intended but the issue is that the ini is currently very complicated so will be working on fine tuning that before public release.
@ChargedKILO For some reason, some peds do not spawn on ground even though they were saved on ground. I edited the xml file as a test, copied the same ped, slightly changing x and y. One ped spawned properly, the other spawned in the air, slowly fell down, and when he landed he still smoked but the cigarette prop disappeared.
<MapObject Id="person1">
<Type>Ped</Type>
<Position>
<X>43.21328</X>
<Y>7082.23047</Y>
<Z>1.7312305</Z>
</Position>
<Rotation>
<X>0</X>
<Y>0</Y>
<Z>0.980416954</Z>
</Rotation>
<Hash>-1404353274</Hash>
<Dynamic>true</Dynamic>
<Quaternion>
<X>0</X>
<Y>0</Y>
<Z>0.008555648</Z>
<W>0.9999634</W>
</Quaternion>
<Texture>0</Texture>
<Action>Smoke</Action>
<Relationship>Companion</Relationship>
<Weapon>Unarmed</Weapon>
</MapObject>
@thalilmythos now we gotta see your map & object placements w/ this tool. i bet you got a few
@mitto_backup I'm more interested in making gang hideouts than anything, that's my jam right there, but big ones, 10 minutes shooting type shit
Very nice , ive been searching for this so long.... One Bug is actual, if i built accident scenarios, all peds and cars will spawn.. Nice, but activated Siren , or sirenlights are missed... If i load the xml to map editor, the sirens are active... If the Autoloadermods loading the zone, for e.g zone1 , siren lights are not active.... Can we fix this ? Greetzz from NRW
@ChargedKILO can you hide the popup in bottom left that says map loaded?
@ChargedKILO Very nice , ive been searching for this so long.... One Bug is actual, if i built accident scenarios, all peds and cars will spawn.. Nice, but activated Siren , or sirenlights are missed... If i load the xml to map editor, the sirens are active... If the Autoloadermods loading the zone, for e.g zone1 , siren lights are not active.... Can we fix this ? Greetzz from NRW
@mitto_backup yes possible, go to your scriptsfolder open MapLoaderAuto config textfile... go to: ShowNotifications=true
Set it from true to false, so the notifications in the left bottom will disappear
@mitto_backup in the ini - set notifications to false
@Creezzy thank you for pointing this out - I will try and fix it later today
@thalilmythos pretty much there with the day and night cycle and will try and upload in an update some time this week - I’m also planning on implemented player model reliant spawns
Excellent idea, especially if you don't want to overload your game.
What about implementing a chance multiplier? For example, with a multiplier of 1.0, the map will load each time you are within its area. With a multiplier of 0.0, the map will never load, and with a 0.5 multiplier, the chances of the map being loaded once you're in the area are 50%.
@ChargedKILO Man that sounds like an awesome Idea, more conditions for different spawns it's always good, a little annoying for people's configuration, but, still, usefull for a lot of us.
@Creezzy fixed
@thalilmythos yeah the config my end is a bit of a chore so might be too complicated for a public release
@ChargedKILO Does this script support background ambient sound?
@ChargedKILO Bro, is there any chance of adding Menyoo maps? Menyoo has many more animations to make the maps more immersive. Congratulations, you've done a great job!
@ChargedKILO, thank you so much for the fix instead of the sirens..... works fine ,very very nice..... Thank you for your work...
You should add the xml support for menyoo maps created with menyoo
no plans to add menyoo maps support