Options

Description

All of the previously mentioned configuration files are by default only loaded once the game is started.

To assist you in testing your work without having to restart the game every time you make a change, there are several options available that allow you to refresh your modified configuration files while the game is open.

These options are all loaded from the {game}/x64/scripts/TheInsurgentsForge/options.lua file when opening the game.

The following configuration is the default:

local configStates = {
  refreshFormulas = false,
  refreshFunctions = false,
  refreshClasses = false,
  refreshHelpers = false,
  refreshAssemblies = false,
  refreshMiddlewares = false
}

return configStates

Below is a list of all configurable options and what they are used for:

Option	Description
Refresh Formulas	Reload formulas.lua if modified.
Refresh Functions	Reload functions/{id}.lua if modified.
Refresh Classes	Reload classes.lua and classes/{name}.lua if modified.
Refresh Helpers	Reload helpers.lua and helpers/{name}.lua if modified.
Refresh Assemblies	Reload assemblies.lua and assemblies/{name}.lua if modified.
Refresh Middlewares	Reload middlewares.lua if modified.

To enable an option, set their state to true, and to disable it, set it to false.

Notes

If a formula function, helper, etc. is reloaded, the references to it in other files are not automatically updated as the dependencies are unknown at that point. To ensure these files use the updated reference, they must be also be reloaded, for example by refreshing the file name list.

If a formula function, helper, etc. in the configuration files couldn't be loaded (e.g. due to syntax errors), the last one that could be will be used instead. If there never was one, the one in the main files will be used instead. If there never was one again, the formula function, helper, etc. will be removed completely unless the file is still listed in the related file name list in which case an error will be shown instead.

Files are checked every second and only loaded if their modification date is different.