Spell.java

package net.spell_engine.api.spell;

import net.minecraft.entity.EquipmentSlot;
import net.spell_engine.api.render.LightEmission;
import net.spell_engine.api.spell.fx.PlayerAnimation;
import net.spell_engine.api.spell.fx.ModelEffect;
import net.spell_engine.api.spell.fx.ParticleBatch;
import net.spell_engine.api.spell.fx.Sound;
import net.spell_engine.api.spell.fx.VFX;
import net.spell_engine.api.spell.summon.AttributeScaling;
import net.spell_engine.api.spell.summon.SummonBehaviour;
import net.spell_engine.api.util.AlwaysGenerate;
import net.spell_engine.api.util.NeverGenerate;
import net.spell_engine.api.util.TriState;
import net.spell_engine.internals.target.SpellTarget;
import net.spell_power.api.SpellSchool;
import org.jetbrains.annotations.Nullable;
import org.joml.Vector3f;

import java.util.ArrayList;
import java.util.List;
import java.util.UUID;

public class Spell {
    public SpellSchool school;

    public enum ExtendedArchetype { ARCHERY, MAGIC, MELEE, ANY }
    @Nullable public ExtendedArchetype secondary_archetype = null;
    public float range = 50;
    /// Provide a value for a non-static range mechanic
    @Nullable public RangeMechanic range_mechanic;
    public enum RangeMechanic { MELEE }

    /// Quality classifier, used for sorting spells, in an increasing order
    @AlwaysGenerate
    public int tier = 1;
    /// Secondary quality classifier, used for sorting spells of the same tier, in an increasing order
    public int sub_tier = 1;

    /// Group classifier, used for ordering related spells within a single tier when a catalog of them is
    /// browsed (spell binding table, creative menu), where it sorts just below `tier`
    /// Can be any arbitrary string, commonly used: `primary` (recommended for main attack or healing spells)
    public String group = "";

    /// If this can be obtained from Spell Binding Table, provide an object
    @Nullable public Learn learn;
    public static class Learn { public Learn() {}
        public int level_cost_per_tier = 3;
        public int level_requirement_per_tier = 10;
    }

    @Nullable public Tooltip tooltip;
    public Tooltip tooltip() { return tooltip != null ? tooltip : Tooltip.DEFAULT; }
    public static class Tooltip { public Tooltip() { }; public static final Tooltip DEFAULT = new Tooltip();
        public boolean show_header = true;
        public boolean show_activation = true;
        public boolean show_range = true;
        public LineOptions name = new LineOptions(true, true);
        public LineOptions description = new LineOptions(false, true);
        public static class LineOptions { public LineOptions() { }
            /// Vanilla enum Formatting value by name
            public String color = "GRAY";
            public boolean show_in_compact = true;
            public boolean show_in_details = true;
            public LineOptions(boolean show_in_compact, boolean show_in_details) {
                this.show_in_compact = show_in_compact;
                this.show_in_details = show_in_details;
            }
        }
    }

    public Type type = Type.ACTIVE;
    public enum Type { ACTIVE, PASSIVE, MODIFIER }

    public Active active;
    public static class Active {
        public Cast cast = new Cast();
        public static class Cast { public Cast() { }
            public boolean haste_affected = true;
            /// Length of the casting phase in seconds. 0 => INSTANT (no casting phase; `type` is ignored).
            public float duration = 0;

            /// The casting mechanic, for a timed cast (duration > 0). Exactly one — the matching
            /// sub-struct below is read, the others are ignored.
            public Type type = Type.STANDARD;
            public enum Type {
                STANDARD,  /// Single delivery on full completion; cannot be released early.
                CHANNEL,   /// Repeated deliveries spread evenly across the duration.
                CHARGE     /// May be released early; the bonus scales with how long it was held.
            }

            /// Read only when `type == CHANNEL`.
            @Nullable public Channel channel;
            public static class Channel { public Channel() { }
                /// Number of deliveries, evenly distributed across the casting duration.
                public int ticks = 0;
                /// Whether release FX/animation are sent on each channel tick.
                public boolean release_fx = false;
            }

            /// Read only when `type == CHARGE`.
            @Nullable public Charge charge;
            public static class Charge { public Charge() { }
                /// Minimum charge ratio (0..1) required to fire on release. Below this, the cast fizzles.
                public float min_release_ratio = 0.2F;
                /// How strongly the charge ratio scales the spell's innate output (damage/heal/
                /// knockback): the output multiplier is `1 - output_scaling * (1 - curve(ratio))`.
                /// 1 (default) = output fully proportional to the curved charge ratio (bow-like);
                /// 0 = constant output regardless of charge; values between dampen the swing
                /// (e.g. 0.5 => a zero-charge release would still deal 50%). Base impact values
                /// always represent a FULL charge.
                public float output_scaling = 1F;
                /// Shapes how the raw charge ratio maps to the scaling applied to `full_charge`.
                public Curve curve = Curve.LINEAR;
                /// The bonus applied at 100% charge, scaled toward zero as the (curved) ratio drops.
                /// Reuses the spell-modifier vocabulary, so the same fields equipment/talents already use
                /// drive the charge (power, projectile launch/perks, effect amplifiers, range, ...).
                /// Scoped implicitly to this spell: `spell_pattern` is ignored; `impact_filters` still
                /// select which impacts the bonus boosts.
                public Spell.Modifier bonus = new Spell.Modifier();

                /// Easing curves (per easings.net). IN = slow start, OUT = fast start, IN_OUT = slow at both ends.
                public enum Curve {
                    LINEAR,
                    EASE_IN_QUAD, EASE_OUT_QUAD, EASE_IN_OUT_QUAD,
                    EASE_IN_QUART, EASE_OUT_QUART, EASE_IN_OUT_QUART,
                    EASE_IN_EXPO, EASE_OUT_EXPO, EASE_IN_OUT_EXPO;

                    /// Maps a raw charge ratio to its eased value, both in 0..1.
                    public float apply(float t) {
                        t = Math.max(0F, Math.min(1F, t));
                        switch (this) {
                            case LINEAR:           return t;
                            case EASE_IN_QUAD:     return (float) Math.pow(t, 2);
                            case EASE_OUT_QUAD:    return 1F - (float) Math.pow(1F - t, 2);
                            case EASE_IN_OUT_QUAD: return t < 0.5F ? 2F * (float) Math.pow(t, 2)
                                                                   : 1F - (float) Math.pow(-2F * t + 2F, 2) / 2F;
                            case EASE_IN_QUART:    return (float) Math.pow(t, 4);
                            case EASE_OUT_QUART:   return 1F - (float) Math.pow(1F - t, 4);
                            case EASE_IN_OUT_QUART:return t < 0.5F ? 8F * (float) Math.pow(t, 4)
                                                                   : 1F - (float) Math.pow(-2F * t + 2F, 4) / 2F;
                            case EASE_IN_EXPO:     return t == 0F ? 0F : (float) Math.pow(2F, 10F * t - 10F);
                            case EASE_OUT_EXPO:    return t == 1F ? 1F : 1F - (float) Math.pow(2F, -10F * t);
                            case EASE_IN_OUT_EXPO:
                                if (t == 0F) return 0F;
                                if (t == 1F) return 1F;
                                return t < 0.5F ? (float) Math.pow(2F, 20F * t - 10F) / 2F
                                                : (2F - (float) Math.pow(2F, -20F * t + 10F)) / 2F;
                            default:               return t;
                        }
                    }
                }
            }

            // MARK: Legacy migration (handled with priority — see resolver accessors below)

            /// @deprecated Use `type = CHANNEL` with a `channel` block instead.
            /// Kept for backward compatibility: when non-zero it takes priority and the spell behaves
            /// exactly as before (channeled), ignoring the `type`/`channel`/`charge` structure.
            @Deprecated(forRemoval = true) public int channel_ticks = 0;
            /// @deprecated Use `channel.release_fx` instead. Only consulted while legacy channeling is active.
            @Deprecated(forRemoval = true) public boolean channeled_release_fx = false;

            // MARK: Resolved accessors — single source of truth for the engine.
            // Legacy fields win when set to a non-default value; otherwise the new structure is interpreted.

            public Type resolvedType() {
                if (channel_ticks != 0) { return Type.CHANNEL; } // legacy override
                return type;
            }
            public int channelTicks() {
                if (channel_ticks != 0) { return channel_ticks; }
                if (type == Type.CHANNEL && channel != null) { return channel.ticks; }
                return 0;
            }
            public boolean channelReleaseFx() {
                if (channel_ticks != 0) { return channeled_release_fx; }
                if (type == Type.CHANNEL && channel != null) { return channel.release_fx; }
                return false;
            }

            public PlayerAnimation animation;
            public boolean animation_pitch = true;
            public float animation_spin = 0F;
            public boolean animates_ranged_weapon = false;

            /// Default `0.2` matches the same as movement speed during vanilla item usage (such as bow)
            public float movement_speed = 0.2F;
            public Sound start_sound;
            public Sound sound;
            public ParticleBatch[] particles = new ParticleBatch[]{};
        }
    }

    public Passive passive;
    public static class Passive {
        public List<Trigger> triggers = List.of();
    }

    public List<Modifier> modifiers = List.of();
    public static class Modifier {
        /// Universal pattern matcher, against spell ID
        public String spell_pattern;
        /// Bonus to add to the range of the spell
        public float range_add = 0;
        public enum ImpactListModifier {
            PREPEND, /// Adds the impacts to the start of the list
            APPEND /// Adds the impacts to the end of the list
        }
        @Nullable public ImpactListModifier mutate_impacts;
        public List<Impact> impacts = List.of();
        @Nullable public AreaImpact replacing_area_impact;

        /// Determines which impacts to apply, the changes below
        public List<ImpactFilter> impact_filters = List.of();
        public static class ImpactFilter {
            @Nullable public SpellSchool school;
            @Nullable public Spell.Impact.Action.Type type;
        }

        @Nullable public LaunchProperties projectile_launch;
        @Nullable public ProjectileData.Perks projectile_perks;
        /// Perks merged into a `SHOOT_ARROW` spell's own `arrow_perks` at launch. This is the only
        /// route a modifier has to an arrow: `SHOOT_ARROW` spells deal their damage through the bow
        /// and `arrow_perks`, so impact-based fields (`power_modifier`, appended damage) never reach
        /// them. null = unchanged
        @Nullable public ArrowPerks arrow_perks;
        /// Bonus added to the launched projectile's render scale and hitbox. 0 = unchanged
        /// (final scale = 1 + sum of this across applied modifiers).
        public float projectile_scale_multiply = 0F;
        /// Bonus added to a meteor delivery's `launch_radius` (the horizontal spread the falling
        /// projectiles are scattered over around the target). 0 = unchanged
        public float meteor_launch_radius_add = 0F;
        /// Particle batches played alongside the spell's release FX (anchored on the caster,
        /// repeated per channel burst when the spell replays release FX). null = none
        @Nullable public ParticleBatch[] release_particles = null;
        @Nullable public Impact.Modifier power_modifier;
        public int channel_ticks_add = 0;
        public float knockback_multiply_base = 0;
        public float spawn_duration_add = 0;
        /// Blocks added to the distance traveled by a `TELEPORT` impact in `FORWARD` mode.
        public float teleport_distance_add = 0;
        public int effect_amplifier_add = 0;
        public int effect_amplifier_cap_add = 0;
        public int stash_amplifier_add = 0;
        public float effect_duration_add = 0;
        public float cooldown_duration_deduct = 0;

        public float melee_momentum_add = 0;
        public float melee_slipperiness_add = 0;
        /// Melee delivery - damage multiplier base, applied to all attacks of the melee delivery, example value: `0.5F` for +50% of the total damage.
        public float melee_damage_multiplier = 0F;
        /// Melee delivery - attacks to append
        @Nullable public List<Delivery.Melee.Attack> melee_attacks = null;

        /// Additional cloud or entity spawn placements
        public List<EntityPlacement> additional_placements = List.of();

        // Summon impact (`Impact.Action.Summon`) modifiers.
        /// Additional owner-scaled attribute bonuses, merged into the summon's `attribute_scaling`.
        /// Entries are combined by `attribute_id` (summing their owner modifiers), so a modifier
        /// scaling an attribute the base summon already scales stacks additively rather than replacing.
        @Nullable public AttributeScaling summon_attribute_scaling;
        /// Extra entities spawned per group (added to `Summon.spawn_count`).
        public int summon_spawn_count_add = 0;
        /// Extra groups spawned (added to `Summon.group_count`).
        public int summon_group_count_add = 0;
        /// Modifiers applied to the summon's `SummonBehaviour`. Applied onto a copy of the behaviour,
        /// never mutating the shared instance stored on the spell.
        public SummonBehaviourModifier summon_behaviour = new SummonBehaviourModifier();
        public static class SummonBehaviourModifier { public SummonBehaviourModifier() { }
            /// Behaviour actions appended to the summon (e.g. additional spells to cast).
            public List<SummonBehaviour.Action.Entry> actions_add = List.of();
            /// Additive adjustments to the summon's lifespan phases.
            public Lifespan lifespan = new Lifespan();
            public static class Lifespan { public Lifespan() { }
                /// Ticks added to the inactionable spawn phase.
                public int spawn_ticks_add = 0;
                /// Seconds added to the active phase (the summon's effective lifetime).
                public int active_seconds_add = 0;
                /// Ticks added to the inactionable despawn phase.
                public int despawn_ticks_add = 0;
            }
        }
    }

    public Release release = new Release();
    public static class Release { public Release() { }
        public PlayerAnimation animation;
        public ParticleBatch[] particles;
        public ParticleBatch[] particles_scaled_with_ranged;
        /// Amount added to the release `sound` pitch, scaled by the charge ratio (CHARGE casts only).
        /// e.g. `0.5` raises the pitch by up to +0.5 at full charge.
        public float pitch_shift = 0F;
        public Sound sound;
        public List<ModelEffect> model_fx = List.of();
        /// Model effects whose `scale` is multiplied by the spell's range on release.
        /// Each entry's authored `scale` acts as the coefficient (final scale = scale * range).
        public List<ModelEffect> model_fx_scaled_with_ranged = List.of();
    }

    public Target target = new Target();
    public static class Target {
        public Type type = Type.CASTER;
        public enum Type {
            NONE, CASTER, AIM, BEAM, AREA, FROM_TRIGGER
        }
        // The number of maximum targets, applied when greater than zero
        public int cap = 0;

        public Aim aim;
        public static class Aim { public Aim() { }
            /// Whether an entity must be targeted to cast the spell
            public boolean required = false;
            /// Whether the spell casting process keeps an entity that was targeted already
            public boolean sticky = false;
            /// Whether the spell casting process uses the caster as a fallback target
            public boolean use_caster_as_fallback = false;
            /// Vertical repositioning of the aimed position (from cursor),
            /// ignored if an entity is targeted, respects ground
            public float reposition_vertically = 0F;
        }

        public Beam beam;
        public static class Beam {
            public Beam() {

            }
            public enum Luminance { LOW, MEDIUM, HIGH }
            public Beam.Luminance luminance = Beam.Luminance.HIGH;
            public String texture_id = "textures/entity/beacon_beam.png";
            public long color_rgba = 0xFFFFFFFFL;
            public long inner_color_rgba = 0xFFFFFFFFL;
            public float width = 0.1F;
            public float flow = 1;
            public ParticleBatch[] block_hit_particles = new ParticleBatch[]{};
        }

        public Area area;
        public static class Area { public Area() { }
            public enum DropoffCurve { NONE, SQUARED }
            public DropoffCurve distance_dropoff = DropoffCurve.NONE;
            public float horizontal_range_multiplier = 1F;
            public float vertical_range_multiplier = 1F;
            public float angle_degrees = 0F;
            public boolean include_caster = false;
        }
    }

    public Delivery deliver = new Delivery();
    public static class Delivery {
        public Type type = Type.DIRECT;
        public enum Type {
            DIRECT, PROJECTILE, METEOR, CLOUD, SHOOT_ARROW, AFFECT_ARROW, MELEE, STASH_EFFECT, CUSTOM
        }
        public int delay = 0;

        public ShootProjectile projectile;
        public static class ShootProjectile {
            public boolean inherit_shooter_velocity = false;
            public boolean inherit_shooter_yaw = true;
            public boolean inherit_shooter_pitch = true;
            public static class DirectionOffset { public DirectionOffset() { }
                public float yaw = 0; public float pitch = 0;
                public DirectionOffset(float yaw, float pitch) { this.yaw = yaw; this.pitch = pitch; }
            }
            public ShootProjectile.DirectionOffset[] direction_offsets;
            public boolean direction_offsets_require_target = false;
            /// Turns the projectile immediately towards the target
            public boolean direct_towards_target = false;
            /// Launch properties of the spell projectile
            public LaunchProperties launch_properties = new LaunchProperties();
            /// The projectile to be launched
            public ProjectileData projectile;
        }

        public Meteor meteor;
        public static class Meteor { public Meteor() { }
            /// How high the falling projectile is launched from compared to the position of the target
            public float launch_height = 10;
            public int offset_requires_sequence = 1;
            public int divergence_requires_sequence = 1;
            public int follow_target_requires_sequence = -1;
            /// How far horizontally the falling projectile is launched from the target
            public float launch_radius = 0;
            /// Launch properties of the falling projectile
            public LaunchProperties launch_properties = new LaunchProperties();
            /// The projectile to be launched
            public ProjectileData projectile;
        }

        public ShootArrow shoot_arrow;
        public static class ShootArrow { public ShootArrow() { }
            public boolean consume_arrow = true;
            public float divergence = 5F;
            public boolean arrow_critical_strike = true;
            /// Launch properties of the arrow
            /// (vanilla default velocity for crossbows is 3.15)
            public LaunchProperties launch_properties = new LaunchProperties().velocity(3.15F);
        }

        public AffectArrow affect_arrow;
        public static class AffectArrow { public AffectArrow() { }
        }

        public Melee melee;
        public static class Melee { public Melee() { }
            /// Whether the melee attacks can be started to perform while airborne,
            /// if false, the attack will be delayed until the caster is on the ground
            public boolean allow_airborne = true;
            public List<Attack> attacks = List.of();
            public static class Attack { public Attack() { }
                /// Only for internal use, do not touch this :)
                @NeverGenerate
                public String id = UUID.randomUUID().toString();
                /// Total damage additive multiplier. Example value: 0.5F for +50% of the total damage.
                public float damage_bonus = 0F;
                /// Duration of the melee attack (in ticks), if zero deferring to use attack cooldown duration (vanilla attack speed).
                public int duration = 0;
                /// A multiplier applied to animation, and non-static duration
                public float attack_speed_multiplier = 1F;
                /// Delay before strike (aka windup), actual value: multiplied by duration, rounded to whole ticks.
                public float delay = 0.25F;
                /// Whether additional melee attack should be performed in a row, with `additional_strike_delay` delay between them
                public int additional_strikes = 0;
                /// Delay between additional strikes, actual value: multiplied by duration, rounded to whole ticks.
                public float additional_strike_delay = 0.25F;
                /// If true additional hits on the same target are allowed.
                public boolean additional_hits_on_same_target = true;

                /// Forward momentum applied to the caster when performing this melee attack
                public float forward_momentum = 0F;
                /// Whether forward momentum can be applied while airborne
                public boolean allow_momentum_airborne = false;
                /// Multiplier applied to the movement speed while executing this melee attack.
                public float movement_speed = 1F;
                /// Bonus applied to block slipperiness. Use positive value to slide further.
                /// grass is 0.6, ice is 0.98
                public float movement_slipperiness = 0F;
                /// Collision detection shape of this attack.
                public HitBox hitbox = new HitBox();

                public PlayerAnimation animation;
                /// The sound to be played when the melee attack is performed.
                public Sound swing_sound;
                /// The sound to be played when the melee attack hits a target.
                public Sound impact_sound;
                /// The maximum number of times the impact sound to be played, to avoid overwhelming the audio channel when hitting lots of targets.
                /// Zero means no limit.
                public int impact_sound_cap = 3;
                public ParticleBatch[] particles = new ParticleBatch[]{};
                public List<ModelEffect> model_fx = List.of();
            }
            public static class HitBox {
                /// Relative length of the hitbox, will be scaled up by attack range.
                public float length = 1F;
                /// Relative width of the hitbox, will be scaled up by attack range.
                public float width = 1F;
                /// Relative height of the hitbox, will be scaled up by attack range.
                public float height = 1F;
                /// Rotation along the forward axis, in degrees.
                /// Positive values rotate clockwise, negative values rotate counterclockwise.
                public float roll = 0F;
                /// Arc of the melee attack hitbox, in degrees. 0 means no angular checks.
                public float arc = 0F;
            }
        }

        public List<Cloud> clouds;
        public static class Cloud { public Cloud() { }
            // Custom entity type id to spawn, must be a subclass of `SpellCloud`
            @Nullable public String entity_type_id;
            /// Ticks of spawn warm-up before the cloud turns active (no impacts; scales in).
            public int spawn_ticks = 0;
            /// Ticks of despawn wind-down after the active period (no impacts; scales out).
            public int despawn_ticks = 0;
            public AreaImpact volume = new AreaImpact();
            /// Active-phase duration (when impacts fire). Total life = spawn_ticks + this*20 + despawn_ticks.
            public float time_to_live_seconds = 0;

            /// The number of ticks between looking for targets and trying to apply impact
            public int impact_tick_interval = 5;
            /// The number of times impacts can be performed, zero means unlimited
            public int impact_cap = 0;
            public ParticleBatch[] impact_particles = new ParticleBatch[]{};

            /// Base spawn delay
            public int delay_ticks = 0;
            public boolean placement_delay_stacks = true;
            public EntityPlacement placement = new EntityPlacement();
            public List<EntityPlacement> additional_placements = List.of();

            @Nullable public Sound presence_sound;
            public Cloud.ClientData client_data = new Cloud.ClientData();
            public static class ClientData {
                public int light_level = 0;
                public ParticleBatch[] particles = new ParticleBatch[]{};
                public int particle_spawn_interval = 1;
                /// Particles to be spawned at the interval of `particle_spawn_interval`
                /// Useful for ground particles with fixed animation duration
                public ParticleBatch[] interval_particles = new ParticleBatch[]{};
                /// Legacy single cloud model. Superseded by `model_fx`.
                @Deprecated(forRemoval = true)
                public ProjectileModel model;
                /// Animatable cloud models, each driven by the modelFX system. When non-empty,
                /// supersedes `model`.
                public List<ModelEffect> model_fx = List.of();
            }
            public Cloud.Spawn spawn = new Cloud.Spawn();
            public static class Spawn {
                public Sound sound;
                public ParticleBatch[] particles = new ParticleBatch[]{};
                public List<ModelEffect> model_fx = List.of();
            }
            /// FX played once, server-side, as the cloud enters its wind-down (the DESPAWNING phase).
            /// Not emitted when `despawn_ticks == 0`: such clouds skip DESPAWNING and vanish on the spot.
            public Cloud.Despawn despawn = new Cloud.Despawn();
            public static class Despawn {
                public Sound sound;
                public ParticleBatch[] particles = new ParticleBatch[]{};
                public List<ModelEffect> model_fx = List.of();
            }
        }

        public StashEffect stash_effect;
        public static class StashEffect {
            /// Spells with valid `stash_effect` get automatically linked
            /// to the status effect specified below.
            /// No java code required.

            /// ID of the status effect, that will stash this spell.
            public String id;
            /// Stacks to apply -1
            public int amplifier = 0;
            public float amplifier_power_multiplier = 0;
            /// Whether effect stacks should be added one by one, or all at once
            public boolean stacking = false;
            /// Duration of the status effect in seconds
            public float duration = 10;
            public boolean show_particles = false;

            /// Trigger of the status effect
            public List<Trigger> triggers = List.of();
            /// Status effect stacks to consume upon triggering
            public int consume = 1;
            /// Whether the stash effect should be consumed next tick
            public boolean consumed_next_tick = false;
            /// Whether the stash effect should consume the stack available, or wait for larger than `consume` stacks
            public boolean consume_any_stacks = false;
            /// Determines what happens to the impacts of the spell when using this stash
            public ImpactMode impact_mode = ImpactMode.PERFORM;
            public enum ImpactMode {
                PERFORM,    /// Perform the impacts, on the target that is available at the time of triggering
                TRANSFER    /// Pass the impacts onto a projectile, that will be launched at the time of triggering
            }
        }

        public Custom custom;
        public static class Custom { public Custom() { }
            /// ID of the handler
            public String handler;
        }
    }

    public List<Impact> impacts = List.of();
    public static class Impact { public Impact() { }
        /// The chance to perform this impact
        public float chance = 1F;
        /// Magic school of this specific impact, if null then spell school is used
        @Nullable public SpellSchool school;
        /// Blends other schools into this impact's power ("hybrid" scaling).
        /// Each component merges the enabled aspects of its school's spell power into the base
        /// school's power (the impact `school`, or the spell's school) as a weighted average,
        /// where the base school always participates with weight 1. Aspects a component leaves
        /// disabled keep the base school's value undiluted. Any number of components is allowed
        /// (bi-/tri-brid…). `null` or empty = no blending.
        @Nullable public List<PowerBlend> power_blend;
        public static class PowerBlend { public PowerBlend() { }
            /// The school whose power is merged into the base school's power
            public SpellSchool school;
            /// Aspects of this school's power participating in the weighted average.
            /// All default to false — a component must enable at least one to have any effect.
            public boolean power = false;
            public boolean critical_chance = false;
            public boolean critical_damage = false;
            /// Weight of this component in the weighted average (the base school weighs 1)
            public float weight = 1;
        }
        public boolean attribute_from_target = false;
        /// Attribute the value of which to override the power
        @Nullable public String attribute;
        public List<TargetModifier> target_modifiers = List.of();
        public static class TargetModifier {
            // If true = AND, if false = OR
            public boolean all_required = false;
            public List<TargetCondition> conditions = List.of();

            /// Decides whether this impact should be carried out
            /// - ALLOW: Executes the impact if conditions are met
            /// - PASS: Executes the impact regardless of conditions
            /// - DENY: Executes the impact if conditions are NOT met
            public TriState execute = TriState.PASS;
            /// Applies power modifiers for this impact (if executed)
            @Nullable public Modifier modifier;
        }
        public static class Modifier {
            // Combined as `ADD_MULTIPLIED_BASE` in `EntityAttributeModifier.Operation`
            public float power_multiplier = 0;
            // Combined as `ADD_VALUE` in `EntityAttributeModifier.Operation`
            public float critical_chance_bonus = 0;
            // Combined as `ADD_VALUE` in `EntityAttributeModifier.Operation`
            public float critical_damage_bonus = 0;
        }

        public Action action;
        public static class Action { public Action() { }
            public Type type;
            /// Whether as an area impact, should be executed on the center target
            public boolean allow_on_center_target = true;
            public boolean apply_to_caster = false;
            public float min_power = 1;
            public float max_power = 999999;
            public enum Type {
                DAMAGE,
                HEAL,
                STATUS_EFFECT,
                FIRE,
                SPAWN,
                SUMMON,
                TELEPORT,
                COOLDOWN,
                AGGRO,
                DISRUPT,
                IMMUNITY,
                VELOCITY,
                CUSTOM
            }
            public Damage damage;
            public static class Damage { public Damage() { }
                public boolean bypass_iframes = true;
                public float spell_power_coefficient = 1;
                public float knockback = 1;
            }
            public Heal heal;
            public static class Heal { public Heal() { }
                public float spell_power_coefficient = 1;
            }
            public StatusEffect status_effect;
            public static class StatusEffect { public StatusEffect() { }
                /// ID of the status effect to apply
                public String effect_id;
                /// Duration of the status effect in seconds
                public float duration = 10;
                /// How many stacks to apply (0 = 1, 1 = 2, 2 = 3, etc...)
                public int amplifier = 0;
                /// How many additional stacks to apply based on power
                public float amplifier_power_multiplier = 0;
                /// Maximum stacks to apply (ignored by mode `ADD`, where this is achieved by `amplifier`)
                public int amplifier_cap = 0;
                /// Maximum additional stacks to apply based on power
                public float amplifier_cap_power_multiplier = 0;
                /// Whether already applied stacks should be refreshed
                public boolean refresh_duration = true;

                public enum ApplyMode { SET, ADD, REMOVE }
                public ApplyMode apply_mode = ApplyMode.SET;

                @Nullable public ApplyLimit apply_limit;
                public static class ApplyLimit { public ApplyLimit() { }
                    public float health_base = 0;
                    public float spell_power_multiplier = 0;
                }
                public boolean show_particles = false;

                public Remove remove;
                public static class Remove { public Remove() { }
                    public enum Selector { RANDOM, FIRST, ALL }
                    /// Status effect id pattern
                    /// (Universal pattern matcher)
                    @Nullable public String id;
                    public Selector selector = Selector.RANDOM;
                    public boolean select_beneficial = false;
                    /// When set, only effects whose movement-impairing classification matches are
                    /// eligible (slows, snares, gravity changes — server-computed, covers modded
                    /// effects too; see `StatusEffectClassification`)
                    @Nullable public Boolean movement_impairing;
                }
            }

            public Fire fire;
            public static class Fire { public Fire() { }
                /// Number of seconds the target is on fire
                public float duration = 2;
                // Entity.java - Notice `% 20` - tick offset is used to avoid instant hits
                // if (this.fireTicks % 20 == 0 && !this.isInLava()) {
                //    this.damage(DamageSource.ON_FIRE, 1.0f);
                // }
                public int tick_offset = 10;
            }

            // Populate either `spawn` or `spawns` but not both
            public List<Spawn> spawns;
            public static class Spawn { public Spawn() { }
                public SpellTarget.Intent intent = SpellTarget.Intent.HELPFUL;
                // Custom entity type id to spawn
                // Implement `SpellEntity.Spawned` to receive information about spawning context
                public String entity_type_id;
                public int time_to_live_seconds = 0;
                public int delay_ticks = 0;
                public EntityPlacement placement = new EntityPlacement();

                public Spawn copy() {
                    Spawn copy = new Spawn();
                    copy.intent = this.intent;
                    copy.entity_type_id = this.entity_type_id;
                    copy.time_to_live_seconds = this.time_to_live_seconds;
                    copy.delay_ticks = this.delay_ticks;
                    copy.placement = this.placement;
                    return copy;
                }
            }

            public Teleport teleport;
            public static class Teleport { public Teleport() { }
                public enum Mode { FORWARD, BEHIND_TARGET }
                public Mode mode;
                public int required_clearance_block_y = 1;
                /// Minimum travel distance (in blocks, straight-line) required for the teleport to happen.
                /// If the resolved destination is closer than this — or no safe destination exists at all —
                /// the teleport is aborted ("fizzles"): the caster stays put and no cost/cooldown is paid.
                /// A value of `0` (default) disables the check, preserving legacy behavior.
                public float minimum_distance = 0;
                /// FX played at the caster's position when the teleport fizzles (see `minimum_distance`).
                @Nullable public Fizzle fizzle;
                public static class Fizzle { public Fizzle() { }
                    @Nullable public Sound sound;
                    @Nullable public ParticleBatch[] particles;
                }
                public SpellTarget.Intent intent = SpellTarget.Intent.HELPFUL;
                public Forward forward;
                public static class Forward { public Forward() { }
                    public float distance = 10;
                }
                public BehindTarget behind_target;
                public static class BehindTarget { public BehindTarget() { }
                    public float distance = 1.5F;
                }
                @Nullable public ParticleBatch[] depart_particles;
                @Nullable public List<ModelEffect> depart_model_fx;
                @Nullable public ParticleBatch[] arrive_particles;
                @Nullable public List<ModelEffect> arrive_model_fx;
            }

            public Cooldown cooldown;
            public static class Cooldown { public Cooldown() { }
                @Nullable public Modify actives;
                @Nullable public Modify passives;
                public static class Modify { public Modify() { }
                    /// Spell school regex
                    @Nullable public String school;
                    /// ID of the spell
                    /// (Universal pattern matcher: `#` prefix checks tag, `~` prefix checks regex, no prefix checks exact match)
                    @Nullable public String id;
                    public float duration_add = 0;
                    public float duration_multiplier = 1;
                }
            }

            public Aggro aggro;
            public static class Aggro { public Aggro() { }
                /// Executes the aggro change only of the caster is targeted by the target
                public boolean only_if_targeted = false;
                /// What to do with the aggro
                public enum Mode {
                    /// Taunt the target, so it will attack the caster
                    SET,
                    /// Clear the taunt from the target, so it will not attack the caster
                    CLEAR
                }
                public Mode mode = Mode.SET;
            }

            public Disrupt disrupt;
            public static class Disrupt {  public Disrupt() { }
                public boolean shield_blocking = false;
                public float item_usage_seconds = 0F;
            }

            public Immunity immunity;
            public static class Immunity { public Immunity() { }
                /// Damage type specifier, id or tag, for example:
                /// - `#minecraft:bypasses_armor` - tag
                /// - `minecraft:drown` - id
                /// - null means all damage types
                public @Nullable String damage_type;
                /// Whether the DamageSource needs to be damageIndirect or not, for example:
                /// - player melee attacks are direct
                /// - spell projectile impacts (such as Fireball) are direct
                /// - spell area effects (such as Fire Breath) are damageIndirect
                public @Nullable Boolean damage_indirect;
                /// Whether the immunity should block harmful effects in general
                public boolean effect_any_harmful = false;
                /// Duration of the invulnerability in ticks
                public int duration_ticks = 20;
            }

            public Velocity velocity;
            /// Pushes the target's velocity. Flexible enough for knockbacks, pulls, and mobility launches
            /// (up / forwards / backwards / towards- or away-from-origin, or any mix). For players it is
            /// synced to their own client, so it moves the caster too, not just other entities.
            /// <p>
            /// The push is a vector in a chosen reference {@link Frame}. Its Y component is always
            /// world-up; its horizontal (X/Z) components are interpreted relative to the frame — so a
            /// single vector + frame expresses all the directions without a large enum.
            public static class Velocity { public Velocity() { }
                public enum Frame {
                    /// Horizontal axes follow the caster's facing: +Z is forward, +X is to the right
                    /// (Y is world-up). Use for forwards/backwards launches.
                    LOOK,
                    /// Horizontal axes are radial to the impact's origin — the area-of-effect centre for
                    /// an area impact (explosion, cloud, meteor landing), or the caster for a direct hit:
                    /// +Z points away from the origin, +X is tangent to it (Y is world-up). Use for
                    /// knock-away / pull-towards.
                    ORIGIN
                }
                public Frame frame = Frame.ORIGIN;
                /// Impulse in blocks per tick, within `frame`. Its magnitude is the speed, e.g.
                /// (0,1,0)=up, (0,0,1)=forward/away, (0,0,-1)=back/towards, (0,0.4,1)=knock away with a
                /// pop up, (1,0,0)=sideways/tangential.
                public Vector3f push = new Vector3f(0, 0.5F, 0);
                /// Scales `push` by (1 + power_coefficient * spellPower), so the push grows with the
                /// impact's spell power. Left 0, the push is a fixed speed regardless of power.
                public float power_coefficient = 0F;
                /// Zero the target's current velocity before applying the impulse, for a consistent
                /// launch regardless of prior motion (rather than adding to whatever it was doing).
                public boolean reset_velocity = false;
                /// Whether this counts as helping or harming the target, for target filtering and
                /// knockback resistance. A pull or knock on enemies is HARMFUL; lifting yourself or an
                /// ally is HELPFUL.
                public SpellTarget.Intent intent = SpellTarget.Intent.HARMFUL;
            }

            public Custom custom;
            public static class Custom { public Custom() { }
                public SpellTarget.Intent intent = SpellTarget.Intent.HELPFUL;
                /// ID of the handler
                public String handler;
            }

            public Summon summon;
            /// Declarative definition of a spell-summoned entity (or formation of them): the entity
            /// type to spawn, its full runtime {@link SummonBehaviour}, and where/how it is placed
            /// (reusing {@link EntityPlacement}). Spawned relative to the caster — see the SUMMON
            /// impact handling in `SpellHelper`.
            ///
            /// Unlike {@link Spawn}, time-to-live is not a separate field — it is part of
            /// {@link SummonBehaviour#lifespan}.
            public static class Summon {
                /// Registry id of the entity type to spawn. The entity type must implement
                /// `SpellSummoned`.
                public String entity_type_id;

                /// Full runtime behaviour: lifespan, movement, targeting, actions, sounds.
                public SummonBehaviour behaviour = new SummonBehaviour();

                /// Owner-scaled attribute bonuses, applied once at spawn (a one-time effect, not part
                /// of the runtime behaviour). Re-applied on chunk reload since the resulting attribute
                /// modifiers are temporary.
                public AttributeScaling attribute_scaling = new AttributeScaling();

                /// Per-entity spawn-location slots within a group. {@link #spawn_count} entities are
                /// spawned per group, cycling through this list and wrapping (slot `i % size`).
                public List<EntityPlacement> placements = new ArrayList<>();

                /// How many entities to spawn per group, cycling through {@link #placements}. Default 1.
                public int spawn_count = 1;

                /// Group-level placement slots. {@link #group_count} groups are spawned; group `g`
                /// uses `group_placements.get(g % size)` as a translation offset (its resulting
                /// position seeds the per-entity placements) applied to every entity in that group.
                /// Empty (default) = a single group anchored at the caster, no group offset.
                ///
                /// Composition is translation only: a group offset moves where its formation is
                /// anchored, but the in-group formation keeps its caster-relative orientation.
                public List<EntityPlacement> group_placements = new ArrayList<>();

                /// How many groups to spawn, each replaying the per-entity formation translated by the
                /// next group placement. Default 1.
                public int group_count = 1;

                /// One-shot FX emitted once per group, at the group's anchor, deferred by the group
                /// placement's `delay_ticks`. Null = none.
                @Nullable public VFX group_spawn_fx = null;

                /// Sound played once per group when it spawns, at the group's anchor (deferred by the
                /// group placement's `delay_ticks`). Null = none.
                @Nullable public Sound group_spawn_sound = null;

                public Summon() {}

                public Summon(String entity_type_id, SummonBehaviour behaviour, List<EntityPlacement> placements, int spawn_count) {
                    this.entity_type_id = entity_type_id;
                    this.behaviour = behaviour;
                    this.placements = placements;
                    this.spawn_count = spawn_count;
                }

                public Summon(String entity_type_id, SummonBehaviour behaviour,
                              List<EntityPlacement> placements, int spawn_count,
                              List<EntityPlacement> group_placements, int group_count) {
                    this(entity_type_id, behaviour, placements, spawn_count);
                    this.group_placements = group_placements;
                    this.group_count = group_count;
                }
            }
        }

        public ParticleBatch[] particles = new ParticleBatch[]{};
        public Sound sound;
        public List<ModelEffect> model_fx = List.of();
    }
    /// Apply this impact to other entities nearby
    @Nullable public AreaImpact area_impact;

    @Nullable public ArrowPerks arrow_perks = null;
    public static class ArrowPerks { public ArrowPerks() { }
        public float damage_multiplier = 1F;
        public float velocity_multiplier = 1F;
        public boolean bypass_iframes = false;
        public int iframe_to_set = 0;
        public boolean skip_arrow_damage = false;
        public int pierce = 0;
        public float knockback = 1;
        public ParticleBatch[] travel_particles = new ParticleBatch[]{};
        public ParticleBatch[] launch_particles = new ParticleBatch[]{};
        @Nullable public Sound launch_sound;
        /// Legacy single override model. Superseded by `composite_model`.
        @Deprecated(forRemoval = true)
        @Nullable public ProjectileModel override_render;
        /// Multi-model successor to `override_render`. When present and non-empty, supersedes it.
        @Nullable public ProjectileModelComposite composite_model;

        public ArrowPerks copy() {
            ArrowPerks copy = new ArrowPerks();
            copy.damage_multiplier = this.damage_multiplier;
            copy.velocity_multiplier = this.velocity_multiplier;
            copy.bypass_iframes = this.bypass_iframes;
            copy.iframe_to_set = this.iframe_to_set;
            copy.skip_arrow_damage = this.skip_arrow_damage;
            copy.pierce = this.pierce;
            copy.knockback = this.knockback;
            copy.travel_particles = this.travel_particles;
            copy.launch_particles = this.launch_particles;
            copy.launch_sound = this.launch_sound;
            copy.override_render = this.override_render;
            copy.composite_model = this.composite_model;
            return copy;
        }

        /// Merges a modifier's perks into this one. Counts add up, multipliers compound, and flags
        /// latch on — so a modifier only ever grants perks, never revokes what the spell already has.
        /// FX and model fields are left untouched: modifiers tune arrow behaviour, not its looks.
        public void mutatingCombine(ArrowPerks other) {
            this.damage_multiplier *= other.damage_multiplier;
            this.velocity_multiplier *= other.velocity_multiplier;
            this.knockback *= other.knockback;
            this.pierce += other.pierce;
            this.bypass_iframes = this.bypass_iframes || other.bypass_iframes;
            this.skip_arrow_damage = this.skip_arrow_damage || other.skip_arrow_damage;
            this.iframe_to_set = Math.max(this.iframe_to_set, other.iframe_to_set);
        }

        /// Neutral element for `mutatingCombine`: adds nothing on its own. Use this as the base of a
        /// modifier's perks, since the field defaults (`damage_multiplier`/`knockback` of 1) are only
        /// neutral because they multiply — an explicit factory keeps that intent readable.
        public static ArrowPerks EMPTY() {
            return new ArrowPerks();
        }
    }

    /// Applied to the caster, once the spell casting process finishes
    public Cost cost = new Cost();
    public static class Cost { public Cost() { }
        /// Whether the cost should be executed at the end of the game tick
        /// So multiple targets can be affected by a triggered execution
        public boolean batching = false;
        /// Exhaust to add
        public float exhaust = 0.1F;
        /// Durability of the spell host item to consume
        public int durability = 1;
        /// Status effect to remove
        /// (Useful for channeled spells)
        @Nullable public String effect_id;

        public Cooldown cooldown = new Cooldown();
        public static class Cooldown {
            /// Arbitrary group code, used to share cooldowns between multiple spells
            @Nullable public String group;
            /// Duration of the cooldown applied on spell cast attempt in seconds (useful for delayed deliveries)
            public float attempt_duration = 0;
            /// Duration of the cooldown in seconds
            public float duration = 0;
            /// Whether the duration to be multiplied by channeling duration
            public boolean proportional = false;
            /// Whether the cooldown is affected by haste
            public boolean haste_affected = true;
            /// Whether item cooldown is imposed onto the hosting item of this spell
            public boolean hosting_item = true;
        }

        @Nullable public Item item;
        public static class Item {
            /// ID or Tag
            /// (When using tags, make sure to have a translation for tha tag)
            public String id;
            /// How many of the item is consumed
            public int amount = 1;
            /// When set to false, spell cast attempt will check availability,
            /// but upon successful cast will not be consumed
            /// (Useful for archery skills)
            public boolean consume = true;
        }
    }

    // MARK: Shared structures (used from multiple places in the spell structure)

    public static class Trigger {
        @Nullable public TargetSelector target_override;
        @Nullable public TargetSelector aoe_source_override;
        public enum TargetSelector { CASTER, AOE_SOURCE, TARGET }

        public enum Type {
            ARROW_SHOT, ARROW_IMPACT,
            MELEE_IMPACT,
            SPELL_CAST, SPELL_IMPACT_ANY, SPELL_IMPACT_SPECIFIC,
            SPELL_AREA_IMPACT,
            EFFECT_TICK, /// Only works for specifically coded Status Effect implementations
            EVASION, /// Performed when the caster evades an attack
            DAMAGE_TAKEN, SHIELD_BLOCK,
            ROLL  /// Only works when Combat Roll mod is installed
        }
        public Type type;
        public enum Stage { PRE, POST }
        /// Represents when the trigger happens
        /// - PRE: Before the actual event
        /// - POST: After the actual event
        /// Only works for some trigger types
        public Stage stage = Stage.POST;
        /// Number of ticks to wait before the spell is performed after a successful trigger
        public int fire_delay = 0;
        /// Limits the number of times this trigger can be executed per game tick
        /// (0 = unlimited)
        public int cap_per_tick = 0;
        /// Chance to trigger. 0 = 0%, 1 = 100%
        public float chance = 1;
        /// Calculates and stores the chance, for the duration of a single game tick
        /// So multiple targets can be affected by the same chance
        public boolean chance_batching = false;
        /// When a value is given, this spell need to be present on the equipped item of the given slot
        /// Recommended use: EquipmentSlot.MAINHAND for weapon passives, so attacks with inactive hand don't trigger
        @Nullable public EquipmentSlot equipment_condition;

        /// When a value is given, the item that performed the triggering attack must match this pattern:
        /// - ARROW_SHOT, ARROW_IMPACT: the weapon the arrow was fired from (spell-fired arrows carry no weapon, so they never match)
        /// - MELEE_IMPACT: the item in the hand performing the attack
        /// - anything else: the caster's main-hand item
        /// (Universal pattern matcher: `#` prefix checks tag, `~` prefix checks regex, `!` prefix negates, no prefix checks exact match)
        @Nullable public String weapon_condition;

        @Nullable public List<TargetCondition> caster_conditions;
        @Nullable public List<TargetCondition> target_conditions;

        /// Evaluated for: SPELL_CAST, SPELL_IMPACT_ANY, SPELL_IMPACT_SPECIFIC
        public SpellCondition spell;
        public static class SpellCondition { public SpellCondition() { }
            /// Spell school regex
            @Nullable public String school;
            /// Exact archetype of the spell school
            @Nullable public SpellSchool.Archetype archetype;
            /// Exact type of the spell
            @Nullable public Spell.Type type;
            /// ID of the spell
            /// (Universal pattern matcher: `#` prefix checks tag, `~` prefix checks regex, no prefix checks exact match)
            @Nullable public String id;
            /// The spell needs to have at least his long of a cooldown
            public float cooldown_min = 0;
            // Maybe add predicate, that can be registered in java, and resolved by this id
            // public String spell_predicate
        }
        /// Evaluated for: SPELL_IMPACT_SPECIFIC
        public ImpactCondition impact;
        public static class ImpactCondition { public ImpactCondition() { }
            // Impact type regex
            @Nullable public String impact_type;
            @Nullable public Boolean critical;
        }

        public DamageCondition damage;
        public static class DamageCondition { public DamageCondition() { }
            /// Minimum damage
            @Nullable public Float amount_min = null;
            /// Maximum damage
            @Nullable public Float amount_max = null;
            /// Damage type pattern
            @Nullable public String damage_type;
            /// Whether the damage amount is greater than the amount of health the target has
            @Nullable public Boolean fatal;
        }
        /// Evaluated for: MELEE_IMPACT
        public MeleeCondition melee;
        public static class MeleeCondition { public MeleeCondition() { }
            @Nullable public Boolean is_combo;
            @Nullable public Boolean is_offhand;
            /// Whether the triggering melee hit must (true) or must not (false) be a critical strike
            @Nullable public Boolean critical;
        }
        /// Evaluated for: EFFECT_TICK
        public EffectCondition effect;
        public static class EffectCondition { public EffectCondition() { }
            /// ID of the status effect
            public String id;
        }
        /// Evaluated for: ARROW_SHOT
        public ArrowShotCondition arrow_shot;
        public static class ArrowShotCondition { public ArrowShotCondition() { }
            /// Defines the source of the arrow shot
            /// `true`  - from a spell
            /// `false` - from a bow or crossbow
            @Nullable public Boolean from_spell;
        }
    }

    public static class AreaImpact { public AreaImpact() { }
        /// Only impacts of this type to trigger area impact
        /// If null, all impacts trigger area impact
        @Nullable public Impact.Action.Type triggering_action_type;
        /// Only impacts of this type to execute upon area impact
        /// If null, all impacts execute upon area impact
        @Nullable public Impact.Action.Type execute_action_type;

        public boolean force_indirect = false;

        public float radius = 1F;
        public ExtraRadius extra_radius = new ExtraRadius();
        public static class ExtraRadius {
            public float power_coefficient = 0;
            public float power_cap = 0;
        }
        public Target.Area area = new Target.Area();
        public ParticleBatch[] particles = new ParticleBatch[]{};
        @Nullable
        public Sound sound;
        public List<ModelEffect> model_fx = List.of();

        public float combinedRadius(double power) {
            return radius + extra_radius.power_coefficient * (float) Math.min(extra_radius.power_cap, power);
        }
    }

    public static class LaunchProperties { public LaunchProperties() { }
        /// Initial velocity of the projectile
        public float velocity = 1F;
        /// When channeling, the index of the channel to, when extra projectiles to shoot
        public int extra_launch_mod = -1;
        /// How many additional projectiles are spawned after launch
        public int extra_launch_count = 0;
        /// How many ticks after launch additional projectiles are spawned
        public int extra_launch_delay = 2;
        /// The sound to play on launch
        @Nullable public Sound sound;

        public LaunchProperties velocity(float value) {
            this.velocity = value;
            return this;
        }
        public LaunchProperties copy() {
            LaunchProperties copy = new LaunchProperties();
            copy.velocity = this.velocity;
            copy.extra_launch_mod = this.extra_launch_mod;
            copy.extra_launch_count = this.extra_launch_count;
            copy.extra_launch_delay = this.extra_launch_delay;
            copy.sound = this.sound != null ? this.sound.copy() : null;
            return copy;
        }

        public void mutatingCombine(LaunchProperties other)  {
            this.velocity += other.velocity;
            this.extra_launch_mod = other.extra_launch_mod >= 0 ? other.extra_launch_mod : this.extra_launch_mod;
            this.extra_launch_count += other.extra_launch_count;
            this.extra_launch_delay += other.extra_launch_delay;
        }

        public static LaunchProperties EMPTY() {
            LaunchProperties empty = new LaunchProperties();
            empty.velocity = 0;
            empty.extra_launch_mod = -1;
            empty.extra_launch_count = 0;
            empty.extra_launch_delay = 0;
            return empty;
        }
    }

    public static class ProjectileData { public ProjectileData() { }
        public float divergence = 0;
        public float homing_angle = 1F;
        @Nullable public float[] homing_angles = null;
        public float homing_after_absolute_distance = 0;
        public float homing_after_relative_distance = 0;
        /// The frequency of playing the travel sound in ticks
        public int travel_sound_interval = 20;
        @Nullable public Sound travel_sound;

        public Perks perks = new Perks();
        public static class Perks { public Perks() { }
            /// How many entities projectile can ricochet to
            public int ricochet = 0;
            /// How far ricochet can look for a target
            public float ricochet_range = 5;
            /// How many times projectile can bounce off a wall
            public int bounce = 0;
            /// Whether ricochet and bounce should be decremented together
            public boolean bounce_ricochet_sync = true;
            /// How many entities projectile can go through
            public int pierce = 0;
            /// How many additional projectiles are spawned on impact
            public int chain_reaction_size = 0;
            /// How many generation of chain reaction projectiles are spawned
            public int chain_reaction_triggers = 1;
            /// How many more projectiles are spawned from chain reaction of a spawned projectile
            public int chain_reaction_increment = -1;

            public Perks copy() {
                Perks copy = new Perks();
                copy.ricochet = this.ricochet;
                copy.ricochet_range = this.ricochet_range;
                copy.bounce = this.bounce;
                copy.bounce_ricochet_sync = this.bounce_ricochet_sync;
                copy.pierce = this.pierce;
                copy.chain_reaction_size = this.chain_reaction_size;
                copy.chain_reaction_triggers = this.chain_reaction_triggers;
                copy.chain_reaction_increment = this.chain_reaction_increment;
                return copy;
            }

            public void mutatingCombine(Perks other) {
                this.ricochet += other.ricochet;
                this.ricochet_range += other.ricochet_range;
                this.bounce += other.bounce;
                this.pierce += other.pierce;
                this.chain_reaction_size += other.chain_reaction_size;
                this.chain_reaction_triggers += other.chain_reaction_triggers;
                this.chain_reaction_increment += other.chain_reaction_increment;
            }

            public static Perks EMPTY() {
                Perks empty = new Perks();
                empty.ricochet = 0;
                empty.ricochet_range = 0;
                empty.bounce = 0;
                empty.pierce = 0;
                empty.chain_reaction_size = 0;
                empty.chain_reaction_triggers = 0;
                empty.chain_reaction_increment = 0;
                return empty;
            }
        }

        /// Custom bounding box of the projectile.
        /// When set, enables volumetric (OBB/SAT) collision detection instead of raycast.
        @Nullable public HitBox hitbox;
        public static class HitBox { public HitBox() { }
            public HitBox(float width, float height) { this.width = width; this.height = height; }
            public float width = 0.5F;
            public float height = 0.5F;
            /// OBB depth along the travel direction; 0 = use width as fallback
            public float length = 0;
        }

        public Client client_data;
        public static class Client { public Client() { }
            /// Ambient light level of the projectile, like players holding torches
            /// Requires `LambDynamicLights` to be installed
            /// Example values:
            /// 14 - torch
            /// 10 - soul torch
            public int light_level = 0;
            public ParticleBatch[] travel_particles = new ParticleBatch[]{};
            /// Legacy single projectile model. Superseded by `composite_model`.
            @Deprecated(forRemoval = true)
            public ProjectileModel model;
            /// Multi-model successor to `model`. When present and non-empty, supersedes `model`.
            public ProjectileModelComposite composite_model;
        }
    }

    /// Legacy single-model projectile/cloud visual. Superseded by {@link ProjectileModelComposite}
    /// (projectiles) and a `List<ModelEffect>` (clouds); slated for removal once both legacy render
    /// paths are gone.
    @Deprecated(forRemoval = true)
    public static class ProjectileModel { public ProjectileModel() { }
        public boolean use_held_item = false;
        public String model_id;
        public LightEmission light_emission = LightEmission.GLOW;
        public float scale = 1F;
        public float rotate_degrees_per_tick = 2F;
        public float rotate_degrees_offset = 0;
        public Orientation orientation = Orientation.TOWARDS_MOTION;
        public enum Orientation {
            TOWARDS_CAMERA, TOWARDS_MOTION, ALONG_MOTION
        }
    }

    /// Multi-model successor to {@link ProjectileModel}: a projectile can render several models,
    /// each animatable via the modelFX system ({@link ModelEffect}). Self-contained on purpose
    /// (its own {@link Orientation}) so the legacy {@link ProjectileModel} can be removed without
    /// touching this. When a projectile's composite is present and non-empty, it supersedes the
    /// legacy single model.
    public static class ProjectileModelComposite { public ProjectileModelComposite() { }
        public List<Model> models = List.of();

        public static class Model { public Model() { }
            /// Facing relative to the projectile's travel.
            public Orientation orientation = Orientation.TOWARDS_MOTION;
            /// Continuous spin about the view/motion axis (degrees per tick) plus a static offset.
            /// Defaults to 2 to match the legacy ProjectileModel; set 0 for a non-spinning (e.g. flat) model.
            public float rotate_degrees_per_tick = 2F;
            public float rotate_degrees_offset = 0F;
            /// Render the caster's held-item id as this model's source instead of `fx.model_id`.
            public boolean use_held_item = false;
            /// The animatable model, driven by the modelFX system: `model_id`, `light_emission`,
            /// `scale`, `positioning`, and the `initial`/`animations` transforms.
            /// `fx.duration` and `fx.follow_entity` are unused in projectile context (animation time
            /// is the projectile's age; the model is rendered on the projectile itself).
            public ModelEffect fx = new ModelEffect();
        }

        /// Duplicated from {@link ProjectileModel.Orientation} on purpose, to keep this type
        /// independent of the legacy one.
        public enum Orientation {
            TOWARDS_CAMERA, TOWARDS_MOTION, ALONG_MOTION
        }
    }

    public static class EntityPlacement { public EntityPlacement() { }
        // If greater than 0, the entity will be placed at the caster's look direction, by this many blocks
        public int delay_ticks = 0;
        public boolean force_onto_ground = true;
        // Determines whether line of sight based fallback position need to be resolved
        public boolean line_of_sight = false;
        public float location_offset_by_look = 0;
        public float location_yaw_offset = 0;
        public boolean apply_yaw = false;
        public boolean apply_pitch = false;
        public float location_offset_x = 0;
        public float location_offset_y = 0;
        public float location_offset_z = 0;

        public EntityPlacement copy() {
            var copy = new EntityPlacement();
            copy.delay_ticks = this.delay_ticks;
            copy.force_onto_ground = this.force_onto_ground;
            copy.line_of_sight = this.line_of_sight;
            copy.location_offset_by_look = this.location_offset_by_look;
            copy.location_yaw_offset = this.location_yaw_offset;
            copy.apply_yaw = this.apply_yaw;
            copy.apply_pitch = this.apply_pitch;
            copy.location_offset_x = this.location_offset_x;
            copy.location_offset_y = this.location_offset_y;
            copy.location_offset_z = this.location_offset_z;
            return copy;
        }
    }

    public static class TargetCondition {
        public float health_percent_above = 0;
        public float health_percent_below = 1;
        /// ID of the entity type
        /// (Universal pattern matcher: `#` prefix checks tag, `~` prefix checks regex, no prefix checks exact match)
        @Nullable public String entity_type;
        /// ID of a registered SpellEntityPredicate
        /// Check out `SpellEntityPredicates` class for options, or new registration
        @Nullable public String entity_predicate_id;
        /// Parameter to pass to the predicate
        /// Each predicate handles this differently
        @Nullable public String entity_predicate_param;
    }
}