bnetd

bnetd copied to clipboard

README

This file contains the release notes for bnetd version 0.4.25.

DESCRIPTION

Bnetd is a program that will eventually emulate a Starcraft Battle.net
server.  It is distributed under the GPL so that others may contribute
to the development.  It currently runs on Unix and Unix like systems
and also Win32.  The code is based on the original bnetd-0.3 by Mark
Baysinger which was distributed on http://www.starhack.ml.org/ until
that domain went away.  Mark's work also spawned several versions for
MS-Windows, most notably FSGS.

STATUS

The server currently implements most of the same functionality as the
real Battle.net servers.  You can chat, play games, use /-commands,
and things like account passwords, user icons, ad banners, channel
operators, ladder, and Diablo games work too.  It is by no means
complete, though.  Different clients may be supported to different
extents.  See the CHANGELOG for summaries about specific modifications.

DOWNLOADING

The latest version of the program can be found at
 http://www.bnetd.org/files.php
 http://www.cs.nmsu.edu/~rocombs/sc
 http://sourceforge.net/project/showfiles.php?group_id=6933

INSTALLING

See the INSTALL file in the distribution directory.  Other information
including Instructions for installing on Win32 with the Borland
compiler is avaliable in the docs directory.

RUNNING

Just run ./bnetd.  It will begin waiting for connections.  Run
./bnetd --help for help with command-line options.  If no config file
is specified, it will look for a config file in a location determined
when the server was compiled.  If that file doesn't exist, it will use
some built-in default settings.

CONFIGURING THE CLIENT

Supported client game software titles:
 Starcraft (and the Brood War expansion pack)
 Diablo (only version 1.05 and later)
 Warcraft II Battle.net Edition
 Diablo II (only open gameplay)

MS-Windows:

Download a copy of the program BNS.exe.  This program will allow you to
choose any bnetd, FSGS, or Battle.net server by manipulating the
registry.  Instead of starting your game client manually, run BNS and
choose which client to launch and enter the hostname or IP address of
the computer which you wish to connect to instead of Battle.net.  Only
the game clients installed on your system will be selectable.  Clicking
Apply will set the server and launch the selected game client, but will
not exit BNS.  Clicking Cancel will abort all changes and exit BNS.
Clicking OK will exit BNS after applying the changes.

MacOS:

There is no automated tool to modify the resources (yet).  To do it
manually, first locate the Starcraft (or Diablo) preference file
located in the Preferences folder inside the System folder.  Open the
file with ResEdit to check if you have the HKEY resources called:
 "HKEY_LOCAL_MACHINE\Software\Battle.net\Configuration\Server List"
 "HKEY_LOCAL_MACHINE\Software\Battle.net\Configuration\Client ID"
If you do not have these resources, you will have to download the demo
of Starcraft from Blizzard and connect to Battle.net.  The demo will
create the necessary resource entries for you.

Once you have those two entries, use ResEdit to change:
 "HKEY_LOCAL_MACHINE\Software\Battle.net\Configuration\Server List"
to the IP addresses or hostnames of the server you wish to connect to.

SUPPORT

If you have trouble with the server or setting up the clients, you
should check to see if the answer to your problem is in our FAQ.  The
current version can be found on
http://www.bnetd.org/doc.php?docname=FAQ.html. If that doesn't solve
your problem, try posting in one of the forums at
http://www.bnetd.org/phpBB.  You can also send email to the list
[email protected].  See the file README.debugging in the docs
directory for information about submitting good bug reports.

Other documents are included in the docs directory of this
distribution including README.ladder and README.adbanner which
contain information about setting up and using those features of the
server.

CONTRIBUTING

Discovered anything about the Battle.net protocol that we overlooked?
Have some ideas that you would like to see implemented in the server?
Please consider either posting in http://www.bnetd.org/phpBB/ or
sending mail to to the list [email protected].  Please note that
the license agreement is the GNU GPL.  See the CREDITS file for a list
of current contributors and TODO for a list of work that needs to be
done.

LEGAL NOTES

Blizzard Entertainment is a trademark of Davidson & Associates, Inc.
Starcraft is a trademark of Davidson & Associates, Inc.
Warcraft is a trademark of Davidson & Associates, Inc.
Diablo is a trademark of Davidson & Associates, Inc.
Battle.net is a trademark of Davidson & Associates, Inc.
Windows is a registered trademark of Microsoft Corporation
MacOS is a registered trademark of Apple Computer, Inc.

The bnetd project is in no way affiliated with Blizzard Entertainment