Table of Contents
Games
A hub game is a door that's installed on your door BBS (your Synchronet), plus an entry in the hub that gives it a code and a name.
Adding a game
1. Install the door on your Synchronet in the usual way (SCFG, External Programs, Online Programs). It can be in any section. Make sure a new user can run it: the section's and the program's Access Requirements must not be SYSOP. See Prepare the door BBS.
2. Test it as an ordinary user. Log on to your Synchronet as a new user and run the door.
3. Add it to the hub:
doorhub door add <code> <INTERNAL CODE> "<name>"
| Part | Meaning |
|---|---|
code | What member BBSes send to start this game, for example lord. Lower case letters, digits, - and _, up to 20 characters. |
INTERNAL CODE | The door's Internal Code in SCFG on your Synchronet. |
name | Shown in the hub menu. |
It's in the menu straight away; no restart needed.
The Kalgoorlie Door Hub was set up with:
doorhub door add ec EC "Esterian Conquest" doorhub door add lord LORD406 "Legend of the Red Dragon 4.06" doorhub door add tw TW2002 "TradeWars 2002 (Kalgoorlie Local)" doorhub door add twgs TWGS "TradeWars 2002 (TWGS Galaxy Server)" doorhub door add bre BRE "Barren Realms Elite"
4. Tell your members the code, so they can add a direct entry (?doorhub.js bre).
Managing games
doorhub door list games, open or closed, play counts doorhub door disable <code> close a game for a while doorhub door enable <code> doorhub door rename <code> "<name>" doorhub door remove <code>
$ doorhub door list CODE XTRN NAME STATUS PLAYS ec EC Esterian Conquest open 0 lord LORD406 Legend of the Red Dragon 4.06 open 4 tw TW2002 TradeWars 2002 (Kalgoorlie Local) open 0 twgs TWGS TradeWars 2002 (TWGS Galaxy Server) open 0 bre BRE Barren Realms Elite open 0
A closed game leaves the menu. A member entry that asks for it directly gets “That game is closed at the moment” and the hub menu instead.
The menu
The menu lists open games in name order with keys 1-9 then A-Z (no Q, which returns the player to their BBS), so up to 34 games fit. A player who presses nothing for 5 minutes is sent back to their BBS.
Licences
Only share doors you're allowed to. Your own doors and free software are fine. Some commercial door registrations cover one BBS; check before offering them to other boards.
Maintenance
Games keep running their own nightly maintenance on your Synchronet as usual (timed events). The hub doesn't change that.