LttP/Oracle Dungeon Map Subscreen

This script adds a custom subscreen over the normal spacebar map that behaves like the dungeon maps seen in ALttP and the Oracle games. The set up is a little complicated, but once you do it once you can set up your maps right in the ZQuest editor with no need to meddle with arrays. This script supports:

Up to 128 dungeons (using level number 0-127)
Up to 13 floors per dungeon
Customizable map and marker tiles
Rooms larger than one screen
Multiple DMap floors with automatic state carryovers
2 layers of compass markers for items, bosses, lock blocks, and secrets

Day 1 Update of Immediate Regret: Added a few more features requested by ywkls. Also fixed a bug with how the floors were being centered.

Update 7/29/25: Updated the script to be better compatible with 2.55. It can now be run from a DMap Map script.

Because the setup for this script is a bit more visual than usual, I've included a PDF file in the download package with setup instructions. Leave a comment if you run into any trouble setting it up.

This script is optimized for Interior DMaps. NES dungeons should still work, but Overworld DMaps will not. In order to use this script, you'll need the NES fix "Subscreen Appears Above Sprites" enabled. This script requires std.zh.

If you're using the 2.55 version, set the MooshMap_Global generic script to run from start in init data. For dungeons that are using the script, assign it under the map script tab. All other setup remains the same.

Deedee

Edited 08 April 2022 - 04:16 PM

Very cool script (if a giant pain in the ass to set up). It'd be nice if there was a way to hide floors you haven't been to yet on the map if you don't have the dungeon map, and one thing I noticed is that if I wanted to have layerable objects (like stairs) on the map, I had to have two identical combos where the first one is a step next. Also, the title has a giant space in it if you spaced some stuff out to fit on the second line of the DMap Title. Also, despite being able to set a custom BG, you can't have custom Map/Compass positions (say, for minidungeons where the boss key might not exist)

Could also be potentially improved by porting to dmapdata map scripts in 2.55, given those freeze screen action automatically (removing the need for Freezing FFCs) and dmapdata has InitD's for the Map script; I did that with a project of mine, though I didn't utilize the InitD's at all.

Mitchfork

Posted 12 January 2021 - 11:05 AM

This is an excellent script. Functionality is everything you would want from a standard map script - support for everything that LttP or the Oracles did, plus a few extra goodies like support for individualized markers.

This has a fairly intuitive setup for people not familiar with scripting - it's very visual, where you set everything up by placing combos instead of editing the script file. There are a LOT of tiles to rip in for this, but that's a one-time operation.

If you are familiar with scripting, the code is pretty readable and well-commented, so you can perform a lot of customization. I was able to easily change the location of nearly every element and edit things such as the text display easily.

Blackpaintbowser

Posted 25 February 2024 - 05:23 PM

There's a problem I'm having, I'm using 2.55 darkness, and the map is obscured by the darkness

Blackpaintbowser

Posted 27 September 2022 - 12:26 PM

for some reason in my two-state dungeon the bottom floor doesn't display that you've been on a screen on the other version but the other floors do

Blackpaintbowser

Edited 31 August 2022 - 02:28 PM

for some reason when I press the spacebar nothing happens. I have press spacebar and script 1 dmap flags and subscreen over sprites all set

also I'm using 2.55

Edit: I got it to work

Demonlink

Posted 28 May 2021 - 12:49 AM

I'm using 2.55, not sure if that has to do with anything but, I can't seem to find the reason of why it isn't drawing Link's floor marker or point on the map... I double checked if I set the right value to the combo that it is supposed to be set to in the script, and it's correct... The MOOSHMAP_DRAWLINKPOSITION constant is set to 1 as well. (Ignore the blue font and the double 1F stuff, that's something I'm still working on).

Posted Image

Noire

Posted 19 March 2018 - 08:24 PM

I got a little problem: I setting anything like your exemple quest (i do changes certain number of required tiles) but when i press in the Map (subspace) it's doesn't do anything else then showing me the classic map view. i did enable the "View Overworld Map by pressing 'map'".