Mod Loading Behaviour

Mod Folders

By default this is <game>/mods/, can be changed with -Dloader.modsDir=<path>.

Additional folders can be specified with -Dloader.addMods - but make sure to use /* for folders!

Loading from Folders

If the configuration option load_sub_folders is true (which it is by default), then this searches sub-folders inside the main mods folders, with a few exceptions:

• Folders that start with . or end with .disabled are ignored.
• Folders that contain a file named quilt_loader_ignored (no extension) are ignored.
• Folders that start with a digit, <, or > are ignored by this option, since they are controlled by the option below.

If the configuration option restrict_game_versions is true (which it is by default), then that folder is only searched if it matches the game option. Folders that start with > match only versions greater than the specified version. Folders that start with < match only versions less than the specified version. (That functionality is unavailable on windows)

Loading files

Certain files are ignored:

• Hidden files
• Files that start with a dot (for example .mod.jar)
• Files that end with .disabled (for example mod.jar.disabled)

Otherwise loader will try to load the file as a mod, passing it to all available plugins. If no plugin can load the file, then loader will crash - make sure you keep any non-mod files outside of your mod folder! edit: after beta 25 the crash has been removed - however it will be brought back in the future, after load plugins have been released!