Play Hex online.
Currently hosted here: https://playhex.org
Requires:
- node >= 18.18.2
- yarn
- mysql or postgres
Create an .env file with at least a database access. Example:
DATABASE_URL="mysql://root:root@localhost:3306/hex"Then run these commands:
# Install dependencies
yarn install
# Create database schema
yarn db:sync
# Start application
yarn serveWait javascript to be bundled, then the application is available at:
For development you can use random and determinist random bots.
Enable them with:
yarn hex create-random-botsDeterminist random bot will always plays same games if you play same moves in same order. This is useful to reproduce things.
If you need to work with real AI (Katahex, Mohex), see:
https://github.com/alcalyn/hex-ai-distributed
You can install it locally, and with Docker you don't need to compile any ai engine.
Once installed, add to your .env file:
HEX_AI_API=http://localhost:8088
And enable ai players in database with:
yarn hex create-katahex-bots
yarn hex create-mohex-botsPlayHex uses i18next and i18next-vue to translate user interface.
Here are all available translations, just click the following image to help translating or add a new language:
You can contribute to translations without any coding, thanks to Weblate.
Some API endpoints exists for admin tasks (i.e persist all memory games into database manually).
To use them, you must add in your .env:
ADMIN_PASSWORD=your-passwordThen you can now call admin endpoints by setting this same password as bearer token, curl example:
curl --location --request POST 'http://localhost:3000/api/admin/persist-games' \
--header 'Authorization: Bearer your-password'See available admin endpoints in postman collection, in "Admin" folder.
# Unit tests (Mocha)
yarn test
# e2e tests (Cypress)
yarn test:e2e
# Open Cypress browser
yarn cypress openWarning: For e2e/cypress tests, random bots are required so don't forget to run this before:
yarn hex create-random-bots# See which dependencies take more size
yarn analyse-sizeCompare two json files with: https://happy-water-0887b0b1e.azurestaticapps.net.
This library is under AGPL-3.0 license.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent