Galactic Invaders

Play-to-Earn retro arcade game on BNB Smart Chain. Players connect wallets, play a Space Invaders-style game, and compete on a weekly leaderboard for token rewards.

Overview

Galactic Invaders is a complete Web3 game with two smart contracts and a React frontend:

• GalacticToken (GLCT) — A BEP-20 token used for paid play sessions and weekly rewards
• GalacticGame — Manages game sessions, leaderboard (top 50), and weekly reward distribution
• Frontend — React 19 app with HTML5 Canvas game engine, Wagmi wallet integration, and Reown AppKit for multi-wallet support

How It Works

1. Player connects wallet via Reown AppKit (MetaMask, TrustWallet, WalletConnect, etc.)
2. Player starts a game session — 1 free play per day, or 50 GLCT for extra plays
3. Player plays the 90-second arcade game and earns a score
4. Score is submitted on-chain with an anti-tamper hash
5. Top 50 scores appear on the leaderboard
6. Every week, the owner distributes the reward pool to the #1 player

Requirements

Project Structure

Install Dependencies

From the project root directory, install everything:

# Install all dependencies (contracts + frontend)
npm install

This uses npm workspaces to install both contracts/ and frontend/ packages.

Environment Setup

1. Create the contracts .env file

# contracts/.env
PRIVATE_KEY=0xYOUR_DEPLOYER_PRIVATE_KEY_HERE

2. Get BNB for gas

Get Reown Project ID

Reown AppKit requires a free project ID for wallet connections.

// Change this line:
export const REOWN_PROJECT_ID = "YOUR_PROJECT_ID";

// To your actual project ID:
export const REOWN_PROJECT_ID = "abc123def456...";

Deploy to BSC Testnet

Test everything on BSC Testnet first before going to mainnet.

cd contracts
npx hardhat run scripts/deploy.js --network bscTestnet

GalacticToken deployed to: 0xAbC123...
GalacticGame deployed to: 0xDeF456...
Reward pool funded with 100,000 GLCT

Deploy to BSC Mainnet

1. Add BSC Mainnet to Hardhat config

Open contracts/hardhat.config.js and add the mainnet network:

module.exports = {
  solidity: "0.8.20",
  networks: {
    bscTestnet: {
      url: "https://data-seed-prebsc-1-s1.binance.org:8545",
      chainId: 97,
      accounts: process.env.PRIVATE_KEY ? [process.env.PRIVATE_KEY] : [],
    },
    // Add this block:
    bscMainnet: {
      url: "https://bsc-dataseed1.binance.org",
      chainId: 56,
      accounts: process.env.PRIVATE_KEY ? [process.env.PRIVATE_KEY] : [],
    },
  },
};

2. Deploy

cd contracts
npx hardhat run scripts/deploy.js --network bscMainnet

Update Frontend Addresses

After deploying contracts, update the frontend to point to your new addresses.

Open frontend/src/wagmi.js and update:

// Replace with YOUR deployed addresses
export const CONTRACTS = {
  token: "0xYOUR_TOKEN_ADDRESS",
  game: "0xYOUR_GAME_ADDRESS",
};

Switch network to BSC Mainnet

In the same file, update the imports and network order:

import { http } from "wagmi";
import { bsc, bscTestnet } from "@reown/appkit/networks";

// Put your primary network first
export const networks = [bsc, bscTestnet];

export const transports = {
  [bsc.id]: http("https://bsc-dataseed1.binance.org"),
  [bscTestnet.id]: http("https://data-seed-prebsc-1-s1.binance.org:8545"),
};

Contract Overview

Change Game Values

Token economics (smart contract)

Open contracts/scripts/deploy.js to change these values before deploying:

// Cost per paid game session (in tokens)
const PLAY_COST = ethers.parseEther("50");

// Weekly reward for #1 player
const WEEKLY_REWARD = ethers.parseEther("1000");

// Initial reward pool deposit
await game.depositRewards(ethers.parseEther("100000"));

Game settings (frontend)

Open frontend/src/game/constants.js to tune gameplay:

export const CANVAS_WIDTH = 800;       // Game canvas width (px)
export const CANVAS_HEIGHT = 600;      // Game canvas height (px)
export const SHIP_SPEED = 5;           // Player movement speed
export const BULLET_SPEED = 7;         // Player bullet speed
export const ALIEN_BULLET_SPEED = 4;   // Enemy bullet speed
export const ALIEN_ROWS = 5;           // Rows of aliens per wave
export const ALIEN_COLS = 10;          // Columns of aliens per wave
export const INITIAL_LIVES = 3;        // Starting lives
export const POINTS_PER_KILL = 10;     // Base points per alien
export const WAVE_BONUS = 200;         // Bonus for clearing a wave
export const SPEED_MULTIPLIER = 0.15; // Alien speed increase per wave
export const POWERUP_CHANCE = 0.03;   // 3% drop chance per kill
export const GAME_DURATION = 90;      // Game length in seconds

Token Name & Symbol

To change the token name and symbol, edit contracts/contracts/GalacticToken.sol before deploying:

constructor() ERC20("Galactic Token", "GLCT") Ownable(msg.sender) {
    _mint(msg.sender, 1_000_000 * 10 ** decimals());
}

Change "Galactic Token" to your token name and "GLCT" to your symbol. You can also change 1_000_000 to adjust the initial supply.

UI Branding & Colors

Game title

Search for GALACTIC INVADERS and GALACTIC / INVADERS in these files:

• frontend/src/components/Header.jsx — Header title
• frontend/src/App.jsx — Home screen title
• frontend/index.html — Browser tab title

Colors

The main colors are used throughout as Tailwind classes and inline styles:

To change colors, search and replace the hex codes across the frontend/src/ files.

Wallet modal accent

In frontend/src/main.jsx, change the AppKit theme:

themeVariables: {
  "--w3m-accent": "#39ff14", // Change this color
},

Network Configuration

All network settings live in two files:

Supported networks from Reown AppKit

You can import any chain from @reown/appkit/networks:

import {
  bsc,          // BSC Mainnet (56)
  bscTestnet,   // BSC Testnet (97)
  mainnet,      // Ethereum (1)
  polygon,      // Polygon (137)
  arbitrum,     // Arbitrum (42161)
  avalanche,    // Avalanche (43114)
  hardhat,      // Local dev (31337)
} from "@reown/appkit/networks";

Deploy on Vercel

cd frontend
npm run build

npm install -g vercel

cd frontend
vercel

vercel --prod

Deploy on cPanel

cd frontend
npm run build

<IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /
  RewriteRule ^index\.html$ - [L]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule . /index.html [L]
</IfModule>

Deploy on Netlify

cd frontend
npm run build

npm install -g netlify-cli
cd frontend
netlify deploy --dir=dist --prod

/*    /index.html   200

Weekly Reward Distribution

As the contract owner, you must call distributeWeeklyReward() once per week to pay the #1 player.

Using Hardhat console

cd contracts
npx hardhat console --network bscMainnet

Then run:

const game = await ethers.getContractAt(
  "GalacticGame",
  "0xYOUR_GAME_ADDRESS"
);
const tx = await game.distributeWeeklyReward();
await tx.wait();
console.log("Reward distributed!");

Mint Additional Tokens

The deployer (owner) can mint more tokens at any time:

cd contracts
npx hardhat console --network bscMainnet

const token = await ethers.getContractAt(
  "GalacticToken",
  "0xYOUR_TOKEN_ADDRESS"
);
// Mint 500,000 tokens to an address
const tx = await token.mint(
  "0xRECIPIENT_ADDRESS",
  ethers.parseEther("500000")
);
await tx.wait();

Local Development

For local testing without spending real BNB:

cd contracts
npx hardhat node

cd contracts
npx hardhat run scripts/deploy.js --network localhost

cd frontend
npm run dev

Game Mechanics

Controls

Touch controls appear automatically on mobile devices.

Scoring

Power-ups (3% drop chance)

Game over conditions

• 90-second timer runs out
• All 3 lives lost
• Aliens reach the bottom of the screen

Tech Stack

Troubleshooting