Iavra Minimap

じ☆ve冰风

Description


        Creates a minimap based on either supplied pictures or generated from terrain tags.


Author


        Iavra


Parameters


@param Switch
@desc Optional switch, that needs to be set to ON for the map to be active.
@default

@param Notetag
@desc Notetag used to mark maps, events and actors that should show up on the minimap.
@default minimap

@param Frame
@desc X, Y, width and height of the minimap. Negative coordinates start at the right/bottom of the screen.
@default 10, 10, 200, 200

@param Tile Size
@desc Size of a single tile on generated maps. Odd numbers might lead to graphical glitches. Minimum: 2
@default 10

@param Terrain Colors
@desc Comma-separated list of <terrainTag>:<color> pairs. Colors are specified in hex format.
@default 0:#FFF

@param Background Color
@desc Color to be used for the minimap background, in hex format.
@default #FFF

@param Background Opacity
@desc Opacity to be used for the minimap background. 0 is fully transparent, 1 is solid.
@default 0.3




Video










How to Use


        To enable the minimap for a specific map, put this tag inside the map's notebox (configurable):


<minimap>


        The plugin will then automatically create a minimap from terrain tags, using the colors provided via the plugin parameter "Terrain Colors". If you want to use a custom map, instead, modify the tag like this:


<minimap img:myImage>


        The given image will be loaded and automatically scaled to fit the tile size specified in "Tile Size", so please make sure it has the right dimensions or you might experience graphical glitches.



        To display the player icon on the map, put the following tag inside the notebox of an actor:


<minimap 1>


        This will cause the icon #1 to be displayed on the minimap, as long as that actor is the current leading player. Different icons can be specified for each actor, so the minimap always shows the correct one.


        To display an event on the map, put the following tag inside a comment:


<minimap 2>


        As long as that page is active, the icon #2 will be shown at that event's position. This can be used to create marker events displaying PoIs or the current quest target.

        The following script calls can be used to modify the map. Please note, that parameter changes are all temporary, unless another plugin stores them in a persistent manner:


IAVRA.MINIMAP.refresh();         
Refreshes the map image loaded or created for the current map.

IAVRA.MINIMAP.move(x, y);        
Repositions the map. Negative values are counted from the right/bottom edge.

IAVRA.MINIMAP.resize(w, h);      
Resizes the map. If needed, it's repositioned to fit against the screen edge.

IAVRA.MINIMAP.x = value;         
Repositions the map. Negative values are counted from the right edge.

IAVRA.MINIMAP.y = value;         
Repositions the map. Negative values are counted from the bottom edge.

IAVRA.MINIMAP.width = value;     
Resizes the map, updating its position if needed.

IAVRA.MINIMAP.height = value;   
Resized the map, updating its position if needed.

IAVRA.MINIMAP.center = value;   
Treates the given character as the new center of the minimap.

IAVRA.MINIMAP.zoom = value;      
Changes the zoom level (doesn't effect icons, only the map itself).

IAVRA.MINIMAP.opacity = value;   
Changes the overall opacity of the map. A value of 0 or lower will disable it.




Terms of Use


        Free to use for both commercial and non-commercial games. Please give credit.


Download


        Core: http://pastebin.com/z4Wy7MX4


        Menu: http://pastebin.com/d0kGBcUb


Latest Changes


        1.00 - Optimized the way events are handled, so the plugin will only create sprites for events, that are actually displayed on the map.


        1.01 - Updated the minimap for 1.3. The menu extension has been cut and will be added later as its own plugin.


        1.04 - Multiple bug fixes regarding map pictures and icon indizes.


本贴来自国际rpgmaker官方论坛作者:Iavra处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/iavra-minimap.51326/