Built-in Modules

Every screen on an ENiGMA½ board is a menu module. Most are the standard handler, which needs no code — but a good number of features ship as purpose-built modules, and each of those accepts its own config block and exposes its own fields for theming.

This section is the reference for the modules ENiGMA½ ships with. You do not need to write any code to use them: point a menu.hjson entry at one, supply its config, and style it from your theme.hjson.

Note

If you are looking to write your own module rather than configure one that ships with the system, see Menu Modules.

Message Base

Module	What it does
Message Conference & Area Lists	Browsing and changing conference and area
Configure Newscan	Which conferences, areas and file areas a user’s newscan covers
Set Newscan Date	Resetting a newscan pointer to a chosen date
Auto Signature Editor	Editing the signature appended to a user’s posts
ActivityPub Message Browser	Listing Notes received from the Fediverse
ActivityPub Message Viewer	Reading a single Fediverse Note

File Base

Module	What it does
File Area List	Browsing, searching and queueing files
File Base Download Managers	The legacy and web download queues
File Transfer Protocol Select	Picking X/Y/ZModem before a transfer

Users & Social

Module	What it does
Who’s Online	Who is connected right now, and what they are doing
Last Callers	Who called recently, with action indicators
User List	All users on the system
TopX	Top user statistics for the week, month or all time
Node to Node Messaging	Sending a message to a user on another node
Onelinerz	The retro onelinerz wall
Rumorz	The classic rumorz board
BBS List	A user-maintained list of other boards

SysOp & Account

Module	What it does
Waiting For Caller (WFC)	The sysop dashboard — node status, live logs and actions
Sysop Chat	Two-way split-screen chat with a connected user
Pre-Auth Feedback	Letting visitors write to the sysop before logging in
2FA/OTP Config	Where users opt in to two-factor authentication

Display

Module	What it does
Show Art	Advanced art display beyond a standard menu’s art spec

Configuring a Module

A module is attached to a menu entry with module, and configured through the config block of that entry:

lastCallers: {
    art: LASTCALL
    module: last_callers
    config: {
        dateTimeFormat: ddd MMM Do
    }
    form: {
        0: {
            mci: {
                VM1: { height: 14 }
            }
        }
    }
}

Each page below documents that module’s config keys and the itemFormat fields it makes available. See Menu HJSON for the surrounding menu entry, MCI Codes for the format syntax, and Themes for where per-menu styling lives.