# MorriCraft

![MorriCraft](assets/TitleImage.png)

MorriCraft is a high-performance voxel engine built with C++ and Raylib. It features a custom physics engine, dynamic world generation, and an interactive inventory and crafting system.

## Features
- **Custom Physics**: Stable "Ground-Lock" system prevents camera jitter and ensures smooth movement.
- **Dynamic World Generation**: Multi-octave Perlin noise (FBM) for realistic terrain, including biomes like grass, sand, and forests.
- **Advanced Crafting**: Includes both a 2x2 player inventory grid and a 3x3 workbench system.
- **Optimized Rendering**: Texture batching and neighbor-chunk caching for stable 60+ FPS.
- **Cross-Platform**: Builds for both Linux and Windows.

## Version History

### v2.1.1 - Interface Isolation (Latest)
*   **Menu Collision Fix**: Resolved a state conflict where the Direct Connect menu would draw over the Skin Editor.
*   **State Hardening**: Correctly isolated all menu drawing blocks to prevent visual "hijacking" of new interfaces.

### v2.1.0 - Personalization & Stability
*   **Integrated Skin Editor**: Personalize your shirt and pants colors directly from the Options menu.
*   **Network Skin Sync**: Custom skin colors are now synchronized between all players via an updated handshake protocol.
*   **Enhanced World Sync**: Increased chunk rebuild priority and optimized block update broadcasting for real-time consistency.
*   **Refined Nameplates**: Elevated nameplates to 2.1f for better visibility above the new humanoid models.
*   **Diagnostic Logging**: Added developer-focused logging for world state changes to ensure parity.

### v2.0.9 - Identity Update
*   **Humanoid Player Models**: Replaced placeholder "blue blobs" with multi-cube humanoid shapes.
*   **Chat Input Isolation**: Inhibited movement and action keys while the chat interface is active.

### v2.0.8 - Real Update & LAN
*   **Real Update System**: Implemented live file download via `curl` for seamless client updates.
*   **Open to LAN**: Added a button to the Pause menu to host a world session instantly.
*   **UI Fixes**: Corrected the main menu "Connect" button navigation.

### v2.0.7 - Collaborative Polish
*   **Streamlined Multiplayer UI**: Relocated all networking settings to a dedicated "Join Server" screen.
*   **Fresh Start Survival**: Players now start in new worlds with an empty inventory.
*   **Full System Updater**: Overhauled the updater to handle comprehensive file replacement.

### v2.0.6 - World Sync & Visibility Hardening
*   **Host-Side ID Tracking**: Fixed a critical bug where the host could not see connected clients.
*   **Auto-Chunk Generation**: Updated `SetBlock` to automatically generate chunks for remote updates.
*   **Reliable Data Streams**: Implemented `SendAll` and `RecvAll` with micro-sleeps to guarantee delivery.

### v2.0.5 - Persistence & Volume Control
*   **Stateful Volume Settings**: Fixed global scope for volume variables to ensure persistence across sessions.
*   **Selective Config Saving**: Refined `SaveConfig` to only persist user preferences (Volume, Name) and ignore session-specific state.

### v2.0.3 - Multiplayer Protocol Hardening
*   **Protocol Synchronization**: Overhauled the packet processing loop to prevent data drift and 'ghosting' blocks.
*   **Notification Debouncing**: Implemented filters to ensure join/leave messages are only triggered once per action.
*   **Cross-Platform Stability**: Replaced non-portable socket flags with a robust `select()`-based architecture for Windows/Linux parity.
*   **Body Validation**: Hardened the data reception logic to ensure complete packet consumption and prevent buffer overflows.

### v2.0.2 - The Social & Sync Update
*   **Integrated Chat System**: Press `Enter` to open the chat box and communicate with other players in real-time.
*   **Player Notifications**: Added automated alerts for players joining or leaving the session.
*   **Multi-Player Visibility**: Fixed player tracking to ensure all peers are correctly identified and rendered for all clients.
*   **Handshake Optimization**: Host now pushes seed, time, and existing player states instantly upon connection.
*   **Update Integrity**: Fixed the auto-update system to correctly write version files after a successful download.

### v2.0.1 - World State Synchronization
*   **Real-Time Block Sync**: Introduced `NetSetBlock` to synchronize all mining and placement actions across peers.
*   **Time Sync**: Host acts as the master clock, ensuring identical day/night cycles for everyone.
*   **Seed Sync**: Corrected world generation so that clients automatically adopt the host's seed.

### v2.0.0 - The Multiplayer Milestone
*   **P2P Architecture**: Implemented a cross-platform peer-to-peer networking stack using standard sockets.
*   **Direct Connect**: Added the ability to join servers via IP and Port from the main menu.
*   **Remote Avatars**: Introduced 3D representation for other players with dynamic floating nameplates.
*   **Server Mode**: Integrated a non-blocking host listener into the standard world generation flow.

### v1.9.1 - The Connectivity & Polish Update
*   **Persistent Configuration**: Added `config.cfg` to save player preferences and identity.
*   **Player Identity**: Implemented a required name-entry sequence on first launch.
*   **Auto-Update System**: Integrated version-checking, update notes viewer, and download progress simulation.
*   **Multiplayer Preparation**: Added Server Mode toggle and Direct Connect interface foundation.
*   **Performance Fixes**: Resolved edge-case frustum culling artifacts.
*   **Audio Refinement**: Fixed music transitions between menus and gameplay states.
*   **UI Polish**: Optimized layout for the Options and Main Menu screens.

### v1.6.6 (Latest)
- **Tool Scaling**: Increased the size of held items (Axes/Sticks) in first-person for better visibility.
- **Custom Assets**: Integrated a high-detail community wooden axe asset.
- **Visual Polish**: Improved the viewmodel orientation and stability.

### v1.6.5
- **Audio Optimization**: Implemented a rapid-crossfade system for cleaner day/night music transitions.
- **UI Bug Fixes**: Resolved music state issues when entering the Options and Crafting menus.

### v1.6.4
- **Immersive Audio**: Added material-specific digging sounds (Grass, Wood, Stone, Sand).
- **Viewmodel Overhaul**: Held blocks are now rendered as 3D textured cubes instead of white boxes.
- **Audio Sync**: Tied digging sounds to mining progress for better tactile feedback.

### v1.6.3

### v1.5.2
- **Stability Fixes**: Resolved texture corruption and state-management bugs with workstations.
- **In-Game Clock**: Added a 12-hour AM/PM HUD clock and day/night status indicator.
- **Lighting Engine**: Implemented a global day/night cycle (300s) with dynamic sun/moon and world tinting.

### v1.4.2
- **UI Redesign**: Overhauled the inventory and crafting windows to match the classic Minecraft layout.
- **Character Preview**: Added a player preview placeholder in the inventory.
- **Centered Layout**: All UI grids are now symmetrically centered.

### v1.4.1
- **Texture Fixes**: Corrected leaf and log textures.
- **Inventory Stability**: Fixed the double-toggle bug when pressing 'E'.
- **Bug Fixes**: Resolved grass rendering issues and fixed tree generation.

### v1.4.0
- **Crafting Table**: Implemented the Crafting Table block and 3x3 grid interaction.
- **Advanced UI**: Centered stack counts and added red versioning to the title screen.

### v1.3.x
- **Physics**: Implemented "Ground-Lock" stabilization.
- **Inventory**: Added basic drag-and-drop support.
- **Wireframes**: Added real-time block selection highlights.

## Build Instructions

### Linux
1. `mkdir build-linux && cd build-linux`
2. `cmake ..`
3. `make -j$(nproc)`

### Windows (Cross-compile from Linux)
1. `mkdir build-windows && cd build-windows`
2. `cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain-windows.cmake ..`
3. `make -j$(nproc)`

## Controls
- **WASD**: Movement
- **Space**: Jump
- **Mouse**: Look / Aim
- **Left Click**: Destroy Block
- **Right Click**: Place Block / Use Crafting Table
- **E**: Toggle Inventory
- **1-9**: Hotbar Selection
- **ESC**: Pause Menu / Close Inventory