https://github.com/arcticray/procedural-tilemap-generator

https://github.com/arcticray/procedural-tilemap-generator

Last synced: 12 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/arcticray/procedural-tilemap-generator
• Owner: ArcticRay
• Created: 2025-07-26T20:42:00.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2025-07-26T21:26:33.000Z (12 months ago)
• Last Synced: 2025-07-27T01:17:27.741Z (12 months ago)
• Language: Python
• Size: 7.81 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Procedural Tilemap Generator Service

**FastAPI** microservice for procedural generation of 2D tilemaps with configurable biome rulesets, live-reload development, and multiple export formats.

[![CI](https://github.com/arcticray/procedural-tilemap-generator/actions/workflows/ci.yml/badge.svg)](https://github.com/arcticray/procedural-tilemap-generator/actions/workflows/ci.yml)

---

## 🚀 Features

- **REST API Endpoints**

  - `POST  /generate_map/` → JSON tile grid

  - `GET   /generate_map/` → JSON via query params

  - `GET   /generate_map/png` → PNG image

  - `GET   /generate_map/svg` → SVG vector map

  - `GET   /generate_map/tmx` → TMX file for Tiled

- **Biome Ruleset**

  - External `biomes.yaml` defines thresholds & variants

  - Validates input, returns 422 on unknown biome

- **Variability**

  - Randomized noise offsets → every request yields a fresh map

- **Playground UI**

  - Interactive form, live PNG preview, download SVG/TMX buttons

- **Dockerized**

  - **Dev** image: live‐reload (`uvicorn --reload`), mounted code & config

  - **Prod** image: lean, excludes dev tools & tests

- **Testing & Linting**

  - `pytest` for unit/integration tests

  - `flake8`, `isort`, **Black** for style enforcement

- **CI/CD**

  - GitHub Actions: tests → lint → build dev & prod images

---

## 🖼️ Example Maps

**32×32 (forest)**  

![32x32 Forest](examples/map-32x32-forest.png)

**32×32 (desert)**  

![32x32 Desert](examples/map-32x32-desert.png)

---

## Application Preview

**Preview of Application**

![Application Preview](examples/application_preview.png)

---