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 4.
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 (32-bit pixel format ARGB recommended).
2) PiStorm (Pi4 recommended)
3) AHI installed and configured (see links section below)
4) Music and SFX files (included)
5) A 2-button digital joystick
6) AmiSSL and bsdsocket.library (Roadshow) for the online scoreboard


Configuration:

You do not need to install any 3rd party graphics libraries.
The 'closewb' tooltype can be used to close the Workbench.
Workbench should be using a 32-bit color mode.
The escape key will bring up the menu and pause the game.
The +/- keys will move the camera backwards and forwards in the scene.
To qualify for the online scoreboard, your highscore must be greater
than 100,000 points and the username must be changed from the default name.
The mouse will automatically lock (CTRL+m to unlock when running in a window).
You can toggle fullscreen with (ALT+ENTER).
The log file will output the average FPS on exit.
This game has been developed for a 4:3 display.
Any errors/warnings should be written to a log file.


Performance Considerations:

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 32-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 640x480 resolution supported


Version History:

1.0.01 - Initial release.
1.0.02 - Added sound effects, added colored 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 color.
1.0.08 - Balanced gameplay, updated attack patterns.
1.0.09 - Game over man.
1.0.10 - Fixed color 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.
3.0.01 - Added an online scoreboard :)
3.0.03 - Tried fixing OpenGL rendering issues impacting some PiStorm setups.
3.0.06 - Updated OpenGL renderer to use 32-bit color, added a window mode.


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)
https://leaderboarded.com/board/ktnpbrrbtfmzr (online scoreboard)
https://github.com/jens-maus/amissl (AmiSSL)

 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]                1651028 1651028 100.0% -lh0- dc9d Jan  3 15:03 G-WARS/Music/Waves.ogg
[Amiga]                    457     978  46.7% -lh5- a752 Jan 31 15:30 G-WARS/NOVA_LOG.TXT
[Amiga]                    668    1085  61.6% -lh5- 834d Jan 31 12:18 G-WARS/NOVA_LOG.TXT.info
[Amiga]                    195     200  97.5% -lh5- 9fe7 Jan 31 15:30 G-WARS/scores.dat
[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]                   1863    2808  66.3% -lh5- 1292 Apr 17  2019 G-WARS/G-WARS.readme.info
[Amiga]                   2225   23350   9.5% -lh5- 558e Jan 22 12:41 G-WARS/G-WARS.scn
[Amiga]                    484    1364  35.5% -lh5- 2bf6 Jan 31 15:32 G-WARS/G-WARS.yaml
[Amiga]                    666    1085  61.4% -lh5- 6d32 Jan  3 16:35 G-WARS/G-WARS.yaml.info
[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]                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]                1205868 3211272  37.6% -lh5- e756 Jan 31 15:27 G-WARS/G-WARS
[Amiga]                   9744   15767  61.8% -lh5- 0cbc Jan 22 17:37 G-WARS/G-WARS.info
[Amiga]                   2025    4017  50.4% -lh5- 19f8 Jan 31 15:34 G-WARS/G-WARS.readme
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        59 files 15073119 17671273  85.3%            Feb  1 00:23