Silvers Minimap

[SilverDash]

Plugin reached v1.00. From now on follow this topic instead: http://forums.rpgmakerweb.com/index.php?/topic/51307-silvers-advanced-minimap/

Spoiler

Minimap v. 0.91

Author: Silver

Features:

- Shows a minimap based on a mapshot or a custom image of the map

- Optional: Renders the actual active/live player graphic onto the minimap

- Optional: Blinking player icon

- Optional: Only shows the map(s) when the party possesses a specific item

- Minimap can be aligned on all 4 sides of the screen, with custom positions

- Automatically attempts to load a minimap for each map

- Supports POI's through plugin command (for advanced users)

- Has plugin commands to control the minimap a bit

- Supports skipping frames for all maps or for specific maps to increase performance for supersized maps
- Supports map-notetags
- Optional: Maintain aspect ratio

- Optional: has leading zeros in minimap image names
- The minimap now properly fades out when the screen fades out
- Realtime events on the minimap. This is it's best feature. It can (among others) show moving events on the minimap as well!

- Has 2 map-modes: Autofit and Scroll
- Has some debugging options
- Suports manual scrolling. This can be enabled/disabled through a parameter and map-notetags
- There is a global-zoom parameter which can be overriden by each map through a map-notetag
- Supports a minimap overlay

- No known conflicts with other scripts

Planned Features:

- Enlarge minimap (by buttonpress or via menu) to go fullscreen and allow the player to scroll it.

- Custom minimap size per map using map notetags

- Adding POI's through icons with less plugin command arguments compared to regular POI's (but regular POI's support all graphics).

- Add optional option to teleport to poi's.

Known Bugs:

- Walking on grass causes the player blip to become invisible.

- Pressing the scroll buttons when not on the gamemap or just not having a minimap will cause a crash. Already fixed in the new version but it's not ready yet for release.
 

Screenshot(s):

http://s21.postimg.org/40vkofao7/mmsample2.png

http://s21.postimg.org/q1bx51tc7/mmsample3.png

http://postimg.org/image/lq5x8rys9/

http://s22.postimg.org/guuhx8wpt/minimap_oddsize.png

TLDR Instructions for experienced people:

Copy the attached files to:

/img/minimap/Overlay.png

/img/minimap/DebugGrid01.png

/img/system/Window_Minimap.png

Place mapshots in the /img/minimap/ directory and rename them 001.png, 002.png etc. (matching the id of your map)

Regular Instructions:

1. Make a mapshot of your map or paint your own map. I personally use: http://forums.rpgmakerweb.com/index.php?/topic/49711-orange-mapshot/ but this one probably works too: http://forums.rpgmakerweb.com/index.php?/topic/49684-mrp-mapexporter-export-your-full-size-maps-11-as-png-files/?hl=mapshot

2. Make sure the mapshot is a png file (not a jpg!).
3. Rename the mapshot to the map-id and make it (by default) 3 numbers total.
    Example for map id 1:   001.png
    Example for map id 16: 016.png
4. Place the mapshots in <project folder>/img/minimap/
    Example: D:\MyAwesomeGame\img\minimap\001.png

5. Place the Window_Minimap.png (see attachment) in your <project>/img/system/ folder. You can obviously also use your own.

6. Copy the Overlay.png to <project folder>/img/minimap/ (or just disable the overlay in the parameters).

- You also may want to set the last parameter (Debug Mode) to false to get rid of the console messages.

- For info on the plugin commands, doubleclick this plugin and press [Help...].

- To enable the debug grid you'll have to place the DebugGrid01.png in the <project folder>/img/minimap/ folder.

Script:

http://pastebin.com/sNYrQyB6

FAQ:

Q: My map sometimes automatically switches to Autofit-mode instead of Scroll-mode. Why?

A: When the map zoom is so small or when the minimap-area is simply so big that the entire map fits into the minimap anyway, then there is no reason to scroll at all because you can see the entire map w/o scrolling.

Q: The console is outputting debug messages? Help?

A: Set the parameter Debug Mode to false.

Q: Your screenshots do match the minimap entirely

A: Yeah that's my lazy fault. I often don't make new mapshots after changing the level and then I upload them here and they will mismatch. It will obviously not affectyour project at all.

 

[SilverDash]

Uploaded new version.

Updates:

- Supports skipping frames for all maps and for specific maps to increase performance for supersized maps.
- Added several map notetags (see plugin help for details)
- Optionally now maintains aspect ratio for odd-sized maps.
- Added an option to automatically delete POI's between map transfers.
- The minimap now properly fades out when the screen fades out.
- New plugin command: Minimap ReloadEvents
- Events are now drawn in realtime onto the minimap. Add the mm_show notetag to any event you'd like to be displayed onto the minimap and it will be displayed there including animations. So now you can display chests, torches, etc on the minimap with just a simple notetag.

 

[Iliketea]

Um, sounds and looks really great, but how can I download the plugin?

 

[SilverDash]

1. Copypaste the script and paste it in a file called SilvMinimap.js.

2. Now move that file to here: <project>/js/plugins/SilvMinimap.js

3. Press F10 in the RPG editor and add my script.

The same as all plugins.

 

[Iliketea]

Ok, did that. But I have trouble using it. 

I made a folder in img called minimap.

Put my png files called 001, 003, 004, and 011 in it.

Made a copy of my window skin and named it Window_Minimap, put it in img/system folder.

Made an ingame item called Map ( id 43).

Made a notetag in map 1 : <mm_req_itm: 43>.

It gives me this error:

This is the debug log:

Any idea what is wrong?

 

[SilverDash]

Thanks for the detailed report I replicated it on my first try. For some reason the variable req_item_ids contains ["", "43"]. It splits your trailing space into a new item_id.

Either replace:

<mm_req_itm: 43>

with

<mm_req_itm:43>

and it will work (remove trailing space before 43).

Or just download the new script because I just changed it to also accept trailing spaces now. No parameters were changed I only changed a  single line of code.

 

[SilverDash]

Massive update:
- Added the scrollmode (see image below for an example) on top of the Autofit Mode
http://s21.postimg.org/q1bx51tc7/mmsample3.png
- Changed and added a lot of parameters.
- Fixed the player, event and POI locations being slightly off. Man that was a hard one to fix, all that mathematics. This is what took me a whole day...
- Added a debugging tile for rendering the debug grid.
- Fixed: no longer displays a black-minimap when the sourcemap is smaller then the minimap itself.
- Implemented manual scrolling (U-H-J-K keys by default).
- There is a global-zoom parameter which can be overriden by each map through a map-notetag.
- Added an overlay.

- Script is now so big I had to paste it on PasteBin.

- Added TLDR instructions.

- More stuff I can't remember.

I did some thorough testing but the script is getting quite big now so if I missed some bugs please let me know and I'll fix them asap.

Sadly still haven't figured out how to fix "Walking on grass causes the player blip to become invisible." but aside from that the minimap could be considered fully completed now.

 

[SilverDash]

It has reached version 1.00. From now on for updates go here:

http://forums.rpgmakerweb.com/index.php?/topic/51307-silvers-advanced-minimap/