diff --git a/docs/Lua API.rst b/docs/Lua API.rst index f31bb5469..8707a0d99 100644 --- a/docs/Lua API.rst +++ b/docs/Lua API.rst @@ -3656,12 +3656,22 @@ Plugins .. contents:: :local: -DFHack plugins may export native functions and events -to lua contexts. They are automatically imported by -``mkmodule('plugins.')``; this means that a lua -module file is still necessary for ``require`` to read. - -The following plugins have lua support. +DFHack plugins may export native functions and events to Lua contexts. These are +exposed as ``plugins.`` modules, which can be imported with +``require('plugins.')``. The plugins listed in this section expose +functions and/or data to Lua in this way. + +In addition to any native functions documented here, plugins that can be +enabled (that is, plugins that support the `enable/disable API `) will +have the following functions defined: + +* ``isEnabled()`` returns whether the plugin is enabled. +* ``setEnabled(boolean)`` sets whether the plugin is enabled. + +For plugin developers, note that a Lua file in ``plugins/lua`` is required for +``require()`` to work, even if it contains no pure-Lua functions. This file must +contain ``mkmodule('plugins.')`` to import any native functions defined in +the plugin. See existing files in ``plugins/lua`` for examples. blueprint =========