Fix config loading, speed thresholds and block selection; add tests, README, CLAUDE.md

2026-10-14 08:22:43 +03:00
parent 85a233f33c
commit d36037c88e
13 changed files with 638 additions and 38 deletions
@@ -0,0 +1,69 @@
+## -=:dAs:=- Tetris
+### _Classic Tetris on Python + pygame with configurable blocks, colors and controls_
+
+[![Python](https://img.shields.io/badge/Python-3.12-green)](#) [![pygame](https://img.shields.io/badge/pygame-2.6.1-orange)](#) [![PyInstaller](https://img.shields.io/badge/PyInstaller-6.16-blue)](#)
+
+🇺🇦 [Українська версія](README_ua.md)
+
+### 💡 Purpose
+A desktop Tetris game where the set of pieces, their colors, the unlock score for each piece, the field width, block size, colors and keys are described in JSON files – so the game can be extended with new shapes without touching the code.
+
+### 📃 Features
+- [Gameplay](#Gameplay) – falling pieces, rotation, line clearing, score and lines counter, next-piece preview
+- [Progressive pieces](#ProgressivePieces) – 23 shapes, new ones unlock as the score grows
+- [Configuration](#Configuration) – keys, colors, field width, block size and speed mode in JSON
+- Pause, restart and exit confirmation dialog (mouse or Y/N keys)
+
+### ⭐ Advantages
+- **Data-driven shapes** – any new piece is a few lines of JSON: name, color, minimal score and a list of rotations.
+- **Safe defaults** – committed `*_000.json` defaults are used automatically when local configs are absent.
+- **Runs from anywhere** – configs are resolved next to the script or the built executable, not the current directory.
+- **Clear config errors** – broken JSON or a missing key stops the game with a message naming the file and key.
+
+### 📱 Screenshots
+<table>
+  <tr>
+    <td align="center"><img src="images/screenshot_game.png" width="300" alt="Game" /></td>
+    <td align="center"><img src="images/logo_02_256x256.png" width="200" alt="Logo" /></td>
+  </tr>
+  <tr>
+    <td align="center"><i>Game field</i></td>
+    <td align="center"><i>Logo</i></td>
+  </tr>
+</table>
+
+### 📌 Using
+
+#### Gameplay<a id='Gameplay' />
+**_Standard Tetris rules on a 20-row field_**
+- `←` / `→` – move, `↑` – rotate, `↓` – drop one row
+- `P` – pause, `R` – restart, `Esc` – exit (with confirmation)
+- Score for cleared lines at once: 1 – 100, 2 – 300, 3 – 500, 4 – 800
+- The next piece is always different from the current one
+
+#### Progressive pieces<a id='ProgressivePieces' />
+**_The higher the score, the more varied the pieces_**
+- 8 base shapes (`configs/blocks.json`): Square, Line, Line3 and L from the start; J from 900, S from 1000, Z and T from 2500 points
+- 15 additional shapes (`configs/blocks_ADD.json`, optional): Dot, U, Corner, X, P, F and others, unlocked from 3500 up to 30000 points
+- Above 5000, 10000 and 15000 points the falling speed changes
+
+#### Configuration<a id='Configuration' />
+**_All settings live in `configs/`_**
+- `config.json` – keys (pygame key names, e.g. `K_LEFT`), controls help text, colors, `store_width` (field width in blocks), `block_size` (pixels), `high_score_inc_speed`
+- `high_score_inc_speed`: `false` – the game speeds up as the score grows, `true` – it slows down
+- `blocks.json` / `blocks_ADD.json` – pieces: `name`, `color` `[r, g, b]`, `min_score`, `shapes` (list of clockwise rotations, 0/1 matrices); at least one piece must have `min_score` 0
+- If a local file is missing, its `*_000.json` default is used
+
+### 🚀 Running
+Requirements: Python 3.12, pygame 2.6.
+```shell
+python3 -m venv .venv
+.venv/bin/pip install -r requirements.txt
+.venv/bin/python das_tetris_gui.py                  # start the game
+.venv/bin/python -m unittest discover -s tests -v   # run tests
+.venv/bin/pip install pyinstaller
+.venv/bin/pyinstaller --onefile das_tetris_gui.py   # build a single executable into dist/
+```
+The executable reads configs from a `configs/` folder located next to it.
+
+###### _Made by -=:dAs:=-_