Go to file
Nico Schottelius 26fa771878 cleanup, re-add arg parsing 2019-08-27 23:19:37 +02:00
archive add /points/<username> 2019-08-26 22:16:23 +02:00
.gitignore add /points/<username> 2019-08-26 22:16:23 +02:00
Pipfile cleanup, re-add arg parsing 2019-08-27 23:19:37 +02:00
Pipfile.lock cleanup, re-add arg parsing 2019-08-27 23:19:37 +02:00
README-20190826.md add /points/<username> 2019-08-26 22:16:23 +02:00
README.md ++doc ++ game 2019-05-26 22:49:26 +02:00
challenge.py cleanup, re-add arg parsing 2019-08-27 23:19:37 +02:00
challenges.py cleanup, re-add arg parsing 2019-08-27 23:19:37 +02:00
challenges_ipv6.py Do stuff 2019-08-26 20:47:15 +02:00
db.py cleanup, re-add arg parsing 2019-08-27 23:19:37 +02:00
server.py cleanup, re-add arg parsing 2019-08-27 23:19:37 +02:00


Welcome to the ungleich-game, a geek game engine!

ungleich-game is supposed to be an easy-to-use, easy-to-play and easy-to-extend game framework for geeks.

It features registration, challenges with dependencies and an easy point system.

The project name is ungleich-game, as it has its roots at ungleich - the project name might change later.

How to play (in general)

  • Select a game server
  • Register
  • List challenges - have fun!

How to play (for instance on Nico's notebook)

  1. Register: send a POST request with your username
curl -d user=nico http://nico.ungleich.cloud:5002/register
  1. Get challenges
curl http://nico.ungleich.cloud:5002/challenge
  1. Get a challenge description
curl http://nico.ungleich.cloud:5002/challenge/registernet
  1. Solve a challenge
curl -d user=nico -d 2a0a:e5c0:101::/64 http://nico.ungleich.cloud:5002/challenge/RegisterNet
  1. Get high score
curl http://nico.ungleich.cloud:5002/highscore

Overview - Game flow

  • Users register at a game server
  • Users play by getting challenges from the game server
  • Users can see their or all high scores on the main page

Overview - Development Flow

[not yet fully implemented]

The idea is that there are challenges and each challenge offers:

  • A description
  • Some dependencies (on something another challenge can provide)
  • A score ("how difficult it is")

How to add challenges

  • Create challenges-.py and add challenges in there
  • Do some magic so all challenges are imported by server

How to run your own game server


python server.py

Overview - Security

None at the moment.

Tech stack

The base for building games is:

  • Python3 - The programmming language
  • Flask - web frontend
  • etcd - storing data, games, etcd.

Things to solve

  • Enhance the Challenge class - maybe make it easier for challenges to abort
  • Enhance the Challenge class - abstract away writing information?
  • Implement dependencies / providers for challenges
  • Add an easy to use CLI (Steven might like click)
  • Write nice code to easily retrieve points per user
  • Sort high score
  • Maybe store all user information in one JSON object?