Cosmic Conquest 1982

This is a fork of Original project from RickCarlino here.

A copy of it is still in local Original directory too. See Original README for details.

Forked version

        ___   _  _  _   
__   __/ _ \ / || || |  
\ \ / / | | || || || |_ 
 \ V /| |_| || ||__   _|
  \_/  \___(_)_(_) |_|  
                        

From now v0.1.3 - this diverge & becomes more modern & less retro compatible.

This will also become specific to gforth 0.7.x, more or less. And curently to linux compatible shells (android/macOSX/Linux)

Why forking ?

Project seems abandoned since about 2 years now. Forked on Wed Jun 21

• Modernize all the code & remove some useless words that are no more needed here
• Will try to do some improvement too
• Add Makefile for latter usage (run/test/install/etc...)
• Change score management/calculations
• Code documentation is currently so bad...
• Games is not starting automatically on load
• Key map is not pleasant to me
• Missing LICENSE file as there was originally no file the unlicensed is the one to use.
• Missing a quit in game to go back to system
• Modernize random sequences
• No gforth version checking
• There are no colors
• There are no score file generated
• Why is there 2 key press needed on start
• Will include original magazine notes too

References

Full instructions are available in the original magazine article.

This is a re-creation of a real-time strategy game published in BYTE Magazine in 1982. The original version of the game was distributed in printed form for users to manually type into their Apple II computers. It is credited as one of the first real-time strategy computer games. The game was authored in a flavor of FIGForth for the Apple II, possibly FIGForth '78. The exact platform is unknown at this time.

Attempts at emulation have not gone well because we cannot determine the exact Forth version originally used. The source code has been updated to run on a modern Forth system (GForth).

Contents of This Repo

• Original - repo as is before forking it
• cosmic_conquest_modern.fs - "40Th Anniversary Edition". A modernized version of the game, playable on GForth.
• modernize.fs - also comes from fork

How to Run - TO BE CHANGED

1. Install GForth. Nearly any version will work and it is verified to work on GForth >= 0.7.3
2. Run the source code via gforth cosmic_conquest_modern.fs.
3. Once GForth is running, type CONQUEST to start the game.

How To Play - TO BE CHANGED

COMMANDS ARE CASE SENSITIVE. In the original Apple II, this did not matter. On modern systems, it does. Keep that in mind as you enter commands.

When you open the game, you will be prompted to press "any key" twice. This is used for generation of a random seed and will affect the structure of the game's universe.

Just run

./go.sh

VIDEO in french so use youtube translator if needed

Key controls:

• J, L, I, k - Directional controls - J to left / K to down / I to up / L to right
• T - Tax your planets
• G - Land on a planet - Ground
• R - Information - Radar
• F - Fire / attack enemy
• C - Switch to Other fleet - Change

Full instructions are available in the original magazine article.

Contributors on forked version

Special thanks goes to the folks who made this restoration possible:

• Alan Sartori-Angus - Original author of the game in 1982.
• Gordon JC Pearce - Ported the historic 1982 source code to GForth.
• tmr4 - Data entry of original sources.
• Rick Carlino - Documentation, proofing, data entry.

play it from container

you can adapt the Makefile to your own needs/environnements but keep in mind the minimum steps below

make Dockerfile
make container
make runcontainer
make clean

If you already built the container just run it from docker

docker run -it cosmic_conquest:latest

you can play directly from shell with

make run