Minecraft Clone

A voxel-based building game created with React, Three.js, and JavaScript. Build and explore in a 3D world with familiar Minecraft-like mechanics.

Features

• 🏗️ Place and destroy blocks
• 🎨 Multiple block types:
  • Dirt
  • Grass
  • Glass
  • Wood
  • Log
• 🎵 Dynamic sound effects
• 🎮 First-person controls
• 💾 Save and load world functionality
• 🎵 Background music

Controls

• Movement: WASD
• Jump: Spacebar
• Block Selection: 1-5 keys or scroll wheel
• Place Block: Left Click
• Remove Block: Alt + Left Click
• Menu: M
• Block Types:
  • 1: Dirt
  • 2: Grass
  • 3: Glass
  • 4: Wood
  • 5: Log

Technologies Used

• React
• Three.js
• React Three Fiber
• React Three Cannon
• Zustand (State Management)
• Vite

Getting Started

Prerequisites

• Node.js (v14+ recommended)
• npm or yarn

Installation

1. Clone the repository:

git clone https://github.com/yourusername/minecraft-clone.git

2. Navigate to the project directory:

cd minecraft-clone

3. Install dependencies:

npm install

4. Start the development server:

npm run dev

5. Open the game in your browser:

http://localhost:5173

Building for production

npm run build

The build will be in the dist folder.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Inspired by Minecraft
• Textures based on the original Minecraft textures
• Sound effects created for similar voxel-based games

Future Features

• Multiplayer support
• More block types
• Inventory system
• Day/night cycle
• Mobile support