User Tools

Site Tools


modules.json Config File

While MBBSEmu allows you to run a single Module from the command line, using a modules.json file allows you to specify any number of modules to be loaded when you run MBBSEmu. You can specify a modules.json file using the -C <fileName> command line switch.

The modules.json file is a simple JSON file that lists an array of modules with their Identifier and Path

Identifier: This is the unique name given to the MajorBBS/Worldgroup module. This is usually the DLL name (Example: TSGARN)

Path: This is the absolute path on the file system to the folder containing the module (Example: c:\\dos\\modules\\telearena\\). Using this path variable, modules can now live in their own folders vs. having to all be installed in a single directory as MajorBBS/Worldgroup required.

MenuOptionKey: MBBSEmu will specify a default value for each module that can be entered at the main menu. If you want to use a custom value for a module (such as T for Tele-Arena), you can specify it using this option. (Modules with Duplicate MenuOptionKey values will be ignored, A-Z or 0-9 accepted)

Enabled: 1 = “true” and is default, which enables the module. 0 = “false” and will load the module in a disabled state – this can be enabled using the sysop commands “/sys enable <moduleid>”

Patch: As of PR #502, MBBSEmu has implemented SoftPatch support which allows you to apply custom hex edits/string edits directly to a module on load without having to make any modifications to the module DLL file.

Note: Because the file is JSON, on Windows platforms you must escape the backslash in the path with \\\\ (See Below)

Example File

  "Modules": [
      "Identifier": "EXAMPLE1",
      "Path": "c:\\bbsv6\\"
      "Identifier": "EXAMPLE2",
      "Path": "c:\\bbsv6\\",
      "MenuOptionKey": "E"
mbbsemu/configuration/modules.json.txt · Last modified: 2023/12/09 21:51 by enusbaum