-- UO UNICODE ANIMATOR --
-- AUTHOR: PanThar
-- SCRIPT EXPLANATION --
The UO Unicode Animator script allows you to create your own ASCII-like effects, or enhance already existing effect, with some limitations.
Firstly, these effects are 100% purely textual, so they could be used for short animations, or enhancing effects of spells and things.
LIMITATIONS:
1.)Each frame of a animation must have the same number of rows.
2.)Each time a player sees an animation, it will show up in their journal. (who needs journal anyways?)
3.)UO has no monospaced fonts, as a result, your going to have to be creative in spacing the characters in an animation.
4.)I would not run this over 5 frames per second.
5.)Each "frame" of the animation can only be 1 color.
6.)Only been tested on 2d UO client at time of writing, have no idea how other clients will behave.
7.)You are limited by around 30 character width for each row.
INSTALL:
1.)Unzip this package to /scripts/UnicodeAnimator/
2.)Restart runUO, login as admin
3.)Type [add UnicodeAnimatorItem
4.)Double click on the item, and you should see a series of 5 frames of an animation be displayed around the item.
TUTORIAL, ADD EXTRA SPELL EFFECT WITH UNICODE ANIMATIOR:
1.)Open up /scripts/spells/first/MagicArrow.cs
2.)Find the line
source.MovingParticles( m, 0x36E4, 5, 0, false, false, 3006, 0, 0 );
And just below this line add:
UnicodeAnimator.PlayAnimationOnMobile(SparkleAnimation.GetAnimationSequence(), SparkleAnimation.GetAnimationHues(),m,4);
Now when you cast magic arrow, it should create an extra animation effect on the target, at ~4 frames per second.
TUTORIAL CREATE YOUR OWN EFFECTS
1.)Open /scripts/UnicodeAnimator/SparkleAnimations.cs
2.)Save as, YourAnimation.cs
3.)Find/replace all instances of "SparkleAnimations" with "YourAnimation"
4,)This file has two functions. The first function is GetAnimationSequence(), and this function just returns all the frames of your animation as a List.
The second function GetAnimationSequenceHues() returns the hue for each item. This is required to have the same number of entries as there are animation frames.
5.)Edit your effect/colors, remember, this is unicode, and not monospace, so you willl have to toy with, since the fonts are not evenly spaced.
6.)Now, instead of using the SparkleAnimation we used above for magic arrow, we can use our new effect, with our new hues, like so:
UnicodeAnimator.PlayAnimationOnMobile(YourAnimation.GetAnimationSequence(), YourAnimation.GetAnimationHues(),m,4);
On the other hand, if you don't want the effect to follow a mobile, and you just want it to effect one location, you can use
UnicodeAnimator.PlayAnimationOnLocation(YourAnimation.GetAnimationSequence(), YourAnimation.GetAnimationHues(),m.Location, m.Map,4);
Basically, this will create a stationary animation, on m.Location and m.Map, but that can be any location or map of you chosing.
TODO:
If anyone knows of a way to deal with the fact UO does not have monospaced fonts, let me know! That was the hardest part.
Best of Luck!
-- AUTHOR: PanThar
-- SCRIPT EXPLANATION --
The UO Unicode Animator script allows you to create your own ASCII-like effects, or enhance already existing effect, with some limitations.
Firstly, these effects are 100% purely textual, so they could be used for short animations, or enhancing effects of spells and things.
LIMITATIONS:
1.)Each frame of a animation must have the same number of rows.
2.)Each time a player sees an animation, it will show up in their journal. (who needs journal anyways?)
3.)UO has no monospaced fonts, as a result, your going to have to be creative in spacing the characters in an animation.
4.)I would not run this over 5 frames per second.
5.)Each "frame" of the animation can only be 1 color.
6.)Only been tested on 2d UO client at time of writing, have no idea how other clients will behave.
7.)You are limited by around 30 character width for each row.
INSTALL:
1.)Unzip this package to /scripts/UnicodeAnimator/
2.)Restart runUO, login as admin
3.)Type [add UnicodeAnimatorItem
4.)Double click on the item, and you should see a series of 5 frames of an animation be displayed around the item.
TUTORIAL, ADD EXTRA SPELL EFFECT WITH UNICODE ANIMATIOR:
1.)Open up /scripts/spells/first/MagicArrow.cs
2.)Find the line
source.MovingParticles( m, 0x36E4, 5, 0, false, false, 3006, 0, 0 );
And just below this line add:
UnicodeAnimator.PlayAnimationOnMobile(SparkleAnimation.GetAnimationSequence(), SparkleAnimation.GetAnimationHues(),m,4);
Now when you cast magic arrow, it should create an extra animation effect on the target, at ~4 frames per second.
TUTORIAL CREATE YOUR OWN EFFECTS
1.)Open /scripts/UnicodeAnimator/SparkleAnimations.cs
2.)Save as, YourAnimation.cs
3.)Find/replace all instances of "SparkleAnimations" with "YourAnimation"
4,)This file has two functions. The first function is GetAnimationSequence(), and this function just returns all the frames of your animation as a List.
The second function GetAnimationSequenceHues() returns the hue for each item. This is required to have the same number of entries as there are animation frames.
5.)Edit your effect/colors, remember, this is unicode, and not monospace, so you willl have to toy with, since the fonts are not evenly spaced.
6.)Now, instead of using the SparkleAnimation we used above for magic arrow, we can use our new effect, with our new hues, like so:
UnicodeAnimator.PlayAnimationOnMobile(YourAnimation.GetAnimationSequence(), YourAnimation.GetAnimationHues(),m,4);
On the other hand, if you don't want the effect to follow a mobile, and you just want it to effect one location, you can use
UnicodeAnimator.PlayAnimationOnLocation(YourAnimation.GetAnimationSequence(), YourAnimation.GetAnimationHues(),m.Location, m.Map,4);
Basically, this will create a stationary animation, on m.Location and m.Map, but that can be any location or map of you chosing.
TODO:
If anyone knows of a way to deal with the fact UO does not have monospaced fonts, let me know! That was the hardest part.
Best of Luck!