A game and custom-built game engine designed for creating simple, top-down strategy games.
Go to file
S David 42af043b3f
Some checks reported errors
buildbot/darwin-macos-cmake-builder Build done.
buildbot/freebsd-jail-cmake-builder Build done.
buildbot/linux-podman-cmake-builder Build done.
WIP: Move boilerplate application code to external lib.
Overview
---

- Added: External dependency on IOCore
- Removed:
  - Application.hpp, Application.cpp
  - debuginnfo.hpp,debuginfo.cpp
  - Exception.hpp,Exception.cpp
  - types/legible_ctypes.hpp
  - All references to Boost and execinfo/backtrace.

Additionally:
---

- .clang-format: Switch to modified WebKit code style
- .clang-tidy:   Tweak style for Constexpr  statements
- .clangd:  Re-enable IWYU include directory insertion & analysis

CMakeLists.txt:
  - Replace manual CMake conditionals with prepackaged functions from my
    custom cmake/BuildProperties.cmake CMake module.
  - Bump project version
  - Set project-wide dir variables
  - Add and use CPM Package Manager
  - Add reference to my IOCore application framework library using CPM
  - Remove references to backtrace generation. Now using IOCore
  - Comment out app and demo subdirectories for now.

cmake/BuildProperties.cmake:
  - Move in-source build detection, set project-wide environment
    variables, and other configuration tasks to specific CMake
    functions in a custom CMake module.

cmake/CPM.cmake:  Imported from the CPM Project under MIT License
  - Copyright (c) Lars Melchior and contributors

demo/Phong.hpp,demo/Phong.cpp:
  - Use  new method names. (untested, never compiled)

include/Component.hpp: Unused, Untested changes

Work #28
2024-04-13 16:17:00 -04:00
.vscode Add some support for VSCode w/ CMake extension 2024-03-07 10:11:22 -05:00
apps Define more clang-tidy checks and improve code legibility 2024-03-09 16:09:19 -05:00
cmake WIP: Move boilerplate application code to external lib. 2024-04-13 16:17:00 -04:00
data Add test rendering image and include licensing info 2024-01-03 23:55:25 -05:00
demo WIP: Move boilerplate application code to external lib. 2024-04-13 16:17:00 -04:00
editorconfig Modify enum constant naming convention base don how the enums are used 2024-02-29 09:39:14 -05:00
include WIP: Move boilerplate application code to external lib. 2024-04-13 16:17:00 -04:00
scripts Modernize codebase using clant-tidy modernization checks 2024-02-26 14:57:56 -05:00
src WIP: Move boilerplate application code to external lib. 2024-04-13 16:17:00 -04:00
tests WIP: Move boilerplate application code to external lib. 2024-04-13 16:17:00 -04:00
.clang-format WIP: Move boilerplate application code to external lib. 2024-04-13 16:17:00 -04:00
.clang-tidy WIP: Move boilerplate application code to external lib. 2024-04-13 16:17:00 -04:00
.clangd WIP: Move boilerplate application code to external lib. 2024-04-13 16:17:00 -04:00
.gitattributes Add .gitattributes for more accurate code statistics on gittea 2023-12-12 23:25:53 -05:00
.gitignore Update .gitignore for vscodium settings folder 2024-03-09 15:59:55 -05:00
CMakeLists.txt WIP: Move boilerplate application code to external lib. 2024-04-13 16:17:00 -04:00
Doxyfile Update doxyfile, .clang_format settings, fix doxygen warnings 2024-01-29 11:41:50 -05:00
LICENSE Fork project from template project. 2023-12-12 21:50:38 -05:00
README.md Fix: Correct required version of C++ in README.md 2024-01-17 18:46:13 -05:00

Elemental Game and Custom-built Game Engine

Welcome to Elemental Game, a game and custom-built game engine designed for creating simple, top-down strategy games. This README provides an overview of the project, its design principles, goals, and instructions for building and testing.

Getting Started

Build Tools

  • CMake (version 3.21 or higher)
  • C++17-compatible compiler

Project Structure

  • src/: Contains the engine logic, defines a libray target
  • apps/: Contains the game source, as well as source for resource editors, all consumers of the engine target
  • test/: Contains unit tests

Library Dependencies

  • Catch2 v3: Test framework for C++ (can be fetched using FetchContent).
  • FakeIt: Mocking framework for C++ (fetched using FetchContent).
  • SDL2: A cross-platform development library providing low-level access to audio, keyboard, mouse, and display functions.
  • SDL2_Image: An extension library for SDL2, offering support for loading various image file formats.
  • SDL2_Gfx: A graphics primitive extension library for SDL2, providing additional functionality for efficient graphics rendering.

Building the Project

  1. Clone the repository:

    git clone <URL>
    
  2. Navigate to the project directory:

    cd  elemental-game
    
  3. Configure your build system:

    cmake -B debug -G Unix Makefiles
    # or
    cmake -B debug -G Ninja   # this is faster and more modern
    
  4. Invoke your build system

    cmake --build debug
    

Running Unit Tests

  1. After building the project, you can run the unit tests:

    cmake --build --target ctest
    

This will execute the Catch2 test suite.

License

This project is licensed under the MPL 2.0 License.

Catch2, which is used for unit-testing is © Catch2 authors, and is licensed under the Boost Software License v1.0 FakeIt, is also used for unit-testing and is © Eran Pe'er and is licensed under the MIT License