[V9.1] [INTERNATIONAL] [Miqui] CustomizableActorDecorators + PhantasmDecorator

[Miquiqui]

Supported TurboHUD version: 9.1

This plugin allows you to somewhat simply create dynamic (or not dynamic too) actor decorators. It is meant as a way for other plugin developers to plug into and add decorators that can evolve as things happen within the game.
For example: a circle around WDs phantasm that turns red for the last 2 seconds before the explosion, so that you know you need to get the elites in quickly if you want them to take damage.
An InnerSanctuary that changes color when you're inside... Etc.

Downloads:
- CustomizableActorDecoratorsPlugin.cs
- IActorDecorator.cs

Installation: Put the files in /plugins/Miqui/CustomizableActorDecorators/

How to use:
- Create a new plugin that extends ICustomizer
- Add the namespace Turbo.Plugins.Miqui.CustomizableActorDecorators
- Create a class that implements IActorDecorator
-> This interface only has one function

WorldDecoratorCollection getActorDecorator(IController hud, IActor actor);  

-> It should return whatever decorator you want to be using for the actor. You have access to the IController value, so you can calculate things like player positions, mob positions, timings....
-> Note that C# does not support Anonymous Innerclasses (wtf ?) so you have to declare full-on classes even for such a simple interface...
- Find which ActorSnoEnum you want to decorate (in game, you can press F11 and cast the skill to get its name, you can then find it in the Actor.cs class
- In the Customize function Run on plugin AddDecorator with the ActorSnoEnum you choose and the IActorDecorator you decided

public void Customize()
        {
            Hud.RunOnPlugin<CustomizableActorDecoratorsPlugin>(plugin => 
            {
                plugin.AddDecorator(ActorSnoEnum.ACTOR_YOU_CHOOSE, YOUR_DECORATOR); // First one
                plugin.AddDecorator(ActorSnoEnum.ANOTHER_ACTOR_(CAN_BE_THE_SAME), ANOTHER_DECORATOR); // Can add as many as you want
            });
        }  

There is not limit to how many decorators you can add per actor, except the number of item you can fit in a C# List (wouldn't try it).
You can also create as many customizer plugins as you want, I personnaly do one per skill.

Note: The content of your IActorDecorator is not called if no actor with the right ActorSnoEnum is in range, however if one is in range, it will be called once per tick so try not to make it too computing heavy. For example, I would advise creating your WorldDecoratorCollection's in the Constructor of your IActorDecorator and never during the getActorDecorator(..) phase, and simply using logic to return the right one at the right time.

As an example, here is my own wd Phantasm plugin, it shows a dashed outline for the explosion radius until 2 seconds before the explosion, where it becomes solid.
Screenshot
Download:
- PhantasmDecoratorCustomizer.cs

Installation: Install the two .cs files mentionned at the start (obviously... ^^), then add this file in /plugins/Miqui/
That's it.

If there is any C# coding style I did not respect... sorry not sorry. I come from a pure java background and it was already hard enough not use keep the { on the same line as the function declaration. I might have missed a couple but couldn't be bothered.
This is quite over-engineered but I had fun doing it, so I thought I might as well share it if someone ever needs it.

@Jack if you ever come around here, would it be possible to make VSC auto format code on save when using your intellisense thingy ?

[takayo72]

Could barb able to see it ?

[Miquiqui]

The Phantasm plugin I assume ? Yes.

[rogue00722]

Can I make it a different color of skill when I add it?

[Miquiqui]

You can edit the PhantasmDecoratorCustomizer if you want to change the colors of the circles.
It's fairly simple, every time you see hud.Render.CreateBrush(A, R, G, B, W) (for example : hud.Render.CreateBrush(100, 130, 213, 255, 10), line 17), the A is the opacity of the brush, R is how much red in the circle color, G green, B blue, and W is the width (how fat the line should be)
In a WorldDecoratorCollection, the first brush is the circle color, and the last is the cooldown color. So let's say you want a red brush, you would change line 17 to hud.Render.CreateBrush(100, 255, 0, 0, 10),.

You can google color picker to get an easy to use color picker and choose your r, g, b colors you want for your circle.
As far as which is which, MainSpiritBarrageCircle is the small circle. Solid/DashedExplosionSpiritBarrageCircle is the bigger circle for the explosion.

[rogue00722]

Thank you for your help always.