1
0
mirror of https://git.zap.org.au/git/trader.git synced 2024-12-04 14:46:45 -05:00
Star Traders is a simple text-based game of interstellar trading, where the objective is to create companies, buy and sell shares, borrow and repay money, in order to become the wealthiest player (the winner). https://www.zap.org.au/projects/trader/
Go to file
John Zaitseff 30bfcd167a Keep Coverity Scan happy
Coverity Scan (https://scan.coverity.com/projects/trader) complains that
a high-impact defect is present in the scramble() function: "String not
null terminated" -- even though b64encode() does give a NUL-termininated
buffer.
2022-08-01 22:27:56 +10:00
build-aux Add an AppStream-conforming metadata file 2021-01-14 09:11:08 +11:00
data Add the icon type for trader.appdata.xml.in 2022-08-01 04:50:14 +10:00
doc Update not-for-profit organisation name to The ZAP Group Australia 2022-08-01 04:59:32 +10:00
lib Update ignored files for the latest version of Gnulib 2022-08-01 10:09:04 +10:00
m4 Update ignored files for the latest version of Gnulib 2022-08-01 10:09:04 +10:00
po Make home_directory() an internal function to utils.c 2022-08-01 11:27:09 +10:00
src Keep Coverity Scan happy 2022-08-01 22:27:56 +10:00
.gitattributes Add an AppStream-conforming metadata file 2021-01-14 09:11:08 +11:00
.gitignore Add an AppStream-conforming metadata file 2021-01-14 09:11:08 +11:00
configure.ac Update minimum version of Autoconf to allow C17 or C11 compilation 2022-08-01 10:01:41 +10:00
COPYING Update the copyright year to 2022 2022-08-01 04:46:15 +10:00
INSTALL Update minimum version of Autoconf to allow C17 or C11 compilation 2022-08-01 10:01:41 +10:00
Makefile.am Update the copyright year to 2022 2022-08-01 04:46:15 +10:00
NEWS Eliminate a TOCTOU bug between data_directory() and xmkdir() 2022-08-01 22:23:06 +10:00
README Update not-for-profit organisation name to The ZAP Group Australia 2022-08-01 04:59:32 +10:00

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

.. -*- mode: rst; coding: utf-8 -*-
.. role:: filename(literal)
.. default-role:: filename

============================================
Star Traders: A Game of Interstellar Trading
============================================

Welcome to Star Traders!  This is a simple game of interstellar trading,
where the objective is to create companies, buy and sell shares, borrow
and repay money, in order to become the wealthiest player (the winner).


Installation
============

Full instructions for installing Star Traders are contained in the file
`INSTALL`.  Please note that that file does *not* contain generic GNU
Autoconf instructions!  For the impatient, the short version is::

    ./configure
    make
    make install

The final command needs to be run as the system administrator (root), of
course.


How to Play
===========

Star Traders comes with quite extensive in-built instructions on how to
play the game.  Start by running ``trader`` from the command line.  You
will be prompted for the number of players; from one to eight people can
play (although, in this version, they will all have to share the one
keyboard and screen!).  After entering the names of the players, you will
have the opportunity to read instructions on how to play the game.  Do
so—and good luck in the game!

The manual page for Star Traders contains more information on command
line options, as well as some suggestions for running a retro-computing
green-screen nostalgia-tour version of the game…  Try running the
following, for example (all on one line)::

    xterm -g 80x24 -fa Mono -fs 18 -bg '#181818' -fg '#2CAB00' -bc +sb \
        +bdc +fbx -xrm 'XTerm*colorBD: #41FF00' -e trader --no-colour &

To read the manual page, type ``man trader`` from the command line.


Feedback
========

Your comments, suggestions, corrections and enhancements are always
warmly welcomed!  Please send these to:

    :Postal:  | John Zaitseff,
              | The ZAP Group Australia,
              | Unit 6, 116 Woodburn Road,
              | Berala, NSW, 2141,
              | Australia
    :Email:   | J.Zaitseff@zap.org.au
    :Web:     | https://www.zap.org.au/projects/trader/
    :FTP:     | https://ftp.zap.org.au/pub/trader/
              | ftp://ftp.zap.org.au/pub/trader/
    :Git:     | https://www.zap.org.au/git-browser/trader.git
              | https://git.zap.org.au/git/trader.git
              | git://git.zap.org.au/data/git/trader.git


Copyright
=========

**Copyright © 19902022, John Zaitseff.**

Star Traders is free software that is distributed under the terms of the
GNU General Public License.  You can redistribute it and/or modify it
under the terms of that License as published by the Free Software
Foundation, either version 3 or (at your option) any later version.

This game 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 in
the file `COPYING` for more details.