https://github.com/mallory-jpg/2021-project

A turn-based NFT browser game built with @_buildspace.
https://github.com/mallory-jpg/2021-project

blockchain buildspace ethereum nft smart-contract

Last synced: about 2 months ago
JSON representation

A turn-based NFT browser game built with @_buildspace.

• Host: GitHub
• URL: https://github.com/mallory-jpg/2021-project
• Owner: mallory-jpg
• Created: 2021-11-06T16:58:32.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2021-11-13T17:08:15.000Z (almost 3 years ago)
• Last Synced: 2024-04-19T21:55:13.220Z (5 months ago)
• Topics: blockchain, buildspace, ethereum, nft, smart-contract
• Language: JavaScript
• Homepage:
• Size: 304 KB
• Stars: 3
• Watchers: 1
• Forks: 2
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-buildspace - 2021-project

README

        
# The 2021 Project

Mint your hero to Fight for The Culture in this turn-based NFT browser game.

The game is based on Ethereum smart contracts (a piece of code that lives on the Ethereum blockchain). As its deployed to the blockchain, anyone in the world with a computer or smart phone can access it, run the smart contract, and play the game. The client website allows players to connect their Ethereum wallets and play the game!

The goal of the game is to **Unalive. The. Boss**. 🗡 ☠️ 🔪

* Players begin by minting a character NFT. Each minted character has a certain *HP* and *Attack Damage*.

* Players command their character to attack the Final Boss and inflict damage. Watch out: the Boss fights back!

* Each character NFT has its attributes (like HP, damage, etc.) stored directly as part of the NFT.

* An unlimited number of NFTs of each character can be minted

## How to Play

1. Go the the [game site](https://2021-project.malloryculbert.repl.co/)

2. Connect your Ethereum wallet

3. Choose a character NFT to mint

4. Work together to fight The Final Boss, *Mackayleigh Karen*   

### Choose Your Fighter

* *MightyChondria* fights for science

* *IcedCovfefe* represents The Gays™️

* *TransPride* fights for our right to party

* *CriticalRaceTheory* fights for liberation

* *Textbook* fights against revisionist history

Each character NFT has the following attributes:

* Image

* Name

* HP value

* Attack Damage value

### How to Win

Players must work together to attack the boss and kill it by draining its HP to 0. Moral of the story: we can't do this alone.

## Rules

* Each player can only have 1 NFT character in their wallet

* If a character's HP goes below zero, it dies >>> GAME OVER.

# Development

## Dev Tools

* Ethereum blockchain

* [buildspace](https://app.buildspace.so/courses/CO5cc2751b-e878-41c4-99fa-a614dc910ee9/lessons/LEc40235e7-8135-4e55-8b7c-6b17ffd15cbd)

* OpenSea or Rarible NFT marketplaces

* [HardHat](https://hardhat.org/tutorial/setting-up-the-environment.html)

* OpenZeppelin

To install HardHat (to compile and test smart contracts locally), you must have node/npm. After downloading & installing npm, create & move into the directory for your game, initialize npm, & install HardHat:

```

npm init -y

npm install --save-dev hardhat

```

## Staging & Testing 

### Tools

* OpenSea TestNets

* MyCrypto ETH faucet

* Rinkeby TestNet & [TestNet Explorer](https://rinkeby.etherscan.io/)

* AlchemyAPI 

* MetaMask ETH wallet

* Replit - fork [this](https://github.com/buildspace/buildspace-nft-game-starter) repo

Note: Getting faux-ETH via Rinkeby's test wallet might take awhile! Mine took about 48 hours due to the volume of requests.

### Updating Smart Contracts

When making changes to immutable smart contracts, you must...

* re-deploy (which will reset all variables & lose all NFT data): `npx hardhat run scripts/deploy.js --network rinkeby`

* update the contract address (from the console log) on the frontend: change `contractAddress` in `constants.js`

* then update the ABI file on the frontend (just copy from `artifacts/contracts/.sol/.json`)