Cenarius Spellpack v1.2.0

[FUJI]

TLDR: it's been a long time promised but now gladly finished~

the spellpack took longer than originally planned due to my limited time, which slowed development and eventually caused a pause (years of pause). so when I was able to commit a time for its development again (just started last october), I had to backtrack, review earlier implementations, and rework all of the approaches where I had to create and develop my own framework to ensure everything aligned with my goal and vision. the blizzard team’s continuous updates to the game were a major plus which am keeping to motivate and push myself with the development further. recalling everything -> transitioning from vJASS to Lua -> creating FujiSpellPack (5k lines of code) -> getting along with the other natives and systems -> developing Cenarius SpellPack -> fixing bugs here and there wasn’t fast (took me almost half a year), but it allowed for cleaner integration and better overall stability. given the release is still initial im planning to create more extensive documentations, examples, and templates etc. how to use the FujiSpellPack framework in the future (although some of the parts were already annotated and the spellpacks to be created will surely rely to it) as it was initially designed for my personal use to allow me create more spellpacks in a convenient manner. for the meantime, im still experimenting the framework's robustness but will eventually give its own formal introduction to everyone once i have the time to do it. nonetheless, I’m happy to finally release the spellpack, and I appreciate everyone who stayed patient and supported it along the way.

 

[khopesh]

fine tuning spellpack

 

[Henry_AC]

Poetic, cosmic, mythical, epic, magnanimous. Uff! A 10 out of 10!

 

[skywalker97]

That's just fantastic! Keep it up, dude. Sadly, i can't use in my map due to Jass.

 

[FUJI]

That's just fantastic! Keep it up, dude. Sadly, i can't use in my map due to Jass.

i understand however for my point of view it's much more easier to build and maintain the framework with lua than jass so unfortunately i cannot guarantee if there will be jass compatibility in the future.
hopefully, some parts of the work can still give you an idea and maybe try to implement it for your next map if you wish to make it in lua.

for basic configurations such as editing the number fields in the script will not totally require you to even have lua knowledge to be honest but still highly suggest you learn the basics of it in order for you to get along with the lua map environment and then create advance modifications if ever. there's a very good tutorial i attached in the description to get started

 

[FUJI]

Cenarius Spellpack v1.1.0 (New Update)
EDIT:

Spellpack
-Added 6 new spells:
Treant - Treant Aggression (Invoked), Spore Cloud (Originated)
Ancient Protector - Protector Remnants (Invoked), Wild Growth (Originated)
Jaina - Tideburst (Invoked)
Tyrande - Starfall Convergence (Invoked)

Wild Growth	Protector Remnants	Ancient Fortification

Spore Cloud	Treant Aggression

Jaina Ability: Tideburst	Thrall Ability: Zapstorm	Tyrande Ability: Starfall Convergence	Arthas (Evil) Ability: Coils Of Death

Framework
-Added new optional string field in spells of FujiSpellPack:
__name - name of the spell class for debugging and monitoring
-Added new optional event boolean field in spells of FujiSpellPack:
unitDeathEvent - automates passive instance creation upon death
-All event boolean fields in spells of FujiSpellPack will now default to false for clarity. (updated all existing spells with the change)

-Added more invoke functions:
registerInvokeActive - registers active spell to invoke from the SpellEffectEvent
registerInvokePassive - registers passive spell to invoke from the FujiSpellPack.initialize() event system (rect check,enter map,unit death,hero learn)
createInvokePassive - creates invoke passive instance of the spell

-Added more safety checks in FujiSpellPack:remove() method due to the new spells structure. (idempotent and safe with multiple calls)
-Changed order of callbacks in FujiSpellPack.removeAura(aura) function:
old - End > Exit
new - Exit > End (much more favorable with exit callback to avoid invalid, nil, or stale references if end callback has cleaning operations)

-Added more aura caches information in FujiSpellpackMonitor system:

Spoiler

now this update concludes the finalization of the cenarius spellpack abilities which includes his summoned units and other extras so that i can jump with another stuff (actually have to investigate why the sleep ability is not working continuously like it's just pausing the unit but not making them sleep therefore due to current limitation had to make the Spore Cloud use entangle ability instead which just works perfectly fine hence im suspecting the engine might be the culprit, plus im having the same behavior with the purge ability which should also be the design choice for Zapstorm but yeah i'll just figure them sometime if they really have odd or hardcoded behaviors)

please kindly let me know if there will be issues in the new update.

EDIT: it turns out there are no issues with the sleep and purge abilities. unfortunately, their hardcoded mechanics just don't get along with how the CrowdControl system works:

for sleep, CrowdControl uses dummy recasting for stacking purposes however sleep has hardcoded mechanic where it sets the unit to invulnerable state so recasting won't work because the unit is already invulnerable. setting the unit pause or invulnerable duration from the object editor field to 0.00 did pause the unit forever lol. the only ideal solution i can think for now which preserves all of the CrowdControl system logic is to set the targets allowed field for the sleep ability to both vulnerable and invulnerable. however, this kind of approach has a caveat that will require an extra modification to the system or the users to manually check invulnerability state whenever they will apply sleep using CrowdControl to avoid bugs of course.

for purge, CrowdControl creates dummy owned by PLAYER_NEUTRAL_PASSIVE for casting purposes however purge has hardcoded mechanic where if the target unit is an ally then it will just dispel without the slow buff to apply because it's an ally. therefore the slow buff will only apply if the target unit is an enemy which the PLAYER_NEUTRAL_PASSIVE do not consider any of the players as its enemy hence no buff will apply to the units. the only ideal solution i can think for now which preserves all of the CrowdControl system logic is to change from PLAYER_NEUTRAL_PASSIVE to PLAYER_NEUTRAL_AGGRESSIVE so units will be treated as enemy when using purge. however, this will always apply buff and slow the units (which i believe should be the preferable mechanic for a CrowdControl effect anyway)

overall, still glad they are not bugs but just conflicting mechanics which are fixable via slight tweaking and not recoding a broken stuff. although, one may prefer other types of crowd control in the system which can achieve the same effects these possess but those may still depend with what the user really desires.

i rest the case

 

[FUJI]

Cenarius Spellpack v1.2.0 (New Update)

Spellpack
-Integrated with the new updates in framework

Framework
-Updated FujiSpellPack and other systems in Dependencies folder specifically:
CrowdControl - added configurable fields to allow invulnerable and magic immune units to be controlled, fixed purge and sleep control behaviors, etc.
DamageInterface - added configurable field to exclude dummy id in dealing attack damage or DAMAGE_TYPE_NORMAL due to drunken haze ability
Missiles - added FujiSpellPack.playEffectAnimation() support
MissileEffect - added FujiSpellPack.playEffectAnimation() support
MouseUtils - added configurable field to allow computer player support, fixed nil errors, etc.
FujiSpellPack
-Added buff system
-Changed createPassive() to detect existing instances when hero is leveling instead of destroying and recreating them (which i thought to be the better approach however most use cases did not really benefit from it so had to rework). Existing instances now persist across hero levels with only instance.level being updated via levelSpell(), preserving all instantiated data like counters, flags, and storages with no hassle
-Added 60+ instance detection methods covering source, target, and range filtering across all Passive/Active/All variants
-Added castX, castY, markX, markY automated fields to an instance which store source and target positions at creation time, contrasting with sourceX/Y and targetX/Y which now automatically sync every period (to align with position checks of instance in range detection methods)
-Added containsOriginId(), containsInvokeId(), containsId() for convenient ability ids detection in originated and invoked spells
-Added iterateOriginIds(), iterateInvokeIds(), iterateAllIds() for convenient ability ids iteration in originated and invoked spells

-Changed registerInvokeActive() to support multiple spells per ability id using nested [abilityId][spell] storage (invokedActives)

-Added missileMove(missile,x,y,z,yaw,pitch,roll) - manually reposition a paused missile which is completely safe when resumed
-Added arrayInsert(), arrayRemove(), arrayClear() - safe array methods with O(1) removal
-Added adjustAbilityCooldown(unit,abilityId,amount) - adjusts remaining cooldown of the ability id by amount
-Added switchAbility(unit,fromAbility,toAbility,disable,hide,permanent) - safe ability swap with deferred callback due to rapid key press
-Added concealUnit(unit) and revealUnit(unit) - hide+invulnerable+pause and the reverse in one call
-Added destroyTreesInRange() and reviveTreesInRange() - with optional animation speed and life parameters
-Added playEffectAnimation(effect,animationType,...) - play animation type of the effect with optional timescale and sub animations
-Added 20+ 2D and 3D position functions (angleDistanceFromPoint2D,angleDistanceFromPointSquare3D(),etc...)
-Added animationType, subAnimationOne/Two/Three, animationTimeScale fields to missile() and addMultipleEffect() configs
-Reworked summonUnit() to use a config table parameter which support addMultipleEffect() and setUnitAnimationRate() configs
-Changed periodPassives from 0.050 to 0.025 (to align with position checks of instance in range detection methods)
-Changed periodAuras from 0.500 to 0.025 (to align with position checks of instance in range detection methods)

FujiSpellPackMonitor - aligned monitoring with the new updates in FujiSpellPack

Testmap
-Added a new mode called Arena which is a new testing environment implemented from the mode selection dialog to ensure PvsP compatibility and further support the performance and robustness of the spellpacks.