2020-11-16 17:54:46 +01:00
# Mastodon Chess
2020-11-18 16:52:03 +01:00
Play with other fediverse users a Chess game! Mastodon Chess control games, players and boards and even it post, graphically, every move to both players!
Mastodon Chess (mastochess) uses [python-chess ](https://python-chess.readthedocs.io/en/latest/ ) library.
2020-11-16 17:54:46 +01:00
2020-11-16 18:02:57 +01:00
### How to play:
2020-11-16 17:54:46 +01:00
2020-12-04 19:47:05 +01:00
- To get help:
2020-11-28 23:00:15 +01:00
@your_bot_username help
2020-12-04 19:47:05 +01:00
- To start a game:
2020-11-16 18:03:48 +01:00
2020-11-16 17:54:46 +01:00
@your_bot_username new
2020-12-04 19:47:05 +01:00
- To make a move:
2020-11-16 17:54:46 +01:00
@your_bot_username move e2e4
2020-12-04 19:47:05 +01:00
- To finish game at any time:
2020-11-16 18:01:31 +01:00
2020-11-19 14:18:02 +01:00
@your_bot_username end
2020-12-04 19:47:05 +01:00
- To list on going games:
2020-11-19 14:18:02 +01:00
2020-11-25 11:38:16 +01:00
@your_bot_username games
2020-12-04 19:47:05 +01:00
- To get any game anotations, in ex. game 1, in pgn format:
2020-11-25 11:38:16 +01:00
@your_bot_username send 1
2020-11-16 18:01:31 +01:00
2020-12-04 19:47:05 +01:00
- To promote a pawn use first letter of desired piece:
2020-11-27 22:13:16 +01:00
@your_bot_username move g7g8r (if you want a rook)
n = knight
b = bishop
r = rook
Don't use q for queen. Pawn is promoted to Queen by default.
2020-12-04 19:47:05 +01:00
- To claim a draw:
@your_bot_username draw
### Commands table
2020-11-28 18:35:31 +01:00
| ca | en | es | ex. | Observ. |
|:-----:|:-----:|:--------:|:----:|:-----------:|
| nova | new | nueva | | |
| mou | move | mueve | e2e3 | |
| fi | end | fin | | |
| jocs | games | partidas | | |
| envia | send | envia | 1 | game number |
2020-12-04 19:47:05 +01:00
| taules| draw | tablas | | |
| ajuda | help | ayuda | | |
2020-11-27 22:13:16 +01:00
2020-11-16 17:54:46 +01:00
### Dependencies
- **Python 3**
- Postgresql server
- Mastodon's bot account
2020-11-18 16:53:45 +01:00
- [Mastodon ](https://joinmastodon.org ) server admin
2020-11-16 17:54:46 +01:00
### Usage:
Within Python Virtual Environment:
1. Run `pip install -r requirements.txt` to install needed Python libraries.
2020-11-25 13:42:53 +01:00
2. Run `python db-setup.py` to setup and create new Postgresql database and needed tables in it.
2020-11-16 17:54:46 +01:00
2020-11-25 13:42:53 +01:00
3. Run `python smtp_setup.py` to setup your smtp server, user and password. Needed to send game anotations to players.
2020-11-16 17:54:46 +01:00
2020-11-25 13:42:53 +01:00
4. Run `python setup.py` to get your Mastodon's bot account tokens.
5. Use your favourite scheduling method to set `python mastochess.py` to run regularly.
2020-11-16 17:54:46 +01:00
2020-11-20 10:00:27 +01:00
2020-11-25 11:38:16 +01:00
20.11.2020 - New feature! Added link to on going games in games list
2020-11-23 18:22:08 +01:00
21.11.2020 - New feature! Added a warning to player in turn when has been captured one of its pieces
2020-11-25 11:40:36 +01:00
23.11.2020 - New feature! Now all moves are saved to file (with san anotation).
2020-11-27 22:13:16 +01:00
25.11.2020 - New feature! Get any game anotations via email (see point 3 above).
2020-11-28 18:09:48 +01:00
27.11.2020 - New feature! Pawn promotion and locales support ( ca & eng )
2020-11-28 20:14:40 +01:00
28.11.2020 - New feature! Added 'es' locale support
2020-11-28 23:00:15 +01:00
28.11.2020 - New feature! Now any fediverse user can play Mastodon Chess!
2020-12-03 13:36:06 +01:00
28.11.2020 - New feature! Added help
2020-12-04 19:49:40 +01:00
03.12.2020 - New feature! Added pgn save & send support
2020-12-04 19:47:05 +01:00
04.12.2020 - New feature! Now players can claim a draw.
