# ASSEMBLER CASINO (KAZIK) 🎰

A retro casino gaming suite powered by a high-performance **pure x86 assembly (MASM32)** engine featuring an interactive **2.5D retro Raycaster 3D Hall** (DOOM / Wolfenstein style) and a catalog of classic and underground gambling games.

---

## 🏛️ Architecture Overview

The repository is organized into distinct, modular subsystems:

```
                  ┌────────────────────────────────────────┐
                  │          ASSEMBLER CASINO              │
                  └──────────────────┬─────────────────────┘
                                     │
         ┌───────────────────────────┼───────────────────────────┐
         ▼                           ▼                           ▼
┌──────────────────┐       ┌──────────────────┐        ┌──────────────────┐
│   MASM32 Engine  │       │   C99 Portable   │        │  C# GUI Launcher │
│   (Root Directory)│      │  (src_portable/) │        │ (build/ & dist/) │
│  - poker.asm     │       │ - casino_portable│        │ - Launcher.cs    │
│  - casino3d.inc  │       │ - CMakeLists.txt │        │ - Installer GUI  │
│  - font8x8.inc   │       │ - Makefile       │        │ - Setup Wizards  │
└────────┬─────────┘       └──────────────────┘        └──────────────────┘
         │
         ▼
┌──────────────────────────────────────────────┐
│       Offline Pipeline & Tooling             │
│                (tools/)                      │
│ - tools/previews/   (ANSI / 3D previews)     │
│ - tools/generators/ (Asset & table packers)  │
│ - tools/tests/      (Simulators & checks)    │
└──────────────────────────────────────────────┘
```

1. **MASM32 Core Game Engine (Root)**
   - **`poker.asm`**: Main game binary (~8,500+ lines of hand-crafted x86 assembly). Contains game logic, cheat engine, socket networking, profile save system, and sound triggers.
   - **`casino3d.inc` / `casino3d_data.inc`**: Software 2.5D Raycaster engine rendering a 32×32 grand casino hall at 640×480 with DDA wall casting, depth-sorted sprite objects, and interactive tables.
   - **`font8x8.inc`**: CP1251 1-bit monochrome 8×8 bitmap font table for high-speed HUD rendering directly to the Win32 GDI frame buffer.

2. **Portable C99 Core (`src_portable/`)**
   - Cross-platform implementation (`casino_portable.c`, `casino_portable.h`) allowing gameplay on POSIX / Linux / macOS environments.
   - Fully standalone build with standard `Makefile` or `CMakeLists.txt`.

3. **Desktop Distribution & Launcher (`build/` & `dist/`)**
   - **`build/`**: C# source code for the launcher (`AssemblerCasinoLauncher.cs`), setup GUI (`PokerGameSetupGui.cs`), and uninstaller.
   - **`dist/`**: Ready-to-run compiled desktop executables (`Assembler Casino.exe`, `Uninstall Assembler Casino.exe`).

4. **Offline Development Tooling (`tools/`)**
   - **`tools/previews/`**: Terminal ANSI animation players (`preview_intro.py`, `preview_hakari.py`, `preview_dbd_hook.py`) and 3D preview runner.
   - **`tools/generators/`**: Texture pack scripts (`build_graphics_assets.py`), math table generators (`generate_math_and_map.py`), font rasterizer (`generate_font.py`).
   - **`tools/tests/`**: Software raycaster simulator (`simulate_render.py`), release integrity checks (`release_smoke_check.ps1`), achievement popup modal (`achievement_popup.bat`).

5. **Assets & Documentation (`assets/`, `docs/`, `backups/`)**
   - **`assets/`**: High-resolution textures, sprites, audio samples (`.wav`), and ANSI cinematics (`.ans`).
   - **`docs/`**: Design specifications, cheat sheet, networking guides, and engine render previews.
   - **`backups/`**: Historical milestones and archived releases.

---

## 📁 Repository Directory Structure

```
├── poker.asm                    # Primary MASM32 assembly source
├── casino3d.inc                 # 2.5D retro 3D raycaster engine implementation
├── casino3d_data.inc            # 3D engine math tables (sin/cos) & casino hall grid
├── font8x8.inc                  # 8x8 CP1251 bitmap font data
├── poker.wap                    # Pelles C / Windows project definition
├── build.bat                    # One-click build script for MASM32 core
├── poker.exe                    # Compiled game binary
├── AGENTS.md                    # Engineering guidelines and agent instructions
├── README.md                    # Project documentation (this file)
├── LICENSE                      # Project license
├── .gitignore                   # Git ignore patterns
│
├── assets/                      # Game assets
│   ├── animations/              # ANSI animations (casino_intro.ans, hakari_dance.ans, dbd_hook.ans)
│   ├── audio/                   # Sound effects (.wav) for cards, roulette, coins, win/loss
│   ├── data/                    # Dealer dialogues and text tables (CP1251)
│   ├── icons/                   # Game icon assets (.ico, .png)
│   ├── music/                   # Background tracks
│   ├── sprites/                 # Source sprite sheets & cabaret animations
│   └── textures/                # Packed 128x128 BGRA texture binaries (casino3d-hd.bin)
│
├── backups/                     # Preserved backups and legacy archives
│
├── build/                       # Launcher and setup source code (C# .NET)
│   ├── AssemblerCasinoLauncher.cs
│   ├── PokerGameSetupGui.cs
│   └── UninstallAssemblerCasino.cs
│
├── dist/                        # Compiled desktop distribution binaries
│   ├── Assembler Casino.exe
│   └── Uninstall Assembler Casino.exe
│
├── docs/                        # Project documentation, guides, and plans
│   ├── intro_code_draft.txt     # Opening sequence drafts
│   ├── render_view.png          # Simulated frame render of the 3D casino hall
│   ├── ИДЕИ.txt                 # Game ideas and development backlog
│   ├── ЧИТКОДЫ.txt              # Complete list of cheat codes
│   └── *.txt                    # Release notes, security guidelines, networking
│
├── src_portable/                # Standalone portable C99 implementation
│   ├── casino_portable.c
│   ├── casino_portable.h
│   ├── CMakeLists.txt
│   ├── Makefile
│   └── poker_portable.exe
│
└── tools/                       # Developer tooling & offline asset pipeline
    ├── README.md                # Documentation for tools
    ├── previews/                # Animation & 3D preview scripts (.py, .bat)
    ├── generators/              # Asset packers, math & font generators (.py)
    └── tests/                   # Software render simulator & test scripts (.py, .ps1, .bat)
```

---

## 🛠️ Build Instructions

### 1. MASM32 Game Binary (`poker.exe`)

Prerequisites: MASM32 SDK (`ml.exe`, `link.exe`) installed in `D:\MASM32\masm32`, `C:\masm32`, or Visual Studio MSVC BuildTools.

Simply run:
```bat
build.bat
```
This will assemble `poker.asm` with MASM, link against `kernel32`, `winmm`, `user32`, `ws2_32`, `gdi32`, and produce `poker.exe`.

### 2. C99 Portable Engine (`src_portable/`)

With GCC / MinGW:
```bash
cd src_portable
make
```

Or with CMake:
```bash
cd src_portable
mkdir build && cd build
cmake ..
cmake --build .
```

### 3. Running Previews and Simulators

- **Hakari Jackpot Dance Preview**:
  ```bat
  tools\previews\preview_hakari.bat
  ```
- **Casino Intro Animation Preview**:
  ```bat
  tools\previews\preview_intro.bat
  ```
- **3D Engine Software Simulation**:
  ```bash
  python tools/tests/simulate_render.py
  ```
  Generates `docs/render_view.png` showing the 3D raycaster view with sprites.

---

## 🔤 Character Encoding Standard

- **Game source & strings (`poker.asm`, `assets/data/dealer_phrases.txt`)**: **CP1251 (Windows-1251)**. Never save as UTF-8.
- **ANSI animations (`.ans`)**: CP1251 encoding with ANSI escape codes and form feed (`\f`, `0x0C`) frame delimiters. Preview runners execute `chcp 65001` before playback.

---

## 🎮 Games & Features

| # | Game | Description |
|---|------|-------------|
| 1 | **21 / Blackjack** | Classic card game against the dealer with hit/stand mechanics. |
| 2 | **Poker** | Texas Hold'em with AI opponents, betting rounds, and pot calculations. |
| 3 | **CloverPit** | 5×3 video slots with custom bonus features and payouts. |
| 4 | **Russian Roulette** | High-stakes survival with revolver chamber simulation. |
| 5 | **Skulls & Cups** | Thimblerig shell game testing perception and luck. |
| 6 | **Coin Flip** | Double or nothing coin toss. |
| 7 | **Dice / Craps** | Classic dice rolling wagering. |
| 8 | **Roulette** | European roulette wheel with single and range bets. |
| 9 | **Classic Slots** | 3-reel 777 fruit machine. |
| 10 | **Durak** | Traditional Russian card game with trump cards and defense logic. |
| 11 | **Training** | Practice arena with infinite balance. |
| 12 | **Observer (AI vs AI)** | Watch autonomous agents play against each other. |
| 3D | **Grand Casino Hall** | Real-time 2.5D raycaster environment to explore and walk up to tables. |