# 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

### 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