require

Opens and executes Lua modules.

Use periods to seperate folders. If the module is a lua file, don't use the .lua extension in the string passed to require.

require("foo")
require("subfolder.bar")


LÖVE adds two loaders (before the Lua loaders) that search for modules in the game and save directory. These loaders are not affected by Lua's package.path. The paths can be altered with love.filesystem.setRequirePath for Lua modules and love.filesystem.setCRequirePath for C modules, the latter only work on files located at save directory.

Notes

It's strongly recommended to use period as directory separator! Forward slashes accidently work, hence its usage is discouraged! One of the reasons is that loading modules that are not Lua code files is only possible with dots as separator, and using dots and slashes at the same time might lead to mixing separators, and due to mixing require might load the same code multiple times.

See Also

Other Languages