The file to execute.
There're no restrictions for Lua code if you add it to Preload files (which are supposed to be in Jass), that's only possible with dirty hacks or manual editing. If the map runs in Lua mode, the Jass code is compiled using Jass2Lua before execution.
On pre-Reforged (version?) this only works if you have enabled the usage of local files in your registry.
The registry key is HKEY_CURRENT_USER\Software\Blizzard Entertainment\Warcraft III\Allow Local Files\
@note Here are some ways to get the data out of the preload file into your map:
To store multiple integers you can use SetPlayerTechMaxAllowed to have a good
2d-array. Read via GetPlayerTechMaxAllowed.
For strings SetPlayerName is suited. To read use GetPlayerName.
Inside the preload script you can also use ExecuteFunc to call your map-defined
functions and interleave the preload script with your functions.
@note If you use Preloader to load some values into your map, these values
are very likely to be different for each player (since the player might not
even have local files enabled), so treat them as async values.
@note Also see the documentation of Preload to see how to properly get the data
into the preload script.
@bug 1.33.0 and above: Due to aggressive file caching by the game, the preload file is only loaded and read once. This means, updates to the saved preload file cannot be reloaded and old contents will be executed.
@note See: Preload, PreloadEnd, PreloadStart, PreloadRefresh, PreloadEndEx, PreloadGenClear, PreloadGenStart, PreloadGenEnd.
Generated using TypeDoc
Runs the filename as a preload script, only if the filename has an extension. For Jass, the capabilities are very restricted.
Example (from blizzard.j):