Awesome
Lean 4 Game
This is the source code for a Lean game platform hosted at adam.math.hhu.de.
Creating a Game
Please follow the tutorial Creating a Game. In particular, the following steps might be of interest:
- Step 5: How to Run Games Locally
- Step 7: How to Update an existing Game
- Step 9: How to Publishing a Game
- Troubleshooting
Documentation
The documentation is very much work in progress but the linked documentation here should be up-to-date:
Game creation API
- Creating a Game: the main document to consult.
- More about Hints: describes the
HintandBranchtactic.
Frontend API
- How to Run Games Locally: play a game on your computer
- How to Update an existing Game: update to a new lean version
- How to Publishing a Game: load your game to adam.math.hhu.de for others to play
Backend
not fully written yet.
- Server: describes the server part (i.e. the content of
server/undrelay/).
Contributing
Contributions to lean4game are always welcome!
Translation
The interface can be translated to various languages. For adding a translation, one needs to do the following:
- In
client/src/config.json, add your new language. The "iso" key is the ISO language code, i.e. it should be accepted by "i18next" and "GNU gettext"; the "flag" key is once accepted by react-country-flag. - Run
npm run translate. This should create a new fileclient/public/locales/{language}/translation.json. (alternatively you can copy-pasteclient/public/locales/en/translation.json) - Add all translations.
- Commit the changes you made to
config.jsontogether with the newtranslation.json.
For translating games, see Translating a game.
Security
Providing the use access to a Lean instance running on the server is a severe security risk. That is why we start the Lean server with bubblewrap.
Credits
The project has primarily been developed by Alexander Bentkamp and Jon Eugster.
It is based on ideas from the Lean Game Maker and the Natural Number Game (NNG) by Kevin Buzzard and Mohammad Pedramfar, and on Patrick Massot's prototype: NNG4.