NPC Dialogue Speech Bubble

Version: v3.1

Author: ToshAngel

Overview

NPC Dialogue Speech Bubble is a powerful plugin for RPG Maker MZ that enables developers to display customizable speech bubbles above NPCs (Non-Player Characters) on the game map. With extensive customization options for appearance and behavior, you can create a more immersive and interactive dialogue system in your game.

Key Features

Customizable Appearance:

• Text: Define message content with support for line breaks.
• Text Color: Choose text colors using HEX codes.
• Font Size: Adjust the size of the message text.
• Background Image: Utilize custom images for the speech bubble background.
• Arrow Image: Customize the tail of the speech bubble with specific images.
• Opacity Settings: Control the transparency of both the message window and the arrow.

Message Behavior:

• Display Duration: Specify how long a message is visible (in frames; 60 frames = 1 second).
• Activation Distance: Set the distance in tiles at which the message activates.
• Repeat Modes:
  • never: Show the message only once.
  • onMapReload: Repeat the message each time the player re-enters the map.
  • onApproach: Display the message every time the player enters the activation zone.

Advanced Functionality:

• Random Messages: Display one random message from a predefined list.
• Delays Between Messages: Insert pauses between consecutive messages.
• Variable and Switch Manipulation: Modify game variables and switches after displaying messages.
• Local Switches: Change local switches for specific events, even across different maps.

How to Use

Install the Plugin:

1. Download the ToshA_NPCDialogue.js file.
2. Place it in the js/plugins folder of your RPG Maker MZ project.
3. Enable the plugin via the Plugin Manager in RPG Maker MZ.

Configure Messages:

1. Open the event on the map where you want to add a message.
2. In the "Comments" section, add <msg> tags and other related tags (<var>, <switch>, <lswitch>) to define the message's behavior and appearance.

Usage Examples:

<msg id=1 text="Hello, traveler!" time=120 distance=2 repeat="onApproach" fontSize=18 textColor="#FFFFFF">
        

<msg id=2 rand="How are you?|Nice to see you!|Long time no see!" time=150 distance=3 repeat="never" fontSize=16 textColor="#00FF00">
<msg time=60>
<var id=5 value=10>
        

<msg id=3 text="This is a secret message." time=180 distance=2 repeat="onMapReload" fontSize=20 textColor="#FF00FF">
<switch id=7 value=true>
<lswitch eventId=4 switchId=B value=false mapId=10>
        

Plugin Settings

Configure default parameters such as message display time, activation distance, repeat mode, font size, text color, background and arrow images, as well as their opacity and offset through the Plugin Manager in RPG Maker MZ.

Compatibility

Compatible with: RPG Maker MZ

Other Plugins: Not tested with other plugins. It is recommended to verify compatibility when using multiple plugins.