MapLoaderAuto is an advanced XML map streaming engine for GTA V.

It automatically loads and unloads MapEditor XML maps based on:

Player location

Time of day (day / night cycles)

Days of the week

This allows dynamic world changes such as:

Day vs night environments

Weekend-only locations

Time-based interiors, events, or scenes

Load requirement via PlayerModels

REQUIREMENTS

Before installing MapLoaderAuto, ensure you have:

ScriptHookV

ScriptHookVDotNet

MapEditor

IMPORTANT

ONLY MapEditor XML files are supported

MapFolder= should be left blank

Zone names must follow the correct format

Press Numpad * in-game to reload the INI

INSTALLATION
STEP 1 – INSTALL FILES

Copy into your scripts folder:

MapLoaderAuto.dll

MapLoaderAuto.ini

Structure:

GTA V
└── scripts
    ├── MapLoaderAuto.dll
    ├── MapLoaderAuto.ini
STEP 2 – CREATE MAP FOLDER

Create:

scripts\MapLoaderAuto\

Place all XML maps inside this folder.

STEP 3 – ADD MAP FILES

Example:

scripts\MapLoaderAuto\
    ├── yourmap.xml

IMPORTANT
The filename must match exactly in the INI.(inc .xml at the end)

GLOBAL SETTINGS

From your INI

[Settings]
MapFolder=
TickInterval=250
ShowNotifications=true
Use2DDistance=true

SETTINGS EXPLAINED

MapFolder=

Leave blank (uses default scripts\MapLoaderAuto)

TickInterval=250

How often zones are checked (lower = faster, higher = better performance)

ShowNotifications=true

Shows load/unload messages

Use2DDistance=true

Ignores height (Z axis) for more stable detection

ZONE SYSTEM (DAY / NIGHT)

Each zone is split into two parts:

ZoneXDay

ZoneXNight

Example

[Zone1Day]
Enabled=true
MapFile=yourmap.xml
X=1111.1111
Y=-1111.111
Z=11.11
LoadRadius=120
ClearRadius=180
StartHour=6
EndHour=18
Days=Mon,Tue,Wed,Thu,Fri,Sat,Sun

[Zone1Night]
Enabled=true
MapFile=yourmap.xml
X=1111.1111
Y=-1111.111
Z=11.11
LoadRadius=120
ClearRadius=180
StartHour=18
EndHour=6
Days=Mon,Tue,Wed,Thu,Fri,Sat,Sun

ZONE SETTINGS EXPLAINED

Enabled=true

Turns the zone on/off

MapFile=yourmap.xml

XML file inside MapLoaderAuto folder

X / Y / Z

Center of the zone

LoadRadius

Distance at which the map loads

ClearRadius

Distance at which the map unloads

IMPORTANT
ClearRadius must always be larger than LoadRadius

TIME-BASED LOADING

StartHour / EndHour control when a zone is active

Examples:

Daytime

StartHour=6  
EndHour=18  

Night (overnight range)

StartHour=18  
EndHour=6  

Notes:

Uses 24-hour format (0–23)

Overnight ranges are fully supported

DAYS SYSTEM
Days=Mon,Tue,Wed,Thu,Fri,Sat,Sun

Controls which days the zone is active

Examples:

Weekend only

Days=Sat,Sun

Weekdays only

Days=Mon,Tue,Wed,Thu,Fri

Custom

Days=Fri,Sat
HOW DAY / NIGHT ZONES WORK

Each pair (e.g. Zone1Day / Zone1Night):

Shares the same location

Can load the same or different maps

Switches automatically based on time

Example uses:

Day: empty area

Night: populated nightlife scene

Day: active construction site

Night: abandoned version

ADDING MORE ZONES

Your INI supports multiple zones:

Zone1Day / Zone1Night

Zone2Day / Zone2Night

Zone3Day / Zone3Night

Zone4Day / Zone4Night

Zone5Day / Zone5Night

To activate a zone:

Enabled=true

PLAYERMODELS UPDATE (allows map to load with only certain playermodels)

PlayerModels=All,player_one/two/zero,alladonpeds,addonpedname

PERFORMANCE TIPS

Use reasonable radii (100–300 for most maps)

Split large maps into multiple zones

Avoid too many overlapping active zones

Keep Use2DDistance=true for best results

TROUBLESHOOTING

MAP DOES NOT LOAD

Check:

XML is in scripts\MapLoaderAuto\

MapFile matches exactly

Enabled=true

You are inside LoadRadius

Time and day conditions are correct

MAP LOADS AT WRONG TIME

Check:

StartHour / EndHour values

Overnight ranges (e.g. 18 → 6)

MAP NEVER LOADS

Check:

Days setting matches the current in-game day

FLICKERING / CONSTANT LOAD UNLOAD

Fix:
Increase ClearRadius

Example:

LoadRadius=120  
ClearRadius=180  
FINAL NOTES

MapLoaderAuto provides:

Automatic map streaming

Time-based world changes

Day-of-week control

Once configured, everything runs automatically with no manual input required.