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.