NPC Dialogue Speech Bubble

Version: v4.0

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.

New in v4.0

✨ New Feature: Character Dialogues (CharacterDialogue)

We are excited to introduce the **CharacterDialogue** feature, which allows you to add character dialogues that appear on the right side of the screen. This enhancement enables the creation of deeper and more interactive scenes without slowing down the gameplay.

Key Features of CharacterDialogue:

• Dialogues Displayed on the Right: Character dialogues neatly appear on the right side of the screen, ensuring they do not interfere with the main gameplay.
• Customizable Appearance: Change the text color, font size, and the background of dialogue windows to match your game's aesthetic.
• Character Face Images: Include images of character faces for more expressive dialogues.
• Sound Effects: Add sound effects for dialogue appearances to enhance the atmosphere.
• Parallel Operation: All dialogues run concurrently with the game process, ensuring smooth gameplay without any lag.

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.

Configure CharacterDialogues:

1. Open the event editor in RPG Maker MZ.
2. Add the Character Dialogue command from the list of available plugin commands.
3. Configure the dialogue parameters, including the character face image, text, duration, and sound effects.

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.

What's New in v4.0

In addition to all existing features, version 4.0 introduces the CharacterDialogue functionality, enhancing your ability to create engaging and dynamic character interactions. Upgrade to enjoy a more versatile dialogue system that seamlessly integrates with your game's flow.