Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

360 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🏴‍☠️ PIRATE'S ODYSSEY: TREASURE ISLAND


⭐ Overview

Pirate's Quest: Treasure Island is a 2D Platformer (Side-Scrolling Action-Adventure) where players step into the role of a determined pirate. Your epic quest is to uncover a legendary treasure hidden deep within a mysterious, uncharted island. Navigate treacherous levels, defeat hostile enemies, and solve environmental puzzles to reach the ultimate prize.


🛠️ Features & Mechanics

Controls

Key Action Description
ASDW Movement Run/Walk, and navigate the environment, including avoiding hazards.
J Attack Execute attacks to defeat enemies and open closed doors/pathways.
E Interact Interact with objects, NPCs, and environmental elements (e.g., picking up items).

Player Stats

  • Abilities: Capable of executing Combo Attacks.
  • Jump Height: 2 blocks.
  • Base Damage: 2 points.
  • Base Health: 5 HP.
  • Objective: Collect keys to unlock doors and gain access to new levels/maps.

In-Game Items

Item Name Description Interaction
Heart Restores or increases player health by +1 HP. Consumed by the Player upon touch.
Bouncy Mushroom Allows the player to reach high or inaccessible areas (acts as a springboard). Player steps on the mushroom.
Pirate Gold Coin Currency used to purchase items from vendors/shops. Collected and spent by the Player.

Entities


🗺️ The World

The game spans multiple distinct areas, increasing in difficulty:

Level Design


🛠️ Technology Used

This project is built using the following technologies and tools:

  • Programming Language: C++
  • Graphics Library: SDL2 (Simple DirectMedia Layer)
    • SDL2_image - For image loading and rendering
    • SDL2_mixer - For audio and sound effects (if applicable)
  • Development Environment: Microsoft Visual Studio 2019+
  • Art: Aseprite - For creating pixel art sprites and level design
  • Version Control: Git & GitHub

📥 Installation & Setup

This project is configured as a Microsoft Visual Studio Solution and requires the following environment:

  • Operating System: Windows
  • IDE: Microsoft Visual Studio (Version 2019 or later is recommended, based on the solution file format).
  • Dependencies: The project is configured to use the SDL2 library (and likely other SDL extensions like SDL_image).

Steps to Build and Run (Windows/Visual Studio):

  1. Clone the repository:
    git clone https://github.com/DuyTaDinh/Pirate-Odyssey-SDL2.git
    cd Pirate-Odyssey-SDL2
  2. Open the Solution:
    • Locate the solution file: Pirate-Odyssey-SDL2/SDL.sln
    • Double-click the file to open the project in Visual Studio.
  3. Ensure Dependencies are Met:
    • Verify that the required SDL2 libraries (.lib, .dll, and header files) are correctly linked in the project properties as configured in the .vcxproj file. (If the project doesn't use NuGet or vcpkg for dependency management, you may need to manually place the SDL DLLs in the project's output directory.)
  4. Build the Project:
    • In the Visual Studio menu, go to Build -> Build Solution.
    • Select the desired configuration (e.g., Debug or Release) and platform (e.g., Win32 or x64) from the dropdown menus.
  5. Run the Game:
    • Go to Debug -> Start Debugging.

🚀 Future Roadmap

The following features are planned for future development:

  • Expanded Combat: Introducing a greater variety of enemies and more complex, diverse Boss encounters.
  • Increased Exploration: Designing and implementing more expansive, explorable areas (levels/biomes).
  • Weapon Economy: Integrating a system where players can purchase new Weapons using the in-game Gold Coins they collect.

👥 Team & Credits

Name Role GitHub/Contact
Ta Dinh Duy Developer, Level Designer @DuyTaDinh
Trinh Anh Son Developer @trinhanhson

About

A 2D side-scrolling action-adventure platformer where a pirate searches for legendary treasure on a mysterious island. Developed using C++ and the SDL2 library.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages