Skip to content

0xhaaz/coqui-island-hopper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

title description version author license
Coquí Island Hopper
Guide a courageous coquí frog on a vibrant pixel-art adventure across Puerto Rico's living landscapes
1.0.0
Haz
Code MIT, Assets CC BY-SA 4.0

🐸 Coquí Island Hopper 🏝️

Coquí Island Hopper

Guide a courageous coquí frog on a vibrant pixel-art adventure across Puerto Rico's living landscapes.

✨ Features

🎮 Gameplay

  • Physics-based platforming with realistic gravity and momentum
  • Enhanced double jump system (110% of normal jump power)
  • Gliding mechanics for precise landings
  • Dynamic difficulty scaling that adapts as you progress
  • Special platform types with unique behaviors

🌴 Immersive World

  • 5 Unique Biomes: El Yunque Rainforest, Coastal Mangroves, Karst Mountains, Bioluminescent Bay, and Cloud Forest
  • Authentic Puerto Rican Flora: Collect wild mangoes, flamboyán flowers, bromeliads, and native orchids
  • Dynamic Weather Systems: Experience rain, mist, trade winds, and clear skies
  • Scrolling Backgrounds with parallax effects

🎯 Special Platforms

  • Bamboo Platforms: Automatic jump boost
  • Coral Reefs: Standard platforms with vibrant colors
  • Mangrove Roots: Sturdy water-based platforms
  • Crumbling Platforms: Limited durability - land carefully!
  • Bouncy Platforms: Launch high into the air
  • Moving Platforms: Dynamic vertical movement
  • Falling Platforms: Start falling after you land

🏆 Scoring System

  • Distance-based scoring: Earn points for every meter traveled
  • Collectible bonuses: Gather native Puerto Rican plants and fruits
  • Combo system: Chain actions for multiplier bonuses
  • Speed boosts: Collect flamboyán flowers for temporary speed increases

🎮 Controls

🖱️ Mouse/Touch

  • Click/Tap: Jump (single or double jump)
  • Hold during fall: Glide for precise landings

⌨️ Keyboard

  • SPACE: Jump (single or double jump)
  • A/D or Arrow Keys: Move left/right
  • S: Glide (hold during fall)

🚀 Getting Started

🌐 Play Online

Visit the live game at: https://coqui-island-hopper-hazs-projects-551a9557.vercel.app

💻 Local Development

  1. Clone the repository:

    git clone https://github.com/haz-t/coqui-island-hopper.git
    cd coqui-island-hopper
  2. Open the game:

    # Using Python (if available)
    python -m http.server 8000
    
    # Or using Node.js (if available)
    npx serve .
    
    # Or simply open index.html in your browser
    open index.html
  3. Start playing!

🎨 Game Themes

The game features 5 authentic Puerto Rican biomes, each with unique characteristics:

🌳 El Yunque Rainforest

  • Platforms: Tree ferns, cecropia leaves, bamboo platforms
  • Collectibles: Bromeliads, native orchids
  • Weather: Rain, mist
  • Colors: Deep greens with vibrant accents

🏖️ Coastal Mangroves

  • Platforms: Mangrove roots, coral reefs, coconut palm logs
  • Collectibles: Wild mangoes, flamboyán flowers
  • Weather: Clear skies, trade winds
  • Colors: Ocean blues with golden highlights

⛰️ Karst Mountains

  • Platforms: Taíno stones, tree ferns, coconut palm logs
  • Collectibles: Native orchids, bromeliads
  • Weather: Clear, windy conditions
  • Colors: Stone grays with natural greens

🌌 Bioluminescent Bay

  • Platforms: Mangrove roots, coral reefs
  • Collectibles: Wild mangoes
  • Weather: Clear nights
  • Colors: Deep blues with cyan bioluminescent accents

☁️ Cloud Forest

  • Platforms: Tree ferns, cecropia leaves, bamboo platforms
  • Collectibles: Bromeliads, native orchids
  • Weather: Mist, rain
  • Colors: Pale greens with ethereal lighting

🛠️ Technical Details

💾 Technologies Used

  • HTML5 Canvas for rendering
  • Vanilla JavaScript for game logic
  • Farcade Game SDK for enhanced features
  • Responsive Design for mobile compatibility

📱 Mobile Support

  • Touch Controls: Tap to jump, hold to glide
  • Full-Screen Experience: Optimized for mobile browsers
  • Responsive Canvas: Adapts to any screen size
  • Optimized Performance: Smooth 60fps gameplay

🎯 Game Physics

  • Realistic Gravity: 0.8 units per frame
  • Jump Power: 12 units (ground), 13.2 units (double jump)
  • Movement Speed: 4 units per frame
  • Platform Speed: Progressive difficulty scaling
  • Collision Detection: Precise platform landing system

🤝 Contributing

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

🐛 Bug Reports

If you encounter any bugs, please open an issue with:

  • Description of the bug
  • Steps to reproduce
  • Expected vs actual behavior
  • Browser/device information

💡 Feature Requests

Have ideas for new features? Create an issue with the "enhancement" label.

📄 License

💻 Code

This project's code is licensed under the MIT License.

MIT License

Copyright (c) 2024 Haz

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

🎨 Art Assets

Game art assets are licensed under CC BY-SA 4.0 unless otherwise specified. Some assets may be released under CC0 (Public Domain).

🙏 Acknowledgments

  • Puerto Rico's Natural Beauty: Inspiration for all biome designs
  • Coquí Frogs: The beloved symbol of Puerto Rico
  • Pixel Art Community: For artistic inspiration and techniques
  • Game Development Community: For helpful resources and feedback

📞 Contact


🐸 Enjoy your adventure across Puerto Rico's magical landscapes!

Made with ❤️ for the Puerto Rican gaming community

About

Lead a pixel-art coquí frog across Puerto Rico’s beaches, rainforests, and mountains to uncover its hidden ecological wonders.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages