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; } }