https://github.com/dannygaray60/godot-gamelevels-blueprint

Create a blueprint in Godot Engine to organize levels/rooms of a game and their interconnections. Useful for metroidvanias or non-linear games.
https://github.com/dannygaray60/godot-gamelevels-blueprint

addon gdscript godot godot-engine level-design metroidvania non-linear-game plugin rogue-like

Last synced: about 2 months ago
JSON representation

Create a blueprint in Godot Engine to organize levels/rooms of a game and their interconnections. Useful for metroidvanias or non-linear games.

• Host: GitHub
• URL: https://github.com/dannygaray60/godot-gamelevels-blueprint
• Owner: dannygaray60
• License: mit
• Created: 2022-07-31T22:38:04.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-12-08T17:50:52.000Z (about 2 years ago)
• Last Synced: 2023-04-30T06:05:14.332Z (over 1 year ago)
• Topics: addon, gdscript, godot, godot-engine, level-design, metroidvania, non-linear-game, plugin, rogue-like
• Language: GDScript
• Homepage: https://dannygaray60.github.io/
• Size: 2.7 MB
• Stars: 52
• Watchers: 5
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# GameLevels Blueprint

Create a blueprint in *Godot Engine* to organize levels/rooms of a game and their interconnections. **Useful for metroidvanias or non-linear games.**

***

I made this plugin in order to have a direct access to the scenarios [of my metroidvania game](https://dannygaray60.github.io/tn-oota.html). With this blueprint I can organize the scenarios and see where they should connect to.

**This blueprint has no functions beyond a visual representation of the general map of a game.**

***

![](static/example.png)

# How to install

Just copy "addons/gamelevels_blueprint" folder in your own addons folder and enable from project settings.

***

### Working in Godot Engine 3.4.x and 3.5.x

***

# How to use

![](https://github.com/dannygaray60/godot-gamelevels-blueprint/blob/main/static/editor%20modes.png)

Once you have activated the plugin, a new button called **LvlMap** will appear at the top of the editor, from here you can access the blueprint.

***

## Buttons located at the top:

![](https://github.com/dannygaray60/godot-gamelevels-blueprint/blob/main/static/topbar%20actions.png)

1. About and Help button.

2. Open a map file.

3. Save the map file.

4. Close any open map file.

***

## Drag n' Drop

Now you can drag your scenes (.tscn) one by one to the blueprint:

![](https://raw.githubusercontent.com/dannygaray60/godot-gamelevels-blueprint/main/static/drag%20n%20drop.gif)

***

## Editing Levels / Rooms

By pressing the center button of the scene, you can edit the chosen panel. You can replace the file it points to by another scene. Add a description or change the color of the panel.

![](https://github.com/dannygaray60/godot-gamelevels-blueprint/blob/main/static/edit%20added%20room.gif)

From the same menu you can remove the scene from the blueprint (the file will not be removed from the game).

***

## Connecting Levels / Rooms

To connect rooms, click on the button located in the upper right corner, this will change the edit mode. Now just click on the scenes you want to connect.

![](https://github.com/dannygaray60/godot-gamelevels-blueprint/blob/main/static/edit%20connections.gif)

When you select a scene, the lines that are connected will show a button with which you can delete the connection. These connections are also automatically deleted if you delete a scene.

*There are no connection limits, a scene can be connected to one, two, three or many scenes.*

**Note that connections have no additional function, they are just a way to represent the connection between scenarios.**

***

Each added scenario will show four buttons:

![](https://github.com/dannygaray60/godot-gamelevels-blueprint/blob/main/static/scenario%20actions.png)

1. The first one will open the scenario in the editor (think of this as a shortcut).

2. The second one will play the scene.

3. The third one will open the editor panel.

4. And the fourth button will copy the scenario path to the clipboard.

***

![](https://github.com/dannygaray60/godot-gamelevels-blueprint/blob/main/static/scenario%20not%20exists.png)

**Note: If the file pointed to by the panel does not exist, a flag (!) will be displayed and the open and copy path actions are disabled.**

***

You can save the blueprint in a lvlmap file. And work with several at the same time:

![](https://github.com/dannygaray60/godot-gamelevels-blueprint/blob/main/static/save%20map.png)

***

# Credits

This plugin was made by [Danny Garay](https://twitter.com/dannygaray60)

**Icons made by svgrepo.com and game-icons.net**

Website

[https://dannygaray60.github.io/](https://dannygaray60.github.io/)

Email: [[email protected]](mailto:[email protected])

Support me with a donation here

[https://ko-fi.com/dannygaray60](https://ko-fi.com/dannygaray60)