5.1 KiB
ooga booga
TOC
- What is ooga booga?
- Course: From Scratch to Steam
- Quickstart
- Examples & Documentation
- Known bugs
- Licensing
What is ooga booga?
Ooga booga, often referred to as a game engine for simplicity, is more so designed to be a new C Standard, i.e. a new way to develop software from scratch in C. Other than <math.h> we don't include a single C std header, but are instead writing a better standard library heavily optimized for developing games. Except for some image & audio file decoding, Ooga booga does not rely on any other third party code.
SIMPLICITY IS KING
Ooga booga is designed to keep things simple, and let you solve video game problems the simplest way possible.
What we mean by simple, is twofold:
-
Simple to use Performing SIMPLE and TRIVIAL tasks should be ... SIMPLE. If you want to draw a rectangle, there should be a single procedure to draw a rectangle. If you want to play an audio clip, there should be a single procedure to play an audio clip. Etc. This is something OS & Graphics API's tend to be fascinatingly terrible at even for the most trivial of tasks, and that is a big chunk of what we set out to solve.
-
Simple implementations When you need to do something more complicated, you need to understand the library you're working with. For some reason, it seems like it's a standard for libraries today to obscure the implementation details as much as possible spread out in layers and layers of procedure calls and abstractions. This is terrible. In Oogabooga, there is none of that. We WANT you to delve into our implementations and see exactly what we do. We do not hide ANYTHING from you. We do not impose RESTRICTIONS on how you solve problems. If you need to know what a procedure does, you search for the symbol and look at the implementation code. That's it.
The "Build System"
Our build system is a build.c and a build.bat which invokes the clang compiler on build.c. That's it. And we highly discourage anyone from introducing unnecessary complexity like a third party build system (cmake, premake) or to use header files at all whatsoever.
This might sound like we are breaking some law, but we're not. We're using a compiler to compile a file which includes all the other files, it doesn't get simpler. We are NOT using third party software to run the same compiler to compile the same files over and over again and write it all to disk to then try and link it together. That's what we call silly business (and unreasonably slow compile times, without any real benefit).
Oogabooga is made to be used in Unity builds. The idea is that you only include oogabooga.c somewhere in your project, specify the entry (see build.c) and now it's a Oogabooga project. Oogabooga is meant to replace the C standard, so it is not tested with projects which include standard C headers, so that will probably cause issues.
Course: From Scratch to Steam
This project was started to be used in a course detailing the full ride from starting out making a game to publishing it to Steam. If you're keen on going all-in on getting a small game published to steam within 2-3 months, then check it out for free in our Skool Community.
Quickstart
Currently, we only support Windows x64 systems.
- Make sure Windows SDK is installed
- Install clang, add to path
- Clone repo to <project_dir>
- Make a file my_file.c in <project_dir>
int entry(int argc, char **argv) {
print("Ooga, booga!\n");
}
- in build.c add this line to the bottom
#include "my_file.c"
- Run
build.bat - Run build/cgame.exe
- profit
Examples & Documentation
Documentation will come in the form of a lot of examples because that's the best way to learn and understand how everything works.
See examples.
Simply add #include "oogabooga/examples/some_example.c" to build.c and compile & run to see the example code in action.
Other than examples, a great way to learn is to delve into the code of whatever module you're using. The codebase is written with this in mind.
Known bugs
- Window positioning & sizing is fucky wucky
- Converting 24-bit audio files doesn't really work
Licensing
By default, the repository has an educational license that makes the engine free to use for personal projects.
When you're ready to take the next step and work on a commercial game, you can upgrade to the full commercial license.
Here are the benefits of obtaining the full license:
- Permanent Ownership: You completely own the source code for life.
- No Recurring Fees or Royalties: Just an affordable one-time payment.
- It qualifies you to enter the private Skool community, where there's daily calls with Randy & Charlie, to help speedrun your game's development
You can contact us to find out more.