R-Stick Mouse MV + MZ

This plugin is available for free because it was commissioned by Phanicom. Thank you!

This plugin simulates mouse input (movement and left mouse button) using input from the right control-stick and a configurable button on gamepads.

By default, the player can adjust the speed of the virtual cursor and R-stick deadzone in the Options menu, in addition to the defaults set in this plugin's Parameters.

Drag-and-drop-style interactions are fully supported!

Before deploying for Linux on Windows, you must update MV's NW.js runtime.

Hints

If the controller pressing the "mouse button" is disconnected, the "click" effectively continues until changed. It can be released by reconnecting a controller without the button held into the same player slot, clicking the button on another controller, or simply by clicking the mouse.

This matches RPG Maker's default controller input behaviour.

Load Order

This plugin must be loaded after the following plugins, if present:

• Alpha_ABSZ
• DK_Mouse_System
• EliMZ_Book
• Mimosa_MouseCursor / Mimosa_MouseCursorPlus
• MRP_CameraMouseMove
• YEP_BattleEngineCore

This plugin must be loaded before the following plugins, if present:

• TS_Live_Menu_and_Pause

There appears to be a partial incompatibility between Mimosa_MouseCursor and DK_Mouse_System that can make the native mouse cursor appear erroneously. If this happens, please disable either of these two plugins or look for a compatibility patch.

Plugin Commands

PointAt (MV) / Point at (MZ)

Enables and moves the virtual cursor to the specified coordinates, potentially activating hover controls at the destination.

The PointAt command expects two integers for the x- and y-coordinate in canvas space, respectively, as offsets from the top-left canvas corner.
(Normally, these are game pixels.)

Save Contents

This plugin creates an additional top-level key TSC_RStick_Mouse in the configuration save file.

Compatibility Notes

This plugin should generally be loaded after any other plugins that receive mouse input. Additionally, as it hides/shows the native mouse cursor and a virtual cursor and there is no standard interface for this in RPG Maker, other cursor plugins likely won't be compatible unless specifically supported here.

(Check "Load Order" to see if a specific cursor plugin is compatible. If it's not listed there, or if there's another compatibility issue, you can message me and I'll see if it's an easy fix.)

This plugin was tested in RPG Maker MV 1.6.3 and RPG Maker MZ 1.8.0, uses only the public RPG Maker API as far as possible, and does not use any platform-specific APIs.

This plugin should be compatible with any deployment target available for RPG Maker MV and MZ, including web and most custom ones.

This plugin is compatible with VisuMZ_0_CoreEngine and VisuMZ_1_BattleCore.

License

This plugin is available under the MIT License. Please see the plugin file for details.