🎮 What This Is

This project takes inspiration from the balance cube games.  Instead of just the seven original tetrominoes, here you can design new, custom pieces by describing them with simple text strings. Each string defines which squares of a grid are filled and which are empty. The system then turns that text into a parametric 3D block.

📝 Tutorial: How to Make Strings

The string format is simple and human‑readable:

• Characters:
  • Any non‑space character (like x, #, *) = filled square.
  • A space “ “ or period ”.” = empty square.
• Rows:
  • Each row is separated by a comma (",").
• Layers:
  • Each layer (for 3D stacking) is separated by a pipe ("|").

Examples

1. Square (O piece)

xx|xx

→ 2×2 block.

2. Line (I piece)

xxxx

→ 4×1 block.

3. L piece

x|xxx

→ L‑shaped block.

4. T piece

xxx|.x.|.x.

or

xxx|.x|.x

→ T‑shaped block.

5. Cube (two stacked layers)

xx,xx|xx,xx

→ A 2×2×2 cube.

6. Custom shape (Y‑like)

x.x|xxx|.x|.x

7. Big O

xxxxx|x...x|x...x|x...x|xxxxx

→ O shaped block.

Formatting Rules

• Use spaces or periods to leave gaps.
• Use comma (",") to move down rows.
• Use pipe ("|") to start a new layer above.
• Keep rows aligned: each row in a layer should have the same number of characters for clean geometry, but any missing characters will just assume a lack of block in that space
• You can use any symbol (x, #, @) — the parser only cares whether it’s a space or not.