92 lines
3.2 KiB
Markdown
92 lines
3.2 KiB
Markdown
# 🟦 MorriCraft
|
|
|
|
|
|
|
|
**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.7 - Log Realism (Latest)
|
|
- **Visual Overhaul**: Added authentic Oak Log textures with separate bark and rings.
|
|
- **Multi-Texture Rendering**: Implemented specialized draw calls for complex cube mapping.
|
|
|
|
### v2.1.6 - Inventory Insight
|
|
- **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.*
|