Moss Module Creation

This is a quick intro on how to set up a basic Moss module.

Build

The module source will contain at least one class, with at least one header and one C++ source file.  The module source will build to a shared library file, either a .so binary in unix, or a .dll in win32.

Module class

The module must contain at least one module class, a module class is a C++ class that inherits MModule.  The module can either inherit MModule directly, or inherit an interface that inherits MModule, such as IConsole, for a console module.  The class can then have all the neccessary virtual functions implemented to perform it's function.  The following MModule virtual functions provide the core of the functionality of the module:

• initialize(): called when the module is added to the application, perform non-trival initialisation
• shutdown(): called before the module is removed from the application for any reason, perform all shutdown procedures
• update(): called once per increment of the program's main loop
• rebind(): called when a module is added or removed from the application, use it to keep accurate intermodule pointers

C Function

The module MUST export a single plain C function defined as:

extern "C" SYM_EXPORT MModule* GetModule();

The GetModule function must return a new instance of the class described in this module.