jameskmonger / creature-chess

Open source Auto Chess game in TypeScript, React and Node

Creature Chess

An open-source auto chess game written in TypeScript using React and Node.

Playing

To try the game, head to creaturechess.gg, register an account and click "Find Game".

Development

Prerequisites

• Node.js 18
• Docker w/ docker-compose
• Yarn (npm i -g yarn && yarn set version 4.0.2)

Environment variables

Copy .env.example to .env in the root of the repo.

These will be automatically picked up and used by the game.

Generate Prisma client

If you are aiming to work on the code locally, you must generate the Prisma client so that TypeScript understands the available types.

make prisma-generate

Running it in Docker

To build and run the project, you can use make:

make

If you change the server, you can run make rebuild to rebuild and restart the server.

Documentation

• Auth0 Setup
• Monorepo / Modules

Creature images

When you run make server, the creature images will be hosted at http://localhost/images.

You can set the CREATURE_CHESS_IMAGE_URL environment variable to change this, for instance to use a CDN.

License

Creature Chess is licensed under the AGPL v3 License.

All creature sprites are from Tuxemon and are licensed under the CC BY-SA 3.0 license.

creature-chess's Issues

Bots should spend money to level up

Chat window grows forever

Opponent doesn't clear when entering preparing phase

Refactor to feature folders

Its painful having to jump between 6 different folders to implement a feature.

So rather than:

• /actions
  • /pieceActions.ts
• /actiontypes
  • /pieceActionTypes.ts
• /components
  • /piece.tsx
• /reducers
  • /pieceReducer.ts
• /selectors
  • /pieceSelectors.ts

Have:

• /piece
  • /pieceActions.ts
  • /pieceActionTypes.ts
  • /piece.tsx
  • /pieceReducer.ts
  • /pieceSelectors.ts

User can reroll during waiting phase

Run combat when entering playing phase

Implement "ready up" button on preparing phase

Cards not added back to deck on death

Create Bench

Create bench to store pieces

Pokemon stats UI

Display UI in the top right (next to the chess board) showing pokemon name, pictures and stats

Display "combine" button if there are 3 of the same pokemon ID

Add user name limits

Alphanumeric only
16 characters max

Add a marker to show who the local player is

Set up server for prep and play

Lifecycle maybe:

• server tells client starting prep phase (30 seconds)
• server tells client starting ready phase (5 seconds)
• server tells client to play with seed ______________

Bots should sell pieces

Bots should sell pieces to make room for better pieces

Drag and drop doesn't work on mobile

Watch / Webpack dev server

Dead enemies not removed from the battlefield

Create debug options in client to turn off animations

Turning off movement / attack animations would be useful to debug pathfinding

Dissappearing piece

Couldn't move a piece

Then when the game started this pokemon appeared where I was trying to drop

Battle times out if no pieces on board

If one team has no pieces on the board, the battle takes the whole 30 seconds

Add correct pokemon to deck

• Caterpie
• Weedle
• Scyther
• Dratini
• Pikachu
• Magnemite
• Voltorb
• Electabuzz
• Machop
• Hitmonlee
• Hitmonchan
• Charmander
• Vulpix
• Ponyta
• Bulbasaur
• Oddish
• Bellsprout
• Sandshrew
• Diglett
• Pidgey
• Spearow
• Jigglypuff
• Zubat
• Grimer
• Koffing
• Abra
• Drowzee
• Geodude
• Aerodactyl
• Squirtle
• Poliwag
• Magikarp

Drag pieces from bench to board

Implement leveling system

Players should get XP at the end of every match and level up with that XP

Each level allows for 1 more board piece

Players should be able to buy XP

Player not removed from game when dead

Buying Units UI

Create UI for buying pieces

Prevent piece movement outside of "preparing" phase

If the game is not in the "preparing" phase, prevent the user from moving pieces on the board

They can still buy/reroll cards as well as moving pieces on their bench

Unit Stats

Attack
Defense
Speed

Bots should aim to combine pieces

Bots should consider whether a card will combine with other cards that they have, and favour those that do

Add linting ts + sass

neworbit standard lint rules makes sense?

Dragging piece off board at end of preparing may cause losing piece

Growlithe beats Blastoise

In a one on one.

Why?!

Sync piece movement to server

When player moves a piece, this move should be sent to the server so that it's kept in sync

Update the player's board property on the server

This should maybe be done as a patch style update to save data (e.g. piece 123 moved to x,y)

Testing infrastructure

Set up alsatian etc.

Add round indicator

Next to the phase timer?

Server battle doesn't stop after 20 simulated seconds

A battle executes much faster on the server than on the client, so a fight that runs to a "tie" on the client may be a win to some player on the server

The client turn timer is 50ms so maybe the server could stop simulating after 400 times

Level 2 evolution pieces do not evolve to level 3

Doesn't reasses evolution after a purchased piece has evolved

Create benchmark mode

Create a mode that runs through a bot game with no wait times

Implement creep rounds

Rounds where the opponent team is all one creature

Doesn't affect your streak

Movement

Should not be able to place two units on the same tile

Game doesn't progress when in background tab

Server get into infinite loop if a team has no pieces

Win Message / dance

Victory dance and win message does not work

Fighting

No animations on Edge

Open edge.
Run on edge
Fail on edge

Make a go button so easier to play

reduce all the bullshit time waiting to get it hosted

Chat window shows messages in reverse order

This is unintuitive when reading a conversation

Buy units from card list

• Click on card
• Send PURCHASE_CARD opcode to server
• Take money from user
• Add card to first empty slot in player's bench (on server and client)

Player list doesn't preserve order of dead players

Bottom player should be the one who died first, then the one above, etc etc

Sell pieces from board and bench

When selling a piece, give the player the piece's cost back and delete it from the board

Add the card back to the deck