Call and Store Boats with an Item

BoatManager.js – Call and Store Boats with an Item

BoatManager is a plugin for RPG Maker MV/MZ that allows the player to summon and retrieve a boat using an item, only on valid water tiles.

This plugin is perfect for games with exploration, fishing, or travel mechanics where you want to give players control over when and where to use their boat.

Features

• Call the boat using an item (e.g., “Boat”).

• Only allows the boat to be summoned:

  • If it's not already in use.

  • If the player is facing water with the correct terrain tag.

  • If there’s space to spawn the boat.

• Automatically stores the boat back to a safe location.

• Works with Common Events, which you can customize.

• Includes plugin commands for calling, retrieving, and checking the boat.

How It Works

1. Create an item called Boat, and give it a Common Event.

2. The Common Event must:

   • Get the player position and facing direction.

   • Add/subtract 1 tile depending on the direction.

   • Place the boat in that adjacent tile.

   • Turn on a switch (e.g., usarBarco) to mark the boat as active.

 Example Common Event (Text Version)

Here’s what the common event chamarBarco is doing:

plaintext
CopiarEditar
◆Control Variables:     #0001 position = Map ID     #0002 playerX = Player X     #0003 playerY = Player Y     #0026 direcao = Direction of Player  ◆If: direcao == 2 (Down)     → #0003 playerY += 1   Else If: direcao == 4 (Left)     → #0002 playerX -= 1   Else If: direcao == 6 (Right)     → #0002 playerX += 1   Else (Up)     → #0003 playerY -= 1  ◆Set Vehicle Location: Boat → {position}, {playerX}, {playerY} ◆Control Switch: #0041 usarBarco = ON 

This ensures the boat is always spawned in front of the player, wherever they are looking — but only if it's water (handled by the plugin's validation).

 Plugin Commands

You can use the following plugin commands in events:

• BoatManager call
  ➤ Calls the boat in front of the player if conditions are met.

• BoatManager retrieve
  ➤ Retrieves the boat and moves it to a "storage" location on a different map.

• BoatManager check
  ➤ Displays a message saying whether the boat is in use or not.

 Notes

After the first use, the boat needs to be sent to another place in the map.
(Correct English version):
"After the first use, the boat is stored in another map location until called again."

You can easily change this logic depending on your game needs.

 Installation

1. Download and place BoatManager.js in your plugin folder.

2. Add it in the plugin manager.

3. Set the parameters:

   • Boat Item ID = ID of the item (e.g., Boat)

   • Stored Map ID / X / Y = Where to store the boat when retrieved

   • Switch ID = Controls whether the boat is currently out

   • Water Terrain Tag = Tiles where the boat can be called