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!

See Also

© 2006–2020 LÖVE Development Team
Licensed under the GNU Free Documentation License, Version 1.3.
https://love2d.org/wiki/require