Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/stephenombuya/role-playing-game


https://github.com/stephenombuya/role-playing-game

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README

        

# **RPG - Dragon Repeller**
RPG - Dragon Repeller is a simple browser-based role-playing game (RPG) created using HTML, CSS, and JavaScript. The objective of the game is to explore different locations and ultimately defeat the dragon that is terrorizing the town.

## **Demo**
[Live Demo](https://roleplayinggame2.netlify.app/)

## **Features**
* **Interactive RPG**: Explore different areas like the store and cave, or engage in a battle with the dragon.
* **Dynamic Stats**: Keep track of your character’s XP, Health, and Gold.
* **Combat System**: Fight the dragon by choosing different actions, with stats updating in real-time.
* **Monster Stats**: View the dragon’s health and name during combat.

## **Technologies Used**
1. HTML5 for the game structure.
2. CSS3 for styling the game interface.
3. JavaScript for game logic and interactivity.

## **Project Structure**
* **index.html**: The main HTML structure of the game.
* **styles.css**: Contains the styles for the game UI.
* **script.js**: Implements the game logic, including character and monster interactions.

## **Installation**
To run the RPG - Dragon Repeller locally, follow these steps:

1. Clone the repository:

git clone https://github.com/stephenombuya/Role-Playing-Game

2. Navigate to the project folder:

```
cd Role-Playing-Game
```

3. Open the index.html file in your browser:

```
open index.html
```

You can also run the project using a local server:

```
python -m http.server
```

## **Game Instructions**
1. **Start in the Town Square**: The game begins with a welcome message in the town square.
2. **Choose Actions**: Use the buttons to either:
3. **Go to store**: Buy items with your gold.
4. **Go to cave**: Explore for treasure or encounter enemies.
5. **Fight dragon**: Engage in combat with the dragon.
6. **Track Stats**: Your XP, health, and gold are displayed at the top, and the monster’s stats are shown during combat.
7. **Victory**: Defeat the dragon to save the town!

## **Usage**
This project is a demonstration of:

* Building a simple RPG interface using HTML, CSS, and JavaScript.
* Using JavaScript to dynamically update game stats and create interactivity.
* Handling user inputs with buttons to trigger different game actions.

## **Future Improvements**
1. Add more locations and interactions.
2. Include inventory and item management.
3. Introduce multiple enemies with different abilities.

## **Contributing**
Contributions are welcome! If you'd like to improve this project, feel free to fork the repository and submit a pull request. Suggestions for new features, design improvements, or game mechanics are encouraged.

## **License**
This project is licensed under the [GNU](https://github.com/stephenombuya/Role-Playing-Game/blob/main/LICENSE)License. See the LICENSE file for more details.