Cajun Style Templates (UPDATE 3.0.5, Rooms, UB, MSE 2.5!)

That's right baby, after almost a year we're back to the Dungeon frame with a complete overhaul to the system to make it so so so much more powerful than before! You can now have three room entrances and exits, left and right movement, triple-length rooms, dead-ends, variable width rooms, door offsets, even custom floors, the new reminder box, and card colors! A big thanks as always to CardConjurer for the card images and wall textures, and to sleep deprivation for the breakthrough that made this code come together.

A Note On Backwards Compatibility! The layout of existing dungeon cards will be completely lost. Your text will maintained, however, due to the room restructure all the rooms but the entrance have been moved: The old Level 2, Room 1 is now Level 1, Room 2, and so on, with the old Final Room now at Level 7, Room 3. Setting a grid of 3,3,3,3,3,3,3, will let you see all the rooms to recover text.

Creating A Dungeon


1. Room Counts
In this style option, list the number of rooms that should be on each level of the dungeon, separated by commas. For example, Lost Mines would be 1,2,3,1, Tomb of Annihilation would be 1,2,2,1, and The Backrooms would be 3,3,3,3,3,3,3,. There is a maximum of 3 rooms per level, and a maximum of 7 levels total.

2. Room Heights
MSE will try to hand out the level heights equally automatically. In this style option, you can set the height of the room in gridblocks for each level also separated by commas. A blank spot will cause it to be sized automatically. The auto sizer may still make your room taller than the number you give if the total number you assign isn't equal to 19, the total maximum of the dungeon. Each level can be a minimum of 2 blocks tall and a maximum of 15.

3. Other Stuff, Part 1
Under here you can choose if the Dungeon has a textbox for reminder text at the top like the Undercity, a font size maximum that applies to all the dungeon rooms for consistent text, and add a custom floor image. The last opens an uploadable image box which is clickable along the outside edges of the border walls.


From here on, each styling option will apply to a particular level, and (until Advanced Scripts) you don't need to use commas to separate the numbers or order them, “1,2,3,” and 231 will get the same results.

4. Level N Long Rooms
In these style options, list the rooms in this level that are long rooms rather than their own new room, like Oubliette. This can go as long as you want, so make triple-size or quad-size or even sept-size rooms to your heart's content. Each level that the double length room passes through needs to have the same number of rooms listed in Room Counts, but later on we'll have a trick that will allow us to make a room 0 blocks wide, allowing for 2 room → 3 room configurations, like the one seen in Prison above.

5. Level N Dead Ends
In these style options, list the doors in this level that you want to close off. The wall will be filled in and the arrow removed. Since this tracks doors, you may get up to 4 or 5 in here. Note that a long room opening also counts as a door for these numbers. You can also dead end the top level entrances with Level 0 dead ends, and the bottom level exits with whatever the next level number would be dead ends (so a 3 level dungeon would use Level 4, and a 7 level dungeon would use Level 8).

6. Level N exits
In these style options, list the walls in this level that you want to open. Wall 1 is the left-hand border, Wall 2 is the right hand wall of Room 1, and so on. By default, these doors will get arrows that point out of the dungeon on the borders, and into rooms that don't dead-end on the interior walls, however, all arrows are editable if you want them to point in a particular direction. Additionally there's a lock and key symbol, and custom slots...

7. Other Stuff, Part 2
Here we have customization for the arrow symbols. First is Arrow replacement folder, this takes a folder location (ie “foldername/”) from within magic-mainframe-extras, and replaces the symbols with arrowL, arrowR, arrowLR, arrowU, arrowD, arrowUD, lock, and key.png from that folder. Next is custom symbol image names, also in magic-mainframe-extras. If you have an arrow replacement folder, these images will be pulled from that folder as well. Finally you can have all the arrows turned off by default.

8. Advanced Scripts
The next two options require more intense scripts in order to use, and MSE will hang for a second or three every time it needs to re-render the dungeon (basically, when you change these options, the card color, or switch to the card for the first time). Because of that, there is a toggle here that determines whether these scripts run at all. It is off by default. Switching to preview mode will cause the changes to be applied, but the dungeon will be in black and white so it updates faster. Finally changing this to Yes will render it fully. Editing the card (ie text and arrows) will still work at normal speed so you won't need to worry about that.

9. Level N custom widths
Here we can change how many blocks wide each room in a level is, using a comma-separated list of numbers for each room length. As mentioned before, we can use this to allow for a level with a long room and one normal room to transition to a level with a long room and two normal rooms. To do this, we just use 3 rooms on each level, then use a custom width of 0 for one of the rooms on the intended 2-room levels. If the long room is room 1, this will happen automatically if the first two room widths add up to 16.

10. Level N door offsets

And once again, happy dungeon crawling.

Cajun once against proves why they are the GOAT

Do we have anyone working on the Battle Template?

updates for things are underway. there are just many things.