XivParty - Party List Addon For Windower 4

Hello everyone!

XivParty is a party list replacement inspired by the Final Fantasy XIV user interface. I created this, because healing a party meant staring at a tiny box at the bottom right of the screen, especially on 1440p and higher resolutions. It is mostly useful for healers and support jobs to have a good overview of the party, or in general if you like pretty UIs. :3



Installation

• Download the latest release and extract it to Windower4/addons

• Load using "//lua load xivparty" in the chat window

• To load the addon automatically when the game starts, edit Windower4/scripts/init.txt and add "lua load xivparty" at the end

• RECOMMENDED: Download and install the free font "Grammara" for a more authentic FF14 look of the numbers. Right click the downloaded TTF file and select "Install". Restart Windower afterwards, or it won't find the newly installed font.

Commands
The full list of commands can be found in the readme on GitHub or by typing "//xp help".

Layouts
Change the appearance of the UI by switching between layouts (skins) using the "layout" command. For example: "//xp layout ffxi". The following is a list of all currently available layouts that come with the addon.

• xiv - The default layout in the style of FFXIV with some tweaks.

• xiv2 - Closer to the original FFXIV party list. No TP bar, no MP or names in alliance.

• ffxi - A variant of the default skin with an FFXI background and colors.

• ffxi2 - Similar to the original FFXI party list. Buffs extend to the left. Can be used to cover the original UI if you toggle "//xp alignbottom" on.

Setup Mode
You can position and scale the UI in-game using drag & drop and the mouse wheel. Use the command "//xp setup" to toggle on the setup mode which displays a full alliance of fake party members. This mode is also useful to test out custom layouts you are creating!



Range Indication
The distance to party members is indicated by dimming their HP bars in two stages: out of standard casting range (~20.8) and out of targeting range (50).

There is also a customizable range indicator useful when casting aoe buffs. Set a near and an optional far distance with the "range" command. A filled icon (near) or a hollow icon (far) will appear below the HP bar of any party member in range. The main player will always have the icon displayed when the feature is active. Set the range to "off" or "0" to disable.

Buff Filters
When the UI gets too cluttered with buff icons, you can set filters to only show or hide certain buffs. Use the command "filter add [ID]" to add a buff to the filter list. The buff IDs can be found in bufforder.lua or in-game using the "buffs" command, which shows the current buff IDs of a party member. The filter list works in "blacklist" mode by default, meaning any added buffs are hidden. You can switch the mode to "whitelist" to only display buffs that are on the filter list instead. Filters can also be set up separately for each job, see below for details.

Custom Buff Order
By default buffs are sorted debuffs first, then buffs by various categories. This can be disabled to revert back to the game's original order, which is sometimes random and based on when the buff was added to the game.

You can customize the sorting order by editing the file bufforder.lua. Just reorder the lines of the list. Do not change the IDs. The name strings are not used by the addon and are only there for readability. Save the file as UTF-8 without BOM or ANSI (however this will destroy the Japanese translations).

Job Specific Settings
Can be toggled separately for each job using the "job" command. While on a job with enabled job specific settings, the following commands will only affect the settings of that job: range, filter, customOrder. Switching jobs will automatically apply a job's specific settings, or the global settings when none present or disabled.

Hiding the UI
The UI can be automatically hidden in certain situations: while you are not in a party (solo) or during cutscenes. This behavior can be configured using in-game commands. The UI is always hidden while zoning.

In addition, you can hold down the "End" key on your keyboard to temporarily hide the UI. This can be useful while reading the expanded chat log, currently there is no way to detect the expanded log to hide automatically. This hotkey can be changed to any other key by manually setting the "hideKeyCode" parameter in your data/settings.xml to the desired DirectInput key code.

Creating Custom Layouts
Layouts consist of XML files in the XivParty/layouts directory and image files in XivParty/assets. Values defining positions, sizes, image paths, fonts and colors of various UI elements can be set in the XML files, so editing the LUA files should not be necessary to customize the look of the UI.

For more details on creating layouts, check out the readme on GitHub.


Credits and thanks to SirEdeonX whose xivbar addon I used as a base for an early prototype, KenshiDRK for the buffs code and icons and the Windower team!