Skyrim Spell Craft Functions SE ?‍

SKSE64 plugin that adds more papyrus functions for the manipulation of spells in Skyrim Special Edition.

Usage
Scriptname SpellCraft

;; setters
bool Function SetSpellNthMagicEffect(Spell akSpell, MagicEffect akEffect, int index) Global Native 
bool Function SetSpellNthMagicEffectMagnitude(Spell akSpell, Float mag, int index) Global Native 
bool Function SetSpellNthMagicEffectDuration(Spell akSpell, Int dur, int index) Global Native 
bool Function SetSpellNthMagicEffectArea(Spell akSpell, Int area, int index) Global Native 
bool Function SetSpellNthMagicEffectCost(Spell akSpell, Float cost, int index) Global Native 

bool Function SetSpellNthMagicEffectDelivery(Spell akSpell, int delivery, int index) Global Native ; doesnt seem to work as intended;
; 0 = self, 1 = contact, 2 = aimed, 3 = target actor, 4 = target location

bool Function SetSpellType(Spell akSpell, Int akType ) Global Native 
; 0 = spell, 1= disease, 2 = power, 3 = lesser power, 4 = ability
; 5 = poison, 6 = addition, 7 = voice (shout?)

bool Function SetSpellCastType(Spell akSpell, Int akType ) Global Native 
; 0 = constant effect, 1 = fire and forget, 2 = concentration

bool Function SetSpellCastTime(Spell akSpell, Float akTime ) Global Native 
bool Function SetSpellPerk(Spell akSpell, Perk akPerk ) Global Native
bool Function SetSpellCost(Spell akSpell, Int akCost ) Global Native 
bool Function SetSpellName(Spell akSpell, String name ) Global Native 

;; getters
Float Function GetSpellNthMagicEffectCost(Spell akSpell, int index) Global Native
Int Function GetSpellType(Spell akSpell ) Global Native 
; 0 = spell, 1= disease, 2 = power, 3 = lesser power, 4 = ability
; 5 = poison, 6 = addition, 7 = voice (shout?)

Int Function GetSpellCastType(Spell akSpell ) Global Native
; 0 = constant effect, 1 = fire and forget, 2 = concentration

Int Function GetSpellCastTime(Spell akSpell) Global Native
Perk Function GetSpellPerk(Spell akSpell) Global Native
; Int Function GetSpellDelivery(Spell akSpell ) Global Native // not implemented

;; fancy functions lol
; appends a new MagicEffect to a spell
bool Function SpellAddEffect(Spell akSpell, MagicEffect akEffect, Float magnitude, int duration, int area, Float cost) Global Native

; basically replaces spellA with a copy of spellB
; seems to result in ctd, but it works in the combine spells so idk what's wrong
bool Function CopySpell(Spell spellA, Spell spellB) Global Native

; deletes all spells from an actor, and the actor's base if {removeBase} is true ({removebase} doesn't work as intended, still removes all added spells tho)
bool Function RemoveAllActorSpells(Actor akActor, bool removeBase=false) Global Native

; returns an array of all spells from an actor, including their base
; you can specify a specific magic school, or leave {akSchool} empty for all spells
; you can also specify the spell type (see above)
Spell[] Function GetAllActorSpells(Actor akActor, String akSchool="", int type=0) Global Native

; function that allows you to filter duplicates and specific spells from an array
; returns an array with no duplicately named spells, and without any spells whose names are specified in {tags}
Spell[] Function FilterSpellArray(Spell[] spells, String[] tags) Global Native

; fun function that replaces {base} spell with a new spell that combines all the effects of {spells}
bool Function CombineSpells(Spell base, Spell[] spells, String name) Global Native


Check SpellCraft.psc and the Github for more.

Example
The following papyrus snippet creates a spell effect that will add all spells from a target actor to the caster:

Event OnEffectStart(Actor AkTarget, Actor akCaster)
Spell[] stolen_spells = SpellCraft.GetAllActorSpells(AkTarget, "")
int i = 0
while i < stolen_spells.Length
akCaster.AddSpell(stolen_spells[i])
i += 1
endWhile
EndEvent

The following papyrus function changes a spell's cost and adds an additional effect:

MagicEffect Property new_effect Auto
Function ModifySpell(Spell akSpell, Int cost)
bool worked = SpellCraft.SetSpellCost(akSpell, cost) ; modify the cost of the spell
Debug.Trace("Set spell cost:" + worked) ; make sure everything worked
worked = SpellCraft.SpellAddEffect(akSpell, new_effect, 25.0, 60, 0, 100) ; add additional effect
Debug.Trace("Add new effect:" + worked)
EndFunction


Notes
Not an actual mod! Just a modders' resource. Think of it as an extension to skse.
Not extensively tested either so submit an issue if you notice any bugs.
Feel free to use and package with your mods, just credit me.

(created from zero experience in skyrim modding with the help of this tutorial from @Ryan-rsm-McKenzie, inspired by GrimyPlugin)