Holsham Traders README

Info

Holsham Traders is a realtime multiplayer trading game. You are a trader in a town named Holsham, which is situated on a distant planet; You send your transporters from town to town and try to make as much money as possible by buying and selling goods.

htsserver is the server application of Holsham Traders.

It should work on GNU/Linux, SunOS, FreeBSD and HP/UX.

Release Notes

This is still a developer release. You cannot play the game, yet.

From now on, you need at least GLib 1.3.2 to be able to compile htsserver.

You should remove all files from previous installations, especially the whole directory ~/.htsserver, because we don't use it anymore.

This release won't work with ghtsclient 0.2 and nhtsclient 0.5.1. Please upgrade.

Requirements

GLib 1.3.2 or better: ftp://ftp.gtk.org/pub/gtk/v1.3/

Compiling and Installing

Install GLib 1.3.x
- Extract the GLib archive
- Run ./configure with the --prefix=<PREFIX> argument, so you needn't replace your stable GLib 1.2.x with the beta stage GLib 1.3.x! The 1.3.x series is incompatible with the 1.2.x series, therefore your other applications wouldn't run/compile anymore.
- make
- make install
Add <PREFIX>/lib to the environment variable LD_LIBRARY_PATH:

export LD_LIBRARY_PATH=<PREFIX>/lib

Alternatively you can add <PREFIX>/lib to your global /etc/ld.so.conf and run ldconfig, but you need root permissions for this.

Set the environment-variable GLIB_CONFIG to <PREFIX>/bin/glib-config-2.0:

export GLIB_CONFIG=<PREFIX>/bin/glib-config-2.0

Alternatively, you can create a symbolic link <PREFIX>/bin/glib-config, which points to <PREFIX>/bin/glib-config-2.0:

ln -s <PREFIX>/bin/glib-config-2.0 <PREFIX>/bin/glib-config

This is necessary, because configure only searches for glib-config and not for glib-config-2.0 by default.

Install htsserver
- Extract the htsserver archive
- Edit src/defaults.h to set some compile-time options. (optional)
- ./configure --help (to see the options you have)
- ./configure --with-glib-prefix=<PREFIX>
- make
- make install

See INSTALL for more information.

If you have problems compiling, please send a bug-report.

Quickstart

Edit the configfile. You need to at least change the adminpassword, because htsserver will not start with the default adminpassword.
Start htsserver.
Run a client (see below) and connect to htsserver.

Clients

I know of two clients for Holsham Traders at the moment:

nhtsclient

ncurses-based client, written by me
Homepage: http://nhtsclient.sourceforge.net/

ghtsclient

client for Gtk+, written by Piotr Esden-Tempski <pe1724@bingo-ev.de>
Homepage: http://ghtsclient.sourceforge.net/

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

See COPYING for details.

Mailinglists

There are two mailing-lists at the moment:

htsserver-devel:
Mailing-list for use by developers and contributors.
http://lists.sourceforge.net/mailman/listinfo/htsserver-devel
htsserver-cvs:
Information about every commit to the CVS-repository is automatically sent to this list. It should not be used for discussions. Its purpose is to keep you up-to-date with current development.
http://lists.sourceforge.net/mailman/listinfo/htsserver-cvs

Homepage

The official Holsham Traders homepage is: http://htsserver.sourceforge.net/

You should also check the Holsham Traders project-page on SourceForge: http://sourceforge.net/projects/htsserver/

--
Uwe Hermann <uh1763@hermann-uwe.de>