# MiniCraft

**Repository Path**: wndproc12/mini-craft

## Basic Information

- **Project Name**: MiniCraft
- **Description**: A simplified Minecraft clone built with LWJGL 3 and OpenGL 3.3 core profile.
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-18
- **Last Updated**: 2026-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MiniCraft

A simplified Minecraft clone built with LWJGL 3 and OpenGL 3.3 core profile.

## Build & Run

```sh
./gradlew run         # launch game
./gradlew test        # all tests
./gradlew shadowJar   # fat JAR → build/libs/MiniCraft.jar
```

JDK 21 required. Assets in `assets/` directory.

## Spawn

Player spawns on the surface at the world origin (0, 0). Terrain generated with Perlin noise; surface height varies from 1–128 blocks (avg. ~64).

## Controls

| Key | Action |
|-----|--------|
| W / A / S / D | Move forward / back / strafe left / right |
| Space | Jump |
| Left Shift | Sneak (slows down, prevents edge falling) |
| Left Ctrl | Sprint |
| Mouse | Look around |
| Left Click | Break block (bedrock indestructible) |
| Right Click | Place block |
| Mouse Scroll | Cycle hotbar slots |
| F3 | Toggle debug overlay (FPS / coords / chunk / facing) |
| F11 | Toggle fullscreen |
| ESC | Release / capture cursor |

## Blocks

| ID | Name | Color | Destructible |
|----|------|-------|-------------|
| 1 | Grass | Green top, brown sides | Yes |
| 2 | Dirt | Brown | Yes |
| 3 | Stone | Gray | Yes |
| 4 | Bedrock | Dark gray | No |

## Tech Stack

| Component | Version |
|-----------|---------|
| Java | 17+ (OpenJDK) |
| LWJGL | 3.3.4 (GLFW + OpenGL + STB) |
| JOML | 1.10.8 |
| Gradle | 8.10 |
| OpenGL | 3.3 Core |

## Project Structure

```
src/main/java/com/minicraft/
├── Main.java             entry point
├── Game.java             game loop (60 tps)
├── Window.java           GLFW window
├── block/                block registry, types, directions
├── input/                keyboard & mouse input
├── physics/              AABB collision
├── player/               camera & player
├── render/               renderer, shaders, textures, font, HUD, debug HUD
├── util/                 Perlin noise, raycast
└── world/                world, chunk, terrain generation
```

## Tests

JUnit 5 — 7 test classes, 34 tests.

```sh
./gradlew test
```

## License

MIT License — see [LICENSE](LICENSE).