🐠 Fish Adventure

A modern, accessible underwater survival game built with vanilla JavaScript. Navigate through various ocean depths, collect stars, and survive against increasingly dangerous sea creatures.

🌊 Gameplay Features

• Dynamic Stages: Progress through 5 unique environments, each with its own background, music, and challenges:
  • Calm Waters: The perfect place to start your journey.
  • Reef Waters: Watch out for more active marine life.
  • Deep Sea: High pressure and strange creatures await.
  • Storm Waters: Navigate through turbulent currents and lightning.
  • The Abyss: The ultimate challenge in the darkest depths.
• Unique Enemies: Each creature has its own behavior:
  • 🦈 Sharks: Aggressive predators that will chase you if you get too close.
  • 🐙 Octopuses: They spray ink clouds that can obscure your vision.
  • 🐍 Electric Eels: Watch out for their periodic electric shockwaves.
  • 👹 Sea Monsters: Giant beasts with powerful special attacks.
• Power-ups & Progression:
  • Collect ⭐ Stars to increase your score and advance to the next stage.
  • Pick up ❤️ Lives to stay in the game longer.
  • Unlock power-ups to help you survive the harsher depths.
• Difficulty Settings: Choose between Easy, Normal, and Hard modes to match your skill level.

🎮 Controls

Desktop

• Arrow Keys: Move the fish

• P: Pause / Resume game

• R: Restart (when game over)

• 1, 2, 3: Quick difficulty selection

Mobile

• Virtual Joystick: Drag to move the fish

• ⏸️ Button: Pause game

• ⚙️ Button: Settings and difficulty

♿ Accessibility

Fish Adventure is designed with accessibility in mind:

• Screen Reader Support: ARIA labels and live regions for game status.
• Reduced Motion: Option to disable intensive animations.
• High Contrast: Clear UI elements and visual feedback.
• Keyboard Navigation: Fully playable with standard keyboard controls.

🛠️ Technical Details

Built with a modular architecture:

• Vanilla JavaScript: No heavy frameworks, utilizing modern ES modules.
• CSS3 Animations: Smooth underwater effects and UI transitions.
• HTML5 Canvas/DOM: Efficient rendering of game entities.
• Asset Pooling: Performance-optimized management of game objects.

Project Structure

├── assets/             # Game assets (images, music, sounds)
├── css/                # Stylesheets
├── js/                 # Game logic (ES modules)
│   ├── main.js         # Entry point
│   ├── entities.js     # Player and enemy logic
│   ├── stages.js       # Stage and behavior configuration
│   └── ...
└── index.html          # Main entry file

🚀 Getting Started

1. Clone the repository:

   git clone https://github.com/ageborn-dev/fish-adventures.git

2. Open index.html in any modern web browser.

   • Note: Since the game uses ES modules, you may need to serve it via a local web server (e.g., using VS Code Live Server or python -m http.server).

📄 License

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

---

Developed with 🌊 by ageborn-dev