Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
fastrgv authored Apr 10, 2021
1 parent de9814c commit 483cd1f
Showing 1 changed file with 30 additions and 21 deletions.
51 changes: 30 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,18 +40,25 @@ https://youtu.be/428fRdu-fZs

# AdaVenture GLFW/OpenAL version

### Note: Please ignore the "Source code" zip & tar.gz files. (They are auto-generated by GitHub). Click on the large 7z file under releases to download all source & binaries (Windows,Mac & Linux). Then, type "7z x filename" to extract the archive.
### GitHub downloaders: Please ignore the "Source code" zip & tar.gz files. (They are auto-generated by GitHub). Click on the large 7z file under releases to download all source & binaries (Windows,Mac & Linux). Then, type "7z x filename" to extract the archive.



## Whats new:


**ver 2.2.2 -- 10apr21**
* Improved castle exterior & lighting on interior alcove.
* Upgraded to glfw v3.3.4.
* Fixed bad logic that forced a death by beetles.
* Enhanced maze maps.

**ver 2.2.1 -- 28mar21**
* Added beetle warning so gamers don't dawdle among them.
* Added decorative metallic copper brackets to castle pool as a demonstration of multi-texturing and reflective lighting.

**ver 2.2.0 -- 08nov20**
* Installed completely new cross-platform sound system usind OpenAL.
**ver 2.2.0 -- 07nov20**
* Installed completely new cross-platform sound system using OpenAL.
* Now deliver only a single Windows build (64-bit).

**ver 2.1.8 -- 18sep20**
Expand All @@ -62,7 +69,7 @@ https://youtu.be/428fRdu-fZs


## AdaVenture Game Description
AdaVenture is a kid-friendly retro point & click game, intended to be a minimal extension to 3D of the 2D Atari game named "Adventure", but with various artistic extrapolations. Same stories but a different perspective. Now runs on Windows, OSX, and GNU/Linux.
AdaVenture is a kid-friendly retro point & click game, intended to be a minimal extension to 3D of the 2D Atari game named "Adventure", but with various artistic extrapolations. Same stories but a different perspective. Runs on Windows, OSX, and GNU/Linux.

Set in ancient Persia, it begins outside the castle of the young King Xerxes, who inherited a magical golden chalice from his father, Darius the Great. Coveted by Greek foes King Leonidas of Sparta and King Minos of Crete, the chalice has been stolen.

Expand All @@ -71,19 +78,17 @@ Your quest is to seek and return the royal chalice to its pedestal within the ca
Be sure to look to the sky as you return to the castle with the chalice.




## AdaVenture Game Features

* Observe that the mazes have interconnections that are impossible in 3 dimensions, but as such, they are painstakingly exact reproductions of those in the original "Adventure" game from Atari. In fact, the "./mapRoom" subdirectory contains the original maps to help guide you.
* The mazes have interconnections that are impossible in 3 dimensions, but as such, they are painstakingly exact reproductions of those in the original "Adventure" game from Atari. In fact, the "./mapRoom" subdirectory contains the original maps to help guide you.

* When looking closely at a pickable object, a hand will appear indicating that a click will pick up the object. When holding an object, another click will drop it at the current location. Only one object at a time may be carried.

* Works on PCs or laptops running Windows, OSX or GNU/Linux. And if GNAT is installed you can build it yourself! But first try the delivered binaries.

* Windows, GNU/Linux and OSX binaries provided, as well as full source.

* Note that both 32 and 64 bit builds for Windows are delivered.
* Note that a 64 bit build for Windows is delivered.

* Laptop friendly controls; supports Mac Retina displays in high DPI mode.

Expand Down Expand Up @@ -146,7 +151,7 @@ If the need arises, copy the file "default_settings.txt" to "./data/settings.txt
## required for running:

* graphics card with ample memory & driver that supports OpenGL version 3.3 or later;
* Windows, GNU/Linux or OSX;
* Windows, GNU/Linux(glibc > v2.14) or OSX >= 10.13(sep2017);
* optional game controller or joystick.


Expand All @@ -159,27 +164,31 @@ Mac users see "osx-setup.txt".
Windows users see "windows-setup.txt".


Unzip the archive. On Windows, 7z [www.7-zip.org] works well for this. The proper command to extract the archive and maintain the directory structure is "7z x filename".

Unzip the archive. On Windows, 7z [www.7-zip.org] works well for this.
The proper command to extract the archive and maintain the directory structure is "7z x filename".

Open a commandline terminal, and cd to the install directory, and type:

* adaventure.bat (Windows)
* adaventure_osx (Mac)
* adaventure_gnu (Linux)
adaventure.bat (Windows)
adaventure_osx (Mac)
adaventure_gnu (Linux)


This linux executable was built on [RedHat] Scientific-Linux to not only run well, but to rebuild easily. I believe this single linux executable will run on most recent distributions of linux. It has been tested on OpenSuse and Mint. Alternatively, you can run the Windows executable on linux using wine thusly:
Note that the Windows executable can be run on linux using wine thusly:

* wine binw64/adaventure64.exe



The linux executable was built on [RedHat] Scientific-Linux to not only run well, but to rebuild easily. I believe this single linux executable will run on most recent distributions of linux. It has been tested on OpenSuse and Mint. Also should run under wine thusly:

* wine binw64/adaventure64.exe


Mac users can also navigate to the installation directory in Finder and click the "adaventure.app" icon named "AdaVenture". Note that any jerkiness experienced while running at HiDpi can be elliminated by editting the bundle-controls to force LowDpi.

Save the game [ v-key ] prior to risky behavior or quitting, in order to resume later.

The install_directory should contain a subdirectory named "data". It contains shaders, skyboxes, sound and texture data.
In case of trouble moving, switch to 1st person.

Note that adjustable OpenGL settings should favor performance. OTOH, this game runs fine on an Intel NUC with embedded Intel graphics, so the graphics demands are modest.

Expand Down Expand Up @@ -218,13 +227,13 @@ Three [pre-compiled] binary executables are delivered, one for Windows, one for

The distributed linux executable requires glibc v2.14 or newer. That means if your distribution is older than june 2011, it may not run, and you will need to recompile.

Build scripts for GNAT2015 or newer are provided; and due to a recent script change, a Windows or linux build machine need not have a C++ compiler installed. Only GNAT-GPL from AdaLibre is required (GNAT has its own g++).
Build scripts for GNAT are provided; a Windows or linux build machine need not have a C++ compiler installed. Only free GNAT-GPL from AdaCore is required (GNAT has its own g++).

-------------------------------------------------------

**msWin64** => wcmp.bat

Note that the above windows build scripts might need to be editted to reference your actual installation directory for 64bit AdaCore 2018/2020 compilers.
Note that the above windows build script assume the 64bit AdaCore compiler is on your path.


-------------------------------------------------------
Expand Down Expand Up @@ -294,7 +303,7 @@ It is suitable for any Ada application that needs music, sound loops or transien
-----------------------------------------------------------------------
## What is special about this project?

The linux-build of this app is among very few modern OpenGL games with sound where a single pre-built executable can run on multiple Linux distros without 3rd party add-ons! It has been tested on OpenSuse, ScientificLinux, Mint and CentOS.
The linux-build of this app is among very few modern OpenGL games with sound where a single pre-built executable can run on multiple Linux distros without any 3rd party add-ons! It has been tested on OpenSuse, ScientificLinux, Mint and CentOS.

For developers, this project can serve as a testbed for learning modern OpenGL and GLSL.

Expand All @@ -319,7 +328,7 @@ If you make improvements, please send then to <[email protected]>
AdaVenture itself is covered by the GNU GPL v3 as indicated in the sources:


Copyright (C) 2020 [email protected]
Copyright (C) 2021 [email protected]

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
Expand Down

0 comments on commit 483cd1f

Please sign in to comment.