Kadajah's MiniMap - Radar + Dynamic Tracking

Stop forcing players to wander blindly. Make navigation a core part of your gameplay.

Are you tired of static, boring map overlay images in RPG Maker MZ? Kadajah MiniMap completely overhauls how players explore your world. This is not just a simple picture on the screen; it is a real-time tracking system that combines automatic passability detection, expanding radar waves, and intense visual corruption effects.

Give your players a tactical edge. Whether you need a sleek sci-fi circular radar with sonar pings, a glitching cyberpunk GPS, or a classic rectangular fantasy dungeon map, this plugin handles it all with zero image setup required.

v2.0 Update:

• Bounds Clamping: The minimap camera now intelligently stops at the map edges, preventing ugly black voids from showing on the edges of your maps.
• Radar Waves: Spawn expanding sonar pulses using the new SpawnWave command. Perfect for pings, alarms, or objective markers.
• Trigger Glitch: Corrupt the minimap visually! Add screen tearing, intense shaking, and digital artifacts for a set duration.
• Dynamic Visibility Overrides: You can now force show or hide specific events on the fly using the SetEventVisibility command without needing to change event pages.

Key Features

• Zero-Setup Terrain Generation: Automatically reads your map's tileset passability to draw walkable floors and walls. No need to manually draw minimap images!
• Shape & UI Control: Choose between a sleek Circle radar or a classic Rectangle map. Customize the X, Y, Width, Height, Zoom level, and Background Opacity directly in the parameters.
• Event & Enemy Tracking: Simply add an <enemyMap> comment to any event page to make them show up as a colored dot. Perfect for tracking roaming monsters or NPCs.
• Full Color Customization: Use Hex codes to define exactly what color your Walls, Floors, Player, and Enemies should be.
• Hardware Accelerated: Uses PIXI.Graphics for drawing, ensuring the map updates dynamically at a smooth 60FPS without eating up system memory.

Creative Gameplay Mechanics

• Horror Encounters: Use the TriggerGlitch command right before a jumpscare or when a stalker enemy enters the room. Watch the player panic as their reliable GPS violently shakes, flashes red, and fills with dead pixels.
• Stealth & Sound Systems: Use the SpawnWave command to simulate sound. When an alarm goes off or a bomb explodes, ping the minimap with a massive red sonar wave so the player knows exactly where the danger is.
• Dynamic Target Acquisition: Have an assassination or bounty hunting quest? Use the SetEventVisibility command to suddenly reveal the target's dot on the minimap only after the player hacks a terminal or reads a specific document.

Perfect Game Examples

• Horror Games: Essential for creating unease. Rip away the player's sense of safety by glitching the map or showing an enemy dot rapidly approaching from behind a wall.
• Sci-Fi / Cyberpunk: The circular radar shape, sonar waves, and digital visual glitches fit perfectly into futuristic HUDs and hacker themes.
• Stealth / Action: Give players the situational awareness they need to track enemy patrols and plan their routes.

Compatibility & Requirements

• Engine: RPG Maker MZ.
• Platforms: Windows, macOS, Linux, Web Browsers.
• Performance: Extremely lightweight. Uses dynamic PIXI drawing instead of loading massive image files into memory.

Technical Specs & Plugin Compatibility Built for performance. Powered by PIXI.js.

The Kadajah MiniMap plugin uses pure PIXI.Graphics to render the terrain and objects. It calculates the map in real-time, meaning moving events, changing tiles, and zoom scaling are handled efficiently.

• Modified Classes: The plugin safely extends the following core classes:
  • Scene_Map: Aliases createAllWindows, onMapLoaded, and update to inject the minimap UI layer.
  • Game_Event: Aliases initMembers and setupPage to cache the <enemyMap> tags and optimize performance so the map isn't constantly reading event note tags every frame.
• Plugin Suite Compatibility:
  • VisuStella MZ: Fully compatible. The minimap lives on the Scene_Map layer and will not interfere with VisuStella's core systems or battle engines.
  • MogHunter: Compatible. The map is drawn as an independent sprite, preventing overlap with Mog's Map HUDs (you can easily adjust the X/Y coordinates to fit perfectly alongside them).

Terms of Use

• Commercial and non-commercial projects: Allowed.
• Redistribution: You are NOT permitted to resell or redistribute this plugin (js file), either on its own or as part of a bundle.

Editing: You ARE permitted to edit the plugin's code (shaders/logic) for your own project's use. However, you are NOT permitted to redistribute the edited version of the plugin.