[CGMZ][Alpha] Dungeon Tools for RPG Maker MZ

Hi all,

This plugin adds reset, arrow, bomb, boomerang, hookshot, interact, and lantern tools to your game. You can optionally have tools require items in the inventory, and consume those items on use.

Reset tool: This tool will "reset" the current map the player is in. It accomplishes this by 1) saving the coordinates the player entered the map and teleporting them to those coordinates when the tool is used, and 2) manipulating the self-switches of events set up to interact with the tool.

Arrow tool: This tool will shoot an arrow in the direction the player is currently facing which will travel for the configurable range number of tiles, or until it collides with either an impassable part of the map or an event. If it collides with an event, it will check and see if that event is interactable with the arrow, and if so, it will manipulate the self-switches of that event. It can move through otherwise impassable map tiles if they are painted with the passable region ID.

Bomb tool: This tool will set a bomb down at the player's current location which will explode after a certain amount of steps taken by the player. Events nearby that are hit by the explosion will be checked to determine if any of their self-switches should be manipulated.

Boomerang tool: This tool will shoot a boomerang in the direction the player is currently facing which will travel for the configurable range number of tiles, or until it collides with either an impassable part of the map or an event where it will then return to the player. It can move through otherwise impassable map tiles if they are painted with the passable region ID. When passing over an event, it will check if the event can be "picked up" by the boomerang as well as if the event should have its self-switches manipulated by the boomerang. The boomerang can pick up an unlimited number of events. Since the boomerang returns to the player, the player cannot move while this tool is active.

Hookshot tool: This tool will shoot a hookshot in the direction the player is currently facing, which will travel for the configurable range number of tiles, or until it collides with an impassable part of the map or an event. If the event it collides with is tagged as interactable with the hookshot tag, it will pull the player to the event rather than returning to the player. Since the hookshot returns to the player (or pulls the player to the hookshot), the player cannot move while this tool is active.

Interact tool: This tool will simply interact with the event(s) in front of the player. Something like a pickaxe or axe to cut through a stone or tree that might be blocking the player's path.

Lantern tool: This tool will show a [CGMZ] Light Effect around the player. When the player moves near an event that interacts with this tool, it will have its self switches turned ON. When the player moves away, the self switches will turn back off. You can use this to create hidden events, hidden floors over pits, and many other uses.

There is some eventing necessary to get these tools to interact with the correct events, so I have also included a demo project which shows one approach to making them function in dungeons. You don't have to do it how I do with self-switches, I just prefer that to avoid using global switches whenever possible. You can get image resources for the tools from the attached demo as well.

This plugin supports both keyboard and gamepad inputs to use and select the tools. You can also assign a key or gamepad button to cycle to the next tool without needing to open the select tool menu. Touch UI is also supported with a button to use, select, and cycle tools.

INTEGRATIONS

[CGMZ] Light Effects - To optionally show a light effect around the player while they use a lantern tool.

[CGMZ] Event Movement - To stun events with the arrow, boomerang, or hookshot tools.

[CGMZ] Scene Backgrounds - To customize the background image of the tool select scene, including scrolling backgrounds.

[CGMZ] Controls Window - To show a window that tells the player keyboard or gamepad controls for using the tool select window, based on their last input type.

Want additional features not already present/listed above? Make suggestions on the Patreon Post, this Itch.io page, or in my discord under the #suggestions channel!

PLEASE READ BEFORE PURCHASING:

Please be aware that you can access this as well as all of my other Alpha plugins for $5 on my Patreon: https://www.patreon.com/CasperGamingRPGM

This is posted to Itch.io since some people only use Itch and are not aware my Patreon and all of my beta/alpha plugins exist, or want to have everything in one convenient location (itch.io), or do not want to do a monthly subscription.

Casper Gaming's Beta/Alpha plugins are treated as an "early access" and will eventually be free for everyone once they are fully released, though this process can take months/years. By purchasing in beta/alpha, you are able to provide early feedback/suggestions which are more likely to make it into the final fully released plugin.

Please see terms of use here: Terms of Use

Requires CGMZ Core plugin: CGMZ Core

Happy RPG Making!

CGMZ_Temp.prototype.updateLastGamepad = function(gamepad) {
   alias_CGMZ_DungeonTools_Temp_updateLastGamepad.call(this, gamepad);
   console.log(gamepad);
   this.updateDungeonToolsForGamepad(gamepad);
};