Merge pull request #11 from dhcold/dhc/laughing-brahmagupta

Migrate UI to PyQt6 with dark/light theme, DBT importer overhaul, CI

Author: dhcold

.github/workflows/release.yml

@@ -0,0 +1,98 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            artifact_name: turnt-o-mapper-windows.exe
+            pyinstaller_args: >-
+              --onefile
+              --windowed
+              --name turnt-o-mapper
+              --icon assets/icon.ico
+            dist_file: turnt-o-mapper.exe
+
+          - os: macos-latest
+            artifact_name: turnt-o-mapper-macos
+            pyinstaller_args: >-
+              --onefile
+              --windowed
+              --name turnt-o-mapper
+            dist_file: turnt-o-mapper
+
+          - os: ubuntu-latest
+            artifact_name: turnt-o-mapper-linux
+            pyinstaller_args: >-
+              --onefile
+              --name turnt-o-mapper
+            dist_file: turnt-o-mapper
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: pip install PyQt6 Pillow pyinstaller
+
+      - name: Bump __version__ to match tag
+        shell: bash
+        run: |
+          TAG="${{ github.ref_name }}"
+          VER="${TAG#v}"
+          echo "__version__ = \"$VER\"" > turnt_o_mapper/__version__.py
+
+      - name: Build binary (Windows)
+        if: runner.os == 'Windows'
+        run: pyinstaller ${{ matrix.pyinstaller_args }} main.py
+        continue-on-error: true
+
+      - name: Build binary (macOS / Linux)
+        if: runner.os != 'Windows'
+        run: pyinstaller ${{ matrix.pyinstaller_args }} main.py
+
+      - name: Rename artifact
+        shell: bash
+        run: |
+          SRC="dist/${{ matrix.dist_file }}"
+          DST="dist/${{ matrix.artifact_name }}"
+          if [ "$SRC" != "$DST" ]; then mv "$SRC" "$DST"; fi
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact_name }}
+          path: dist/${{ matrix.artifact_name }}
+          retention-days: 5
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: artifacts/**/*
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

README.md

@@ -0,0 +1,138 @@
+# Turnt-o-Mapper
+
+> A procedural `.map` file generator and Diabotical importer for the game **Turnt**.
+
+<!-- Insert hero screenshot here -->
+
+Turnt-o-Mapper generates ready-to-play for Turnt / ready-to-compile Quake 3 `.map` files.
+Design a full map layout in seconds: choose room count, dimensions, corridor width, texture sets, and let the generator handle the geometry.
+
+---
+
+## Features
+
+- **6 layout strategies** — Linear, Zigzag, Snake, Random, Spiral, Multilevel
+- **Interactive 2D preview** — scroll to zoom, drag to pan, double-click to fit
+- **Interactive 3D wireframe** — drag to rotate, WASD to pan, scroll to zoom, Iso/Top/Front/Side presets
+- **Physics model** — acceleration-based speed simulation per room segment
+- **Texture selector** — assign floor / wall / ceiling textures with live preview
+- **Diabotical `.rbe` importer** — import existing DBT maps with configurable XYZ scale
+- **Auto-update** — checks GitHub Releases on startup and downloads new versions automatically
+
+---
+
+## Download
+
+Pre-built binaries are available on the [Releases](../../releases) page:
+
+| Platform | File |
+|---|---|
+| Windows | `turnt-o-mapper-windows.exe` |
+| macOS | `turnt-o-mapper-macos` |
+| Linux | `turnt-o-mapper-linux` |
+
+**Windows:** Double-click the `.exe` — no install needed.
+
+**macOS:** If you see a security warning, right-click → Open, or run:
+```bash
+xattr -cr turnt-o-mapper-macos && chmod +x turnt-o-mapper-macos && ./turnt-o-mapper-macos
+```
+
+**Linux:**
+```bash
+chmod +x turnt-o-mapper-linux && ./turnt-o-mapper-linux
+```
+
+---
+
+## Build from source
+
+**Requirements:** Python 3.10+
+
+```bash
+git clone https://github.com/dhcold/Turnt-o-mapper.git
+cd Turnt-o-mapper
+pip install PyQt6 Pillow
+python main.py
+```
+
+Optional — texture thumbnails require Pillow (already listed above).
+
+### Build a standalone binary yourself
+
+```bash
+pip install pyinstaller
+pyinstaller --onefile --windowed --name turnt-o-mapper main.py
+# Output: dist/turnt-o-mapper[.exe]
+```
+
+---
+
+## Usage
+
+### Generate tab
+1. Set **Number of rooms** (2–100) and choose a **Layout style**
+2. Adjust **Room size** (min/max width, depth, height)
+3. Set **Corridor width** (25–100%)
+4. Optionally enable **Physics model** for acceleration-based level design
+5. Click **⚡ Generate** — preview updates instantly
+
+### Textures tab
+- Assign textures to **Floor**, **Wall**, and **Ceiling** categories using the F/W/C checkboxes
+- Set the **Texture folder** path in Settings to see live thumbnails
+- The generator picks randomly from each category per room
+
+### Settings tab
+- **Output .map file** — where the generated file is saved
+- **Texture folder** — path to your Turnt texture assets (for preview only)
+- **Game executable** — path to Turnt binary for the Launch button
+
+### DBT Import tab
+- Select a Diabotical `.rbe` map file
+- Configure X/Y/Z scale (Quake units per DBT block)
+- Click **Import** to get a `.map`
+- **Save** map file
+
+### Save & launch
+- **Save .map** — writes the current map to the configured output path
+- **Open folder** — opens the output folder in your file manager
+- **Launch game** — runs Turnt with `--import=<path>` to preview in-engine
+
+---
+
+## Map pipeline
+
+```
+Turnt-o-Mapper  →  .map file  →  Turnt
+```
+
+The generated `.map` uses standard Quake 3 brush format and is compatible
+with any Q3-based compiler (q3map2, DarkPlaces, etc.).
+
+---
+
+## Project structure
+
+```
+main.py                  Entry point (QApplication bootstrap)
+turnt_o_mapper/
+  app.py                 Main window (PyQt6 UI)
+  preview2d.py           2D top-down preview widget
+  viewer3d.py            3D wireframe preview widget
+  generation.py          Map generation orchestrator
+  layout.py              Room placement & corridor routing
+  brushes.py             Quake 3 brush/face geometry
+  entities.py            Spawn, trigger, checkpoint entities
+  dbt_import.py          Diabotical .rbe importer
+  constants.py           Texture registry, theme colours, geometry params
+  models.py              Room & Bridge dataclasses
+  config.py              JSON config persistence
+  updater.py             GitHub Releases auto-update
+  __version__.py         Version string
+```
+
+---
+
+## License
+
+MIT

main.py

@@ -1,7 +1,13 @@
 #!/usr/bin/env python3
 """Turnt-o-mapper -- launch entry point."""
 
-from turnt_o_mapper.app import App
+import sys
+from PyQt6.QtWidgets import QApplication
+from turnt_o_mapper.app import App, DARK_QSS
 
 if __name__ == "__main__":
-    App().mainloop()
+    app = QApplication(sys.argv)
+    app.setStyleSheet(DARK_QSS)
+    window = App()
+    window.show()
+    sys.exit(app.exec())

turnt_o_mapper/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"