horizontally scalable 📈 multiplayer 👩‍💻 🧑‍💻 chess ♟️ over ssh 🖥️ https://chessh.linux.usu.edu
Go to file
2023-03-13 14:11:28 -06:00
.github/workflows Update elixir.yml 2023-01-24 12:43:08 -07:00
buildscripts Update build_server.sh 2023-02-24 23:44:34 -07:00
config Show previous move in message body, which notification is now instant, add check highlighting 2023-02-08 22:06:58 -07:00
front Revert "Sudoku" 2023-02-26 12:27:27 -07:00
lib/chessh Add previous game viewer 2023-03-13 14:11:28 -06:00
presentation Better README 2023-02-24 15:59:42 -07:00
priv store move history 2023-03-08 00:24:30 -07:00
test Discord notifs (#14) 2023-02-01 14:57:14 -07:00
.env.example Better README 2023-02-24 15:59:42 -07:00
.formatter.exs Initial commit! 2022-12-19 01:39:10 -07:00
.gitignore Elixir cluster! 2023-01-31 19:07:47 -07:00
.tool-versions Presentation (#17) 2023-02-23 19:52:25 -07:00
Dockerfile Multicast instead of .hosts.erlang 2023-02-01 08:51:20 -07:00
mix.exs Add previous game viewer 2023-03-13 14:11:28 -06:00
mix.lock Elixir cluster! 2023-01-31 19:07:47 -07:00
package-lock.json Web Client (#11) 2023-01-19 14:04:10 -07:00
README.md Update README.md 2023-02-28 15:07:35 -07:00

CheSSH

CheSSH is a distributed multiplayer implementation of the game of Chess over SSH, written in Elixir, with Discord integrations to deliver alerts when players are looking for opponents, or in games when it is one's turn.

https://user-images.githubusercontent.com/25559600/221317658-a80046ca-6009-456d-b43c-67d95baa4bf6.mp4

Usage

Dependencies

  • npm
  • elixir
  • postgresql
  • redis (which you can ignore if you only use the ETS backend for Hammer in config/dev.exs [set by default])

Installation

Do something among the lines of:

git clone https://github.com/Simponic/chessh
cd chessh

cp .env.example .env
chmod 0700 .env

# In one shell (after filling in your .env), start CheSSH
export $(cat .env | xargs)
mix ecto.create
mix ecto.migrate
iex -S mix

# In another shell, start the frontend
export $(cat .env | xargs)
cd front
npm install
npm start

Architecture

The process of building the pi cluster is wholly contained in the awful buildscripts, which will individually ssh into separate pi's and build the services locally there as well as update the load balancer pi's configurations for nginx and HAproxy.

More architecture talk of CheSSH can be found in my (albeit kinda cringe) FSLC presentation on Elixir: https://github.com/Simponic/chessh/blob/main/presentation/chessh.org

Environment Variables (mostly optional)

  • REACT_APP_DISCORD_INVITE is the invite link to the discord server with the CheSSH bot
  • REACT_APP_DISCORD_OAUTH is the link (after replacing the GET URL params) that will be used to initiate discord OAUTH from the frontend
  • CLIENT_REDIRECT_AFTER_OAUTH & SERVER_REDIRECT_URI are self-explanatory
  • REACT_APP_SSH_SERVER and REACT_APP_SSH_PORT are used to build the .ssh config given to users on the home page of CheSSH after authentication
  • NEW_GAME_PINGABLE_ROLE_ID is the role id of the role to ping when one is looking for an opponent
  • REMIND_MOVE_CHANNEL_ID is the channel id to create private threads with players for move reminders and other communications
  • NEW_GAME_CHANNEL_ID is similar to the above
  • CLUSTER_NODES is a comma-separated list of nodes accepting connections to connect with libclustre