Dingo for Godot 4

Dingo is a Godot add-on for generating and decorating customizable procedural dungeons/rooms!

---

Examples of layouts generated & decorated with Dingo!

---

Installation & Usage

Github Download Installation

1.) Download the ZIP file from main
2.) Drag the folder "Dingo - Dungeon Generator Plugin" into your filesystem in Godot (I reccomend creating a folder for it called "addons")
3.) Open up one of the example scenes - scenes > example scenes > (ex, scifikit example)
4.) Look at the tutorial video on how to use Dingo

Godot Asset Library Installation

1.) In Godot, open the AssetLib tab
2.) Search for and select "Dingo"
3.) Download then install the plugin
4.) Enable the plugin inside Project/Project Settings/Plugins.
5.) Look at the tutorial video on how to use Dingo

Tutorial Video: (In the works!)

Showcase Video: https://www.youtube.com/watch?v=FkrG9R1dFIs

---

Features

• An intuitive interface & workflow, designed with developers, designers, & artists in mind.

  

  ---

• A “room type” based setup, with the ability to customize individual room types and create complex layouts from them.

---

• A two step workflow with the ability to generate layouts for rooms using Godot’s gridmap then decorate them with custom meshes and nodes of any kind.

  

---

• Decorate rooms with procedurally placed assets, place prebuilt rooms or mix and match.

---

• Dynamic and static modes for sizing - generate sized room types within a range or with specific measurements.

---

• Dynamic, static, and ranged modes for room placement - generate room types placed randomly within an area, a range within the area (for biome creation) or at a specific location.

---

• Dynamic and static modes for door placement - generate doors randomly located within a room, or in a specific location within the room (good for irregularly shaped rooms & prebuilt rooms)

---

• Layout customizability like room margins, recursion, amount, and priority all adjustable by individual room type,

  

  ---

• Options to guarantee room amounts or set “goal” amounts (good for if you want more rigid or dynamic layouts)

  

  ---

• Adjustable corridor amount to create more complex or simply connected layouts

  

  ---

• Printed generation results with the amount of rooms generated per type, generation progress, and coordinates for each room.

  

  ---

• Dozens of free dungeon themed assets, and example layouts to use as a base or in your own generations!

  

  ---

Disclaimer

• This project was built off of this tutorial by quwatz_! I referenced a good amount of their code so please check out their channel :) https://www.youtube.com/watch?v=h64U6j_sFgs&list=PLIjshinY7LU9EsAAuCTrfOSs2mxC6GCyw&index=4

• This is my first Godot addon i've published, so please let me know if you have any critiques or suggestions, I would like to create more addons in the future so I appreciate the feedback

• If you do end up using this plugin, I would be very interested in seeing what you create! Feel free to show me your results in your game or any other projects by contacting me through any of the socials I have linked. I look forward to seeing what the community can create with this tool and how it can be improved

  ---

Contribution

If you would like to make changes please send in a feature proposal or bug report prior to commiting any work or sending PRs! If you would like to implement any listed "future plans" feel free to have a go with it or implementing anything else you think would be helpful for this addon.

---

Known Issues/Limitations

• Corridors can only be of one room type
• No seed creation
• Large scenes with lots of rooms can crash Godot when the project is opened (to fix this if it occurs, prevent the scene from opening upon startup in Projects → Project Settings → Application → Run → Main Scene)

  ---

Future Plans

• Seed creation
• Multiple corridor roomtypes
• Faster mesh building
• LODs
• Customizable corner tiles for room types
• Minimap creation

  ---

Support/My Links

Donations: https://ko-fi.com/benjtek01 Website: https://benjtek01.crd.co/ Disc: benjtek01

---

License

https://github.com/benjtek01/dingo-roomgen/blob/main/LICENSE