⚔️ RIFT COMMANDERS

tactical strategy game built

Strategic 2-player turn-based combat on a 5×5 battlefield. Command your forces, plan moves in secret, execute simultaneously using commit-reveal mechanics to achieve victory.

📋 Table of Contents

• Overview

• Game Description

• Features

• Tech Stack

• Getting Started

• Game Mechanics

• Project Structure

• Deployment

• Contributing

• License

🎮 Overview

Rift Commanders is a tactical combat game where two players deploy units, plan moves simultaneously, and battle in commit-reveal turns. Victory is achieved by eliminating the enemy Commander through strategic planning and simultaneous turn execution.

• Genre: Turn-based Tactical Strategy

• Blockchain: Mantle Network (Sepolia Testnet)

• Smart Contracts: Solidity 0.8.20

• Players: 1v1 PvP

• Game Length: 5-15 minutes per match

• Built for: Mantle Global Hackathon 2025

🎯 Game Description

Command 3 unique units - a powerful Commander, a close-range Warrior, and a long-range Archer. Plan your moves in secret using commit-reveal mechanics, then watch as both players' actions execute simultaneously. Outsmart your opponent to eliminate their Commander first.

Core Gameplay Loop

1. Deployment Phase - Deploy 3 units on your side of the battlefield

2. Planning Phase - Secretly plan 1 action per unit (Move/Attack/Defend)

3. Revealing Phase - Both players reveal their committed moves

4. Execution Phase - Moves execute simultaneously, damage dealt

5. Repeat until a Commander is eliminated

✨ Features

Core Mechanics

• 5×5 Grid Battlefield - Compact tactical combat arena

• 3 Unique Unit Types:

  • 👑 Commander (20 HP, 5 ATK, 3 DEF) - Must protect to win

  • ⚔️ Warrior (15 HP, 7 ATK, 2 DEF) - High-damage melee fighter

  • 🎯 Archer (10 HP, 6 ATK, 1 DEF) - Long-range attacker (2 tile range)

• Commit-Reveal Mechanics - Moves are hashed and hidden until reveal phase

• Simultaneous Turn Execution - No turn order advantage

• Strategic Depth - Positioning, prediction, and timing matter

On-Chain Features

• ✅ Fully deterministic gameplay

• ✅ All game state stored on Mantle Network

• ✅ Verifiable move execution with commit-reveal

• ✅ No centralized server required

• ✅ EVM compatible smart contracts

• ✅ Optional betting system (wager MNT tokens)

🛠 Tech Stack

Smart Contracts

• Solidity 0.8.20 - Smart contract language

• Hardhat 3.0.13 - Development framework

• Mantle Sepolia - Testnet deployment