Balloon 4.3.0

Cinematic mode

Balloon will auto hide the game UI during a cutscene and handle key/button presses to continue the dialogue.
If the game presents you with options during a cutscene, Balloon will temporarily re-show the game UI and hide it again once you've made a selection.

Cinematic mode is enabled by default.
If you want to turn it off, you can toggle the option using /balloon cinematic.

Thanks to atom0s for sharing some code that made this feature possible.

Balloon 4.2.2

• Fixes some theme backgrounds being clipped when in always_on_top mode.

Balloon 4.2.1

Fixes an issue introduced in 4.2.0 where the addon would crash if it tried to display a balloon during combat.

Balloon 4.2.0

• Fixed issue where dialogue on multiple lines moved left or right a tiny bit as each line appeared.
• Added always_on_top option (on by default) to render the final textures in an IMGUI window to ensure Balloon always appears in front of all other custom UI elements. If you have any problems with this you can switch back to the old rendering method using /balloon always_on_top but most people shouldn't notice any difference.
• Added in_combat option which is off by default and means Balloon won't open in combat. If you want Balloon to open during combat you can use /balloon in_combat.
• Some hyphen and punctuation fixes (thanks @Herschel).
• Fixed addon error that could occur when using additional_chat_modes (thanks @Herschel).

Balloon 4.1.0

• Fixed crash in tests (thanks Tavo5691).
• Removed filter setting added in 4.0.4 and replaced it with a new setting: additional_chat_modes. Most people shouldn't need to touch this but if you would like Balloon to display messages from other channels you can edit this in the settings file.
• Out of the box Balloon no longer displays messages from channel 142, which at least on HorizonXI was causing "other's fishing results" and "player obtained item" messages from appearing in a balloon.

Balloon 4.0.4

• Keyboard enter and controller will now dismiss balloon, similar to how the original Balloon addon works.
• Fixed random numbers from appearing at the end of lines due to some prompt characters not being correctly stripped from the message before being displayed.
• Fixed issue when no prompt characters exist and using hide log option causes ending characters to still be displayed.
• Added filter setting to optionally turn off a couple of chat modes from being processed by balloon. You need to edit this in the settings file. For people having issues with fishing results appearing in a balloon, I recommend for now setting settings['filter']['timed_battle'] = false .
• Update text_speed param to speed in help (@Herschel).

Balloon 4.0.3

• Fixed an addon crash when NPC text contains only "...".
• Fixed some clipping issues which could occur in some cases.

Balloon 4.0.2

Fixes an issue with addon not initialising if reloaded.

Balloon 4.0.1

Fixes error unable to load module in gdifonts when loading gdifonttexture.dll.
Thanks to Thorny for helping to spot the problem and to Arxief and Rockmizx for reporting the error.

Balloon 4.0

This is an Ashita v4 port of the Balloon addon, forked from StarlitGhost's version.

The original Windower Balloon addon was created by Hando and modified by Kenshi, Yuki and Ghosty.

This Ashita v4 port was created by onimitch.

How to install:

1. Download the latest Release from the Releases page
2. Extract the balloon folder to your Ashita4/addons folder

How to enable it in-game:

1. Login to your character in FFXI
2. Type /addon load balloon

How to have Ashita load it automatically:

1. Go to your Ashita v4 folder
2. Open the file Ashita4/scripts/default.txt
3. Add /addon load balloon to the list of addons to load under "Load Plugins and Addons"

Commands

You can use /balloon or /bl

/balloon 0 - Hide balloon & display npc text in game log window.

/balloon 1 - Show balloon & hide npc text from game log window.

/balloon 2 - Show balloon & display npc text in game log window.

/balloon reset - Reset all settings back to default.

/balloon theme <theme> - Switch theme (see below for info on Themes).

/balloon scale <scale> - Scales the size of the balloon by a decimal (eg: 1.5).

/balloon delay <seconds> - Delay before closing promptless balloons.

/balloon text_speed <chars per second> - Speed that text is displayed, in characters per second. Set to 0 to disable.

/balloon portrait - Toggle the display of character portraits, if the theme has settings for them.

/balloon move_closes - Toggle balloon auto-close on player movement.

/balloon test <name> <lang> <mode> - Display a test bubble. Lang: "-" (auto), "en" or "ja". Mode: 1 (dialogue), 2 (system).

/balloon test - List all available tests.

Themes

There are currently four themes bundled with the addon.

default

ffvii-r

Requires "Libre Franklin Medium" or "Libre Franklin Regular" font, which you can get free from Google Fonts. Install the font in Windows.

ffxi

snes-ff

Uses "DotGothic16" font, which you can get free from Google Fonts. Install the font in Windows.

Alternatively it will look for "DePixel" font if "DotGothic16" not installed, which you can get free from Be Fonts.

Theme customisation

If you want to customise a theme, copy one of the existing themes from addons/balloon/themes into config/addons/balloon/themes.

Example: config/addons/balloon/themes/my_theme.

In game switch to your new theme: /balloon theme my_theme.

Edit the theme.xml file as you wish, or replace the pngs with alternatives. Sorry there isn't any more help on this for now but hopefully the existing themes are enough to figure out how it works.

Reload the theme by using: /balloon theme my_theme.

See your changes immediately by using one of the test prompts:

e.g: /balloon test bahamut or /balloon test colors.

Issues/Support

I only have limited time available to offer support, but if you have a problem, have discovered a bug or want to request a feature, please create an issue on GitHub.

Gdifonts

This addon uses a custom fork of ThornyXI's gdifonts and gdifonttextures, in order to support colored regions and clipping:

https://github.com/onimitch/gdifonts/tree/regions

https://github.com/onimitch/gdifonttexture/tree/regions