namespace SOR.Game.Abilities.Models;
/// The visual presentation style for an ability animation.
public enum AbilityAnimationType
{
/// A projectile that arcs from caster to target.
Projectile,
/// A projectile that travels in a straight line from caster to target.
LinearProjectile,
/// A projectile that follows a parabolic arc from caster to target.
ArcProjectile,
/// A radial aura effect centered on the caster or target.
Aura,
}
/// Where the animation effect VFX is rendered.
public enum AbilityAnimationEffect
{
/// Effect plays on the ability's source unit.
Self,
/// Effect plays on each selected target.
Target,
/// Effect plays on a subset of affected units.
Some,
/// Effect covers the entire board (e.g. board-wide clear).
All,
}
///
/// Client-side animation and sound metadata for an ability.
/// Stored inside AbilityDefinition.Animation (JSONB).
/// Not used by server game logic — purely for the client renderer and audio system.
///
public sealed class AbilityAnimationDefinition
{
public AbilityAnimationType Type { get; set; } = AbilityAnimationType.Projectile;
public AbilityAnimationEffect Effect { get; set; } = AbilityAnimationEffect.Target;
/// CDN URL to the animation asset (particle effect, sprite sheet, etc.).
public string? AssetUrl { get; set; }
/// Scale width multiplier for the effect (1.0 = default size).
public float Width { get; set; } = 1f;
/// Scale height multiplier for the effect (1.0 = default size).
public float Height { get; set; } = 1f;
/// Duration of the animation in seconds.
public float Duration { get; set; } = 1f;
/// CDN URL to the sound played when the ability is cast/activated.
public string? CastSoundUrl { get; set; }
/// CDN URL to the sound played on impact/effect resolution.
public string? ImpactSoundUrl { get; set; }
}