🟦 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

mkdir build-linux && cd build-linux
cmake ..
make -j$(nproc)
./MorriCraft

🪟 Windows (Cross-compile)

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.