How to use Dungeon Generator

• Head to the Generator Page
• Optionally, choose a template to start with.
• Create a graph layout using the management panels.
• Ensure the graph meets the configuration constraints (e.g. the graph is one single graph instead of 2 smaller sub-graphs)
• Click the “Generate Dungeon” button!

Creating a Graph

Adding Rooms

1. In the Node Manager panel on the left, select a room type from the dropdown:

   • RectangularSmall - Small room node
   • RectangularMedium - Medium room node
   • RectangularLarge - Large room node
   • CorridorNarrow - Narrow corridor connector
   • CorridorWide - Wide corridor connector

2. Click Add Node to create the room in your graph

3. The new room will appear in the Layout Visualiser tab and the Rooms list

Creating Connections

1. In the Connection Manager panel on the right, select a starting room from the first dropdown
2. Select an ending room from the second dropdown
3. Click Add Connection to link the two rooms

Note: You cannot connect a room to itself, and duplicate connections are not allowed.

Using Templates

Click one of the template buttons at the top to load pre-configured dungeon layouts:

• Linear - A chain of 3 rooms, connected by corridors
• Branching - A layout with multiple paths coming off a centre room
• Complex - A cyclic layout with a corridor shortcut between two rooms
• Y-Shape - A tree-like layout with multiple branching rooms
• Circle - A cyclic layout with 8 rooms

Templates will replace your current graph.

Visualizing Your Graph

• Layout Visualiser tab: See an interactive force-directed graph of your dungeon

  • Nodes move and arrange themselves automatically
  • Larger nodes represent larger rooms
  • Red nodes are corridors, gray nodes are rectangular rooms

• Dungeon Layout tab: Generate a rendered dungeon image

  • Click Generate Graph Image to send your layout to the backend
  • Wait for the API to process and return the dungeon image

• Rooms tab: View a list of all rooms with their IDs and types

  • Click the delete button (×) to remove a room
  • Deleting a room also removes all its connections

• Connections tab: View all connections between rooms

  • Shows source and target room IDs
  • Click the delete button (×) to remove a connection

Graph Constraints

Your dungeon graph must meet the following requirements:

Connection Limits

Each room type has a maximum number of connections:

• Rectangular rooms (Small/Medium/Large): Maximum 4 connections
• Corridors (Narrow/Wide): Maximum 2 connections

The Connection Manager will prevent you from exceeding these limits.

Graph Connectivity

• All rooms must be part of a single connected graph
• Avoid creating isolated sub-graphs (disconnected room clusters)
• Every room should be reachable from every other room through connections

Valid Room Types

Only use the five supported room types listed above. Custom room types are not supported.