FOnline Engine

Goal

Friendly engine for fallout-like isometric games for develop/play alone or with friends.

Features

• OpenGL/ES/WebGL and DirectX (wip) rendering
• C++17, AngelScript, C#/Mono and Fallout Star-Trek as scripting languages (wip)
• Editor and Server target platforms
  • Windows
  • Linux
  • macOS (wip)
• Client target platforms
  • Windows
  • Linux
  • macOS
  • iOS
  • Android
  • Web
  • PS4 (wip)
• Online and singleplayer (wip) modes
• Supporting of Fallout 1/2/Tactics, Arcanum and other isometric games asset formats
• Supporting of 3d characters in modern graphic formats
• Hexagonal/square map tiling

Work in progress

Bugs, performance cases and feature requests see at Issues page.

Some major issues (that I work currently)

• Code refactoring (see separate section below)
• C++ as native scripting language with additional optional submodules for AngelScript, C# and Fallout Star-Trek SL
• Multifunctional editor
• Singleplayer mode
• Documentation

Some minor issues

• Direct X rendering
• Supporting of UDP
• Exclude FBX SDK from dependencies
• Parallelism for server
• Steam integration

Code refactoring plans

• Move errors handling model from error code based to exception based
• Eliminate singletons, statics, global functions
• Preprocessor defines to constants and enums
• Eliminate raw pointers, use only smart
• Hide implementation details from headers using abstraction
• Fix all warnings from PVS Studio and other static analyzer tools
• Improve more unit tests and gain code coverage to at least 80%

Repository structure

• BuildScripts - scripts for automatical build in command line or any ci/cd system
• Resources - resources for build applications but not related to code
• SdkPlaceholder - all this stuff merged with build output in resulted sdk zip
• Source - fonline engine specific code
• SourceTools - some tools for formatting code or count it
• ThirdParty - external dependencies of engine, included to repository

Clone / Build / Setup

You can build project by sh/bat script or directly use CMake generator.
In any way first you must install CMake version equal or higher then 3.10.2.

For build just run from repository root one of the following scripts:

• BuildScripts\windows.bat - build Windows binaries (run on Windows only)
• BuildScripts/linux.sh - build Linux binaries (run on Unix platforms)
• BuildScripts/web.sh - build Web binaries (run on Unix platforms)
• BuildScripts/android.sh - build Android binaries (run on Unix platforms)
• BuildScripts/mac.sh - build macOS binaries (run on macOS only)
• BuildScripts/ios.sh - build iOS binaries (run on macOS only)

All output binaries you can find in Build/Binaries directory.

Third-party packages

• ACM by Abel - sound file format reader
• AngelScript - scripting language
• Asio - networking library
• Assimp - 3d models/animations loading library
• backward-cpp - stacktrace obtaining
• Catch2 - test framework
• GLEW - library for binding opengl stuff
• glslang - glsl shaders front-end
• Json - json parser
• diStorm3 - library for low level function call hooks
• PNG - png image loader
• rapidyaml - YAML parser
• SDL2 - low level access to audio, input and graphics
• SHA1 by Steve Reid - hash generator
• SHA2 by Olivier Gay - hash generator
• SPIRV-Cross - spir-v shaders to other shader languages converter
• Theora - video library
• Vorbis - audio library
• cURL - transferring data via different network protocols
• FBX SDK - fbx file format loader
• {fmt} - strings formatting library
• Dear ImGui - gui library
• libbson - bson stuff
• mbedTLS - library for network transport security
• MongoC Driver - mongo db driver
• Mono - c# scripting library
• libogg - audio library
• openssl - library for network transport security
• unqlite - nosql database engine
• variant - c++17 std::variant implementation in c++11/14
• websocketpp - websocket asio extension
• zlib - compression library

Help and support

• Site: fonline.ru
• GitHub: github.com/cvet/fonline
• E-Mail: cvet@tut.by
• Forums: fodev.net
• Discord: invite