This is an old revision of the document!
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 lord LORD "Legend of the Red Dragon" doorhub door add reach REACH "Ember Reach" doorhub door add seal SEAL "The Broken Seal" doorhub door add wake LONGWAKE "The Long Wake"
4. Tell your members the code, so they can add a direct entry (?doorhub.js seal).
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 lord LORD Legend of the Red Dragon open 2 reach REACH Ember Reach open 2 seal SEAL The Broken Seal open 0 wake LONGWAKE The Long Wake 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.