Skip to content

Repository files navigation

0GBomber Banner

0GBomber

AI-Powered Autonomous Farming Game on 0G

Next.js TypeScript Tailwind Solidity 0G Testnet MIT License


What is 0GBomber?

0GBomber is an AI-native autonomous farming game inspired by Bomb Crypto, built on the 0G blockchain.

Players hatch AI-powered heroes, deploy them into dangerous alien environments, and watch them learn, evolve, build bloodlines, and earn rewards — completely autonomously.

Unlike traditional idle games, every hero is an autonomous AI agent with:

System Description
DNA Unique genetic code passed through generations
Personality Brave, greedy, curious, loyal, lazy, tactical — each hero is unique
Memory Heroes remember their battles, loot finds, and near-death escapes
Traits Unlockable bonuses like Loot Goblin, Bomb Master, Fast Learner
Intelligence Core, AI, and farming stats that evolve through combat
Legacy Retire a hero to create a Legacy Core for the next generation
Bloodline Genetic inheritance system — children inherit stats and traits from parents

Features

🤖 AI Heroes
Autonomous agents with unique DNA and personality
🧠 Memory System
Heroes remember battles, loot, and near-death experiences
🧬 Hero DNA
Genetic code that evolves across generations
🎭 Personality System
6 trait dimensions define every hero's behavior
⭐ Trait Evolution
Unlock special traits through combat achievements
👑 Legacy System
Retire heroes to pass power to the next generation
🔗 Bloodlines
Genetic inheritance with mutation mechanics
⚔️ Equipment System
6 equipment slots with affixes and set bonuses
🏪 Marketplace
Trade heroes, equipment, cosmetics, and items
🌾 Autonomous Farming
Auto-deploy, auto-redeploy, energy management
💰 Onchain Economy
$0BOMB token on 0G testnet with fragment conversion
🛠️ Admin Dashboard
Full economy controls, events, and maintenance mode

Gameplay Loop

┌─────────────────────────────────────────────────────────┐
│                                                         │
│   🥚 Hatch Hero                                         │
│     ↓                                                   │
│   🚀 Deploy Hero                                         │
│     ↓                                                   │
│   🤖 Hero Farms Automatically                            │
│     ↓                                                   │
│   🧠 Hero Learns & Gains Memories                        │
│     ↓                                                   │
│   ⭐ Hero Evolves & Unlocks Traits                       │
│     ↓                                                   │
│   💰 Hero Earns Rewards                                  │
│     ↓                                                   │
│   👑 Hero Creates Legacy Core                            │
│     ↓                                                   │
│   🔗 Hero Builds Bloodline                                │
│     ↓                                                   │
│   🥚 Hatch Next Generation Hero                          │
│                                                         │
└─────────────────────────────────────────────────────────┘

Tech Stack

Category Technology
Frontend Next.js 16, React 19, TypeScript 5, Tailwind CSS 4
Blockchain Solidity, Ethers.js 6, 0G Galileo Testnet (Chain ID 16602)
Game Engine AI Behavior Engine, Memory Engine, Hero DNA System, Autonomous Farming Engine
Storage Supabase, LocalStorage
Assets Phaser 3, Custom Pixel Art Sprites

Smart Contract

Property Value
Network 0G Galileo Testnet
Chain ID 16602
RPC URL https://evmrpc-testnet.0g.ai
Token 0BOMB ($0BOMB)
Token Decimals 18
Contract Address 0xB9Ca501a3e59716F328552C7BA26d1fa68Dc76E6
Treasury 0xa8DAb875Eb73173C8C96215445263AA6a6851Af6

Getting Started

Prerequisites

  • Node.js 18+
  • npm 9+
  • A wallet with 0G Galileo testnet configured

Installation

# Clone the repository
git clone https://github.com/ajoikafeb/0Bomb.git
cd 0Bomb

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your Supabase credentials

# Start development server
npm run dev

Open http://localhost:3000 to start playing.

Build

npm run build
npm start

Screenshots

Landing Page Hero Dashboard
Landing Page Hero Dashboard
Map Farming Marketplace
Autonomous Map Farming Marketplace
Admin Dashboard
Admin Dashboard

Core Game Systems

System Documentation
Hero System GAME_DESIGN.md
AI System GAME_DESIGN.md
Map System GAME_DESIGN.md
Auto Farm System GAME_DESIGN.md
Equipment System GAME_DESIGN.md
Legacy System GAME_DESIGN.md
Bloodline System GAME_DESIGN.md
Economy System TOKENOMICS.md
Marketplace GAME_DESIGN.md

Architecture

┌─────────────────────────────────────────────────────────┐
│                    Frontend (Next.js)                    │
│  ┌──────────┐ ┌──────────┐ ┌──────────────────────────┐ │
│  │ Landing  │ │  Game    │ │  Admin Dashboard         │ │
│  │  Page    │ │  Page    │ │  (Economy, Events, etc)  │ │
│  └──────────┘ └──────────┘ └──────────────────────────┘ │
├─────────────────────────────────────────────────────────┤
│                    Game Engine                            │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
│  │  Hero        │ │  AI Decision │ │  Game State      │ │
│  │  Generator   │ │  Engine      │ │  Manager         │ │
│  └──────────────┘ └──────────────┘ └──────────────────┘ │
├─────────────────────────────────────────────────────────┤
│                   Blockchain Layer                        │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
│  │  Wallet      │ │  Smart       │ │  Token/Economy   │ │
│  │  Connection  │ │  Contract    │ │  Engine          │ │
│  └──────────────┘ └──────────────┘ └──────────────────┘ │
└─────────────────────────────────────────────────────────┘

See ARCHITECTURE.md for detailed architecture diagrams.


Roadmap

Phase Focus Status
Phase 1 Core Gameplay — Hatching, deploying, basic AI ✅ Complete
Phase 2 AI Evolution — Memory, traits, personality-driven behavior ✅ Complete
Phase 3 Marketplace — Trading, fees, listings 🔄 In Progress
Phase 4 Legacy System — Retirement, Legacy Cores 📋 Planned
Phase 5 Bloodline System — Genetics, inheritance, mutation 📋 Planned
Phase 6 Onchain Integration — Full $0BOMB economy, NFT verification 📋 Planned

See ROADMAP.md for the full roadmap.


Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Quick Start

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/your-feature develop
  3. Commit using conventional commits
  4. Push and open a PR against develop

License

This project is licensed under the MIT License — see the LICENSE file for details.


Built on 0G • Powered by AI • Autonomous by Design

About

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages