Overloading

Overloading is a way to //add new// or //overwrite// files to the parent module. This the way graphics such as talent icons are added. Overloading can also add .lua but will replace those with the same name. So typically adding new trees, or overwriting trees. Or adding music and graphics.

Whenever the game attempts to load a file (in any of various ways), it will prefer files in an /overload/ folder to files in the path of default ToME. If an overload is present for a file, that overload will be loaded, and the default file will be ignored.

Overloads are to be avoided-- in general. Certain kinds of files cannot be placed elsewhere-- for instance, many graphics files need to be placed in overload, unless you want to rewrite a lot of code that prepends paths to graphic filenames. But the presence of overloaded Lua files means that your module or add-on will most likely be incompatible with any other module or add-on that requires the same file.