Our mission: use autonomous AI agents to help game developers generate quests dynamically, saving time, improving maintainability, and raising marine awareness through engaging educational gameplay.

• Frontend & Backend: Next.js + Tailwind CSS
• Game Engine: Phaser.js
• AI: Google ADK + A2A Protocol + Gemini API
• Hosting: Vercel
• Domain: TBA

EcoQuest uses Google’s Agent Development Kit (ADK) and Agent2Agent (A2A) protocol to build an ecosystem of AI-powered agents.
Each marine animal NPC represents a specialized AI agent with unique responsibilities:

[ Player ] → [ Phaser.js Game ] → [ Next.js API ] → [ Google ADK Agents ]

• 🪸 Coral (Loop Agent)
  Continuously monitors the ecosystem state and provides periodic updates (loop architecture).

• 🐢 Turtle (Parallel Agent 1: Resource Agent)
  Tracks biodiversity and resources such as the number of animals or objects in the environment.

• 🐬 Dolphin (Parallel Agent 2: Fact Agent)
  Generates marine awareness facts to educate players.

• 🐙 Octopus (Sequential Quest Agent)
  Combines outputs from other agents into structured quest JSON that the game can render.
  Example:

  {
    "quest": "Clean 5 plastic bottles near the coral reef",
    "reward": "Increase biodiversity score by 10%"
  }
  

1. Clone the Repository

git clone https://github.com/NotAPlumber505/EcoQuest.git
cd ecoquest

2. Launch Visual Studio Code and open the project folder.

3. Install Node.js & Dependencies

npm install

4. Run Development server

npm run dev

Visit http://localhost:3000 in your browser to see the app running.

Instructions for adding Phaser.js to the project will go here.

Steps for setting up Google ADK and connecting agents will go here.

For future agent logic (data processing, fine-tuning, etc.), we will include Python dependencies in a requirements.txt.

MIT License © 2025 EcoQuest Team