Map Controls Plugin

Map Controls 1.10
Author: Michael Morris @Blue Booth Studios
Engine: RPGMaker MV
Language: JavaScript
Links: RPGMakerWeb Plugin Release Post
MV Plugins Entry

Let’s face it. You’ve got your really cool mini-game ideas, and you can’t wait to put them together. The last thing you want to bother with is making all the buttons and input methods work correctly. To be used with map interface elements or mini-games, this creates a series of sprite buttons on screen that will respond to keyboard, mouse, and touch. Very flexible, can be used to create any mini-game of your choosing. First created to replace static arrow pictures for BBS_WorldMap.js.

  • Adds full multi-touch support to RPGMaker MV.
  • Adds swipe gesture support to RPGMaker MV.
  • Fully customizable map controls (ie. Zelda) / minigame controls.
  • Up to eight controls on screen – four DPad buttons and four action buttons (ok, cancel, menu, other). Any combination of these eight controls can be used.
  • Simple script call can be made to check whether a button has been pressed in standard conditionals: ie. “If SceneManager._scene.isPressed(‘ok’);”
  • Simple script call can be made to check whether a button is enabled via standard conditionals: ie. “If SceneManager._scene.isButtonEnabled(‘ok’);”
  • New isPressed() will check for keyboard, mouse, AND touch input on a given button, which means that map controls now only need to check one function to determine input.
  • Each button can be set to a specific x, y, or set to center around the player (particularly for DPad buttons). Buttons will automatically follow player if centered.
  • Opacity fade-in/out buttons when dialogue boxes are open. Faded out buttons are automatically disabled.
  • Button sprite sheet with support for separate graphics for hot, cold, and disabled frames.
  • Plugin Command can be used to completely block all default touch input processing.
  • Plugin Commands to show/hide active GUI elements, and to disable all GUI elements through one call.
  • Buttons will only display once completely loaded and ready (no more flickers of bad positions / hidden buttons etc.).
  • Buttons can be enabled/disabled/faded through plugin command.

How to Use
  1. Download or copy script into your game js/plugins directory.
  2. Import script into your project.
  3. Call script plugin commands within your own events or plugins.

  1. BBS_MultiTouch Plugin

Demo: MC
Script: BBS_MapControls.js

Credit and Thanks
  • Micheal Morris @Blue Booth Studios
  • Credit to Tsukihime and all of those who have been supportive of my scripts and put up with my incessant barrage of questions.
  • Credits to Kenney for the Open Source game art used for buttons in the demo.
  • Kenney for the open-source art assets used for button images.
  • Masked – MBS – Mobile DirPad & Action Button, which serves as basis for some of the button functionality.
  • Jairajs89 – Touchy.js, which serves as basis for some multi-touch functionality.
  • Ramza, Lakaroth and friends for all their help testing multi-touch.

Known Bugs
  • None known.

Terms of Use
Contact us

Free for non-commercial usage of script as long as credit is given.

Please contact us for details.

Leave a comment