Welcome to gOLD mINE

gOLD mINE (named after a coin-op arcade near where j0hnny a1pha grew up) is a terminal-based Community Door Server for BBS games. Open to all, easy to access with modern BBS software.

It's located on port 2513 at 143.198.58.173 (or goldminedoors.com).

Total Games: Loading...

Under the hood:

• Synchronet v3.20 for native Linux, DOS and Win32 games (Ubuntu 24.04 x64 and Windows 10 x64)
• MBBSEmu for MajorBBS-based game modules (Windows 10 x64)

WHAT'S A 'DOOR SERVER'?

gOLD mINE is not a BBS (despite the URL). There are no message boards or file download areas, and you can't "login" to it like a traditional BBS via Telnet or SSH. It does one thing, and one thing only: launch games remotely for users from other BBSs using RLOGIN.

If you run an old-school style, terminal-based BBS (probably using new-school BBS software like Mystic, Synchronet, Talisman, WWIV or ENiGMA½) you know that setting up door game programs can be time consuming and sometimes, a headache.

In their heyday of the 1980s and early 90s, these door games were designed to run under DOS (or later, Windows 32-bit) and they could be finicky. Hunting down registration keys or cracks can now be daunting (many doors are abandonware these days, with original authors having sadly passed). So, a Door Server takes work out of setup and lets you add LOTS of these games from a central service, almost immediately, running them over an RLOGIN connection that's practically seamless for your users. The other benefit is a potentially larger player base, aggregating them in a centralized manner with other BBSs.

Setup Gold Mine

JOIN GOLD MINE

gOLD mINE does not require you to apply for membership. Just follow the directions below using RLOGIN.

CONNECT FROM YOUR BBS

Ready to go? Setup an outbound RLOGIN connection from a menu item on your BBS to 143.198.58.173, or goldminedoors.com port 2513, using the settings below. Heck, you could even connect directly using RLOGIN and Syncterm!

• If you are running a legacy DOS BBS under Windows, check out Telnet Door, use the RLOGIN mode
• For Ubuntu or other Linux flavors, use 'sudo apt install rsh-redone-client'

CREATE A BBS TAG

Every gOLD mINE BBS needs a tag that identifies it. You can make it up, just use these guidelines:

• Format for the tag is: [TAG], replace "TAG" with your unique 3 characters that represent your BBS
• For instance, Space Junk BBS uses [SJ!]
• Use exactly 3 characters: no more, no less
• No profanity, please

Mystic BBS Example

Add gOLD mINE to your menu as IR - Outbound RLOGIN Connection

/addr=143.198.58.173 /port=2513 /user=[TAG]@USER@ /pass=@USER@ /PROMPT

• Replace TAG with your unique 1-3 character BBS tag, e.g [ABC].
• Make sure there are no spaces between [TAG] and @USER@
• FYI: /PROMPT hides the connection string from the user
• You can replace /pass=@USER@ with whatever you want for the @USER@ part

WWIV BBS Example (Linux)

Use Chain Edit to add a gOLD Mine entry. If you want to load the main menu so your users can select a game, and not directly launch a specific door with a door code, leave off the door code parameter ("WORDLE"):

A) Description  : Space Junk! gOLD mINE Game Server
B) Filename     : doors/goldmine/goldmine.sh %N WORDLE
C) ACS          : user.sl >= 10
D) ANSI         : Optional
E) Exec Mode    : STDIO
F) Launch From  : BBS Root Directory
G) Local only   : No
H) Multi user   : Yes
I) Usage        : 0
J) Registered by: AVAILABLE
L) Pause after  : No

• Replace TAG with your unique 1-3 character BBS tag, e.g [ABC].
• Note: we aren't passing the BBS Alias here, we're passing the node number, which the script will then extract from the drop file in case we need to parse out special characters, spaces, etc.

DIRECTLY LAUNCH A DOOR

If you want to launch a door game directly from your BBS, bypassing the gOLD mINE main menu, use a Door Code from the list on this page. If no door code is passed, the user will land at the gOLD mINE main menu.

Mystic Example

Replace the doorcode with a code below ("/term=xtrn=WORDLE") that you want to launch directly:

/addr=143.198.58.173 /port=2513 /user=[XYZ]@USER@ /pass=@USER@ /term=xtrn=WORDLE /PROMPT

WWIV Example (Linux)

goldmine.sh

#!/bin/bash

cd doors/goldmine

# Get the node number and door code from the arguments passed to the script
NODE_NUMBER=$1
BBS="SJ!"       # Change this to your tag
DOOR_CODE=$2

# Define the path to the WWIV DOOR32.SYS file
DOOR32_SYS_PATH=/home/bbs/wwiv/e/${NODE_NUMBER}/temp/door32.sys

# Extract the alias from line 7, replace spaces with underscores, and store it in a variable
USER_ALIAS=$(sed -n '7p' "$DOOR32_SYS_PATH" | tr ' ' '-')
PREFIX="["$BBS"]"

# Uncomment to print the alias and door code for debug 
# echo "BBS: $PREFIX"
# echo "User Alias: $USER_ALIAS"
# echo "Door Code: $DOOR_CODE"

# Run the rsh-redone-client command with the extracted user alias and provided door code
if [ -n "$DOOR_CODE" ]; then
    TERM_PARAM="xtrn=$DOOR_CODE"
    TERM=$TERM_PARAM rlogin -p 2513 -l "$PREFIX$USER_ALIAS" goldminedoors.com
else
    rlogin -p 2513 -l "$PREFIX$USER_ALIAS" goldminedoors.com
fi

Library

GoldMine Game Code List

Top 10 Games - All Time

API

Goldmine API

You can access some endpoints to retrieve JSON statistics for:

• Top 10 most launched games.
• Monthly statistics.
• Yearly statistics.
• All-time statistics.
• List all games with details.

Data automatically reloads and refreshes JSON data every 24 hours.

Access the API endpoints:

• Top 10 Games: https://goldminedoors.com/top10?period=all
• Replace all with month or year or a specific month (e.g., july) or year (e.g., 2024).
• Detailed Stats: https://goldminedoors.com/stats?period=all
• Replace all with month or year or a specific month (e.g., july) or year (e.g., 2024).
• Library: https://goldminedoors.com/library

API Endpoints

GET /top10

Retrieve the top 10 most launched games.

Query Parameters:

• period (required): The time period for the statistics. Valid values are month, year, all, or a specific month (e.g., july) or year (e.g., 2024).

Response:

200 OK: A JSON object containing the top 10 most launched games.

400 Bad Request: If the period parameter is missing or invalid.

{
      "period": "all",
      "games": [
        {
          "game_name": "Adventurer's Maze II",
          "door_code": "AM2",
          "category": "RPGs: Medieval & Fantasy",
          "launch_count": 42
        },
        ...
      ]
    }

GET /stats

Retrieve detailed statistics.

Query Parameters:

• period (required): The time period for the statistics. Valid values are month, year, all, or a specific month (e.g., july) or year (e.g., 2024).

Response:

200 OK: A JSON object containing detailed statistics.

400 Bad Request: If the period parameter is missing or invalid.

{
      "month": {
        "january": [
          {
            "game_name": "Adventurer's Maze II",
            "door_code": "AM2",
            "category": "RPGs: Medieval & Fantasy",
            "launch_count": 42
          },
          ...
        ],
        ...
      }
    }

GET /library

Retrieve a list of all games with details.

Query Parameters:

• None

Response:

200 OK: A JSON object containing the list of all games.

[
      {
        "game_name": "Adventurer's Maze II",
        "door_code": "AM2",
        "category": "RPGs: Medieval & Fantasy"
      },
      ...
    ]

Contact

Need Help?

Contact j0hnny a1pha on fsxNet or WWIVNet "gOLD mINE Game Server" sub, or on BBS World Discord (alpha_64) for more details or to ask a question.