README.md

TerminalMC

Italian version: README.it.md

TerminalMC is a terminal-based 3D voxel sandbox inspired by Minecraft, rendered with ASCII/ANSI TrueColor output.

Author: PiBOH
Website: https://piboh.github.io/

Quick start

Run from the project root:

start_game.bat

Recommended option:

1. Start in Alacritty (recommended)

Alacritty must be placed here:

deps/alacritty.exe

Project layout

TerminalMC/
├─ start_game.bat
├─ main.py
├─ mouse_test.py
├─ requirements.txt
├─ README.md
├─ README.it.md
├─ scripts/
├─ deps/
├─ docs/
├─ log/
└─ worlds/

Main controls

W/A/S/D        Move
Arrow keys     Camera yaw/pitch
Mouse          Camera/click support when available
Left click/E   Mine
Right click/Q  Build
Space          Jump
1-5            Hotbar block selection
P or F5        Manual save
O              Cycle autosave interval
ESC            Pause menu

Saves and logs

World saves:

worlds/

Logs:

log/

Version file:

scripts/version