Overview:

This is my first ever original Amiga game inspired by the classic
XBOX 360 shooter Geometry Wars (a 2025 release!).
This is not a port of Geometry Wars, it's all my own code developed
over the past 6 months (basically I just made it up as I went along).
I used my old PC 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 doesn't contain any Amiga
specific code so it will be highly portable to other retro platforms.
This game was developed using C++ exclusively.


Requirements:

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


Configuration:

You do not need to install any 3rd party 3D or SDL libraries.
The log file will output the average FPS on exit.
The escape key will bring up the menu and pause the game.
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.


Performance Considerations:

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.
All of the music and SFX files included with this archive has been
converted to 11,025 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.


Limitations:

1) No 3D hardware support (old school baby)
2) Only 16 bit colour depth is supported
3) Only 640x480 resolution supported
4) No online high score saving


Version History:

1.0.01 - Initial release.
1.0.02 - Added sound effects, add 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.


Links:

https://eab.abime.net/showthread.php?t=119350 (G-WARS thread on EAB)
https://youtu.be/UtPClZCHVdQ (Latest 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 12:10 G-WARS/Sounds/Ship_thrust_loop.wav
[Amiga]                     73    9516   0.8% -lh5- d602 Jan 11 12:10 G-WARS/Sounds/silence.wav
[Amiga]                 195758  233516  83.8% -lh5- 3f00 Jan 11 12:10 G-WARS/Sounds/Snake_spawn.wav
[Amiga]                   1622    1636  99.1% -lh5- f7a7 Jan 11 12:10 G-WARS/Sounds/UI_Change.wav
[Amiga]                  23572   26862  87.8% -lh5- 9b45 Jan 11 12:10 G-WARS/Sounds/UI_Confirm.wav
[Amiga]                   1620    1620 100.0% -lh0- 3cd2 Jan 11 12:10 G-WARS/Sounds/UI_Delete.wav
[Amiga]                  86457   96044  90.0% -lh5- b855 Jan 11 12:10 G-WARS/Sounds/Wanderer_spawn.wav
[Amiga]                  70554   73652  95.8% -lh5- ddea Jan 11 12:10 G-WARS/Sounds/Repulsar_activate.wav
[Amiga]                  69198   96044  72.0% -lh5- 5cef Jan 11 12:10 G-WARS/Sounds/Repulsar_spawn.wav
[Amiga]                 346175  404908  85.5% -lh5- db26 Jan 11 12:10 G-WARS/Sounds/SFX_ambience.wav
[Amiga]                  18456   19712  93.6% -lh5- e2c7 Jan 11 12:10 G-WARS/Sounds/Shield_off.wav
[Amiga]                  41832   46536  89.9% -lh5- 4b45 Jan 11 12:10 G-WARS/Sounds/Shield_on.wav
[Amiga]                  65536   73058  89.7% -lh5- 3761 Jan 11 12:10 G-WARS/Sounds/Ship_explode.wav
[Amiga]                   5418    6508  83.3% -lh5- 91b9 Jan 11 12:10 G-WARS/Sounds/Ship_hitwall.wav
[Amiga]                  46279   48684  95.1% -lh5- 987d Jan 11 12:10 G-WARS/Sounds/pickup_extralife.wav
[Amiga]                  92343   96044  96.1% -lh5- 19cd Jan 11 12:10 G-WARS/Sounds/pickup_smartbomb.wav
[Amiga]                  48804   48804 100.0% -lh0- aac2 Jan 11 12:10 G-WARS/Sounds/pickup_weapon.wav
[Amiga]                  12305   12698  96.9% -lh5- a959 Jan 11 12:10 G-WARS/Sounds/Player_shielded_hit_enemy.wav
[Amiga]                 140023  146908  95.3% -lh5- 3670 Jan 11 12:10 G-WARS/Sounds/Player_Spawn.wav
[Amiga]                  24603   28992  84.9% -lh5- 3f35 Jan 11 12:10 G-WARS/Sounds/Projectile_hit_wall.wav
[Amiga]                 182143  193426  94.2% -lh5- edd9 Jan 11 12:10 G-WARS/Sounds/Game_start.wav
[Amiga]                 135641  147862  91.7% -lh5- 1599 Jan 11 12:10 G-WARS/Sounds/Gravity_well_die.wav
[Amiga]                 246242  292058  84.3% -lh5- 2b8c Jan 11 12:10 G-WARS/Sounds/Gravity_well_explode.wav
[Amiga]                 261771  425004  61.6% -lh5- 44ff Jan 11 12:10 G-WARS/Sounds/Hi_Score_achieved.wav
[Amiga]                 192304  192304 100.0% -lh0- 4eb3 Jan 11 12:10 G-WARS/Sounds/Mayfly.wav
[Amiga]                  23042   23972  96.1% -lh5- c3f7 Jan 11 12:10 G-WARS/Sounds/Multiplier.wav
[Amiga]                   9323    9836  94.8% -lh5- bed6 Jan 11 12:10 G-WARS/Sounds/Fire_Hispeed.wav
[Amiga]                  18523   19630  94.4% -lh5- a87d Jan 11 12:10 G-WARS/Sounds/Fire_homing.wav
[Amiga]                  18828   19630  95.9% -lh5- cf0c Jan 11 12:10 G-WARS/Sounds/Fire_normal.wav
[Amiga]                  88133   93124  94.6% -lh5- dc07 Jan 11 12:10 G-WARS/Sounds/Fire_smartbomb.wav
[Amiga]                 192972  220268  87.6% -lh5- 0acb Jan 11 12:10 G-WARS/Sounds/Fire_smartbomb_low.wav
[Amiga]                  18853   19630  96.0% -lh5- ae9b Jan 11 12:10 G-WARS/Sounds/Fire_triway.wav
[Amiga]                 368242  407488  90.4% -lh5- 07f1 Jan 11 12:10 G-WARS/Sounds/Game_over.wav
[Amiga]                  45010   48036  93.7% -lh5- 5cf7 Jan 11 12:10 G-WARS/Sounds/Enemy_red_warning.wav
[Amiga]                  31190   32586  95.7% -lh5- 1160 Jan 11 12:10 G-WARS/Sounds/Enemy_spawn_blue.wav
[Amiga]                  45958   49954  92.0% -lh5- b850 Jan 11 12:10 G-WARS/Sounds/Enemy_spawn_green.wav
[Amiga]                  41352   43756  94.5% -lh5- 032a Jan 11 12:10 G-WARS/Sounds/Enemy_spawn_orange.wav
[Amiga]                  44266   48630  91.0% -lh5- 1cd8 Jan 11 12:10 G-WARS/Sounds/Enemy_spawn_purple.wav
[Amiga]                  88450   96054  92.1% -lh5- bdcd Jan 11 12:10 G-WARS/Sounds/Enemy_spawn_red.wav
[Amiga]                1233857 1233857 100.0% -lh0- 289e Jan 20 14:26 G-WARS/Music/Evolved.ogg
[Amiga]                 930393  930393 100.0% -lh0- 1855 Mar 17 15:54 G-WARS/Music/King.ogg
[Amiga]                1181209 1181209 100.0% -lh0- d08b Jan 24 11:13 G-WARS/Music/Waves.ogg
[Amiga]                  44918   63162  71.1% -lh5- 632b Jan 11 12:10 G-WARS/Sounds/bullet_hitwall.wav
[Amiga]                  90014   96470  93.3% -lh5- 385f Jan 11 12:10 G-WARS/Sounds/Enemy_explode.wav
[Amiga]                  45670   47360  96.4% -lh5- 023c Jan 11 12:10 G-WARS/Sounds/Enemy_red_hit.wav
[Amiga]                  91013   96044  94.8% -lh5- 1dce Jan 11 12:10 G-WARS/Sounds/Enemy_red_suck.wav
[Amiga]                1173781 3135572  37.4% -lh5- 47c8 Jun 10 18:54 G-WARS/G-WARS
[Amiga]                   9175   21180  43.3% -lh5- 4824 Jun  2 11:03 G-WARS/G-WARS.info
[Amiga]                   1609    3004  53.6% -lh5- e808 Jun 10 13:24 G-WARS/G-WARS.readme
[Amiga]                   1863    2808  66.3% -lh5- 1292 Apr 17  2019 G-WARS/G-WARS.readme.info
[Amiga]                   1781   16270  10.9% -lh5- d04a May 24 23:58 G-WARS/g-wars.scn
[Amiga]                    477    1424  33.5% -lh5- 3393 Jun 10 13:18 G-WARS/G-WARS.yaml
[Amiga]                    120     131  91.6% -lh5- e40d May 30 14:57 G-WARS/HighScores.txt
[Amiga]                1199439 1199439 100.0% -lh0- c085 Jan 24 11:11 G-WARS/Music/Deadline.ogg
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        54 files 9492823 12044829  78.8%            Jun 10 21:58