Skip to main content

luadch-ng

Plugins

82 plugins ship with the hub and load once you list them in cfg.scripts. Another 31 live in the companion repository and are copied in by hand. The tags say which release lines each one runs on and how much testing it has had; the legend below spells them out.

113 of 113

PluginAvailable inPurpose
bot_advanced_chatBots · optional3.1T1Chat room with history, member management and PM-to-op forwarding
bot_opchatBots · bundled3.13.2Internal op-chat bot for operator coordination
bot_pm2opsBots · bundled3.13.2Routes operator private messages to the opchat bot
bot_regchatBots · bundled3.13.2Registered-user chat with optional message history
bot_session_chatBots · bundled3.13.2Temporary per-session chats for user collaboration
cmd_accinfoCommands · bundled3.13.2Display extended account details for registered users
cmd_asciiCommands · bundled3.1ASCII art command, moved to the companion repository
cmd_asciiCommands · optional3.1T1ASCII art command, retired from the bundled tree
cmd_banCommands · bundled3.13.2Ban / unban users by nick, CID, or IP with optional duration and reason
cmd_botflagCommands · bundled3.2Toggle the bot icon (ADC CT bot bit) on a registered account, no privilege change
cmd_delregCommands · bundled3.13.2Delete registrations by nick
cmd_disconnectCommands · bundled3.13.2Forcefully disconnect a user with optional reason message
cmd_errorsCommands · bundled3.13.2Display the hub error log to users with sufficient permissions
cmd_gagCommands · bundled3.13.2Mute, kennylize (garble), or shadowmute users with optional duration
cmd_helpCommands · bundled3.13.2Central help registry for all operator commands
cmd_hubinfoCommands · bundled3.13.2Display comprehensive hub information
cmd_hubstatsCommands · bundled3.13.2Track hub statistics over time (user averages, share, registrations, bans)
cmd_mainclearCommands · optional3.1T1Clears the main chat display
cmd_massCommands · bundled3.13.2Broadcast mass messages to all users or specific user levels
cmd_myinfCommands · bundled3.13.2Display own or target user's raw INF command output (client information)
cmd_myipCommands · bundled3.13.2Display own or target user's IP address
cmd_nickchangeCommands · bundled3.13.2Change registered user nicknames
cmd_pm2offlinersCommands · optional3.1T1Sends a private message to an offline user, delivered at their next login
cmd_redirectCommands · bundled3.13.2Redirect users to an alternate hub URL based on level or manual command
cmd_regCommands · bundled3.13.2Register new users or add / modify registration descriptions
cmd_reloadCommands · bundled3.13.2Reload hub configuration, user database, and restart scripts without full hub restart
cmd_restartCommands · bundled3.13.2Gracefully restart the hub with optional broadcast message to users
cmd_rulesCommands · bundled3.13.2Display hub rules to users (sent at login or on command)
cmd_setpassCommands · bundled3.13.2Set or change passwords for registered users
cmd_shutdownCommands · bundled3.13.2Gracefully shut down the hub with optional broadcast message
cmd_slotsCommands · bundled3.13.2Display list of all currently connected users with available upload slots
cmd_sslinfoCommands · bundled3.13.2Display TLS / SSL connection information for user's client
cmd_talkCommands · bundled3.13.2Broadcast messages anonymously without nickname prefix
cmd_topicCommands · bundled3.13.2Set or reset the hub topic string
cmd_upgradeCommands · bundled3.13.2Set or change a registered user's level by SID or nick
cmd_uptimeCommands · bundled3.13.2Display hub uptime (session and cumulative since first start)
cmd_usercleanerCommands · bundled3.13.2Show and remove inactive or never-used accounts
cmd_userinfoCommands · bundled3.13.2Display user information (nick, level, IP, features, share, slots)
cmd_userlistCommands · bundled3.13.2List all registered users sorted by level or registration date
cmd_usersearchCommands · bundled3.13.2Search registered users by partial nick match
etc_aliasesUtility · bundled3.2Operator-defined command aliases
etc_auditlogUtility · bundled3.2Persistent JSONL audit trail for staff actions
etc_backupUtility · bundled3.2Automatic encrypted local backups of the hub's restore-critical state, rotated on a schedule
etc_bannerUtility · bundled3.13.2Broadcast periodic banner messages to main chat at configurable intervals
etc_banner_modUtility · optional3.1T1Shows a banner or message of the day on login
etc_blackboardUtility · optional3.1T1Shared note board with add, delete and show commands
etc_blacklistUtility · bundled3.13.2Maintain and display the blacklist of delreg'd users to prevent re-registration
etc_blocklistUtility · bundled3.2Operator-facing chat command for the unified pre-handshake IP/CIDR blocklist
etc_blocklist_feedsUtility · bundled3.2External IP/CIDR blocklist feed puller
etc_ccpmblockerUtility · optional3.1T1Restricts client-to-client private messages to operators and above
etc_chatlogUtility · bundled3.13.2Log main chat messages with timestamps, user nicks, and message content
etc_client_su_checkUtility · optional3.1T1Warns or blocks clients with missing or invalid SU features
etc_clientblockerUtility · bundled3.2Block clients by Lua-pattern match against the BINF `AP+VE` field
etc_cmdlogUtility · bundled3.13.2Audit log of all operator `+cmd` invocations (who, what, when)
etc_dhtblockerUtility · bundled3.13.2Disconnect users with DHT (Distributed Hash Table) search enabled
etc_dummy_warningUtility · bundled3.13.2Warn level-100 admin on login if the default "dummy" account is still registered
etc_EventAnnouncerUtility · optional3.1T1Announces scheduled events at a configurable interval
etc_forcetlstransferUtility · bundled3.2Force TLS-encrypted client-to-client transfers (force ADCS)
etc_geoipUtility · bundled3.2Country / ASN policy blocking via a MaxMind GeoLite2 database
etc_hide_announcerUtility · optional3.1T1Keeps user announcements out of public view
etc_hubcommandsUtility · bundled3.13.2Internal registry module for `+cmd` handlers
etc_hubportierUtility · optional3.1T1Limits concurrent connections per user or IP
etc_keyprintUtility · bundled3.13.2Automatically extract and cache hub certificate keyprint (SHA256) for client validation
etc_levelcheckUtility · optional3.1T1Reports a user's level by private message
etc_lockdownUtility · bundled3.2Transient maintenance-mode access gate: temporarily admit only users at or above a given level
etc_log_cleanerUtility · bundled3.13.2Clean error.log and cmd.log files
etc_mainechoUtility · optional3.1T1Echoes main chat messages
etc_maxhubs_announcerUtility · optional3.1T1Announces how many hubs a user is connected to on login
etc_messengerUtility · optional3.1T1Private-message delivery with a queue
etc_motdUtility · bundled3.13.2Send message-of-the-day to users on login
etc_msgmanagerUtility · bundled3.13.2Block main chat and / or PM for specific user levels
etc_NewPasswordsUtility · optional3.1T1Lets registered users change their own password
etc_noadvertiseUtility · optional3.1T1Blocks configurable forbidden strings in main chat and private messages
etc_onfailedauthUtility · bundled3.13.2Send report when user fails authentication (bad password, IP ban, etc)
etc_onlinecounterUtility · optional3.1T2Tracks online time and can gate search and download below a threshold
etc_openhubs_announcerUtility · optional3.1T1Announces how many open hubs a user is in
etc_prometheusUtility · bundled3.2Prometheus text-exposition `/metrics` endpoint for the HTTP API
etc_proxydetectUtility · bundled3.2Live proxy / VPN / Tor detection via an external provider API on connect
etc_recordsUtility · bundled3.13.2Track and display hub records (peak users, largest user share, etc)
etc_regserver_announceUtility · bundled3.2Announces this hub to an external ADC hublist regserver
etc_reportUtility · bundled3.13.2Internal library for sending operator reports to hub bot and / or opchat
etc_requestsUtility · optional3.1T2Release request board where users ask and others fulfil
etc_sslonlyUtility · optional3.1T1Disconnects users who connect without TLS
etc_status_pushUtility · bundled3.2Periodically pushes the hub's public status to an external HTTP(S) endpoint
etc_trafficmanagerUtility · bundled3.13.2Block downloads, uploads, and searches for specific users
etc_unknown_commandUtility · bundled3.13.2Reject mistyped or malformed commands in main chat with helpful error message
etc_usercommandsUtility · bundled3.13.2Internal registry module for client right-click context menus
etc_userlogininfoUtility · bundled3.13.2Display detailed user connection info on login
etc_webhookUtility · bundled3.2Inbound webhook receiver: an external service POSTs an HMAC-signed JSON body, announced in chat as a named bot
etc_whitelistUtility · bundled3.2Operator-facing chat command for the global IP/CIDR allowlist
etc_wunschbrettUtility · optional3.1T1Wishlist board with comments and votes
hub_bot_cleanerHub management · bundled3.13.2Remove unused bot accounts from user database on timer
hub_cmd_managerHub management · bundled3.13.2Enforce permission levels on direct ADC commands (EMSG, DMSG, SCH, etc)
hub_inf_managerHub management · bundled3.13.2Validate user INF flags on connect and broadcast
hub_runtimeHub management · bundled3.13.2Track cumulative hub runtime (survives restarts) and provide show / reset commands
hub_user_lastseenHub management · bundled3.13.2Update `lastseen` timestamp in user database on periodic timer
ptx_anti_dlPtokaX ports · optional3.1T1Blocks matching client profiles from searching and downloading
ptx_freshstuffPtokaX ports · optional3.1T2Release announce bot with categories, scheduled broadcasts and rankings
ptx_poll_botPtokaX ports · optional3.1T1needs v3.1.7Polls and voting, with results in chat
ptx_rotatingtopicPtokaX ports · optional3.1T1Rotates the hub topic at a configurable interval
ptx_RSSFeedWatchPtokaX ports · optional3.1T2needs v3.1.2Posts new RSS or Atom items into the hub
ptx_tagcheckPtokaX ports · optional3.1T1Validates release tags and blocks invalid ones
ptx_tophubbersPtokaX ports · optional3.1T1Ranks and announces the most active users
usr_desc_prefixUser restriction · bundled3.13.2Prepend level-based prefix to user descriptions (e.g. `[VIP]`, `[MOD]`)
usr_hide_shareUser restriction · bundled3.13.2Hide share size for specified user levels
usr_hubsUser restriction · bundled3.13.2Enforce minimum / maximum hub count per level
usr_nick_lengthUser restriction · bundled3.13.2Enforce min / max nickname length on connect and INF updates
usr_nick_prefixUser restriction · bundled3.13.2Prepend level-based prefix to user nicknames (e.g. `[Op]Bob`, `[VIP]Alice`)
usr_nick_prefix_modUser restriction · optional3.1T1Adds a cosmetic prefix to nicks
usr_shareUser restriction · bundled3.13.2Enforce minimum / maximum share per user level
usr_slotsUser restriction · bundled3.13.2Enforce minimum / maximum upload slots per user level
usr_speedinfoUser restriction · optional3.1T1Shows a user's connection speed on request
usr_uptimeUser restriction · bundled3.13.2Track per-user session and cumulative online time
3.13.2
The hub release lines a plugin runs on. For bundled plugins this is simply which line ships it. For optional ones it records where it has been run: the companion repository targets 3.1.x, and a missing 3.2 means nobody has checked yet, not that it is broken. That check matters because the plugin sandbox was tightened for 3.2, so a plugin that is fine on 3.1 can still fail there.
T1T2
The tier from the import audit of the companion repository, not a statement about hub versions. T1 is a low-risk drop-in: audited for Lua 5.4 and it loads cleanly. T2 passed the same audit but is worth testing on your own hub first, because of its size, complexity or because it talks to the outside world.
needs v3.1.7
A minimum hub version the plugin itself states in its header. Only a couple of them do.

Bundled entries link to their section in the hub documentation. Optional entries link to their directory in luadch-ng/scripts, where each plugin carries its own README with commands and config keys.