Odd Jelly GamesAssets

Holy Light: Divine Spell VFX / Docs

Holy Light docs

Which file to download, how to set it up in Godot, Unity or Unreal, every effect with its settings, and how to call them from code.

Which download do I need?

One pack, five downloads. Take the one for your engine; they hold the same 18 effects.

EngineVersionsDownloadWhat is insideSold on
Godot4.4 and newer (tested in 4.4, 4.5, 4.6, 4.7)HolyLight_Godot.zipOne addon: a node per effect, its shaders, a showcase, a playable arena demo and a benchmark scene. Forward+, Mobile and Compatibility.itch.io
UnityUnity 6 (6000.0 and newer; VFX Graph version 6000.0 to 6000.3)HolyLight.unitypackageParticle System prefabs for Built-in and URP, one component per effect, a demo scene and a benchmark scene. The VFX Graph version is optional, inside it as HolyLight_VFXGraph.unitypackage (URP and the Visual Effect Graph package).Unity Asset Store, Fab, itch.io
Unreal5.4 to 5.7HolyLight_Niagara_UE5.4.zipNiagara systems and Blueprints, content only, no C++: works in Blueprint-only projects. Overview, Showcase and Examples maps.Fab, itch.io
Unreal5.8HolyLight_Niagara_UE5.8.zipThe same, saved by Unreal 5.8.Fab, itch.io
Any other engine, BlenderanyHolyLight_FBX.zipThe meshes the effects are built from as FBX, and their sprites and noise as PNG, to build the effects yourself.Fab, itch.io

On Fab one listing carries the Unreal, Unity and FBX downloads: Fab offers the one for your engine. On itch.io all five come with the one purchase.

Start here

Godot

  1. Copy addons/ into your project (and holy_light_demo/ for the demos), then open the project once so Godot imports it. Nothing else: the effects are global classes. Enabling the plugin under Project Settings > Plugins is optional.
  2. Make the light bloom. Give your WorldEnvironment the pack's look preset, addons/holy_light/holy_look.tres, or turn on Glow in your own Environment: intensity 0.8, bloom 0.08, HDR threshold 0.9, tonemap ACES. The light of the pack is made to bloom: without bloom it looks flat.
  3. Add Child Node > search "Holy" > pick one (HolyPillar, HolySmite...). It previews in the editor at once.
  4. Open holy_light_demo/showcase.tscn to see all 18 (arrow keys go from effect to effect), or arena.tscn to be the one they are cast at.

Unity

  1. Import HolyLight.unitypackage. The Particle System version needs nothing else. The Welcome window opens by itself (later: Tools > Holy Light > Welcome), with a button for each of the next steps.
  2. Make the light bloom. In the Welcome window press Set up Bloom (or Tools > Holy Light > Set Up Bloom). In URP it adds a global Volume with the pack's look preset, the HolyLook_URP profile (Bloom and ACES tonemapping), and turns on HDR and post-processing on the main camera. In the Built-in renderer it offers the demo's camera look (HolyDemoLook), or use the Post Processing package. Linear colour space looks best.
  3. Drag a prefab from Assets/HolyLight/Prefabs into the scene. Select it and it plays in the Scene view, as any Particle System does. Its component holds the colours, size and timing.
  4. Open demo in the Welcome window: every effect looping in rows (Left / Right go from effect to effect, Space plays one again). Demo/HolyBenchmark is a stress test with a live readout (1 Horde, 2 Raid, 3 Everything). With VFX Graph: install Visual Effect Graph from the Package Manager, then import HolyLight_VFXGraph.unitypackage from the HolyLight folder; Open demo then opens its demo.

Unreal

  1. Add the pack to your project from the Fab library, or copy the HolyLight folder from the download's Content into your project's Content (in Unreal: /Game/HolyLight). The download also opens on its own: HolyLight.uproject.
  2. Make the light bloom. Drop BP_HolyLook (Blueprints/) into your level: an unbound post-process with the look the effects were made in (no auto exposure, the tone curve and bloom of the pack's videos). Your own level's bloom works too: the effects are additive light.
  3. Open Maps/Overview: every effect labelled with its name and system, each playing again after it ends.
  4. Place a system (NS_HolyPillar...) or a BP_HolyEffect actor in a level, or spawn one from a Blueprint (below). Maps/Examples: six ways to use them, on keys 1 to 6.

Other engines (FBX kit)

  1. Import the meshes from Meshes/ (metres, Y up) and the textures from Textures/. Import HL_Noise.png as data: linear, uncompressed, repeating.
  2. Make the light bloom: your engine's bloom and an HDR camera. The sprites are white with the shape in alpha, meant for additive blending: colour times alpha.
  3. Build the effects from beams, domes, blades and sprites; the README lists every piece and the pack's colours (tint 1.0 0.70 0.26, core 1.0 0.93 0.70, accent 0.95 0.58 0.22, linear).

The 18 effects

Recorded in the Godot version on the pack's dark floor; Unity and Unreal draw the same effects. Lasting effects stand until you let them go.

What every effect has

Godot

Every effect node has autoplay, looping, free_when_done, size (1 is for a figure 1.8 m tall), and its colours tint, core, accent, brightness. play() runs it again; stop(secs) lets it go: what shows fades out, nothing new starts, looping turns off; the signal finished(fx) says when it is over. For the whole scene: HolyHazardFx.quality (0, 1 or 2: detail of the grounds) and HolyHazardFx.ground_brightness (raise it on snow or sand).

Unity

Every effect's component has autoplay, looping (plays again 0.6 s after it ends), destroyWhenDone, exactClock (re-simulates to its clock every frame: recordings, slow motion), and its colours tint, core, accent, brightness. Play() runs it again; Stop(secs) lets it go (0.3 s by default); Recolour() sends changed colours to it while it plays; Scrub(t) shows the moment t exactly (Timeline). To read: T (its clock), Duration, Strike (seconds from Play to the blow), Playing, Done. Every part is an ordinary Particle System under the prefab: edit its modules as you would any other (how long a Pillar stands, Blades' count, Purge's arc: those live in the prefab's modules, not on the component).

Unreal

Every Niagara system has the same User parameters first: Tint, Core, Accent, Brightness (0 to 4), Size, then its own. Set End to 1 to let it go (over EndSecs), then deactivate it. BP_HolyEffect wraps any system as an actor: Play, Stop (Secs), End (Secs), Recolour, Aim, Hit, Shatter, Shelter, and the events On Strike (Location) and On Finished. Times are seconds, distances metres (positions: centimetres, as Unreal places things).

Judgement

The whole area is struck, but for its sanctuaries: stand in a small circle or be struck. A great warning fills, light gathers, then a barrage of pillars falls, volley after volley.

Godot
HolyJudgement node: radius, wind_up, pillars, pillar_radius, barrage, pillar_hold, volley, sanctuaries (positions), sanctuary_radius
Unity
HolyJudgement prefab: radius, windUp, pillars, barrage, volley, sanctuaries (positions), sanctuaryRadius, pillarRadius
Unreal
NS_HolyJudgement: Radius, WindUp, Barrage, SanctuaryRadius, SanctuaryCount, Sanctuary0-3. The barrage as a game mechanic: BP_HolyJudgement (Sanctuaries, Wind Up, Volley, Barrage, Radius, Seed; On Strike for every pillar).

Sanctuary lasting

A safe place to stand, with a dome that flares when something strikes round it.

Godot
HolySanctuary node: radius; shelter() flares it
Unity
HolySanctuary prefab: radius; Shelter()
Unreal
NS_HolySanctuary: Radius, ShelterAt; BP_HolyEffect > Shelter

Consecrate lasting

Hallowed ground for as long as it lasts: shafts of light, motes rising.

Godot
HolyConsecrate node: radius, lasts; end() lets it go out
Unity
HolyConsecrate prefab: radius, lasts; End()
Unreal
NS_HolyConsecrate: Radius, Lasts; BP_HolyEffect > End

Pillar of Light

A short warning, then a column of light slams down, burns away and leaves the ground hallowed.

Godot
HolyPillar node: wind_up, radius, hold, burn, ground_life
Unity
HolyPillar prefab: windUp, radius (how long it stands and burns: the prefab's modules)
Unreal
NS_HolyPillar: WindUp, Radius, Hold, Burn, GroundLife

Judgement Blades

Swords of light fall round someone, lean in, then burst together.

Godot
HolyBlades node: count, radius, stagger
Unity
HolyBlades prefab: radius (count and stagger: the prefab's modules)
Unreal
NS_HolyBlades: Count, Radius, Stagger

Resurrection

A seal, a shaft of light from the sky, feathers, and a burst that brings them back.

Godot
HolyResurrection node: radius, rise_at
Unity
HolyResurrection prefab: radius, riseAt
Unreal
NS_HolyResurrection: Radius, RiseAt

Smite

A blow of light lands on someone: a cross, a turning star, rings, sparks, a bolt from above.

Godot
HolySmite node: height
Unity
HolySmite prefab: radius
Unreal
NS_HolySmite: Height

Holy Bolt

An orb of light thrown in a shallow arc that lands as a Smite.

Godot
HolyBolt node: source, speed, bow, height; aim(from, to)
Unity
HolyBolt prefab: source, speed, bow, height; Aim(from, to)
Unreal
NS_HolyBolt: Source, Speed, Bow, Height; BP_HolyEffect > Aim

Ray of Light lasting

A channelled beam, held for as long as it loops, threads of light winding round it.

Godot
HolyRay node: source, height, width; aim(from, to)
Unity
HolyRay prefab: source, height; Aim(from, to)
Unreal
NS_HolyRay: Source, Height, Width; BP_HolyEffect > Aim

Holy Nova

Light bursts out of whoever stands here, a wall of light running outward.

Godot
HolyNova node: radius, run
Unity
HolyNova prefab: radius
Unreal
NS_HolyNova: Radius, Run

Holy Explosion

A dome of light swells and bursts, shafts fan out, the ground is left hallowed.

Godot
HolyExplosion node: radius
Unity
HolyExplosion prefab: radius
Unreal
NS_HolyExplosion: Radius

Purging Wave

A curved wall of light sweeps out across an arc in front of the caster.

Godot
HolyPurge node: reach, arc, run, wall_height
Unity
HolyPurge prefab: reach (arc, run and wall height: the prefab's modules)
Unreal
NS_HolyPurge: Reach, Arc, Run, WallHeight

Divine Shield

A ward of light: blows ripple across it where they land, and it shatters. With demo on (as it ships, in Godot and Unity) it is struck three times and breaks by itself; with demo off it stands until you shatter or stop it. In Unreal it stands until End or one second after it shatters.

Godot
HolyShield node: radius, height, demo (off in a game); hit(from), shatter()
Unity
HolyShield prefab: radius, height, demo (off in a game); Hit(from), Shatter()
Unreal
NS_HolyShield: Radius, Height, ShatterAt, Hit0-3; BP_HolyEffect > Hit, Shatter

Heal

Light rises through someone, a warm glow swelling at the chest.

Godot
HolyHeal node: radius
Unity
HolyHeal prefab: radius
Unreal
NS_HolyHeal: Radius

Blessing lasting

A halo, a turning ring and rising motes for as long as it lasts.

Godot
HolyBlessing node: halo_height, radius
Unity
HolyBlessing prefab: radius
Unreal
NS_HolyBlessing: HaloHeight, Radius

Ascension

Someone leaves in light: a teleport, a departure.

Godot
HolyAscend node: radius
Unity
HolyAscend prefab: radius
Unreal
NS_HolyAscend: Radius

Sacred Flame lasting

A fire of white-gold light for a brazier, an altar or a censer.

Godot
HolyFlame node: radius
Unity
HolyFlame prefab: radius
Unreal
NS_HolyFlame: Radius

Falling Feathers lasting

Feathers of light drifting down over an area.

Godot
HolyFeathers node: radius, amount
Unity
HolyFeathers prefab: radius
Unreal
NS_HolyFeathers: Radius, Amount

Using them from code and Blueprint

Godot GDScript

# A Pillar of Light at the target's feet: it plays at once and frees itself.
var pillar := HolyPillar.new()
pillar.wind_up = 1.2
add_child(pillar)
pillar.global_position = target.global_position
# it lands wind_up seconds later: deal the damage then
get_tree().create_timer(pillar.wind_up).timeout.connect(_on_pillar_landed)

# A bolt from the caster to the target, in frost blue
var bolt := HolyBolt.new()
bolt.tint = Color(0.45, 0.7, 1.0)
add_child(bolt)
bolt.aim(caster.global_position, target.global_position)

# A shield on the player, struck, then broken
var shield := HolyShield.new()
shield.demo = false
player.add_child(shield)
shield.hit(enemy.global_position)
shield.shatter()

# Lasting ground, let go later; know when it is gone
var ground := HolyConsecrate.new()
add_child(ground)
ground.finished.connect(func(fx): print(fx.name, " is over"))
ground.end()   # or stop(0.8) on any effect

Unity C#

using UnityEngine;
using OddJelly.HolyLight;

public HolyPillar pillarPrefab;   // Assets/HolyLight/Prefabs/HolyPillar
public HolyBolt boltPrefab;

void CastPillar(Vector3 target)
{
    var pillar = Instantiate(pillarPrefab, target, Quaternion.identity);
    pillar.windUp = 1.2f;
    pillar.Play();                 // (autoplay would too)
    Invoke(nameof(PillarLanded), pillar.Strike);   // it lands Strike (= windUp) seconds later
}

void PillarLanded() { /* deal the damage */ }

void Throw(Vector3 from, Vector3 to)
{
    var bolt = Instantiate(boltPrefab);
    bolt.tint = new Color(0.45f, 0.7f, 1f);   // frost blue
    bolt.Aim(from, to);
    bolt.Play();
}

// Divine Shield: shield.Hit(attacker.position); shield.Shatter();
// Sanctuary: sanctuary.Shelter();   Consecrate: ground.End();
// Any effect: fx.Stop(0.8f) lets it go; fx.Recolour() after changing colours; fx.Done once it is over.

Unreal Blueprint

  1. Spawn System at Location: System NS_HolyPillar, Location the target's feet. Keep the returned Niagara component.
  2. Set Niagara Variable (Float) on it: WindUp 1.2. Colours with Set Niagara Variable (Linear Color): Tint, Core, Accent.
  3. To let a lasting one go: Set Niagara Variable (Float) End = 1, then Deactivate it.
  4. Game side: spawn a BP_HolyEffect actor instead and call Play, Aim (From, To), Hit (From), Shatter, Shelter or End (Secs) on it; bind your damage to On Strike (Location) and your clean-up to On Finished.
  5. Judgement as a boss mechanic: BP_HolyJudgement: set its Sanctuaries, call Play, and bind On Strike for every pillar that lands.
  6. Maps/Examples (BP_HolyExamples) shows six of these working: cast at a target's feet, throw a bolt, pick an effect from a list, your own colours, a lasting effect ended by hand, knowing when it is done.

Questions

It looks dull or flat.

Turn on bloom. The effects are bright light made to bloom: in Godot Glow in the WorldEnvironment (or holy_look.tres), in Unity URP a Volume with Bloom and ACES and the camera in HDR (the Welcome window's Set up Bloom), in Unreal BP_HolyLook or your own post-process. Raise brightness over 1 for more glow. On snow or sand raise the grounds' brightness (Godot HolyHazardFx.ground_brightness) or choose a deeper tint.

URP or the Built-in renderer?

Both. The Particle System version runs in URP and in the Built-in renderer with the same shaders (plain HLSL) and looks the same; only bloom is set up differently: a Volume in URP, the Post Processing package (or the demo's HolyDemoLook) in Built-in. The VFX Graph version is URP only. HDRP is not tested.

Do I need the VFX Graph package?

No. The Particle System version is complete on its own. The VFX Graph version is an extra for URP projects that use VFX Graph (Unity 6000.0 to 6000.3): install Visual Effect Graph from the Package Manager, then import HolyLight_VFXGraph.unitypackage from the HolyLight folder. It adds a .vfx graph and a prefab for every effect (HolyPillar_VFX...) with the same component and calls, the graphs' exposed properties (Tint, Core, Accent, Brightness, WindUp and the effect's own), its own demo scene (HolyShowcase_VFX) and benchmark (HolyBenchmark_VFX). Without the package, don't import it.

Which engine versions and renderers are tested?

Godot 4.4, 4.5, 4.6 and 4.7, each in Forward+, Mobile and Compatibility (Compatibility glows a little softer). Unity: the Particle System version in 6000.0, 6000.3 and 6000.6, each in a new Built-in and a new URP project; the VFX Graph version in 6000.0 and 6000.3 (URP with Visual Effect Graph). In 6000.6 the VFX Graph version works in the editor, but its player builds fail, so it is not claimed there yet. Unreal 5.4 and 5.8 (the two zips, opened and played as a buyer gets them). Godot 4.3 does not work (its shaders lack what the pack needs).

Phones and the web?

Not tested yet. The Godot version runs in the Mobile and Compatibility renderers, but they were tried on a Mac, not on a phone, and no web export has been tried. If you try one, we would like to hear how it went.

Why is the download so small?

Every effect is shaders and code: no flipbook textures, no sprite sheets, one shared noise texture. So the downloads are tiny (Godot about 0.25 MB, Unity about 4 MB, Unreal under 10 MB with its maps) and the effects stay sharp at any resolution, close up or at 4K.

Can I change the colours?

Yes, every effect, in every engine: tint (the colour it is remembered by), core (its hottest part), accent (the deeper second hue) and brightness. Gold by default; frost blue, violet, green or a dark version are a change of tint. They can change while an effect plays: Godot and Unity follow at once (Unity: Recolour()), Unreal through Recolour on BP_HolyEffect.

What do they cost to run?

Each part of an effect (a beam, a flare, a ground) is one particle, and the sparks are few. Unreal: every system has a Niagara Effect Type, so far-off and surplus effects are culled by Unreal's scalability (Effects quality: up to 150 m at Epic, 60 m at Low; lasting effects pause instead of vanishing). Godot: HolyHazardFx.quality 0 lowers the detail of the grounds for weak hardware. Unity: leave exactClock off in a game (it re-simulates every frame). Every package has a benchmark scene with a live readout (100 effects at once, a Judgement raid, or all 18 x 5): run it on your own machine. On a laptop's integrated graphics (Ryzen 7 5825U, 1920x1080) 100 effects at once run at about 35 FPS in Godot (Forward+) and 52 FPS in Unity URP.

Can I scrub them or record them?

Yes. Every effect runs on its own clock, so it looks the same at any frame rate and in a recorded video. In Unity Scrub(t) shows any moment exactly (Timeline).

How it was made

Every effect is our own code and shaders. We used AI assistance for coding. No AI-generated images, textures or 3D models were used, and no outside assets are included.

Help

Something not working, or a setting you wish an effect had? Write to assets@oddjellygames.com. Importing, the licence and refunds: https://assets.oddjellygames.com/support/.