Chocobo Hunter 🐤

A Final Fantasy themed hunting game built with CSFML.

📖 Description

Chocobo Hunter is a game inspired by the classic "Duck Hunt" but with a Final Fantasy twist. Players must catch chocobos (the iconic bird creatures from the Final Fantasy universe) that are running wild across the screen.

🎮 Gameplay

• Objective: Catch as many chocobos as possible by clicking on them.
• Beware: Grey chocobos are hostile and will reduce your health if clicked.
• Health: You start with 3 health points. The game ends when your health reaches zero.
• Speed: As you catch more chocobos, they will begin to move faster, increasing the difficulty.

🔧 Installation

Prerequisites

• GCC compiler
• CSFML library (requires SFML)

Build Instructions

1. Clone the repository:

   git clone https://github.com/Txtsuya/my_hunter.git
   

2. Navigate to the project directory:

   cd my_hunter
   

3. Compile the project:

   make
   

4. Run the game:

   ./my_hunter
   

🎵 Features

• Authentic Final Fantasy Music: Enjoy classic 8-bit renditions of beloved Final Fantasy themes.
• Menu Interface: Clean UI with play and quit options.
• Multiple Chocobo Types: Regular chocobos to catch and black chocobos to avoid.
• Score System: Keep track of how many chocobos you've caught.
• Health System: Monitor your remaining lives.
• Custom Cursor: Crosshair cursor for improved aiming.

🎮 Controls

• Mouse Movement: Aim the crosshair
• Left-Click: Catch chocobos
• ESC: Exit the game
• Menu Navigation: Use the mouse to select options

📋 Help

For instructions on how to play, run:

./my_hunter -h

🖼️ Assets

• Sprites: Chocobo sprites from Final Fantasy series
• Backgrounds: Pixel art backgrounds inspired by Final Fantasy landscapes
• Music: 8-bit versions of "Chocobo Theme" and "Final Fantasy VII Main Theme"

🧠 Technical Details

The game is built using:

• CSFML
• Linked list data structure for managing multiple chocobos
• Event-driven programming for user interactions
• Memory management with proper allocation and deallocation

🧩 Project Structure

• src/: Source code files
• include/: Header files
• assets/: Game assets (images, music, fonts)
  • img/: Game images
  • music/: Game audio
  • font/: Game fonts

🛠️ Development

Building and running with Debug Information

make val && valgrind ./my_hunter

Cleaning Object Files

make clean

Rebuild Everything

make re

🎮 Acknowledgements

• Final Fantasy franchise for the inspiration and theme
• CSFML/SFML libraries for making game development accessible

🔗 License

This project was created as part of EPITECH PGE coursework.

---

Have Fun! 🐤