Project under development, it is a platform for testing new boardgame prototypes in the browser online with multiple players. This project is currently including one board game prototype called "Skyscrapers". It is being developed alongside the platform it runs on. The project name "tsobg" is a working project name based on my initials.
Requires python 3 (has been tested on version 3.8.2). Requires some python modules including "flask", module names are printed as errors if you try to run it. Install flask (and other missing modules for example like this):
pip3 install --user flaskRun the prototype board game "Skyscrapers". First, generate the graphics image files:
python Skyscrapers/generate_graphics.pyThis should create new folders with image files in the Skyscrapers project folder.
Now start the game:
python Skyscrapers/online/main.pyThe command terminal should ask you to enter number of players, and then the flask server will start.
Now go to the root page of the server in the browser. You should see a page that lets you enter your player name. All players have to do this, and the game starts when playar count has filled up.
It is possible to hardcode number of players and some or all player names (also require user id's) in game_settings.py.
Threre are some unit tests for tsobg and Skyscrapers, run like this:
python tsobg_test.py
python Skyscrapers/Skyscrapers_test.pyThe project is divided into "tsobg" (the platform), and the board game "Skyscrapers". The board game extends an interface called "GameInterface" and implements some methods, in this case the class is called "SkyscrapersGame". tsobg contains the web server, and the client files as well. Once the game has started, the client game page acts as a single-page application. The board game project (Skyscrapers) sends client updates to the platform (by a reference to GameManager), these updates are sent via the "UIInterface" class. The game project both creates and alternates the UI for the game as it goes on sending "uiChanges". These uiChanges uses div element id's and can position divs, set size, set parent div, set background colors, add a text and/or image to div etc... The uiChanges is then picked up by the client when it asks the server platform for the latest uiChanges. It is possible to select only a subset of players when making uiChanges, to handle for example secret information.
The game project can also add one or more actions to a div (under development). These should be sent back to board game object when user interacts. If the action is valid the board game object will progress the game by updating its state, and send new uiChanges to the clients.
Finally, the platform includes a uiHistory and player action history. The uiHistory makes it possible for the clients to step backwards to see what happened in the past.
The actionHistory makes it possible to revert one or more moves if all players agrees that this is ok to do so.
This is an expermintal feature, can be tested by first taking some actions to progress the game a couple of states,
then use the admin page to trigger a revert: http://127.0.0.1:5000/admin/