Kalgoorlie Retro Docs

Documentation for the Kalgoorlie Retro BBS, its games and servers

User Tools

Site Tools

You are here: Kalgoorlie Retro Docs » LORD Server for Windows » For sysops: link your BBS to our LORD Server
lordsrv:link_your_bbs

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
lordsrv:link_your_bbs [2026-10-29 00:59] – external edit 127.0.0.1lordsrv:link_your_bbs [2026-10-29 01:00] (current) – external edit 127.0.0.1
Line 4: Line 4:
  
 You do it once, in two parts: You do it once, in two parts:
-  - **Get a key.** You connect to our server once and sign your BBS up. It gives you a key: a code like ''7KQ2-M9XD-4TPW-H3NC'' that proves the players are coming from your BBS. + 
-  - **Add a door** to your BBS that connects to our server and sends that key.+**1.** **Get a key.** You connect to our server once and sign your BBS up. It gives you a key: a code like ''7KQ2-M9XD-4TPW-H3NC'' that proves the players are coming from your BBS. 
 + 
 +**2.** **Add a door** to your BBS that connects to our server and sends that key. 
 Allow about ten minutes. Pick your BBS software below and follow its steps from top to bottom. Allow about ten minutes. Pick your BBS software below and follow its steps from top to bottom.
  
 ===== A few words first ===== ===== A few words first =====
 +
 ^ Word ^ What it means here ^ ^ Word ^ What it means here ^
 | **rlogin** | The way one BBS sends a caller to another computer, already logged in. Synchronet, Mystic and most other BBS software can do it. Your door uses it to reach our server. | | **rlogin** | The way one BBS sends a caller to another computer, already logged in. Synchronet, Mystic and most other BBS software can do it. Your door uses it to reach our server. |
Line 24: Line 28:
 Whichever BBS software you use, signing up shows this screen. Type your BBS's name and press Enter, type your tag and press Enter, then press **Y**: Whichever BBS software you use, signing up shows this screen. Type your BBS's name and press Enter, type your tag and press Enter, then press **Y**:
 <code> <code>
-  LORD Server: BBS sign-up +LORD Server: BBS sign-up 
-  ------------------------------------------------------------+------------------------------------------------------------
  
-  This gives your BBS a key, so your door can send players here. +This gives your BBS a key, so your door can send players here. 
-  Each of your players gets their own account, so a player with the +Each of your players gets their own account, so a player with the 
-  same name on another BBS is someone else.+same name on another BBS is someone else.
  
-  BBS name: The Example BBS+BBS name: The Example BBS
  
-  A short tag for your BBS, 2 to 8 letters or digits.  It goes after +A short tag for your BBS, 2 to 8 letters or digits.  It goes after 
-  your players' names in this server's lists: Bob@TAG. +your players' names in this server's lists: Bob@TAG. 
-  Tag: EXB+Tag: EXB
  
-  Sign up "The Example BBS" as EXB? (Y/n) Yes+Sign up "The Example BBS" as EXB? (Y/n) Yes
  
-  Signed up.  Your BBS key is:+Signed up.  Your BBS key is:
  
-      7KQ2-M9XD-4TPW-H3NC+7KQ2-M9XD-4TPW-H3NC
  
-  Write it down now: it isn't shown again.+Write it down now: it isn't shown again.
 </code> </code>
 **Write the key down** (or copy it from your terminal window) before you press a key: the screen closes and the key is never shown again. If the tag is taken, it asks for another. If you press **N**, nothing is saved and you can start again. **Write the key down** (or copy it from your terminal window) before you press a key: the screen closes and the key is never shown again. If the tag is taken, it asks for another. If you press **N**, nothing is saved and you can start again.
Line 54: Line 58:
 ==== Way 1: sign up from the main menu, then make the door ==== ==== Way 1: sign up from the main menu, then make the door ====
 **Get the key** **Get the key**
-  - Log in to your BBS as the sysop, with a terminal program (SyncTERM, NetRunner and so on). + 
-  - At the main menu, type this exactly, starting with the semicolon, and press Enter:<code>;EXEC ?rlogin bbs.theiguru.au:5130 -s register -P</code> The semicolon tells Synchronet this is a sysop command. ''EXEC'' runs the rest of the line; ''?rlogin'' is Synchronet's rlogin program; ''-s register'' asks our server for the sign-up screen; ''-P'' starts without a pause. +**1.** Log in to your BBS as the sysop, with a terminal program (SyncTERM, NetRunner and so on). 
-  - Synchronet asks for your **system password** (the one set in SCFG > System). Type it and press Enter. + 
-  - The sign-up screen appears. Fill it in as shown above and **write down the key**. +**2.** At the main menu, type this exactly, starting with the semicolon, and press Enter:<code>;EXEC ?rlogin bbs.theiguru.au:5130 -s register -P</code> The semicolon tells Synchronet this is a sysop command. ''EXEC'' runs the rest of the line; ''?rlogin'' is Synchronet's rlogin program; ''-s register'' asks our server for the sign-up screen; ''-P'' starts without a pause. 
-  - Press a key. You are back at your main menu.+ 
 +**3.** Synchronet asks for your **system password** (the one set in SCFG > System). Type it and press Enter. 
 + 
 +**4.** The sign-up screen appears. Fill it in as shown above and **write down the key**. 
 + 
 +**5.** Press a key. You are back at your main menu.
  
 **Make the door** **Make the door**
-  - On the computer running Synchronet, open a command prompt or terminal and run SCFG: ''/sbbs/exec/scfg'' on Linux (as the user the BBS runs as), or ''C:\sbbs\exec\scfg.exe'' on Windows. + 
-  - Choose **External Programs**, then **Online Programs...**. +**1.** On the computer running Synchronet, open a command prompt or terminal and run SCFG: ''/sbbs/exec/scfg'' on Linux (as the user the BBS runs as), or ''C:\sbbs\exec\scfg.exe'' on Windows. 
-  - You see a list of program sections (for example "Games" or "Doors"). Choose the one you want the door in, and press Enter. + 
-  - You see the list of programs in that section. Press the **Insert** key (or move to the empty line at the bottom and press Enter) to add one. +**2.** Choose **External Programs**, then **Online Programs...**. 
-  - At **Online Program Name**, type what your callers will see, e.g. ''LORD - Kalgoorlie Retro'', and press Enter. + 
-  - At **Internal Code**, type a short code with no spaces, e.g. ''LORDKRG'', and press Enter. +**3.** You see a list of program sections (for example "Games" or "Doors"). Choose the one you want the door in, and press Enter. 
-  - The new program's settings open. Move to each of these with the arrow keys, press Enter, and set it:+ 
 +**4.** You see the list of programs in that section. Press the **Insert** key (or move to the empty line at the bottom and press Enter) to add one. 
 + 
 +**5.** At **Online Program Name**, type what your callers will see, e.g. ''LORD - Kalgoorlie Retro'', and press Enter. 
 + 
 +**6.** At **Internal Code**, type a short code with no spaces, e.g. ''LORDKRG'', and press Enter. 
 + 
 +**7.** The new program's settings open. Move to each of these with the arrow keys, press Enter, and set it: 
 ^ Setting ^ Set it to ^ ^ Setting ^ Set it to ^
 | Command Line | ''?rlogin bbs.theiguru.au:5130 -s 7KQ2-M9XD-4TPW-H3NC -t xtrn=A -P'' \\ (with **your** key in place of ''7KQ2-M9XD-4TPW-H3NC'') | | Command Line | ''?rlogin bbs.theiguru.au:5130 -s 7KQ2-M9XD-4TPW-H3NC -t xtrn=A -P'' \\ (with **your** key in place of ''7KQ2-M9XD-4TPW-H3NC'') |
Line 73: Line 90:
 | Native Executable/Script | No | | Native Executable/Script | No |
 | BBS Drop File Type | None | | BBS Drop File Type | None |
-  Leave everything else as it is. Start-up Directory stays blank. + 
-  - Press **Esc** until SCFG asks **Save Changes?**, and answer **Yes**. Then leave SCFG. Synchronet picks up the change by itself within a minute or so (or restart the BBS).+Leave everything else as it is. Start-up Directory stays blank. 
 + 
 +**8.** Press **Esc** until SCFG asks **Save Changes?**, and answer **Yes**. Then leave SCFG. Synchronet picks up the change by itself within a minute or so (or restart the BBS). 
 Now go to [[#try_it|try it]]. Now go to [[#try_it|try it]].
  
 ==== Way 2: a temporary door, then change it ==== ==== Way 2: a temporary door, then change it ====
 **Make a temporary sign-up door** **Make a temporary sign-up door**
-  - Run SCFG and add a program as in Way 1 above (External Programs > Online Programs... > your section > Insert), named e.g. ''LORD sign-up'' with Internal Code ''LORDREG''. + 
-  - Set these:+**1.** Run SCFG and add a program as in Way 1 above (External Programs > Online Programs... > your section > Insert), named e.g. ''LORD sign-up'' with Internal Code ''LORDREG''. 
 + 
 +**2.** Set these: 
 ^ Setting ^ Set it to ^ ^ Setting ^ Set it to ^
 | Command Line | ''?rlogin bbs.theiguru.au:5130 -s register -P'' | | Command Line | ''?rlogin bbs.theiguru.au:5130 -s register -P'' |
 | Access Requirements | ''SYSOP'' (so only you can run it while it is there) | | Access Requirements | ''SYSOP'' (so only you can run it while it is there) |
 | BBS Drop File Type | None | | BBS Drop File Type | None |
-  - Press **Esc**, answer **Yes** to Save Changes, and leave SCFG.+ 
 +**3.** Press **Esc**, answer **Yes** to Save Changes, and leave SCFG.
  
 **Get the key** **Get the key**
-  - Log in to your BBS as the sysop, open your door menu, and run **LORD sign-up**. + 
-  - Fill in the sign-up screen and **write down the key**. Press a key to go back to your BBS.+**1.** Log in to your BBS as the sysop, open your door menu, and run **LORD sign-up**. 
 + 
 +**2.** Fill in the sign-up screen and **write down the key**. Press a key to go back to your BBS.
  
 **Change the same door into the real one** **Change the same door into the real one**
-  - Run SCFG again and go back to the same program (External Programs > Online Programs... > your section > **LORD sign-up**). + 
-  - Change these:+**1.** Run SCFG again and go back to the same program (External Programs > Online Programs... > your section > **LORD sign-up**). 
 + 
 +**2.** Change these: 
 ^ Setting ^ Change it to ^ ^ Setting ^ Change it to ^
 | Name | ''LORD - Kalgoorlie Retro'' (what callers will see) | | Name | ''LORD - Kalgoorlie Retro'' (what callers will see) |
Line 99: Line 128:
 | Access Requirements | Clear it (blank), so all your callers can play. | | Access Requirements | Clear it (blank), so all your callers can play. |
 | Multiple Concurrent Users | Yes | | Multiple Concurrent Users | Yes |
-  - Press **Esc**, answer **Yes** to Save Changes, and leave SCFG.+ 
 +**3.** Press **Esc**, answer **Yes** to Save Changes, and leave SCFG. 
 Until you change it, the door shows the sign-up screen instead of the game, which is why it is limited to SYSOP in the meantime. Until you change it, the door shows the sign-up screen instead of the game, which is why it is limited to SYSOP in the meantime.
  
 ==== What the door's command line means ==== ==== What the door's command line means ====
 <code>?rlogin bbs.theiguru.au:5130 -s 7KQ2-M9XD-4TPW-H3NC -t xtrn=A -P</code> <code>?rlogin bbs.theiguru.au:5130 -s 7KQ2-M9XD-4TPW-H3NC -t xtrn=A -P</code>
 +
 ^ Part ^ Meaning ^ ^ Part ^ Meaning ^
 | ''?rlogin'' | Synchronet's own rlogin program. | | ''?rlogin'' | Synchronet's own rlogin program. |
Line 110: Line 142:
 | ''-t xtrn=A'' | Go straight into game A, and back to your BBS when the player quits. Without it, players see our server's game menu first. | | ''-t xtrn=A'' | Go straight into game A, and back to your BBS when the player quits. Without it, players see our server's game menu first. |
 | ''-P'' | Don't pause with "press a key" before connecting. Add ''-q'' as well to hide the "Connecting..." message. | | ''-P'' | Don't pause with "press a key" before connecting. Add ''-q'' as well to hide the "Connecting..." message. |
 +
 Synchronet sends each caller's **alias** as their name, so their account on our server is ''<alias>@<your tag>''. Synchronet sends each caller's **alias** as their name, so their account on our server is ''<alias>@<your tag>''.
  
Line 120: Line 153:
  
 ==== Step 1: add a temporary sign-up item ==== ==== Step 1: add a temporary sign-up item ====
-  - On the computer running Mystic, open its configuration: ''mystic -cfg'' (''mystic.exe -cfg'' on Windows), in Mystic's folder. + 
-  - Open the **Menu Editor** (in the **Editors** menu), choose your theme, and open the menu your doors are on (for example ''doors''; if you don't have one, use ''main''). +**1.** On the computer running Mystic, open its configuration: ''mystic -cfg'' (''mystic.exe -cfg'' on Windows), in Mystic's folder. 
-  - Insert a new menu item, and set:+ 
 +**2.** Open the **Menu Editor** (in the **Editors** menu), choose your theme, and open the menu your doors are on (for example ''doors''; if you don't have one, use ''main''). 
 + 
 +**3.** Insert a new menu item, and set: 
 ^ Item setting ^ Set it to ^ ^ Item setting ^ Set it to ^
 | Text | ''LORD sign-up'' | | Text | ''LORD sign-up'' |
 | Hot key | a letter not used on that menu, e.g. ''L'' | | Hot key | a letter not used on that menu, e.g. ''L'' |
 | Access | ''s255'' (sysop security level only, while it is there) | | Access | ''s255'' (sysop security level only, while it is there) |
-  - Give the item **one command**:+ 
 +**4.** Give the item **one command**: 
 ^ Command setting ^ Set it to ^ ^ Command setting ^ Set it to ^
 | Command | **IR** (Outbound RLOGIN connection) | | Command | **IR** (Outbound RLOGIN connection) |
 | Data | ''/addr=bbs.theiguru.au /port=5130 /user=@USER@ /pass=register'' | | Data | ''/addr=bbs.theiguru.au /port=5130 /user=@USER@ /pass=register'' |
-  - Save the menu. If the menu uses its own ANSI screen rather than a generated list, add the item to that screen too, or just press the hot key: it works even if it isn't shown.+ 
 +**5.** Save the menu. If the menu uses its own ANSI screen rather than a generated list, add the item to that screen too, or just press the hot key: it works even if it isn't shown.
  
 ==== Step 2: get the key ==== ==== Step 2: get the key ====
-  - Log in to your BBS as the sysop, go to that menu, and press the hot key (''L''). + 
-  - Fill in the sign-up screen and **write down the key**. Press a key to go back to your BBS.+**1.** Log in to your BBS as the sysop, go to that menu, and press the hot key (''L''). 
 + 
 +**2.** Fill in the sign-up screen and **write down the key**. Press a key to go back to your BBS.
  
 ==== Step 3: change the same item into the real door ==== ==== Step 3: change the same item into the real door ====
-  - Open the Menu Editor again and the same menu item. + 
-  - Change these:+**1.** Open the Menu Editor again and the same menu item. 
 + 
 +**2.** Change these: 
 ^ Setting ^ Change it to ^ ^ Setting ^ Change it to ^
 | Text | ''LORD - Kalgoorlie Retro'' (what callers will see) | | Text | ''LORD - Kalgoorlie Retro'' (what callers will see) |
 | Access | Clear it (blank), or the security level your callers have, so all of them can play. | | Access | Clear it (blank), or the security level your callers have, so all of them can play. |
 | Command data | ''/addr=bbs.theiguru.au /port=5130 /user=@USER@ /pass=7KQ2-M9XD-4TPW-H3NC /term=xtrn=A'' (with **your** key). In other words: replace ''register'' with your key, and add ''/term=xtrn=A'' at the end. | | Command data | ''/addr=bbs.theiguru.au /port=5130 /user=@USER@ /pass=7KQ2-M9XD-4TPW-H3NC /term=xtrn=A'' (with **your** key). In other words: replace ''register'' with your key, and add ''/term=xtrn=A'' at the end. |
-  - Save the menu.+ 
 +**3.** Save the menu.
  
 ==== What the data means ==== ==== What the data means ====
 +
 ^ Part ^ Meaning ^ ^ Part ^ Meaning ^
 | ''/addr=bbs.theiguru.au /port=5130'' | Our server and its port. | | ''/addr=bbs.theiguru.au /port=5130'' | Our server and its port. |
Line 152: Line 199:
 | ''/pass=<key>'' | Your key. | | ''/pass=<key>'' | Your key. |
 | ''/term=xtrn=A'' | Go straight into game A, and back to your BBS when the player quits. Without it, players see our server's game menu first. | | ''/term=xtrn=A'' | Go straight into game A, and back to your BBS when the player quits. Without it, players see our server's game menu first. |
 +
 Add ''/prompt'' if you'd rather not show Mystic's connecting messages. Mystic sends its user and password fields the other way round from Synchronet; our server takes them either way, so don't swap them. Add ''/prompt'' if you'd rather not show Mystic's connecting messages. Mystic sends its user and password fields the other way round from Synchronet; our server takes them either way, so don't swap them.
  
Line 158: Line 206:
 ===== Other BBS software ===== ===== Other BBS software =====
 Use your software's rlogin door, gateway or menu command. Sign up first with ''register'' as the server user name (some software calls it the password), write down the key, then change ''register'' to the key: Use your software's rlogin door, gateway or menu command. Sign up first with ''register'' as the server user name (some software calls it the password), write down the key, then change ''register'' to the key:
 +
 ^ rlogin setting ^ For the sign-up ^ For the real door ^ ^ rlogin setting ^ For the sign-up ^ For the real door ^
 | Address | ''bbs.theiguru.au'' | ''bbs.theiguru.au'' | | Address | ''bbs.theiguru.au'' | ''bbs.theiguru.au'' |
Line 164: Line 213:
 | Server user name (remote user; "password" on some software) | ''register'' | your key | | Server user name (remote user; "password" on some software) | ''register'' | your key |
 | Terminal type | anything | ''xtrn=A'' | | Terminal type | anything | ''xtrn=A'' |
 +
 If your software can't do this, email [[slaterm@theiguru.au]] with your BBS's name and the tag you'd like, and we'll send you a key. If your software can't do this, email [[slaterm@theiguru.au]] with your BBS's name and the tag you'd like, and we'll send you a key.
  
Line 169: Line 219:
  
 ===== Try it ===== ===== Try it =====
-  - Log in to your BBS as an **ordinary user** (not the sysop) and run the door. + 
-  - You should go straight into Legend of the Red Dragon. The first time, it asks you to make a character: a name, then male or female, then a class. +**1.** Log in to your BBS as an **ordinary user** (not the sysop) and run the door. 
-  - Play a little, then quit LORD (Q at the town square, then confirm). You should be back on your BBS.+ 
 +**2.** You should go straight into Legend of the Red Dragon. The first time, it asks you to make a character: a name, then male or female, then a class. 
 + 
 +**3.** Play a little, then quit LORD (Q at the town square, then confirm). You should be back on your BBS.
  
 If something is wrong: If something is wrong:
 +
 ^ You see ^ What to check ^ ^ You see ^ What to check ^
 | "this BBS has no key for LORD Server" | The key isn't reaching the server. Synchronet: it must come straight after ''-s''. Mystic: after ''/pass=''. Check for a typing mistake. Upper or lower case doesn't matter, and the dashes are optional. | | "this BBS has no key for LORD Server" | The key isn't reaching the server. Synchronet: it must come straight after ''-s''. Mystic: after ''/pass=''. Check for a typing mistake. Upper or lower case doesn't matter, and the dashes are optional. |
lordsrv/link_your_bbs.txt · Last modified: by 127.0.0.1