Home

Awesome

Apolune and the Lost Astronaut Game Creation Framework

This is the Lost Astronaut Game Creation Framework ...

alt text

... along with the commercial Apolune Game (artwork reduced from commercially available version) as an implementation example, organized as a Visual Studio (2017) solution.

alt text

We're low on our monthly LFS charges. If you can't download the code directly, or if one of these images is "broken", try downloading a Release instead.

TL;DR

Description

Written in Visual C++ for Win32 using WinAPI as a WinProc Application. Does not use SDL. External dependencies kept to a minimum.

This game creation framework has taken well over 10 years of my life to develop. At various times it has been licensed to companies that I managed, for projects I developed, in the commercial computer graphics space. In particular one company, PieceMaker Technologies Inc., of which I held an equity stake, allowed me to reuse non-application-level code I developed, so in this way the framework has had some indirect funding applied to it.

Lost Astronaut Studios (lostastronaut.com) will adapt portions of this code for use in other game engine projects.

I am releasing it because:

  1. It's in a space that always needs more input, so it adds value to the spaces it interacts with (software, image analysis, automation, graphics and gaming)
  2. It would be useful for third parties who wish to produce transparent research and small independent developers who wish to learn and make games
  3. It is solely a Windows targetted project, and is stuck in the Win32 legacy, and when the project started Windows Desktop Users represented over 76% of all gamers, but today that number is more like 24%. While useful for producing Windows Desktop games, it wouldn't easily be ported to any other platform including the Xbox (though it might work on the Xbox with some effort).
  4. It is built on the aging OpenGL library, a tried-but-true-but-deprecated library from Khronos, and thus is stuck in the throws of that beast
  5. It contains over a decade of distilled knowledge and shows an evolution in home PC entertainment
  6. It is useful for makers and DIY enthusiasts
  7. It is powerful and will empower people who choose to learn it

Come find us on our Discord. DM "@Retrofriends" or join #framework to start a conversation with the author. http://discord.gg/MduSuX3

Additional documentation can be found on the wiki https://github.com/LAGameStudio/apolune/wiki

Sponsoring, Donations and Contribution

As the primary author, initiator and only vested official team member, I do appreciate donations and any donations will be used to fund making of video tutorials, documentation and code cleanup. Depending on the amount of accumulated donations, I may attempt to form a non-profit corporation around this project. The current spend of this project is $5/month to support the cost of hosting it on Github.com since the size of the repo is slightly larger than 2GB.

Another great way to support the project is to buy our games on STEAM, which you may find by visiting LostAstronaut.com or by searching steam for "Apolune" and looking for "Lost Astronaut Studios" on the Store pages.

If you download this project, please Star it.

With more stars we can get an Open Collective account to collect additional sponsorships.

If you use this project, please Watch it.

If you care about this project, please Sponsor it, or Contribute (see CONTRIBUTING.md for more information)

Feel free to make requests by reporting issues, as they will be considered and appropriately prioritized.

Fork us

Feel free to create Pull requests with fixes and suggested improvements only after you have tested them. Explain why you are making the request in the comment section of the request. We have a lax but optional Pull Request Template.

Features

A massive 1800+ class 1400 file extravaganza of OpenGL, WinAPI, OpenAL and many other features, written in Visual Studio for over a decade!

Technicals:

OpenGL Implementations:

Image support:

Animation Features:

Geometry:

Fonts:

UI:

Audio:

Networking and threading:

Shaders:

Collision

Utilities:

Getting Started

Select "Release" mode for 32 bit. 64 bit does not build and will not work.

Clean. After you are done with "Build All", copy the contents of DLLs to the target folder (probably SolutionDir/Release)

The project filters are carefully organized.

"Application" is your application, and most likely the work you will do will involve adding new files to the "Game" filter/folder under this. When you first download this repo, the "Game" filter contains the Apolune game. You can modify this to get started, or you can stick all of those subfilters into Apolune, then create new ones. The entire application is built off the singleton "windows" -- to that you add derivatives of the GLWindow class, and those can contain many of the other classes, including other derivatives of GLWindow, which you can "hook in" to your GLWindow. You can also switch between GLWindows and you can also build distinct pieces of UI as overlay using multiple GLWindows.

"Framework" contains all of the utilities, helper classes, OpenGL, OpenAL and other middleware classes. Worth exploring. It is organized by purpose. Skimming through the files here is pretty important. Take inventory of your massive graphics encyclopedia and decide what "legos" you want to plug in to make your next user experience.

Additional documentation can be found on the wiki https://github.com/LAGameStudio/apolune/wiki

The project configurations are as follows:

There are variants that offer features like Logging, Live Edit, Unoptimized, etc. Some are more useful than others.

No real use of namespaces. It's all :: most of the time (global namespace)

Getting your feet wet

Data files are stored in SolutionDir/Apolune/data

Do not manipulate main.cpp, and most likely not Application or AppFramework classes

Play around with GLWindow derivatives:

Use of Global Singletons

I looked at each new component as one that was global and reusable. The main singletons are listed here:

Use of Functional Libraries

Some files implement drawing and other routines as functional calls or macros, rather than organizing them into a class. These are listed here

Data Wrangling Classes

Proce55ing and Particles

Cameras

There are multiple cameras, one in particular is GLMCamera which is built on GLM. There are others that were useful for specific implementations, now older and less used.

Shaders

Dependencies (DLLs)

There are many. Here they are in a nutshell:

License

The following statement applies, but please read the following section "Philosophies on Licensings" which talks about how this might be more fluid than it appears.

Any original artwork not licensed elsewhere and unique to this software is licensed under CC BY NC ND 4.0 and should be replaced if you wish to make a commercial product. This artwork is found in the /data folder (https://github.com/LAGameStudio/apolune/tree/trunk/Apolune/data) -- please note, that you can ask and this portion can be waived depending. Some of the artwork found here is royalty free, so you can use it! Just ask. The main reason behind this is to protect people from claiming that they own Fringes of the Empire or Apolune, two games I sell on STEAM. Also, some of the artwork and sound files are provided here but are licensed elsewhere, so I must protect those sound files from being distributed and resold by third parties. Much of the visual artwork in the data/images folder is in fact from free sites on the internet, and you can go and get that free work yourself, replacing what comes with the framework for your own application.

As it states in the LICENSE file, this work is licensed, unless otherwise indicated, under the AGPL V3 or greater, providing a framework for creating additional open source and is rather permissive. If you wish to purchase an exception to this license, feel free to contact the author directly.

The licensed does not cover third party code, snippets and libraries, only the work unique to this framework. Most of the other work is either in the public domain or, more commonly, in an MIT or MIT-compatible license (some are BSD or 3 Clause). The library inventory was vetted by attorneys in 2015 when it was licensed to PieceMaker and used in a retail setting at Toys-R-Us for commercial purposes, so it has already been combed for any copyright violations or patent infringements.

I politely request that if you use our framework to make a product, game or otherwise, please include the Lost Astronaut Game Creation Framework splash screen among your logos and other marketing material. You can find the highest quality copy of this splash screen image in Apolune/data/images/splash.png You are also welcome to isolate the center portion as a "sticker style label" if you don't want to use the whole screen.

Crediting the author, H. Elwood Gilliland III in your documentation and/or credits would also be nice. Also, linking to this repository would be nice.

Note that if you remove a section you should not remove any copyright notices. If a file or section of a file that is desired to be used in another project does not have a copyright notice, then, to assure compliance, please use the following snippet and place it at the beginning of the section or file:

--- SNIPPET STARTS
/*********************************************************************************************
 *  __    __________________   ________________________________   __________  ________       *
 * /\ \  /\  __ \  ___\__  _\ /\  __ \  ___\__  _\  == \  __ \ "-.\ \  __ \ \/\ \__  _\ (tm) *
 * \ \ \_\_\ \/\ \___  \/\ \/ \ \  __ \___  \/\ \/\  __<\ \/\ \ \-.  \  __ \ \_\ \/\ \/      *
 *  \ \_____\_____\_____\ \_\  \ \_\ \_\_____\ \_\ \_\ \_\_____\_\\"\_\_\ \_\_____\ \_\      *
 *   \/_____/_____/_____/\/_/   \/_/\/_/_____/\/_/\/_/\/_/_____/_/ \/_/_/\/_/_____/\/_/      *
 *    --------------------------------------------------------------------------------       *
 *     Lost Astronaut Game Development Framework (c) 2007-2020 H. Elwood Gilliland III       *
 *********************************************************************************************
 * This software is copyrighted software.  Use of this code is given only with permission to *
 * parties who have been granted such permission by its author, Herbert Elwood Gilliland III *
 * This software is licensed by permissions of the following open source LICENSE:  AGPL 3.0  *
 * See https://www.gnu.org/licenses/agpl-3.0.en.html for details on this license.            *
 *********************************************************************************************/
--- SNIPPET ENDS

Philosophies on Licensings

The point of releasing this work in Github as AGPL3 was to:

a) Protect myself against losing ownership

b) Provide a way for open source to be made by third parties

c) Align with the goals of the AGPL3

However, it is not set in stone and may change in the future. I have not yet found a license that:

a) Encourages/requires modifications and improvements to the framework to be passed back to the main project in a way that enhances the original project for community support

b) Distinguishes "Application Code" from "Framework Code" when these things are in essentially the same overall source code project, and yet is still a recognized OSI license. I really don't want to "own" your application code, it's yours -- as I say in one of the GraphicsAddict videos -- but if you make something amazing as part of your application and want to share it back with us, you should, and we'll try to include it for everyone to benefit.

c) Provides some way for those who do profit off it from to reliably contribute profits back to this project to help it financially.

I have mentioned at some point in this readme, that you can negotiate an exception or exemption from the AGPL. This would probably mean you would have to sign something or provide at least some written evidence of an agreement with me. However, while I have not posted any particular fee for that, I want to make clear that I have considered a fee of $200 per application in the past, though I have not entirely decided when and how that is appropriate to collect. So, I'm open to discussing ways to exempt yourself. Perhaps a percentage of royalties is a good way for this to happen. Regardless, we do not have enough sponsorship at this point to create a non-profit around this source code, to hire people to maintain it for example, nor to fund improvements for the greater good as far as the project's roadmap. These things are all possible if we (you the community and me the author) can leverage such deals. There are also some cases where a fee-less exemption might be possible.

So, it's still up for discussion and may change and I welcome you to open an Issue to discuss this publicly, or to reach out privately (starting on the Discord, as mentioned above) to negotiate.

Project History

Let's go through a brief history of this project, which, until 10/30/2020 was completely done in secret as closed source.

2005

I do some work in Processing and make some small games and audiovisual helpers.

2008

When I first developed this engine, it was written in pure C using a toolkit called Agar GUI. I had been using Agar GUI for a postdoctoral research project called Avenzoar Digital Pathology Tool (https://sourceforge.net/projects/avenzoar) and after that appointment concluded I wanted to develop a game called Interstellar Empire as a "quick 6 month project" that extended earlier work I had done using Processing IDE (Java).

2009

Frustrated with the extremely odd world of Agar and remembering now why I stopped using C to develop games, I discovered "Enhanced C" and the Ecere SDK. The lure of this toolkit was that I could agnostically develop for Linux and Windows using a more modern language (and quite a nifty one at that) and with the flip of a switch support either OpenGL or DirectX. I quickly moved the engine into "eC" (Enhanced C) (https://ecere.org) -- but after about a year of learning OpenGL and eC, I realized I needed to take the plunge and learn C++ because Ecere had sparce support compared to what I felt were "well funded and organized" commercial platforms like Microsoft Visual Studio.

2010

After transliterating all of the work from eC to C++ and filling in most of the requirements by developing an OpenGL engine "from a single triangle demo" in Visual Studio, I decided I would develop a game called Empire in the Sky (http://lostastronaut.com/empire). It was around this time that I released libALgore, a joke on the name of former vice president of the USA, for the OpenAL ecosystem, which implemented an object-oriented approach to libALURE in C++.

At the time I was using the first "free" version of Visual Studio, called MS Visual C++ 2010 Express Edition. Unfortunately, this "freebie" by Microsoft had an inherent flaw: the team at Microsoft had inadvertently colluded C# rules with C++ rules. And so, even after several years of effort, I kept running into undefined behavior. After I got in touch with Microsoft, three VPs apologized and gave me "lifetime professional level support" for my fledgling game development company. They also lead me through a series of complex patches to fix the problem, but ultimately I moved on to newer versions of Visual Studio.

2013

Three years had passed since I began work in Visual Studio. My "six month game project" was nowhere near complete. By this time, Empire in the Sky (EITS) and its home, Desura, had questionable futures. EITS contains some of my best visual work with spheres and planetoids, and some of the more complicated work I've done in 3D editors, but I hit a wall that is probably familiar to players of No Man Sky. I realized that a procedurally generated universe was either too broad of a scope for one lone game developer to muster, or that it would take 20 years to complete. I learned a powerful lesson about art and procedurally generated worlds at this time. I decided I would "pause" EITS in lieu of completing one "traditional space game" title, a prequel, called Fringes of the Empire. I had learned an aweful lot about graphics and 3D. And, after many trials and challenges, I had an engine that's code was a flawless diamond.

2014

Fringes of the Empire is in development. I decided that -- perhaps I was wrong in creating my own engine. Perhaps I had overextended myself? Bloggers had advised against it. Maybe I was too determined? I needed support. So, I bought GameMaker for a wopping $500, thinking I would skip all that engine development hell and in 1 year produce a game close to what I was hoping. It was to be an RPG in space only (scoping it back, roping it in) and it was going to be all pre-designed levels for a single player experience.

Well, GameMaker 1.2 was horribly buggy, too! I spent countless months talking to GameMaker's developer YoyoGames. I hoped they would hire me, since I could make engines and had farther-reaching ideas than they would even believe! I did end up influencing GM:S 2, but those lousy bastards wouldn't even give me a free upgrade and discontinued GM:S 1.2 (the version I had bought) which in my opinion broke their promises for lifetime updates. They said it was technically only for GMS version 1.2 !!!! WHAT!!! See it: https://www.youtube.com/watch?v=v61uaki9GZw&ab_channel=HerbertGilliland

After 1 year of working in GameMaker, I couldn't do it anymore. I scrapped it and decided to rewrite everything back in this game framework again. I wanted to finish the game!

2015

This year I licensed the engine to PieceMaker Technologies Inc., to build creative 3D printing kiosks gamified for the Toys-R-Us retail space. Entire branches of source code (still private) built out an award-winning 3D system for retail environments that won Best in Toy Fair 2016.

I give up on GameMaker, but continue to enhance the framework and begin creating a new "Fringes" in C++.

2017

I take a two year haitus while working on Poser 3D: Character Art and Animation Studio. I implement more 4.x style OpenGL VBO functionality eliminating most of the older

2020

I decide to release the project on Github. Happy Devil's Night 10/30/2020