Anura is the tech behind the spectacular Frogatto & Friends. It is a fully-featured game engine, free for commercial and non-commercial use.
To compile Anura for Argentum Age
(formerly Citadel), use the argentum-age
branch.
At the time of writing (2023-08), Anura is only committed to supporting explicitly one module / game: Frogatto. For anything else (like Argentum Age above) you are on your own.
Anura is a multi platform C++ engine rolling its own functional scripting language (FFL) to build games.
While there have been multiple native mobile, console and other embedded platforms supported in the past, at the time of writing (2023-08) only three major desktop operating systems are supported.
While Anura might build and run on other operating systems, on those you will be on your own. It is not completely out of the question to eventually widen the set of platforms targeted, but currently (2023-08) the main focus is to clean Anura up and to ensure its compilability for years (and compilers and language standards and library upgrades) to come.
Anura is built using the ISO C++ 17 standard on all platforms without any language specification extensions.
Anura is not fully known or understood at this point in time, but we know for certain some of parts of it are actually dead (not used anymore) or unused (never used, at least not by Frogatto). The effort to reverse engineer and identify and prune the truly dead parts off Anura off is currently (2023-08) starting.
For the majority of these we do not, at the time of writing (2023-08), know the upper or lower bounds of what the engine actually happily builds, links and runs against.
This list represents our current (2023-08) understanding:
We know the above is not an exhaustive list: there are other ones too, but pulling at least these in results in a build, which builds, links and runs. The investigation continues (2023-08) to find and minimize the true full set.
All builds of Anura are 64bit only and come in two flavors: Debug and Release builds.
The default build type on every platform is Debug.
Additionally on some platforms it is possible to also build the engine dynamically linked against the operating system provided libraries. The default build type on every platform is to use vcpkg to pull the dependencies in and to statically link those in into the resulting binary for the ease of distribution.
Anura is an old clunky beast with over a decade of history. It's currently (2023-08) spitting out a lot of compiler warnings on most platforms we eventually aim to peel off one by one so that we would feel comfortable going for applying static analysis tooling and also eventually driving those results down to zero.
Aspirational concept level build type descriptions are provided below. The finer details will vary on a per platform basis as the toolchains and the exact command line flags they use can be very different across ecosystems.
Reference material:
As a rule of thumb the Debug builds add the appropriate per platform flags to enable the debuggability of the binary with reasonable performance.
Compiler flags:
-g
-Og
Release builds add optimization flags for the best level of performance, which is still language specification compliant.
The release builds also turn all debug features (like Asserts!) off.
Precompiler flags:
NDEBUG
Compiler flags:
-O3
-flto
We can only feasibly build, link and run against operating system provided libraries on various UNIXen, out of which we currently only support Linux.
Currently (2023-08) we use CMake to build the project on Linux operating systems.
Sample build flow:
cmake . -D CMAKE_CXX_COMPILER='clang++' -D CMAKE_BUILD_TYPE=Release
make -j "$(getconf _NPROCESSORS_ONLN)"
You may not pass the compiler in via the environment variable CXX
as that
fools quite a lot of CMake internal machinery. Only two different kinds of C++
compilers being passed in actually work: g++
and clang++
. Passing in gcc
or clang
will not work as that confuses CMake and it tries to link the wrong
runtime in (a C runtime instead of a C++ runtime).
We recommend to use clang++
for developer eronomics:
lldb
vs. gdb
<- Subjective preferenceThis build treats warnings as errors and has a separate config file on a per warning, per compiler and per file basis to turn warnings off so that we can prevent the introduction of new warnings into the codebase.
The sets of warnings and diagnostics we currently silence:
-Werror
)
-flto
)
-Wno-odr
-Wno-aggressive-loop-optimizations
-Wno-lto-type-mismatch
-Wall
-Wno-sign-compare
-Wno-reorder
-Wno-unused-function
-Wno-unused-variable
-Wno-overloaded-virtual
-Wno-unused-but-set-variable
-Wno-unused-local-typedefs
-Wno-use-after-free
-Wno-maybe-uninitialized
-Wno-unneeded-internal-declaration
-Wno-reorder-ctor
-Wno-unused-private-field
-Wno-unused-function
-Wno-unused-variable
-Wno-overloaded-virtual
-Wno-unused-but-set-variable
-Wno-unused-local-typedef
-Wno-unused-const-variable
-Wno-unused-lambda-capture
-Wextra
-pedantic
The above peeling is done in order to eventually also aim for a clean static analysis result on the CI.
We officially track the buildability on four major distributions with two compilers: g++ and clang++.
On any rolling release distributions we assume you know what you are doing and you are on your own.
There is a loose plan to have an Anura package available again in Debian in time for the Debian Trixie release expected in early Summer 2025.
Check the CI out and repeat after it what it is doing.
Check the CI out and repeat after it what it is doing.
Check the CI out and repeat after it what it is doing.
Check the CI out and repeat after it what it is doing.
On most platforms we must bundle our libraries in with the binary as that is the way of the land.
Undocumented as of 2023-08.
Undocumented, known broken as of 2023-08.
Undocumented, known broken as of 2023-08.
We only provide static builds for shopfronts and their runtimes.
Only supporting v3 / Sniper as of 2024-01.
Details are purposefully sparse here as the monetization model of Frogatto is convenience.
All incoming changes must:
We recommend to use Atomic Commits and minimal topical Pull Requests where ever possible. These help you teach us about your change and do not leave you as the only person in the universe understanding how your change works. In a Pull Request event the one making the Pull Request is the teacher and the reviewer is the student. The end result should be akin to the student passing the test with flying colors.
Soft Quality Gates are a FYI level informative peek into where Anura can currently build out of the box, but are not of major concern and quite often the correct course of action is to drop the build in question and amend the documentation to match.
On Pull Requests:
This set should cover most popular use cases and also derivative distributions of these root distributions. There are no plans to test on rolling release distributions: on those you are on your own and we welcome the heads up if something breaks for you and can take a look, but will not guarantee a rapid fix. Pull requests to add more known-good targets to the set of are most welcome, but zero effort will be spent on our side to turn a build like that from red to green - it has to be green when coming in.
Hard Quality Gates are our non-negotiable baseline of quality expectations on incoming changes. Not green -> not getting merged.
On Pull Requests:
xvfb-run
All publishing will happen from the module side, most notably from Frogatto.