Kalgoorlie Retro Docs

Documentation for the Kalgoorlie Retro BBS, its games and servers

User Tools

Site Tools


lordkg:start

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
lordkg:start [2026-11-08 15:33] – external edit 127.0.0.1lordkg:start [2026-11-11 13:16] (current) – Main address is now kalretro.au slaterm
Line 6: Line 6:
   * **LORD 4.07 / 4.08 Beta**: the codes depend on the sysop name and the BBS name. (The 2009 patch shows itself as "4.08 Beta".)   * **LORD 4.07 / 4.08 Beta**: the codes depend on the sysop name and the BBS name. (The 2009 patch shows itself as "4.08 Beta".)
  
-The current version is **1.1** (8 November 2026).+The current version is **1.3** (9 November 2026). It fixes the LORD 4.06 codes: those from 1.1 and 1.2 were wrong, so if you used one of them for LORD 4.06, make a new set.
  
 ===== Why it exists ===== ===== Why it exists =====
Line 18: Line 18:
 | ''LORDKG.PY'' | The Python 3 version, for Linux, Windows and macOS (no extra modules) | | ''LORDKG.PY'' | The Python 3 version, for Linux, Windows and macOS (no extra modules) |
 | ''LORDKG.PAS'' | The Free Pascal source of LORDKG.EXE | | ''LORDKG.PAS'' | The Free Pascal source of LORDKG.EXE |
 +| ''sbbs/lordkg.js'' | A sysop-only door for Synchronet BBS (see [[#the_synchronet_door|below]]) |
 +| ''sbbs/lordkglb.js'' | The door's code calculations |
 | ''LORDKG.TXT'' | The manual | | ''LORDKG.TXT'' | The manual |
 | ''FILE_ID.DIZ'' | File description | | ''FILE_ID.DIZ'' | File description |
 | ''COPYING'' | The GNU General Public License, version 2 | | ''COPYING'' | The GNU General Public License, version 2 |
  
-Both programs work the same way and give the same codes.+All three versions work the same way and give the same codes.
  
 ===== Using it ===== ===== Using it =====
Line 57: Line 59:
  Regcode #3 -> 9377  Regcode #3 -> 9377
  Regcode #4 -> 6052  Regcode #4 -> 6052
- Regcode #5 -> 22281+ Regcode #5 -> 19255
 -=-=-=-=-=-=-=-=-=-=- -=-=-=-=-=-=-=-=-=-=-
 </code> </code>
Line 65: Line 67:
 ^ Command ^ What it does ^ ^ Command ^ What it does ^
 | ''LORDKG /406'' | Random LORD 4.06 codes | | ''LORDKG /406'' | Random LORD 4.06 codes |
-| ''LORDKG /406 1000 0 0 0'' | LORD 4.06 with your own first four numbers (0-10000, adding up to at least 971); LORDKG works out the fifth |+| ''LORDKG /406 1000 0 0 0'' | LORD 4.06 with your own first four numbers (0-10000; #1 + #2 + #3 + half of #4 must be at least 971); LORDKG works out the fifth |
 | ''LORDKG /407 "Sysop" "BBS Name"'' | LORD 4.07 codes | | ''LORDKG /407 "Sysop" "BBS Name"'' | LORD 4.07 codes |
 | ''LORDKG /407 /U Sysop BBS_Name'' | The same, with ''_'' for each space, for shells and menus that can't pass quotes | | ''LORDKG /407 /U Sysop BBS_Name'' | The same, with ''_'' for each space, for shells and menus that can't pass quotes |
Line 89: Line 91:
  
 LORD 4.06 asks for no names, and the numbers aren't tied to your board: any set that passes the check works. LORDKG picks a random set so that different boards don't all use the same code. LORD 4.06 asks for no names, and the numbers aren't tied to your board: any set that passes the check works. LORDKG picks a random set so that different boards don't all use the same code.
 +
 +===== The Synchronet door =====
 +
 +The ''sbbs'' folder in the zip has LORDKG as a JavaScript door for Synchronet BBS, with the same menu as LORDKG.EXE:
 +
 +<code>
 + Which LORD version is the key for?
 +
 +   1) LORD 4.06
 +   2) LORD 4.07 / 4.08 Beta
 +   Q) Quit
 +</code>
 +
 +Choose 1 for a random LORD 4.06 set, or 2 and type the sysop name and BBS name for LORD 4.07 (leave a name blank to go back). Each set of codes is shown with a reminder of where to type it in LORDCFG. It was tested on Synchronet 3.21 for Linux, and uses only Synchronet's standard JavaScript, so it should work the same on Windows.
 +
 +The door is a sysop tool: make it sysop-only, so callers never see it.
 +
 +==== Installing the door ====
 +
 +  - Make a folder ''xtrn/lordkg'' in your Synchronet directory (for example ''/sbbs/xtrn/lordkg'' or ''C:\SBBS\XTRN\LORDKG'') and copy ''lordkg.js'' and ''lordkglb.js'' from the zip's ''sbbs'' folder into it. Keep the names in lower case: Synchronet on Linux looks for exactly these names.
 +  - Run SCFG, choose **External Programs**, then **Online Programs (Doors)**, pick a sysop-only section (the stock **Operator** section is one) and add a program:
 +
 +^ Setting ^ Value ^
 +| Name | ''LORDKG - LORD Registration Codes'' |
 +| Internal Code | ''LORDKG'' |
 +| Start-up Directory | ''../xtrn/lordkg'' |
 +| Command Line | ''?lordkg.js'' |
 +| Access Requirements | ''SYSOP'' |
 +| Execution Requirements | ''SYSOP'' |
 +
 +Leave the other settings as they are. The ''?'' at the start of the command line tells Synchronet that it is a JavaScript module.
 +
 +If you edit ''ctrl/xtrn.ini'' by hand instead, the entry looks like this (''OPERATOR'' is the section's internal code):
 +
 +<code>
 +[prog:OPERATOR:LORDKG]
 +        name=LORDKG - LORD Registration Codes
 +        ars=SYSOP
 +        execution_ars=SYSOP
 +        cmd=?lordkg.js
 +        startup_dir=../xtrn/lordkg
 +</code>
 +
 +Save and exit SCFG; Synchronet loads the change the next time a node is free. Log on as a sysop and find LORDKG under External Programs. The Kalgoorlie Retro BBS runs it in its Operator section.
  
 ===== How the codes are worked out ===== ===== How the codes are worked out =====
Line 96: Line 142:
 LORDCFG.EXE 4.06 only checks that the five numbers fit together: LORDCFG.EXE 4.06 only checks that the five numbers fit together:
  
-**Code 5 = Code 1 + Code 2 + Code 3 + Code 4 + 29**+**Code 5 = Code 1 + Code 2 + Code 3 + (Code 4 / 2) + 29**
  
-Codes 1 to 4 must each be from 0 to 10000, and code 5 must be at least 1000, so the first four must add up to at least 971. This was read from the checking code in LORDCFG.EXE 4.06 itself. LORDKG's random codes 1 to 4 are each from 1000 to 9999, which always passes.+Code 4 counts at half its value, rounded down: 6052 counts as 3026. Codes 1 to 4 must each be from 0 to 10000, and code 5 must be at least 1000. This was read from the checking code in LORDCFG.EXE 4.06 itself, and LORD.EXE 4.06 checks the codes again the same way each time it starts. LORDKG's random codes 1 to 4 are each from 1000 to 9999, which always passes.
  
 ==== LORD 4.07 / 4.08 Beta ==== ==== LORD 4.07 / 4.08 Beta ====
Line 111: Line 157:
 | 5 | Half of each BBS name character (rounded down), added up, kept to 16 bits, then doubled. | | 5 | Half of each BBS name character (rounded down), added up, kept to 16 bits, then doubled. |
  
-The Python and Pascal versions were checked against each other on 4,913 random and edge-case name pairs, and the DOS build in DOSBox. Both also give the sample codes that came with ''lord47kg.exe'' (sysop / bbs: 45788 29601 846 7216 782), and every LORD 4.06 set they make is checked against the rule above.+The Python and Pascal versions were checked against each other on 4,913 random and edge-case name pairs, and the DOS build in DOSBox. Both also give the sample codes that came with ''lord47kg.exe'' (sysop / bbs: 45788 29601 846 7216 782), and every LORD 4.06 set they make is checked against the rule above. The Synchronet door's calculations were checked against the Python version on 3,001 name pairs.
  
 ===== Building LORDKG.EXE ===== ===== Building LORDKG.EXE =====
Line 125: Line 171:
 ===== Downloads ===== ===== Downloads =====
  
-From [[https://retro.theiguru.au/lordkg/]], or the **Heisenbergs Files** area on the BBS: ''LORDKG11.ZIP''.+From [[https://kalretro.au/lordkg/]], or the **Heisenbergs Files** area on the BBS: ''LORDKG13.ZIP''. 
 + 
 +The same places also have **LORD Keygen** (''lord-keygen_0.1.1_amd64.deb''), a separate desktop app for Ubuntu and Debian (amd64) that makes LORD 4.06 codes only. You pick the first four numbers with sliders or at random, it works out the fifth, and it can check a code you type. Install it with ''sudo apt install ./lord-keygen_0.1.1_amd64.deb''. Version 0.1.1 has the same LORD 4.06 fix as LORDKG 1.3: 0.1.0 counted all of the fourth number, so its codes were refused. LORD Keygen is free software under the GNU GPL (version 2 or later), and the package includes its Rust source.
  
 ===== Licence ===== ===== Licence =====
lordkg/start.1794152005.txt.gz · Last modified: by 127.0.0.1