Adventurers' Arena is a strategy-based board game where two players, each controlling a team of five unique adventurers, compete to conquer the enemy’s base. This game combines tactical decision-making and adventurous gameplay.
https://vimeo.com/1039377287?share=copy
- 2-Player Gameplay
- Unique Adventurer Roles and Abilities of Pieces
- Shape chain integration
The goal is to strategically maneuver your pieces and place one on your opponent's base to win the game.
- Each player starts with five pieces, each having unique abilities.
- Players take turns moving one piece at a time on the board.
- A piece must reach the opponent's base to win the game.
- All pieces are unique, having their own attack power, health, move range, and special abilities.
- Frontend: Vite ( React )
- Backend: Node.js, Express.js, Socket.io
- Blockchain: Foundry ( Contract deployed on Shape )
- Smart contract Connection: Ethers.js
-
Clone the repository:
git clone https://github.com/ShivRaiGithub/adventurers-arena cd adventurers-arena -
Split terminal into 2 ( For client and server )
-
Terminal 1 and 2 both: Install dependencies
npm install
-
Use .env.development file to know the variables needed to run the files (API Key is not provided, but rest variables are there for local development). Change the .env.development file to .env file or create a new .env file with the variables needed.
-
If in server folder, run the server:
npm run start
-
If in client folder, run the client:
npm run dev
-
The ports should now be working and ready to work on.
-
Go to respective client port and the game should be working.
- You do not need to connect a wallet to play but connecting wallet allows you to select the skins. If both players have their wallet connected, they can agree to register the winner.
- Zoom in/out if unable to see all pieces and map according to your comfort.
- Read the How-to-play on Home page to know about the instructions.
- For the online site, it may happen that the server does not respond due to being inactive after a period of inactivity as it was hosted on a free tier.
A player can create room and get the room code which can then be shared with the other player, and both can jump into a game.
A player can choose to connect their wallet. The code is set up to connect to shape sepolia since the contract was deployed on that. Although it is also set to ask permission to add the testnet if not present in user's metamask, iff facing issue, make sure to add and switch to shape sepolia testnet before connecting wallet. Else if connected wallet but not on shape sepolia, you will be able to see current skins and the ones for collab but will be unable to buy the skins through smart contract.
Shows the current equipped skins of the player. Go to lobby, reload page, and come back if you want to change to default skins after changing the skins.
Shows the current available skins you can buy and apply.
Shows the skins that are provided through some web3 collaboration. Right now there is volcano map which you can get if you have the Shape Keys NFTs on shape mainnet.
If both players have their wallet connected, then after one player wins, both players can choose to agree and register the winning of the winner on blockchain. The option is provided on the same screen which shows who won after the game ends.
The contract is 0x5ad40C3a3FD63267Ca07Bd300C5381080E9e5645 on shape sepolia testnet.
Here is the link of block explorer : https://explorer-sepolia.shape.network/address/0x5ad40C3a3FD63267Ca07Bd300C5381080E9e5645
The code is set up to make sure even though the contract and connection are to shape sepolia, the checking of Shape Keys NFTs happen through Shape Mainnet.