Welcome to PGMV! My goal is to make it easy for everyone to find and share great plugins for creating amazing games. As a plugin developer myself, I'm excited to grow this community with all of you.
FTKR Show Picture Balloon - FTKR_ShowPictureBalloon.js
Plugin desc : v1.0.0 Plugin that displays Balloon Icons on pictures
License : MIT License
Author : Futokoro
Desc page : https://github.com/munokura/futokoro-MV-plugins
Download Page : https://raw.githubusercontent.com/munokura/futokoro-MV-plugins/refs/heads/master/FTKR_ShowPictureBalloon.js
File name : FTKR_ShowPictureBalloon.js
Help of plugin :
@plugindesc v1.0.0 Plugin that displays Balloon Icons on pictures
@author Futokoro
@url https://github.com/munokura/futokoro-MV-plugins
@license MIT License
@help
English Help Translator: munokura
This is an unofficial English translation of the plugin help，
created to support global RPG Maker users.
Feedback is welcome to improve translation quality
(see: https://github.com/munokura/futokoro-MV-plugins ).
Original plugin by Futokoro.
Please check the URL below for the latest version of the plugin.
URL https://github.com/futokoro/RPGMaker
-----
-----------------------------------------------------------------------------
Overview
-----------------------------------------------------------------------------
You can display a Balloon Icon by specifying a picture.
If the picture and Balloon Icon overlap， the Balloon Icon will be displayed on top.
You can display it using the following plugin command.
*[] are not used for actual input.
SPB_ShowBalloonIcon [Picture ID] [BalloonIcon ID] [Display Position X] [Display Position Y] [Weight]
Picture ID
: Specifies the picture ID for which you want to display the Balloon Icon.
You can also specify a variable with ￥v[n].
BalloonIconID
: Specifies the Balloon Icon to display by number.
Counting is from the top of the image set as the Balloon Icon， 1， 2， 3， etc.
You can also specify a variable with ￥v[n].
If you are using the default Balloon.png， you can also use the following string.
1 - Surprise
2 - Question Mark
3 - Musical Note
4 - Heart
5 - Angry
6 - Sweat
7 - Crumpled
8 - Silence
9 - Sweat
10 - Zzz
11 ~ 15 - The User-Defined 1 ~ The User-Defined 5
*The User-defined numbers are half-width characters.
Display Position X
Display Position Y
: Specifies the position of the Balloon Icon relative to the picture.
Specifies the percentage of the picture size.
The upper left corner of the picture is the origin.
Input Example)
x y
0 0 - Display at the origin
0.5 0.5 - Display at the center of the picture
1 1 - Display at the bottom right corner of the picture
1 0 - Display at the top right corner of the picture
Wait
: Specifies whether to wait until completion.
If you want to wait， enter true.
If you do not want to wait， leave this blank.
Command Setting Example: When using the default icon image
◆Plugin Command: SPB_ShowBalloonIcon 1 Surprise 0.5 0 true
Displays a surprise icon in the top center of the picture for picture ID 1.
A wait will occur until completion.
Command Setting Example: When using a custom icon image
◆Plugin Command: SPB_ShowBalloonIcon 1 2 0.5 0
Displays the second column icon in the top center of the picture for picture ID 1.
Since there is no wait， the next Event's Contents will be executed immediately.
-----------------------------------------------------------------------------
Setup Method
-----------------------------------------------------------------------------
1. Add this plugin to the "Plugin Manager."
-----------------------------------------------------------------------------
Balloon Icon Settings
-----------------------------------------------------------------------------
You can change the following settings using the plugin parameters.
1. Image to Use
iconImage
: Select the image to use.
Image files should be saved in the img/system folder.
Icon sizes are free， but please adhere to the following specifications.
1) Arrange each Balloon Icon in a single horizontal row.
2) Use a consistent icon size.
3) The number of icon animations is the default， eight.
2. Size
width
: Sets the width of one Balloon Icon.
If you have created a custom， larger icon， change this to match its size.
height
: Sets the height of one Balloon Icon.
If you have created a custom， larger icon， change this to match its size.
3. Display Time per Frame
speed
: Sets the display time for one Balloon Icon frame.
4. Wait Time After Display
waitTime
: Sets the wait time after the Balloon Icon is displayed.
-----------------------------------------------------------------------------
License for this plugin
-----------------------------------------------------------------------------
This plugin is released under the MIT License.
Copyright (c) 2018 Futokoro
http://opensource.org/licenses/mit-license.php
Plugin source
https://github.com/futokoro/RPGMaker/blob/master/README.md
-----------------------------------------------------------------------------
Change History
-----------------------------------------------------------------------------
v1.0.0 - 2018/03/25: First version created
-----------------------------------------------------------------------------
@param フキダシアイコン設定
@text Balloon Icon settings
@desc Balloon Icon set.
@default {"iconImage":"Balloon"，"width":"48"，"height":"48"，"speed":"8"，"waitTime":"12"}
@type struct<balloon>