Overview:

This is my first (original) Amiga game inspired by the classic
XBOX 360 shooter Geometry Wars.  
This game was developed to prove that OpenGL software rendered 3D games
are now possible with a PiStorm CM4.
This is not a port of Geometry Wars, it's all my own code developed
over the past 12 months (basically I just made it up as I went along).
I used my old 3D engine PolyNova to generate the 3D objects and then
used SDL with OpenGL support (Mesa) to render the polygons.
Although this release targets the Amiga, it will be highly portable
to other retro platforms that support SDL and OpenGL.
This game was developed using C++ exclusively.


Requirements:

1) An RTG Amiga
2) PiStorm CM4 (not included)
3) 64MB of RAM
4) AHI installed and configured (see links section below)
5) Music and SFX files (included)
6) A 2-button digital joystick


Configuration:

You do not need to install any 3rd party graphics libraries.
The escape key will bring up the menu and pause the game.
The +/- keys will move the camera and reduce your view port.
Any errors/warnings should be written to a log file.
This game has been developed for a 4:3 display.
The 'closewb' tooltype will close your workbench.
The log file will output the average FPS on exit.


Performance Considerations:

Although this game has been developed to target PiStorm CM4, it may be
possible to get it running on an overclocked 060 if you configure it to
to disable features like the real-time lighting, the starfield's 
parallax scrolling and reduce the particle effects to a bare minimum.
All of the music and SFX files included with this archive have been
converted to 22,050 kHz which is what the mixer uses by default, if you 
change the mixer quality setting in the game then you'll need to create
new files to match the frequency used by the game.   You should set up
your AHI configuration to also output 22,050 kHz to match the game.
A few silly people have suggested that this game should run on a stock 
A500 or A1200 with some FASTRAM.   This original game is entirely vector
based and renders thousands of 3D objects per frame in 16-bit color
with real-time lighting, try doing that on a stock A1200 FFS.


Limitations:

1) No 3D hardware support (old school baby)
2) Only 16-bit colour depth is supported (RGB16PC format)
3) Only 640x480 fullscreen resolution supported
4) No online high score saving (working on it)


Version History:

1.0.01 - Initial release.
1.0.02 - Added sound effects, added coloured lighting.
1.0.03 - Added music.
1.0.04 - Added more music tracks.
1.0.05 - Shake it baby.
1.0.06 - Changed alien attack waves, added boss level placeholder.
1.0.07 - Changed alien colours.
1.0.08 - Balanced gameplay, updated attack patterns.
1.0.09 - Game over man.
1.0.10 - Fixed colour cycling bugs.
1.0.12 - A couple of minor updates.
1.2.01 - The release version.
1.2.02 - Highscore handling, alien animation updates.
1.2.03 - Tweaked alien behaviour.
1.2.04 - Fixed particle explosion bug.
2.0.01 - Many many updates and new boss aliens added.
2.0.02 - Gameplay tweaks.
2.9.01 - Many updates, too many to list here.


Links:

https://eab.abime.net/showthread.php?t=119350 (G-WARS thread on EAB)
https://www.youtube.com/watch?v=AkWxYPeKY8A (Gameplay video)
https://www.youtube.com/watch?v=NlkxvDx27sY (AHI setup guide)
https://convertio.co/ (OGG and WAV frequency converter)
https://github.com/NovaCoderX/G-WARS (source code)

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                 144633  161516  89.5% -lh5- 81f5 Jan 11  2025 G-WARS/Sounds/Ship_thrust_loop.wav
[Amiga]                     73    9516   0.8% -lh5- d602 Jan 11  2025 G-WARS/Sounds/silence.wav
[Amiga]                 195758  233516  83.8% -lh5- 3f00 Jan 11  2025 G-WARS/Sounds/Snake_spawn.wav
[Amiga]                   1622    1636  99.1% -lh5- f7a7 Jan 11  2025 G-WARS/Sounds/UI_Change.wav
[Amiga]                  23572   26862  87.8% -lh5- 9b45 Jan 11  2025 G-WARS/Sounds/UI_Confirm.wav
[Amiga]                   1620    1620 100.0% -lh0- 3cd2 Jan 11  2025 G-WARS/Sounds/UI_Delete.wav
[Amiga]                  86457   96044  90.0% -lh5- b855 Jan 11  2025 G-WARS/Sounds/Wanderer_spawn.wav
[Amiga]                  70554   73652  95.8% -lh5- ddea Jan 11  2025 G-WARS/Sounds/Repulsar_activate.wav
[Amiga]                  69198   96044  72.0% -lh5- 5cef Jan 11  2025 G-WARS/Sounds/Repulsar_spawn.wav
[Amiga]                 346175  404908  85.5% -lh5- db26 Jan 11  2025 G-WARS/Sounds/SFX_ambience.wav
[Amiga]                  18456   19712  93.6% -lh5- e2c7 Jan 11  2025 G-WARS/Sounds/Shield_off.wav
[Amiga]                  41832   46536  89.9% -lh5- 4b45 Jan 11  2025 G-WARS/Sounds/Shield_on.wav
[Amiga]                  65536   73058  89.7% -lh5- 3761 Jan 11  2025 G-WARS/Sounds/Ship_explode.wav
[Amiga]                   5418    6508  83.3% -lh5- 91b9 Jan 11  2025 G-WARS/Sounds/Ship_hitwall.wav
[Amiga]                  46279   48684  95.1% -lh5- 987d Jan 11  2025 G-WARS/Sounds/pickup_extralife.wav
[Amiga]                  92343   96044  96.1% -lh5- 19cd Jan 11  2025 G-WARS/Sounds/pickup_smartbomb.wav
[Amiga]                  48804   48804 100.0% -lh0- aac2 Jan 11  2025 G-WARS/Sounds/pickup_weapon.wav
[Amiga]                  12305   12698  96.9% -lh5- a959 Jan 11  2025 G-WARS/Sounds/Player_shielded_hit_enemy.wav
[Amiga]                 140023  146908  95.3% -lh5- 3670 Jan 11  2025 G-WARS/Sounds/Player_Spawn.wav
[Amiga]                  24603   28992  84.9% -lh5- 3f35 Jan 11  2025 G-WARS/Sounds/Projectile_hit_wall.wav
[Amiga]                 182143  193426  94.2% -lh5- edd9 Jan 11  2025 G-WARS/Sounds/Game_start.wav
[Amiga]                 135641  147862  91.7% -lh5- 1599 Jan 11  2025 G-WARS/Sounds/Gravity_well_die.wav
[Amiga]                 246242  292058  84.3% -lh5- 2b8c Jan 11  2025 G-WARS/Sounds/Gravity_well_explode.wav
[Amiga]                 261771  425004  61.6% -lh5- 44ff Jan 11  2025 G-WARS/Sounds/Hi_Score_achieved.wav
[Amiga]                 192304  192304 100.0% -lh0- 4eb3 Jan 11  2025 G-WARS/Sounds/Mayfly.wav
[Amiga]                  23042   23972  96.1% -lh5- c3f7 Jan 11  2025 G-WARS/Sounds/Multiplier.wav
[Amiga]                   9323    9836  94.8% -lh5- bed6 Jan 11  2025 G-WARS/Sounds/Fire_Hispeed.wav
[Amiga]                  18523   19630  94.4% -lh5- a87d Jan 11  2025 G-WARS/Sounds/Fire_homing.wav
[Amiga]                  18828   19630  95.9% -lh5- cf0c Jan 11  2025 G-WARS/Sounds/Fire_normal.wav
[Amiga]                  88133   93124  94.6% -lh5- dc07 Jan 11  2025 G-WARS/Sounds/Fire_smartbomb.wav
[Amiga]                 192972  220268  87.6% -lh5- 0acb Jan 11  2025 G-WARS/Sounds/Fire_smartbomb_low.wav
[Amiga]                  18853   19630  96.0% -lh5- ae9b Jan 11  2025 G-WARS/Sounds/Fire_triway.wav
[Amiga]                 368242  407488  90.4% -lh5- 07f1 Jan 11  2025 G-WARS/Sounds/Game_over.wav
[Amiga]                  45010   48036  93.7% -lh5- 5cf7 Jan 11  2025 G-WARS/Sounds/Enemy_red_warning.wav
[Amiga]                  31190   32586  95.7% -lh5- 1160 Jan 11  2025 G-WARS/Sounds/Enemy_spawn_blue.wav
[Amiga]                  45958   49954  92.0% -lh5- b850 Jan 11  2025 G-WARS/Sounds/Enemy_spawn_green.wav
[Amiga]                  41352   43756  94.5% -lh5- 032a Jan 11  2025 G-WARS/Sounds/Enemy_spawn_orange.wav
[Amiga]                  44266   48630  91.0% -lh5- 1cd8 Jan 11  2025 G-WARS/Sounds/Enemy_spawn_purple.wav
[Amiga]                  88450   96054  92.1% -lh5- bdcd Jan 11  2025 G-WARS/Sounds/Enemy_spawn_red.wav
[Amiga]                1946131 1946131 100.0% -lh0- 08b5 Jan  3 14:54 G-WARS/Music/Menu-Theme.ogg
[Amiga]                1747779 1747779 100.0% -lh0- c6ab Jan  3 14:49 G-WARS/Music/Sequence.ogg
[Amiga]                1651028 1651028 100.0% -lh0- dc9d Jan  3 15:03 G-WARS/Music/Waves.ogg
[Amiga]                  44918   63162  71.1% -lh5- 632b Jan 11  2025 G-WARS/Sounds/bullet_hitwall.wav
[Amiga]                  90014   96470  93.3% -lh5- 385f Jan 11  2025 G-WARS/Sounds/Enemy_explode.wav
[Amiga]                  45670   47360  96.4% -lh5- 023c Jan 11  2025 G-WARS/Sounds/Enemy_red_hit.wav
[Amiga]                  91013   96044  94.8% -lh5- 1dce Jan 11  2025 G-WARS/Sounds/Enemy_red_suck.wav
[Amiga]                   1873    3688  50.8% -lh5- 92d8 Jan 14 21:09 G-WARS/G-WARS.readme
[Amiga]                   1863    2808  66.3% -lh5- 1292 Apr 17  2019 G-WARS/G-WARS.readme.info
[Amiga]                   2238   23380   9.6% -lh5- d29b Jan 14 21:01 G-WARS/G-WARS.scn
[Amiga]                    461    1319  35.0% -lh5- 0e2d Jan 14 21:06 G-WARS/G-WARS.yaml
[Amiga]                    666    1085  61.4% -lh5- 6d32 Jan  3 16:35 G-WARS/G-WARS.yaml.info
[Amiga]                    120     131  91.6% -lh5- e40d Aug 19 22:46 G-WARS/HighScores.txt
[Amiga]                1778546 1778546 100.0% -lh0- 8066 Jan  3 14:42 G-WARS/Music/Deadline.ogg
[Amiga]                1513908 1513908 100.0% -lh0- 5bc2 Jan  3 14:57 G-WARS/Music/Evolved.ogg
[Amiga]                1452413 1452413 100.0% -lh0- c6be Jan  3 15:01 G-WARS/Music/King.ogg
[Amiga]                1191472 3179780  37.5% -lh5- 9a0f Jan 14 21:05 G-WARS/G-WARS
[Amiga]                   9740   15762  61.8% -lh5- 80f8 Jan 13 22:40 G-WARS/G-WARS.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        57 files 15057357 17637300  85.4%            Jan 14 23:15