Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/w0rp/mechmission
A FOSS turn-based strategy video game
https://github.com/w0rp/mechmission
ncurses turn-based-strategy video-game
Last synced: about 1 month ago
JSON representation
A FOSS turn-based strategy video game
- Host: GitHub
- URL: https://github.com/w0rp/mechmission
- Owner: w0rp
- License: gpl-3.0
- Created: 2023-08-28T23:44:45.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-09-14T22:28:13.000Z (over 1 year ago)
- Last Synced: 2024-10-14T05:27:26.357Z (3 months ago)
- Topics: ncurses, turn-based-strategy, video-game
- Language: C++
- Homepage:
- Size: 150 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mech Mission
[](https://github.com/w0rp/mechmission/actions?query=event%3Apush+workflow%3ACI+branch%3Amaster++)
Mech Mission is a FOSS turn-based strategy video game in the style of classic
DOS and Windows 9x strategy titles.
This project is very much a "work in progress."
## Build
To build the project, make sure source libraries are loaded by updating git
submodules.
```
git submodule update --init
```
Ensure that ncurses is installed on the system.
## Linting
Use `clangd` and make sure `clang-tidy-17` is installed to check code.
Checks can be run on the whole project like so:
```
! run-clang-tidy-17 -quiet -header-filter '.*\.hpp' src 2>&1 \
| grep -v '^clang-tidy\|^[0-9]\+ warnings generated'
```
## Build for release
```
cmake -DCMAKE_BUILD_TYPE=Release .
make clean
make
```
## Debugging
This section describes how to debug the game using `gdbgui`. If you don't have
it, run `pip install gdbgui`.
Ubuntu has an annoying default where it doesn't let you debug applications by
connection to a process ID. Turn that off when you want to debug programs.
```sh
sudo sh << END
echo 0 > /proc/sys/kernel/yama/ptrace_scope
END
```
Build the project in debug mode and start the executable running.
```
cmake -DCMAKE_BUILD_TYPE=Debug .
make clean
make
./mechmission
```
Open another terminal now the game has started, and get the process ID for it.
```
pgrep -af ./mechmission
```
Now run `gdbgui` telling it to only show our sources and start from a sensible
place to begin with. Enter the PID you saw before into the GUI.
```
gdbgui --project "$PWD/src" mechmission
```