https://github.com/onelitefeathernet/dungeon-python

Small python program which generates 2D dungeon floors
https://github.com/onelitefeathernet/dungeon-python

dungeon dungeon-generator generation hacktoberfest minecraft minestom python

Last synced: 6 months ago
JSON representation

Small python program which generates 2D dungeon floors

• Host: GitHub
• URL: https://github.com/onelitefeathernet/dungeon-python
• Owner: OneLiteFeatherNET
• License: mit
• Created: 2022-03-24T21:07:55.000Z (almost 4 years ago)
• Default Branch: dev
• Last Pushed: 2025-07-18T04:14:28.000Z (7 months ago)
• Last Synced: 2025-07-30T23:08:17.269Z (7 months ago)
• Topics: dungeon, dungeon-generator, generation, hacktoberfest, minecraft, minestom, python
• Language: Python
• Homepage: https://discord.onelitefeather.net
• Size: 292 KB
• Stars: 0
• Watchers: 3
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Python Dungeon Generator

This is a simple dungeon generator.

It uses a simple algorithm to generate a random dungeon. 

The algorithm is based of the generator from the game "The Binding of Isaac"

which is described in this [article](https://www.boristhebrave.com/2020/09/12/dungeon-generation-in-binding-of-isaac/).

## Usage

The dungeon generator can be used with an ui or without.

The ui is a simple pygame window which shows the generated dungeon.

It also can be used as a rest endpoint.

## Generated Dungeon

The dungeon gets generated as a json file.

The json file contains the following information:

- The seed the dungeon was generated with

- Width and height of the dungeon

- The floor layout

  - A list of all rooms

  - Each room contains the following information

    - The room id

    - The room type

    - x and y position

    - a list of all door positions

### Room Types

- 0: Normal Room

- 1: Dead End

- 2: Item Room

- 3: Shop

- 4: Start Room

- 5: Teleport Room