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

https://github.com/winqz/phprealm

Welcome to PHPRealm, an ambitious and evolving open-source MMORPG built with PHP, CodeIgniter 4, and WebSockets. Explore a vast, dynamic world in real time, where players interact, battle, and conquer through the power of PHP!
https://github.com/winqz/phprealm

codeigniter4 database mmorpg mmorpg-client php-framework php8 websocket

Last synced: 3 months ago
JSON representation

Welcome to PHPRealm, an ambitious and evolving open-source MMORPG built with PHP, CodeIgniter 4, and WebSockets. Explore a vast, dynamic world in real time, where players interact, battle, and conquer through the power of PHP!

Awesome Lists containing this project

README

          

Image description

# PHPRealm

### Welcome to **PHPRealm** – an Open-Source MMORPG built with **PHP** and **CodeIgniter 4**!

PHPRealm is an ambitious, work-in-progress MMORPG that brings the power of **PHP** and the **CodeIgniter 4** framework into a fully interactive multiplayer game world. Join players from around the globe, explore vast realms, engage in epic battles, and level up your character in a world where **code** is your greatest ally!

## 🌟 Features Planned for PHPRealm

We’re working hard to bring the best features to PHPRealm! Below is a breakdown of the exciting gameplay mechanics, multiplayer systems, and RPG elements we're developing for the game.

### Core Features:
- **πŸ” User Registration & Character Management**
Players can create accounts, register new characters, and manage stats such as health, mana, and experience points.

- **🌍 Expansive 2D Game Map**
Players can explore a grid-based 2D world with distinct regions, monsters, and loot waiting to be discovered.

- **βš”οΈ Real-Time Combat System**
Engage in dynamic real-time combat with monsters and other players. Use skills and abilities that consume mana or energy.

- **πŸ‘₯ Multiplayer Interaction**
See other players moving around the map in real-time and interact with them, including chatting and trading.

- **πŸ’¬ Real-Time Chat System**
Talk to other players in the game using an in-game chat interface.

- **πŸ“œ Quest System**
Embark on adventures with quests offered by NPCs to earn rewards, experience points, and rare items.

- **πŸŽ’ Inventory and Item System**
Manage your inventory, collect rare items, and trade with other players.

- **πŸ› οΈ Player vs. Player (PvP) Combat**
Challenge other players in the game world for supremacy in exciting PvP battles.

- **πŸ”„ Real-Time Synchronization (WebSockets)**
Use WebSockets to synchronize real-time interactions between players, combat events, and map navigation.

---

## πŸ› οΈ Project Status: Work In Progress 🚧

### Feature Completion Checklist:

- [ ] **User Registration & Character Management**
- [ ] **Basic 2D Map with Player Movement**
- [ ] **Advanced Mob System**
- [ ] **The Best 2D Boss Battles**
- [ ] **Real-Time Combat System**
- [ ] **Multiplayer Interactions (WebSockets)**
- [ ] **Basic Chat System**
- [ ] **Quest System**
- [ ] **Inventory and Item System**
- [ ] **PvP Combat**
- [ ] **Advanced Map Regions & NPCs**
- [ ] **Real-Time Synchronization (WebSockets)**

---

## 🌱 How to Contribute:

PHPRealm is in the early stages of development, and we're actively looking for contributors! Whether you're a PHP wizard, an aspiring game developer, or someone with great ideas, you're welcome to join us on this journey.

Feel free to fork this repository, submit pull requests, or open issues to suggest features or report bugs!

---

## πŸš€ Getting Started

To run **PHPRealm** locally with **CodeIgniter 4**, follow these steps:

1. **Clone the Repository:**
```bash
git clone https://github.com/WinQz/PHP-MMORPG.git
```

2. **Set Up Your Environment:**
- Install PHP and a local server (e.g., XAMPP, WAMP, or MAMP).
- Install MySQL for database management.
- Install **Composer** for managing dependencies.

3. **Install CodeIgniter 4 Dependencies:**
```bash
composer install
```

4. **Configure Database:**
- Set up a MySQL database and import the SQL file from the `/database` folder.
- Edit the configuration file `.env` with your database credentials.

5. **Start the CodeIgniter Development Server:**
```bash
php spark serve
```

6. **Explore PHPRealm:**
- Open your browser and navigate to `http://localhost:8080`.

---

## πŸ“š Future Plans:

As the game grows, we plan to expand the world of PHPRealm with more features, including:
- **Guilds & Alliances**
- **Dynamic Events and Raids**
- **Mounts & Companions**
- **Customizable Player Housing**
- **Economy and Auction System**

Stay tuned for updates!

---

## πŸ“œ License

PHPRealm is licensed under the [MIT License](LICENSE).

---

## 🀝 Contributors

- **WinQz Milan** – Lead Developer
- **Your Name If You Contribute ;p** – Open for contributions!