You are viewing a potentially older version of this package. View all versions.
HolloFox_TS-RadialUIPlugin-1.1.1 icon

RadialUIPlugin

This is a developer tool based package used to help devs easily configure UI. Currently configured for creatures and Hide Volumes.

Date uploaded 3 months ago
Version 1.1.1
Download link HolloFox_TS-RadialUIPlugin-1.1.1.zip
Downloads 43
Dependency string HolloFox_TS-RadialUIPlugin-1.1.1

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

README

Radial UI Plugin

This is a plugin for TaleSpire using BepInEx.

Install

Currently you need to either follow the build guide down below or use the R2ModMan.

Usage

This plugin is specifically for developers to easily implement extra Radial buttons based on a entity properties. Developers should reference the DLL for their own projects. This does not provide anything out of the box.

Example Usage

	void Awake()
        {

	    // Adds Callbacks to append new mapmenu item
            AddOnCharacter(Guid, new MapMenu.ItemArgs
            {
                Action = Action,
                Title = "On Character",
                CloseMenuOnActivate = true
            }); // Callback comparator is optional

            AddOnCanAttack(Guid, new MapMenu.ItemArgs
            {
                Action = Action,
                Title = "On Can Attack",
                CloseMenuOnActivate = true
            }, Check);

            AddOnCantAttack(Guid, new MapMenu.ItemArgs
            {
                Action = Action,
                Title = "On Cant Attack",
                CloseMenuOnActivate = true
            }, Check);

            AddOnHideVolume(Guid, new MapMenu.ItemArgs
            {
                Action = Action,
                Title = "On HideVolume",
                CloseMenuOnActivate = true
            }, Check2);
        }

        private Boolean Check(NGuid selectedCreature, NGuid creatureTargetedFromRadial)
        {
            Debug.Log($"{selectedCreature},{creatureTargetedFromRadial}");
            return true;
        }

        private Boolean Check2(HideVolumeItem args2)
        {
            Debug.Log($"{args2}");
            return true;
        }

        private void Action(MapMenuItem args, object args2) => Debug.Log($"{args},{args2}");

Loading a Sprite

Dimensions for sprites should be 32 by 32, Below is an example script supplied by LordAshes loading in an image to be used as an icon for the new Radial Component.

string dir = "path to directory";
Texture2D tex = new Texture2D(32, 32);
tex.LoadImage(System.IO.File.ReadAllBytes(dir + "Images/Icons/KO.Png"));
Sprite icon = Sprite.Create(tex, new Rect(0, 0, 32, 32), new Vector2(0.5f, 0.5f));

Submenus

	void Awake()
        {
		// Register Group Menus
            	RadialUIPlugin.AddOnHideVolume(
                    Guid + "Grouping",
                    new MapMenu.ItemArgs
                    {
                        Title = "Grouping",
                        Action = ShowGroupingSubmenu, // method to open submenu
                    }, Check
            	);
	}

	private static void ShowGroupingSubmenu(MapMenuItem item, object obj)
        {
	    // Creates a branch mapmenu and opens it.
            MapMenu mapMenu = MapMenuManager.OpenMenu(item, MapMenu.MenuType.BRANCH); // MenuType can be configured
            
	    // Append your new menu items
	    mapMenu.AddItem(new MapMenu.ItemArgs { /* ... */});
        }

How to Compile / Modify

Open RadialUIPlugin.sln in Visual Studio.

You will need to add references to:

* BepInEx.dll  (Download from the BepInEx project.)
* Bouncyrock.TaleSpire.Runtime (found in Steam\steamapps\common\TaleSpire\TaleSpire_Data\Managed)
* UnityEngine.dll
* UnityEngine.CoreModule.dll
* UnityEngine.InputLegacyModule.dll 
* UnityEngine.UI
* Unity.TextMeshPro

Build the project.

Browse to the newly created bin/Debug or bin/Release folders and copy the RadialUIPlugin.dll to Steam\steamapps\common\TaleSpire\BepInEx\plugins

Changelog

1.1.1: Add Docs on how to implement submenus 1.1.0: Removed Modding Utils and display on main menu 1.0.2: Fixed Issue on radial breaking upon leaving board 1.0.0: Initial release

Shoutouts

Shoutout to my Patreons on https://www.patreon.com/HolloFox recognising your mighty contribution to my caffeine addiciton:

  • John Fuller