Internet for DNDBBS:

  C.G. Learn
  DesotoFireflite@comcast.net

  http://bbs.valhallabbs.com/dnd.ssjs

Directions On Setting Up DNDBBS With Telnet.
                          
I will try to make these instructions as easy as possible, while at the same
time I am assuming you have some bbs experience, and some telnet use running 
a BBS. If this is your first BBS, I am also trying to make this as painless
as I can.

I run a 5 node DNDBBS available 24/7. If you want to get a sneak peak of DNDBBS
In operation, you can telnet bbs.valhallabbs.com:26 or if you have no telnet
Client, use my website a http://bbs.valhallabbs.com, and choose DND on the main
Page. 

All DNDBBS Files are available for download on the Main BBS at bbs.valhallabbs.com:23
Do a search for DNDBBS from the File Menu.

There are some prerequisites when using DNDBBS with telnet. 

You can do this totally free, but if you prefer a custom Domain name, setting
up telnet will cost you a minimum of $13.00 dollars a year. 

- I am assuming you are using Windows 10, 32bit. Any Windows 32 bit software
will do, but if you are using Windows 10, be sure you reference one of the below
websites to make your DOS Command Windows run 16 bit software. It's easy to do, 
and it will not affect the way your Windows software runs. The only thing you
are doing is making sure the NTDVM will run 16 bit programs.

Some 16-bit info:

 https://www.groovypost.com/howto/enable-16-bit-application-support-windows-10/
 https://docs.microsoft.com/en-us/windows/compatibility/ntvdm-and-16-bit-app-support

To run in Windows 10 (32 bit):

 In Control panel select:
   programs & features -> turn windows features on or off -> legacy components
   and check NTVDM and reboot.

 In Cmd.exe enter: fondue /enable-feature:NTVDM

To run in Windows 10 (64 bit):

 Get NTVDMx64.DLL from:

  For 16-bit virtual device machine access in Win 10-64 bit:

    http://www.columbia.edu/~em36/ntvdmx64-ccpu-fre.7z

- You will need to open a port on your router under port forwarding. Read your 
Router documentation to explain to forward a port. The Standard Telnet port is
23, but I recommend you picking another port that won't be scanned as much
by the bots over the internet. I use Port 26 for DNDBBS on my system.

- You will need a Telnet aware Fossil Driver to run DNDBBS. Do Not use the 
Internal communications routines that come with DNDBBS. There are many to 
choose from, but I recommend NetFoss from http://pcmicro.com/netfoss/download.html
This is free software.

- You will need a way to Start the BBS as a Telnet Service so users can log
on with a telnet client or from a internet web page. There are many of these
programs to choose from, but I recommend a program called Net2BBS, which
is included with the Telnet Fossil driver NetFoss.

- You will need a Domain Name or DNS Service. They are many of them to 
choose from, but I use www.namecheap.com as I find it inexpensive
and easy to use, and I can use my computer to host my BBS. I pay about
$13.00 bucks a year to get a Domain Name of my choosing. Their are free
domain services out there, and I think they even offer a free service, but
I prefer to choose a name I want.

- You and your users will need a Telnet Client to call your service using
the Telnet Protocol. As with everything else, there are many of these to 
choose from, Again I recommend Syncterm, which you and your users will get
a true BBS experience. You can grab Syncterm from https://syncterm.bbsdev.net

- You will need DNS Client to keep your Domain Name active on your end. Since
I use Namecheap, I use the Namecheap Dynamic DNS Client where I downloaded
From "https://www.namecheap.com/support/knowledgebase/article.aspx/111/11/using-namecheap-dynamic-dns-client-version-20x-beta/"
This is just a small TSR program that runs about every 10 minutes to keep your
Connection alive. If you don't use Namecheap, you will have to use a DNS Client
Made for the Domain/DNS service you are using.

** Read Complete File Before Attempting Any Setup Or Execution **

Now, on to the Setup of DNDBBS. I am assuming you are using Windows 10, but
DNDBBS will run on most any version of DOS or windows.

Setup everything per these instructions before you attempt to run any batch files
or the BBS itself. We will setup the bbs first, then we will set up Netfoss and 
Net2BBS second

Download and install DNDBBS as it says in the SYSOP.DOC file. Your directory structure 
should look something like this if you have unzipped the 4 DNDBBS zip files correctly. 
** Be Sure You Add The 3 Directories as Sub Directories Under DNDBBS50 as Noted Below **

DNDBBS50
   CATALOG1.SIC
   CATALOG2.SIC
   DNDDAT
   DNDDOC
   DNDMESS
   DRIVERS
   GROUP1.SIC
   LIBRARY1.SIC
** (Directories You Must Add) **
   NETFOSS <----Add For Telnet
   TEMP <---- Must Exist, You will get config.sys, config.nt, and other memory errors if not present.
   UTILS <----For Future Use

Files used
---------------
A well  organized  Dndbbs  system would  make full use of the datapath
options. The disk drive structure could look something like this:

   c:\dndbbs50    c:\dndbbs50\dnddat\            c:\dndbbs50\dnddoc\
   RUNNODE.BAT    actions.dat     nonplyrs.dat   abort1.doc
                  automate.dat    notice.dat     abort2.doc 
   badlogin.dat   objdesc.dat     catalog.doc
   *.BAT          bank.dat        objects.dat    catalogd.doc
   x00.sys        containr.dat    prelog.dat     catalogm.doc
   ctninv.dat                     catalogs.doc
   c:\dndbbs50\   dmhelp.dat      roomdesc.dat   hint.doc
   shroom.com     dndcnfg.dat     roominv.dat    summary.doc
   dnd??.cfg      dndedit.dat     rooms.dat      summaryd.doc
   dndbbs.exe     edithelp.dat    spells.dat     summarym.doc
   dndcnfg.exe    graffiti.dat    teaminv.dat    summarys.doc
   dndedit*.exe   help.dat        teamuser.dat   wish.doc
   dndutil.exe    logoff.dat      treasure.dat
   edit*.exe      logoffh.dat     userinv.dat    c:\dndbbs50\
   cmd*.exe       logon.dat       user.dat       coins.doc
   dndcnvt.exe    monclass.dat    welcome.dat    disclaim.doc
   dndcnvt2.exe   moninv.dat                     disclam2.doc
   dndinit.exe    monsters.dat                   readme*.*
   dndpack.exe    montalk.dat                    restrict.doc
   dndsic.exe                                    sysnews.dat
   editedit.exe   d:\ (ram disk)                 tumbler.doc
   helpedit.exe   altwrk??.dat                   *.doc, *.txt
   import.exe     messwrk?.dat
   makecnfg.exe   tmpwrk??.dat                   Main .doc files
   makesys.exe                                   c:\dndbbs50\
   runedit.exe    c:\dndbbs50\dndmess\           dndbbs.doc
   runprog.exe    messbase.dat                   dndcnfg.doc
   setup.exe      public.*                       dndedit.doc
   uninstal.exe   private.*                      edit.doc
   vbdrt10e.exe   base1.*                        sysop.doc

You will need to create 7 Batch files to use DNDBBS under Telnet, as DNDBBS
will not be using the "Waiting For Call" Screen as it does for Dialup Mode.
I have included the batch files I use to make it easy on you. You can call them 
what you like, but I suggest these names, as they follow this tutorial.
All Batch Files reside in the main DNDBBS50 Directory.

RUNNODE.BAT (Used to fire DNDBBS up under Telnet when called for by Net2BBS 
---------
@echo off
echo *--- Setting Up System ---*
path=c:\windows;c:\windows\system32;c:\dndbbs50;c:\dndbbs50\utils
set dndbbs=c:\dndbbs50\
set dnddat=c:\dndbbs50\dnddat\
set dnddoc=c:\dndbbs50\dnddoc\
set dndmess=c:\dndbbs50\dndmess\
set dndtemp=c:\dndbbs50\temp\
set dnddoor=c:\dndbbs50\

echo *--- Starting DND BBS On Node %1 ---*
cd\dndbbs50
if exist dexit%1.def del dexit%1.def
dndbbs.exe /%1/TN/B:38400/P:%1
--------

!CONFIG.BAT (This sets up DNDBBS, and it's nodes)
--------
PATH=%PATH%;c:\dndbbs50;c:\dndbbs50\utils
set dndbbs=c:\dndbbs50\
set dnddat=c:\dndbbs50\dnddat\
set dnddoc=c:\dndbbs50\dnddoc\
set dndmess=c:\dndbbs50\dndmess\
set dndtemp=c:\dndbbs50\temp\
set dnddoor=c:\dndbbs50\
cd\dndbbs50
dndcnfg
--------

!DNDEDIT.BAT (A Simple Editor To Edit Different Areas Of The Game. Can Be Accessed OnLine Also.)
--------
PATH=%PATH%;c:\dndbbs50;c:\dndbbs50\utils
set dndbbs=c:\dndbbs50\
set dnddat=c:\dndbbs50\dnddat\
set dnddoc=c:\dndbbs50\dnddoc\
set dndmess=c:\dndbbs50\dndmess\
set dndtemp=c:\dndbbs50\temp\
set dnddoor=c:\dndbbs50\
cd\dndbbs50
runedit.exe
--------

!PACK.BAT (Nightly Event. Set Up A Timed Event Under Windows To Run Every Day. This Packs Your Message & User Files)
--------
PATH=%PATH%;c:\dndbbs50;c:\dndbbs50\utils
set dndbbs=c:\dndbbs50\
set dnddat=c:\dndbbs50\dnddat\
set dnddoc=c:\dndbbs50\dnddoc\
set dndmess=c:\dndbbs50\dndmess\
set dndtemp=c:\dndbbs50\temp\
set dnddoor=c:\dndbbs50\
cd\dndbbs50
dndpack
--------

!SYSEDIT.BAT (SysOp Editor. You Can Edit Users And Most Anything With This Tool. Use It Carefully.)
--------
PATH=%PATH%;c:\dndbbs50;c:\dndbbs50\utils
set dndbbs=c:\dndbbs50\
set dnddat=c:\dndbbs50\dnddat\
set dnddoc=c:\dndbbs50\dnddoc\
set dndmess=c:\dndbbs50\dndmess\
set dndtemp=c:\dndbbs50\temp\
set dnddoor=c:\dndbbs50\
cd\dndbbs50
DNDEDIT.EXE
--------

!SETPATH.BAT (A Simple Way To Set The Paths In The BBS. Use This In A Dos Window Before Executing Any Command Unless You Use My Batch Files)
--------
PATH=%PATH%;c:\dndbbs50;c:\dndbbs50\utils
set dndbbs=c:\dndbbs50\
set dnddat=c:\dndbbs50\dnddat\
set dnddoc=c:\dndbbs50\dnddoc\
set dndmess=c:\dndbbs50\dndmess\
set dndtemp=c:\dndbbs50\temp\
set dnddoor=c:\dndbbs50\
---------

!SYSOP.BAT (Local Login For Sysop)
---------
PATH=%PATH%;c:\dndbbs50;c:\dndbbs50\utils
set dndbbs=c:\dndbbs50\
set dnddat=c:\dndbbs50\dnddat\
set dnddoc=c:\dndbbs50\dnddoc\
set dndmess=c:\dndbbs50\dndmess\
set dndtemp=c:\dndbbs50\temp\
set dnddoor=c:\dndbbs50\
cd\dndbbs50
Shroom -q Dndbbs.exe /1/LC/N:"sysop"
---------

Now, assuming you have made the batch files, and you directory structure is as
shown above, you are ready to setup DNDBBS to run with telnet. Make sure you have
created your TEMP directory. We are now going to check the config to get the BBS
running. Open a DOS window (Command Prompt) and Change Directories to the DNDBBS
directory (CD\DNDBBS50). This is a simple setup, and we are actually changing nothing 
except the environment variables for a one node bbs. After you get the bbs up and running, 
you can go in and setup the config files to suit your bbs, and how you want it to run.
Execute the !CONFIG.BAT batch file you created earlier in the DNDBBS50 directory.
If you have followed my instructions, you will see a blue configuration screen. We 
are now going to make, or edit one config file for telnet use. First hit Control-R,
then hit 1 (one), then enter. Now hit Enter Again (Follow Prompts), we are now setting 
up node 1. Now select F-3, and check the first 4 lines, and if you created and used
my !CONFIG.BAT batch file, the environment will be filled in, and ready to use. Now
hit the Escape Key to return to the main config menu. Now Hit the Control-W keys to
write the newly edited config file. Type 1 to enter the node number for the new config
file, and hit Enter. Now hit enter again, and if you did everything correctly, you will
be at the main config menu screen. Do the same for nodes 2 through 5 if you want more 
than one node. One node is enough for the test. Now hit the Escape key to return to your command
window. Now for a quick test to see if the bbs will operate before we move to the telnet
setup. Using the open command prompt window, type !sysop to run the sysop batch file you
created from the beginning. If you followed my directions, you will be logged on as the
Sysop, and you will see: 

Dndbbs online at Sun 28 Nov 2021, 01:47p, Node 1, Port -, (bypass).
Change settings(y/n)? (Type N Here)

If you've gotten this far, it's all working well so let's log off and get ready to set
up the telnet add on, (NETFOSS), so you can use the bbs over telnet.

You will see some other prompts, just answer Y or N to get through them for this test.
Now you will see:

Press <enter> to begin the Adventure: (Hit The Enter Key)
You are now logged in to Dndbbs... 
Command> Type Q For Quit, It will ask you if you are sure, Type Y for yes. You will now
be logged out and back to the command prompt.

** Note, before running the bbs online, I suggest you use !SYSEDIT to go in and change
   your sysop name and password. Use F-12 From the !SYSEDIT menu. **

*** If your test was unsuccessful, and you could not login locally, please refer to the
    main SYSOP.DOC in the DNDBBS50 directory, or refer to 2.1 Installation Information at
    the bottom of this document. Do not proceed to the telnet setup till you can get the
    bbs to run locally. ***

Now, The Telnet Setup

As per the Directory structure setup at the beginning of this document, create a directory
called NETFOSS under the DNDBBS50 main directory. Unzip the NETFOSS??.ZIP file you got from
PCMicro to the NETFOSS directory. First, copy the NETFOSS.DLL file to the Windows\System32
directory. This is your actual fossil for Netfoss and Net2BBS. Now edit the NF.BAT file in the
netfoss directory to look like the one below.

NF.BAT
---------
@echo off
c:\dndbbs50\netfoss\ansi.com
c:\dndbbs50\netfoss\netfoss.com %1
rem ** If running a non-door32.sys system, add a " %1" to end of above line **
if errorlevel 1 goto end
c:\dndbbs50\netfoss\netcom.exe %1 %2 %3 %4 %5 %6 %7 %8 %9
c:\dndbbs50\netfoss\netfoss.com /u
:end
----------

Now edit the NET2BBS.INI file to reflect the settings that are in the copy below.

NET2BBS.INI
[Settings]
Command=c:\dndbbs50\netfoss\nf.bat /n*N /h*H c:\dndbbs50\runnode.bat *N *H
StartPath=c:\dndbbs50
Port=23
;PolicyPort=843
;BindToIP=127.0.0.1
Nodes=5
StartNode=1
MaxSameIP=5
Debug=1
NodeView=6
MainView=1
NodeLines=25
Log=telnet.log
;Whitelist=
Blacklist=blacklist.txt
BlacklistMsg=You are not welcome here.
;BlacklistANS=goaway.ans
Editor=notepad.exe
Semaphore=wait.sem
Resolve=1
;ResolveMsg=o Net2BBS - Resolving your IP Address...
ResolveMsg=|[2J[0;32mo [1mNet2BBS [0;32m- [1;37mRe[32mso[0;32mlving your IP Add[1mre[37mss[0;32m...[1;37m
ShowHost=1
AntiScanner=0
AntiHammer=0
CacheTime=5
DNSBL=zz.countries.nerd.dk
BlockCC=156,643,392,804    For nerd.dk only: 156=China 643=Russia 392=Japan 804=Ukraine 
DNSBL2=xbl.spamhaus.org
;DNSBL3=zombie.dnsbl
;DNSBL4=blocklist.de
;GeoIPWeb=api.ipstack.com
;GeoIPPort=80
;GeoIPKey=
********** You must request a free GeoIP API key from http://ipstack.com

This will get you running to receive calls from telnet node 23 quickly. These are quick setup
instructions for Netfoss, and Net2BBS. If you want to know exactly how it works, and see the
full setup instructions, refer to the documentation in the Netfoss directory. 

Create a RUNNODE.BAT, file referenced above, and place it in your DNDBBS50 directory. If
You follow my example batch file, Net2BBS will execute it when a telnet caller calls
Your bbs. RUNNODE.BAT uses NET2BBS info to fire up your BBS to log in the calling
User.

Now open a command prompt window, change directories to the Netfoss directory, CD\DNDBBS50\NETFOSS
and type Net2BBS. If you followed my directions properly, you will see the following screen:

-------------------------------------------------------------------------------

Debug: Read C:\DNDBBS50\NETFOSS\net2bbs.ini
Debug: Cmd=c:\dndbbs50\netfoss\nf.bat /n*N /h*H c:\dndbbs50\runnode.bat *N *H

Commands: [ESC] Exit, [C] Configure INI, [E] Edit Blocked IP List, [F1] Help

11-28-2021 14:18:21 - Listening for Telnet connections on port 23

-------------------------------------------------------------------------------

If you get this window, you are ready to receive Telnet Calls on Telnet Port 23

If you haven't got your dyndds setup, or haven't got your domain name yet, you can 
still test your telnet setup by using your ip address and appending the port number
to the end like: 111.152.104.255:23 

If you are using SyncTERM, hit Control-D, this will put you in direct dial mode. Enter
your IP Address, and the Port number as shown above. Providing you have forwarded the
port in your router, you should connect to your newly setup DNDBBS.

Hopefully you have success, and all that is left is to get your DYNDDS Domain Name, and
you will be ready to receive Telnet calls. By no means is this a fit all, do all instruction,
this is just a guideline to a quick setup. Feel free to lookup things you don't know on
the internet. Don't be afraid to make mistakes and expirement some. I have been running a 
BBS since the early 90's, and I'm still learning. So don't be afraid to ask questions. Most
everything you need to know about running DNDBBS is in the documentation included with the
BBS

Erik Jon Oredson (the author) can be reached by Email at dndbbs@gmail.com

Writer of this text document (C.G. Learn) can be reached by Email at
  DesotoFireflite@comcas.net

Dndbbs is distributed in five files:
        Dnd50a2e.zip -- Runtime programs, data files, documentation,
          and command modules.
        Dnd50a2s.zip -- Source for all runtime modules: (*.bas, and *.inc).
        Dnd50a2u.zip -- Updates for dndbbs v5.0 r2.0
        Dnd50a2p.zip -- Patch kit for dndbbs v5.0 r2.0
        Dnd50a6t.zip -- New Additional Tweak kit for dndbbs v5.0 r2.0 t6.0a
     Copy  these files to the  directory root C:\ and  unzip  the  contents
        with Pkzip.exe or any other unarchiving program. Use the pathname line
        switch -d to preserve the original paths Dndbbs was stored from:
        Pkunzip -d Dnd*.zip
     If  using any  zip  extractor program, unzip the package to C:\  while
        preserving pathnames.

If BBS fails to run, see main SYSOP.DOC, or read below section 2.1 Installation 
Information.

     2.1 Installation Information
     ----------------------------
     Dndbbs is distributed with Users.dat  file containing only the  Sysop.
     If this  file contains any other users then it should be deleted,  and
     restarted with the following instructions:

     To quickstart  Dndbbs  without any  configuration  requirements enter:
     'Makesys' to create  Sysop, then 'Sysop' in the Dndbbs directory,  or,
     Start the  Setup.exe program to create  the necessary  data files, and
     start Dndbbs with the Sysop logon, or,

     To  recreate the configure files,  type 'Makecnfg' to create the setup
     files,  then  type 'Dndinit 1'  to recreate the data files, then start
          Dndbbs.exe, or,
     For  further information read  section 10.0 of this file for  advanced
     setup information.

-end-
