🌲 Mystic Forest Flow - Interactive Blockchain Adventure

An interactive text-based adventure game with AI-generated images and Flow blockchain integration. Make choices that shape your destiny and save your story outcomes on the blockchain!

✨ Features

• 🎮 Interactive Storytelling: Choice-based gameplay with branching narratives
• 🎨 AI-Generated Images: Dynamic images for each scene using Pollinations.ai
• ⛓️ Blockchain Integration: Save story outcomes on Flow blockchain
• 🏆 Multiple Endings: Different endings based on your choices and score
• 📱 Responsive Design: Works on desktop and mobile devices
• 🔗 MetaMask Integration: Seamless wallet connection and network switching

🚀 Live Demo

P | V

🎯 ETHGlobal Submission

This project is built for ETHGlobal New Delhi 2025 and targets the Flow Foundation's $10,000 prize for gaming applications.

🛠️ Tech Stack

• Frontend: HTML, CSS, JavaScript, Ethers.js
• Backend: Python Flask
• Blockchain: Flow EVM (Ethereum-compatible)
• Smart Contract: Solidity
• Image Generation: Pollinations.ai API
• Deployment: Vercel

Blockchain Setup

1. Install MetaMask browser extension
2. Add Flow Testnet to MetaMask:
   • Network Name: Flow
   • RPC URL: https://testnet.evm.nodes.onflow.org
   • Chain ID: 545
   • Currency: FLOW
3. Get test tokens from F

🎮 How to Play

1. Start your adventure in the mysterious forest
2. Make choices that affect your story path and score
3. Watch AI-generated images for each scene
4. Reach an ending based on your decisions
5. Save to blockchain to permanently store your story
6. Share your adventure with friends

🏗️ Project Structure

mystic-forest-flow/
├── api/
│   └── index.py              # Flask backend server
├── public/
│   ├── index.html            # Main game page
│   ├── script.js             # Frontend JavaScript
│   ├── style.css             # Game styling
│   └── ethers-offline.js     # Offline ethers.js fallback
├── ForestAdventure.sol       # Smart contract
├── forest-adventure.js       # Contract interaction
├── requirements.txt          # Python dependencies
├── vercel.json              # Vercel configuration
└── README.md                # This file

🔧 Smart Contract

The game uses a Solidity smart contract deployed on Flow testnet:

• Contract Address: 0xafa6C385c1B6D26Fda55f1a576828B75E9F9FD6c
• Functions: createStoryOutcome, getStoryOutcome, getTotalStories
• Events: StoryCreated, StoryUpdated

What Gets Stored

Each story outcome includes:

• Story ID and ending category
• Player's final score
• Generated image URLs
• Player's wallet address
• Timestamp

This uses Pollinations to get the images, we have integrated the smart contracts on Flow - Flow EVM (Ethereum-compatible), and also used filecoin for storage. the part where the integration of image and generation of a new story took a long time. Flow Integration and deployment of smart contract was a easy process with well documented structure and videos that helped a lot