LordAshes-IconsPlugin icon

IconsPlugin

Adds support for toggling up to 3 icons on the base. Icons are toggled from a GUI menu. Icons now scale with creature. Demo: https://youtu.be/0XN0IkVIXL4

Last updated 2 months ago
Total downloads 1099
Total rating 0 
Categories Tweaks Networked Tools Minis
Dependency string LordAshes-IconsPlugin-1.5.0
Dependants 1 other mod depends on this mod

This mod requires the following mods to function

bbepisTaleSpire-BepInExPack-5.4.10 icon
bbepisTaleSpire-BepInExPack

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.4.10
brcoding-SetInjectionFlagPlugin-2.3.0 icon
brcoding-SetInjectionFlagPlugin

Allows players to flag mods are installed

Preferred version: 2.3.0
LordAshes-StatMessagingPlugin-1.2.0 icon
LordAshes-StatMessagingPlugin

Adds support for JSON broadcast messages to clients, based on Creature Name synchronization. Use this plugin for any Character Name synchronization to ensure compatability with other plugins.

Preferred version: 1.2.0
LordAshes-FileAccessPlugin-1.2.3 icon
LordAshes-FileAccessPlugin

Provides standardized methods for accessing both local file and url resources. Automatically handles searching local folders for assets.

Preferred version: 1.2.3
HolloFox_TS-RadialUIPlugin-1.2.2 icon
HolloFox_TS-RadialUIPlugin

This is a developer tool based package used to help devs easily configure UI Radial Menus.

Preferred version: 1.2.2

README

Icons Plugin

This unofficial TaleSpire plugin is for toggling up to 3 icons on each mini's base. Icons are chosen from among multiple icons from a GUI menu.

Demo: https://youtu.be/0XN0IkVIXL4

Preview

Change Log

1.5.0: Icons are deleted when mini is deleted 1.5.0: Icons are available to GM and owner only 1.4.0: Corrected compatibility after TS update 1.3.1: Corrected ThunderStore dependencies (no plugin change) 1.3.0: Uses FileAccessPlugin so that icons do not need to be moved to the TaleSpire_CustomData folder anymore 1.2.3: Trying to get Thuderstore to display preview correctly 1.2.2: Trying to get Thuderstore to display preview correctly 1.2.1: Trying to get Thuderstore to display preview correctly 1.2.0: Added access to icons from radial menu using the Info main menu option and then the icons sub-menu option 1.2.0: Keyboard access uses full size line menu for icon selection. Radial menu uses radial sub-menu 1.1.0: Icons now scale with creature size 1.0.3: Fixed issue with moving the icons to a sub-folder 1.0.2: Plugin now appears on the TaleSpire main page 1.0.2: Moved icons to sub-folder to not conflict with Radial Menu icons 1.0.1: Fixed dependency requirement 1.0.0: Initial release

Install

Install using R2ModMan or similar.

Usage

Press the shortcut key to activate the Ioncs menu (Left CTRL + I by default but can be changed in R2ModMan) or use Info | Icons Radial Menu selection. This brings up the Icons menu in the middle of the screen or as a circle if using the Radial UI. Click an icon to toggle it. If that icon is not already present on the base, it will be added. If the icon was already present on the base, it will be removed.

Automatic Rotation

The positio of the icons is synchronized with the corresponding based in a gyroscopic way. When the mini sways diagonally when moving the icons will not sway keeping the icons level. In addition the icons automatically rotate so that they are always facing the user regardless of which direction the mini is facing or the direction that the camera is facing.

However, see Performance Modes below.

The Power Of Three

Up to three icons can be displayed on each base. However, the system will actually remember more and display one of the missing ones when a displayed icon is toggled off. However, practical uses should be limited to three icons so that all active icons can be seen.

Stealth Mode

The plugin synchronizes the icons with the mini's stealth mode.

Performance Modes

The plugin supports two plugin modes: Low Performance (default) and High Performance. The low performance mode has some limitations but it is less stressful on the CPU and thus ideal for lower power devices. The high performance mode overcomes the limitations of low performance mode but places a greater stress on the CPU and thus is ideal for more powerful devices.

The Performance Mode can be switched by going into the R2ModMan configuration for the Icons Plugin. Under the Settings section there should be a configuration for the performance setting.

Low Performanmce Mode

In this mode, only the selected mini is updated in terms of position and the rotation angle of the icons in relation to the user. In addition, any updates done by other clients are updated when the corresponding mini is dropped. This means it is possible to see the base and the icons separate for a short duration when a non-local user has started to move a mini but has not dropped it yet. Once the mini is dropped the icons will re-synchronize.

Since locally only the selected mini is being updated for icon angles, it is possible to rotate the screen so that the icons on other mini become hidden. However, as soon as any of these minis are selected their icons will turn to face the user.

Another limitation of this mode is that, since minis only update when they are selected, when the board loads with a mini that has icons, the mini needs to be pick up before the icons beome visible.

This mode performs a lot less work in the update cycle and thus is ideal for devices which are less powerful.

High Performanmce Mode

In this mode, all minis are constantly updated for position and rotation angle. Thus the icons on all minis face the user at all time regardless of which mini is selected and there is no delay in updated.

In this mode, the icons are auotmatically hidden when the mini enters stealth more and automatically displayed when the mini exits stealth mode.

However, this adds more complexity to the update cycle and this is more suitable for more powerful devices. It should be noted that clients can mix and match the performance mode and the plugin can handle this. Clients using the high performance mode will get those benefits while clients using the low performance mode will have the noted limitations.

Custom Icons

To add, remove or modify the available icons, place 64 pixels x 64 pixel PNG files into the following directory:

D:\Steam\steamapps\common\TaleSpire\TaleSpire_CustomData\Images\Icons

The icons must be 64 pixels wide by 64 pixles high in order to be properly displayed in the menu and scaled properly on the base. The file name should be short (typically single word) name that prepresents the icon. While the name does not appear anywhere visually it is used in the logs for trouble shooting purpose.

The files can make use of PNG alpha to make parts of the icon transparent or semi-transparent.

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2021-8-30 1.5.0 254 Version 1.5.0 Install
2021-8-27 1.4.0 60 Version 1.4.0 Install
2021-8-19 1.3.1 112 Version 1.3.1 Install
2021-7-21 1.3.0 239 Version 1.3.0 Install
2021-6-20 1.2.3 198 Version 1.2.3 Install
2021-6-20 1.2.2 20 Version 1.2.2 Install
2021-6-20 1.2.1 24 Version 1.2.1 Install
2021-6-20 1.2.0 23 Version 1.2.0 Install
2021-6-17 1.1.0 39 Version 1.1.0 Install
2021-6-17 1.0.3 34 Version 1.0.3 Install
2021-6-15 1.0.2 42 Version 1.0.2 Install
2021-6-10 1.0.1 29 Version 1.0.1 Install
2021-6-10 1.0.0 25 Version 1.0.0 Install