Veloria

A 2D adventure game built with HTML5 Canvas and JavaScript.
View Demo »

📝 About The Project

Veloria is a classic 2D adventure game where players navigate a vibrant world, battling monsters and exploring different levels. The game is built entirely with vanilla JavaScript and rendered on an HTML5 Canvas, showcasing browser-based game development techniques.

valoria.preview.mp4

⚙️ Built With

This project is built with fundamental web technologies, demonstrating a pure JavaScript-based game engine.

• Frontend: HTML5 & CSS3
• Game Logic: Vanilla JavaScript
• Rendering: HTML5 Canvas

🛠️ Tools Used

• MapperMate: A free online tilemap editor used for creating the game maps.

✅ Key Features

• Responsive Design: The game is fully responsive and adapts to different screen sizes, providing a seamless experience on both desktop and mobile devices.
• Onboarding: An instruction pop-up appears at the beginning of the game to help new players get started.
• Dynamic Player Movement: Smooth, key-based character navigation.
• Collision Detection: Accurate collision handling with environmental objects.
• Combat System: Engage in battles with various monsters.
• Health & Items: Collect hearts to replenish health and leaves for potential power-ups.
• Layered World: Rich, multi-layered maps creating a sense of depth.
• Sound Effects: Immersive audio feedback for actions and events.
• Character Identification: Clear identification of the player and enemy characters in the game's instructions and settings.

▶️ Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

You only need a modern web browser that supports HTML5 and JavaScript.

Installation & Setup

1. Clone the repository:

   git clone https://github.com/Ashwin-Pulipati/veloria.git
   cd veloria

2. Run the game: Simply open the index.html file in your web browser.

   # On Windows
   start index.html
   
   # On macOS
   open index.html
   
   # On Linux
   xdg-open index.html

🚀 Usage

When you first load the game, you will be greeted with a splash screen. Clicking the "Start Game" button will open an instruction pop-up with details on the game's objective, characters, and controls. Click "Continue" to start the game.

Use the W (Up), A (Left), S (Down), and D (Right) keys or the Arrow Keys to move your character around the map and the Space Key to attack enemies. The main objective is to defeat all the monsters that have invaded the village.

You can access the Settings & Info panel by clicking the ⚙️ button on the top right of the screen. This panel provides information on the game's objective, characters, controls, and includes options to toggle the music and sound effects.

🏆 Contributors

Nishanth Pilli (Product Designer) LinkedIn | Portfolio

🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

You can also report a bug or request a feature by opening an issue:

• Report Bug
• Request Feature

📄 License

Distributed under the MIT License. See the LICENSE file for more information.

📧 Contact

Ashwin Pulipati - LinkedIn - [email protected]

Project Link: https://github.com/Ashwin-Pulipati/veloria