# 🟦 MorriCraft

![MorriCraft](assets/TitleImage.png)

**MorriCraft** is a high-performance, multiplayer-ready voxel engine built from the ground up using **C++** and **Raylib**. Inspired by classic survival games, it features a custom physics engine, real-time world synchronization, and a deep crafting system.

---

## 🌟 Key Features

### ⚔️ Combat & Survival
- **PvP Combat**: Real-time melee combat with synchronized hit registration, knockback, and audio feedback.
- **Health System**: 8-heart health system with a visual HUD and damage mechanics.
- **Survival Mechanics**: Falling damage and block-breaking progress.

### 👥 Multiplayer & LAN
- **P2P Architecture**: Cross-platform networking stack using standard sockets (Windows/Linux).
- **Instant LAN Hosting**: Host your world with a single click from the pause menu.
- **Skin Personalization**: Built-in skin editor to customize your character's shirt and pants, fully synchronized across the network.
- **Global Chat**: Press `Enter` to communicate with other players in real-time.

### 🔨 Crafting & Inventory
- **Dual Crafting Modes**: Supports both 2x2 player crafting and 3x3 Workbench crafting.
- **Inventory Insight**: Hover over any item to see its name and properties with dynamic tooltips.
- **Authentic Visuals**: Specialized rendering for complex blocks like logs (bark/rings) and crafting tables.

### ⚙️ Performance & Tech
- **Optimized Voxel Engine**: Texture batching and neighbor-chunk caching for stable 60+ FPS.
- **Dynamic World Gen**: Multi-octave Perlin noise (FBM) with forest, desert, and stone biomes.
- **Cross-Platform Portability**: Standalone binaries for Windows and Linux with zero external DLL dependencies.

---

## 🚀 Getting Started

### Prerequisites
- **Linux**: `libpulse-dev`, `glfw` development headers.
- **Windows**: MinGW-w64 (for cross-compilation).

### Build Instructions

#### 🐧 Linux
```bash
mkdir build-linux && cd build-linux
cmake ..
make -j$(nproc)
./MorriCraft
```

#### 🪟 Windows (Cross-compile)
```bash
mkdir build-windows && cd build-windows
cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain-windows.cmake ..
make -j$(nproc)
```

---

## 🎮 Controls
- **WASD**: Movement
- **Space**: Jump
- **Mouse**: Look / Aim
- **Left Click**: Attack / Destroy Block
- **Right Click**: Place Block / Use Workbench
- **E**: Open Inventory
- **Enter**: Open Chat
- **1-9**: Hotbar Selection
- **ESC**: Pause / Menu

---

## 📜 Version History

### v2.1.8 - Forest Fidelity (Latest)
- **High-Detail Leaves**: Integrated a new high-definition leaves texture with improved alpha transparency.
- **Tree Log Fix**: Corrected the rendering pipeline to ensure trees use the multi-texture Oak Log mapping.

### v2.1.7 - Log Realism
- **Item Tooltips**: Added mouse-over identification for all inventory items.
- **UI Polish**: Dynamic tooltip positioning and screen-edge detection.

### v2.1.2 - Combat & Health
- **PvP Melee**: Added ray-traced hit detection and synchronized knockback.
- **Heart HUD**: Implemented an 8-heart health system.

### v2.1.0 - Personalization Update
- **Skin Editor**: Integrated shirt and pants color customization.
- **Humanoid Models**: Transitioned from placeholder "blobs" to multi-cube player avatars.

---
*Developed by the MorriCraft Team. Built with Raylib 5.0.*