veloren_common/comp/

ability.rs

use crate::{
    combat::{self, CombatEffect, DamageKind, Knockback, ScalingKind},
    comp::{
        self, Body, CharacterState, LightEmitter, StateUpdate, aura, beam, buff,
        character_state::AttackFilters,
        inventory::{
            Inventory,
            item::{
                ItemDefinitionIdOwned, ItemKind, Tool,
                tool::{
                    AbilityContext, AbilityItem, AbilityKind, ContextualIndex, Stats, ToolKind,
                },
            },
            slot::EquipSlot,
        },
        item::Reagent,
        melee::{CustomCombo, MeleeConstructor, MeleeConstructorKind},
        projectile::ProjectileConstructor,
        skillset::{
            SkillSet,
            skills::{self, SKILL_MODIFIERS, Skill},
        },
    },
    explosion::{ColorPreset, TerrainReplacementPreset},
    match_some,
    resources::Secs,
    states::{
        behavior::JoinData,
        sprite_summon::SpriteSummonAnchor,
        utils::{
            AbilityInfo, ComboConsumption, MovementModifier, OrientationModifier, ProjectileSpread,
            StageSection,
        },
        *,
    },
    terrain::SpriteKind,
};
use hashbrown::HashMap;
use serde::{Deserialize, Serialize};
use specs::{Component, DerefFlaggedStorage};
use std::{borrow::Cow, time::Duration};

pub const BASE_ABILITY_LIMIT: usize = 5;

// NOTE: different AbilitySpec on same ToolKind share the same key
/// Descriptor to pick the right (auxiliary) ability set
pub type AuxiliaryKey = (Option<ToolKind>, Option<ToolKind>);

// TODO: Potentially look into storing previous ability sets for weapon
// combinations and automatically reverting back to them on switching to that
// set of weapons. Consider after UI is set up and people weigh in on memory
// considerations.
#[derive(Serialize, Deserialize, Debug, Clone)]
pub struct ActiveAbilities {
    pub guard: GuardAbility,
    pub primary: PrimaryAbility,
    pub secondary: SecondaryAbility,
    pub movement: MovementAbility,
    pub limit: Option<usize>,
    pub auxiliary_sets: HashMap<AuxiliaryKey, Vec<AuxiliaryAbility>>,
}

impl Component for ActiveAbilities {
    type Storage = DerefFlaggedStorage<Self, specs::VecStorage<Self>>;
}

impl Default for ActiveAbilities {
    fn default() -> Self {
        Self {
            guard: GuardAbility::Tool,
            primary: PrimaryAbility::Tool,
            secondary: SecondaryAbility::Tool,
            movement: MovementAbility::Species,
            limit: None,
            auxiliary_sets: HashMap::new(),
        }
    }
}

// make it pub, for UI stuff, if you want
enum AbilitySource {
    Weapons,
    Glider,
}

impl AbilitySource {
    // Get all needed data here and pick the right ability source
    //
    // make it pub, for UI stuff, if you want
    fn determine(char_state: Option<&CharacterState>) -> Self {
        if char_state.is_some_and(|c| c.is_glide_wielded()) {
            Self::Glider
        } else {
            Self::Weapons
        }
    }
}

impl ActiveAbilities {
    pub fn from_auxiliary(
        auxiliary_sets: HashMap<AuxiliaryKey, Vec<AuxiliaryAbility>>,
        limit: Option<usize>,
    ) -> Self {
        // Discard any sets that exceed the limit
        ActiveAbilities {
            auxiliary_sets: auxiliary_sets
                .into_iter()
                .filter(|(_, set)| limit.is_none_or(|limit| set.len() == limit))
                .collect(),
            limit,
            ..Self::default()
        }
    }

    pub fn default_limited(limit: usize) -> Self {
        ActiveAbilities {
            limit: Some(limit),
            ..Default::default()
        }
    }

    pub fn change_ability(
        &mut self,
        slot: usize,
        auxiliary_key: AuxiliaryKey,
        new_ability: AuxiliaryAbility,
        inventory: Option<&Inventory>,
        skill_set: Option<&SkillSet>,
    ) {
        let auxiliary_set = self
            .auxiliary_sets
            .entry(auxiliary_key)
            .or_insert(Self::default_ability_set(inventory, skill_set, self.limit));
        if let Some(ability) = auxiliary_set.get_mut(slot) {
            *ability = new_ability;
        }
    }

    pub fn active_auxiliary_key(inv: Option<&Inventory>) -> AuxiliaryKey {
        let tool_kind = |slot| {
            inv.and_then(|inv| inv.equipped(slot))
                .and_then(|item| match_some!(&*item.kind(), ItemKind::Tool(tool) => tool.kind))
        };

        (
            tool_kind(EquipSlot::ActiveMainhand),
            tool_kind(EquipSlot::ActiveOffhand),
        )
    }

    pub fn auxiliary_set(
        &self,
        inv: Option<&Inventory>,
        skill_set: Option<&SkillSet>,
    ) -> Cow<'_, Vec<AuxiliaryAbility>> {
        let aux_key = Self::active_auxiliary_key(inv);

        self.auxiliary_sets
            .get(&aux_key)
            .map(Cow::Borrowed)
            .unwrap_or_else(|| Cow::Owned(Self::default_ability_set(inv, skill_set, self.limit)))
    }

    pub fn get_ability(
        &self,
        input: AbilityInput,
        inventory: Option<&Inventory>,
        skill_set: Option<&SkillSet>,
        stats: Option<&comp::Stats>,
    ) -> Ability {
        match input {
            AbilityInput::Guard => self.guard.into(),
            AbilityInput::Primary => self.primary.into(),
            AbilityInput::Secondary => self.secondary.into(),
            AbilityInput::Movement => self.movement.into(),
            AbilityInput::Auxiliary(index) => {
                if stats.is_some_and(|s| s.disable_auxiliary_abilities) {
                    Ability::Empty
                } else {
                    self.auxiliary_set(inventory, skill_set)
                        .get(index)
                        .copied()
                        .map(|a| a.into())
                        .unwrap_or(Ability::Empty)
                }
            },
        }
    }

    /// Returns the CharacterAbility from an ability input, and also whether the
    /// ability was from a weapon wielded in the offhand
    pub fn activate_ability(
        &self,
        input: AbilityInput,
        inv: Option<&Inventory>,
        skill_set: &SkillSet,
        body: Option<&Body>,
        char_state: Option<&CharacterState>,
        context: &AbilityContext,
        stats: Option<&comp::Stats>,
        // bool is from_offhand
    ) -> Option<(CharacterAbility, bool, SpecifiedAbility)> {
        let ability = self.get_ability(input, inv, Some(skill_set), stats);

        let ability_set = |equip_slot| {
            inv.and_then(|inv| inv.equipped(equip_slot))
                .and_then(|i| i.item_config().map(|c| &c.abilities))
        };

        let scale_ability = |ability: CharacterAbility, equip_slot| {
            let tool_kind = inv
                .and_then(|inv| inv.equipped(equip_slot))
                .and_then(|item| match_some!(&*item.kind(), ItemKind::Tool(tool) => tool.kind));
            ability.adjusted_by_skills(skill_set, tool_kind)
        };

        let spec_ability = |context_index| SpecifiedAbility {
            ability,
            context_index,
        };

        // This function is an attempt to generalize ability handling
        let inst_ability = |slot: EquipSlot, offhand: bool| {
            ability_set(slot).and_then(|abilities| {
                // We use AbilityInput here as an object to match on, which
                // roughly corresponds to all needed data we need to know about
                // ability.
                use AbilityInput as I;

                // Also we don't provide `ability`, nor `ability_input` as an
                // argument to the closure, and that wins us a bit of code
                // duplication we would need to do otherwise, but it's
                // important that we can and do re-create all needed Ability
                // information here to make decisions.
                //
                // For example, we should't take `input` argument provided to
                // activate_abilities, because in case of Auxiliary abilities,
                // it has wrong index.
                //
                // We could alternatively just take `ability`, but it works too.
                let dispatched = match ability.try_ability_set_key()? {
                    I::Guard => abilities.guard(Some(skill_set), context),
                    I::Primary => abilities.primary(Some(skill_set), context),
                    I::Secondary => abilities.secondary(Some(skill_set), context),
                    I::Auxiliary(index) => abilities.auxiliary(index, Some(skill_set), context),
                    I::Movement => return None,
                };

                dispatched
                    .map(|(a, i)| (a.ability.clone(), i))
                    .map(|(a, i)| (scale_ability(a, slot), offhand, spec_ability(i)))
            })
        };

        let source = AbilitySource::determine(char_state);

        match ability {
            Ability::ToolGuard => match source {
                AbilitySource::Weapons => {
                    let equip_slot = combat::get_equip_slot_by_block_priority(inv);
                    inst_ability(equip_slot, matches!(equip_slot, EquipSlot::ActiveOffhand))
                },
                AbilitySource::Glider => None,
            },
            Ability::ToolPrimary => match source {
                AbilitySource::Weapons => inst_ability(EquipSlot::ActiveMainhand, false),
                AbilitySource::Glider => inst_ability(EquipSlot::Glider, false),
            },
            Ability::ToolSecondary => match source {
                AbilitySource::Weapons => inst_ability(EquipSlot::ActiveOffhand, true)
                    .or_else(|| inst_ability(EquipSlot::ActiveMainhand, false)),
                AbilitySource::Glider => inst_ability(EquipSlot::Glider, false),
            },
            Ability::MainWeaponAux(_) => inst_ability(EquipSlot::ActiveMainhand, false),
            Ability::OffWeaponAux(_) => inst_ability(EquipSlot::ActiveOffhand, true),
            Ability::GliderAux(_) => inst_ability(EquipSlot::Glider, false),
            Ability::Empty => None,
            Ability::SpeciesMovement => matches!(body, Some(Body::Humanoid(_)))
                .then(|| CharacterAbility::default_roll(char_state))
                .map(|ability| {
                    (
                        ability.adjusted_by_skills(skill_set, None),
                        false,
                        spec_ability(None),
                    )
                }),
        }
    }

    pub fn iter_available_abilities_on<'a>(
        inv: Option<&'a Inventory>,
        skill_set: Option<&'a SkillSet>,
        equip_slot: EquipSlot,
    ) -> impl Iterator<Item = usize> + 'a {
        inv.and_then(|inv| inv.equipped(equip_slot).and_then(|i| i.item_config()))
            .into_iter()
            .flat_map(|config| &config.abilities.abilities)
            .enumerate()
            .filter_map(move |(i, a)| match a {
                AbilityKind::Simple(skill, _) => skill
                    .is_none_or(|s| skill_set.is_some_and(|ss| ss.has_skill(s)))
                    .then_some(i),
                AbilityKind::Contextualized {
                    pseudo_id: _,
                    abilities,
                } => abilities
                    .iter()
                    .any(|(_contexts, (skill, _))| {
                        skill.is_none_or(|s| skill_set.is_some_and(|ss| ss.has_skill(s)))
                    })
                    .then_some(i),
            })
    }

    pub fn all_available_abilities(
        inv: Option<&Inventory>,
        skill_set: Option<&SkillSet>,
    ) -> Vec<AuxiliaryAbility> {
        let mut ability_buff = vec![];
        // Check if uses combo of two "equal" weapons
        let paired = inv
            .and_then(|inv| {
                let a = inv.equipped(EquipSlot::ActiveMainhand)?;
                let b = inv.equipped(EquipSlot::ActiveOffhand)?;

                if let (ItemKind::Tool(tool_a), ItemKind::Tool(tool_b)) = (&*a.kind(), &*b.kind()) {
                    Some((a.ability_spec(), tool_a.kind, b.ability_spec(), tool_b.kind))
                } else {
                    None
                }
            })
            .is_some_and(|(a_spec, a_kind, b_spec, b_kind)| (a_spec, a_kind) == (b_spec, b_kind));

        // Push main weapon abilities
        Self::iter_available_abilities_on(inv, skill_set, EquipSlot::ActiveMainhand)
            .map(AuxiliaryAbility::MainWeapon)
            .for_each(|a| ability_buff.push(a));

        // Push secondary weapon abilities, if different
        // If equal, just take the first
        if !paired {
            Self::iter_available_abilities_on(inv, skill_set, EquipSlot::ActiveOffhand)
                .map(AuxiliaryAbility::OffWeapon)
                .for_each(|a| ability_buff.push(a));
        }
        // Push glider abilities
        Self::iter_available_abilities_on(inv, skill_set, EquipSlot::Glider)
            .map(AuxiliaryAbility::Glider)
            .for_each(|a| ability_buff.push(a));

        ability_buff
    }

    fn default_ability_set<'a>(
        inv: Option<&'a Inventory>,
        skill_set: Option<&'a SkillSet>,
        limit: Option<usize>,
    ) -> Vec<AuxiliaryAbility> {
        let mut iter = Self::iter_available_abilities_on(inv, skill_set, EquipSlot::ActiveMainhand)
            .map(AuxiliaryAbility::MainWeapon)
            .chain(
                Self::iter_available_abilities_on(inv, skill_set, EquipSlot::ActiveOffhand)
                    .map(AuxiliaryAbility::OffWeapon),
            );

        if let Some(limit) = limit {
            (0..limit)
                .map(|_| iter.next().unwrap_or(AuxiliaryAbility::Empty))
                .collect()
        } else {
            iter.collect()
        }
    }
}

#[derive(Debug, Copy, Clone)]
pub enum AbilityInput {
    Guard,
    Primary,
    Secondary,
    Movement,
    Auxiliary(usize),
}

#[derive(Copy, Clone, Serialize, Deserialize, Debug, PartialEq, Eq)]
pub enum Ability {
    ToolGuard,
    ToolPrimary,
    ToolSecondary,
    SpeciesMovement,
    MainWeaponAux(usize),
    OffWeaponAux(usize),
    GliderAux(usize),
    Empty,
    /* For future use
     * ArmorAbility(usize), */
}

impl Ability {
    // Used for generic ability dispatch (inst_ability) in this file
    //
    // It does use AbilityInput to avoid creating just another enum, but it is
    // semantically different.
    fn try_ability_set_key(&self) -> Option<AbilityInput> {
        let input = match self {
            Self::ToolGuard => AbilityInput::Guard,
            Self::ToolPrimary => AbilityInput::Primary,
            Self::ToolSecondary => AbilityInput::Secondary,
            Self::SpeciesMovement => AbilityInput::Movement,
            Self::GliderAux(idx) | Self::OffWeaponAux(idx) | Self::MainWeaponAux(idx) => {
                AbilityInput::Auxiliary(*idx)
            },
            Self::Empty => return None,
        };

        Some(input)
    }

    pub fn ability_id<'a>(
        self,
        char_state: Option<&CharacterState>,
        inv: Option<&'a Inventory>,
        skill_set: Option<&'a SkillSet>,
        context: &AbilityContext,
    ) -> Option<&'a str> {
        let ability_set = |equip_slot| {
            inv.and_then(|inv| inv.equipped(equip_slot))
                .and_then(|i| i.item_config().map(|c| &c.abilities))
        };

        let contextual_id = |kind: Option<&'a AbilityKind<_>>| -> Option<&'a str> {
            if let Some(AbilityKind::Contextualized {
                pseudo_id,
                abilities: _,
            }) = kind
            {
                Some(pseudo_id.as_str())
            } else {
                None
            }
        };

        let inst_ability = |slot: EquipSlot| {
            ability_set(slot).and_then(|abilities| {
                use AbilityInput as I;

                let dispatched = match self.try_ability_set_key()? {
                    I::Guard => abilities.guard(skill_set, context),
                    I::Primary => abilities.primary(skill_set, context),
                    I::Secondary => abilities.secondary(skill_set, context),
                    I::Auxiliary(index) => abilities.auxiliary(index, skill_set, context),
                    I::Movement => return None,
                };

                dispatched.map(|(a, _)| a.id.as_str()).or_else(|| {
                    match self.try_ability_set_key()? {
                        I::Guard => abilities
                            .guard
                            .as_ref()
                            .and_then(|g| contextual_id(Some(g))),
                        I::Primary => contextual_id(Some(&abilities.primary)),
                        I::Secondary => contextual_id(Some(&abilities.secondary)),
                        I::Auxiliary(index) => contextual_id(abilities.abilities.get(index)),
                        I::Movement => None,
                    }
                })
            })
        };

        let source = AbilitySource::determine(char_state);
        match source {
            AbilitySource::Glider => match self {
                Ability::ToolGuard => None,
                Ability::ToolPrimary => inst_ability(EquipSlot::Glider),
                Ability::ToolSecondary => inst_ability(EquipSlot::Glider),
                Ability::SpeciesMovement => None, // TODO: Make not None
                Ability::MainWeaponAux(_) => inst_ability(EquipSlot::ActiveMainhand),
                Ability::OffWeaponAux(_) => inst_ability(EquipSlot::ActiveOffhand),
                Ability::GliderAux(_) => inst_ability(EquipSlot::Glider),
                Ability::Empty => None,
            },
            AbilitySource::Weapons => match self {
                Ability::ToolGuard => {
                    let equip_slot = combat::get_equip_slot_by_block_priority(inv);
                    inst_ability(equip_slot)
                },
                Ability::ToolPrimary => inst_ability(EquipSlot::ActiveMainhand),
                Ability::ToolSecondary => inst_ability(EquipSlot::ActiveOffhand)
                    .or_else(|| inst_ability(EquipSlot::ActiveMainhand)),
                Ability::SpeciesMovement => None, // TODO: Make not None
                Ability::MainWeaponAux(_) => inst_ability(EquipSlot::ActiveMainhand),
                Ability::OffWeaponAux(_) => inst_ability(EquipSlot::ActiveOffhand),
                Ability::GliderAux(_) => inst_ability(EquipSlot::Glider),
                Ability::Empty => None,
            },
        }
    }

    pub fn is_from_wielded(&self) -> bool {
        match self {
            Ability::ToolPrimary
            | Ability::ToolSecondary
            | Ability::MainWeaponAux(_)
            | Ability::GliderAux(_)
            | Ability::OffWeaponAux(_)
            | Ability::ToolGuard => true,
            Ability::SpeciesMovement | Ability::Empty => false,
        }
    }
}

#[derive(Copy, Clone, Serialize, Deserialize, Debug)]
pub enum GuardAbility {
    Tool,
    Empty,
}

impl From<GuardAbility> for Ability {
    fn from(guard: GuardAbility) -> Self {
        match guard {
            GuardAbility::Tool => Ability::ToolGuard,
            GuardAbility::Empty => Ability::Empty,
        }
    }
}

#[derive(Copy, Clone, Serialize, Deserialize, Debug, PartialEq, Eq)]
pub struct SpecifiedAbility {
    pub ability: Ability,
    pub context_index: Option<ContextualIndex>,
}

impl SpecifiedAbility {
    pub fn ability_id<'a>(
        self,
        char_state: Option<&CharacterState>,
        inv: Option<&'a Inventory>,
    ) -> Option<&'a str> {
        let ability_set = |equip_slot| {
            inv.and_then(|inv| inv.equipped(equip_slot))
                .and_then(|i| i.item_config().map(|c| &c.abilities))
        };

        fn ability_id(spec_ability: SpecifiedAbility, ability: &AbilityKind<AbilityItem>) -> &str {
            match ability {
                AbilityKind::Simple(_, a) => a.id.as_str(),
                AbilityKind::Contextualized {
                    pseudo_id,
                    abilities,
                } => spec_ability
                    .context_index
                    .and_then(|i| abilities.get(i.0))
                    .map_or(pseudo_id.as_str(), |(_, (_, a))| a.id.as_str()),
            }
        }

        let inst_ability = |slot: EquipSlot| {
            ability_set(slot).and_then(|abilities| {
                use AbilityInput as I;

                let dispatched = match self.ability.try_ability_set_key()? {
                    I::Guard => abilities.guard.as_ref(),
                    I::Primary => Some(&abilities.primary),
                    I::Secondary => Some(&abilities.secondary),
                    I::Auxiliary(index) => abilities.abilities.get(index),
                    I::Movement => return None,
                };
                dispatched.map(|a| ability_id(self, a))
            })
        };

        let source = AbilitySource::determine(char_state);
        match source {
            AbilitySource::Glider => match self.ability {
                Ability::ToolGuard => None,
                Ability::ToolPrimary => inst_ability(EquipSlot::Glider),
                Ability::ToolSecondary => inst_ability(EquipSlot::Glider),
                Ability::SpeciesMovement => None,
                Ability::MainWeaponAux(_) => inst_ability(EquipSlot::ActiveMainhand),
                Ability::OffWeaponAux(_) => inst_ability(EquipSlot::ActiveOffhand),
                Ability::GliderAux(_) => inst_ability(EquipSlot::Glider),
                Ability::Empty => None,
            },
            AbilitySource::Weapons => match self.ability {
                Ability::ToolGuard => inst_ability(combat::get_equip_slot_by_block_priority(inv)),
                Ability::ToolPrimary => inst_ability(EquipSlot::ActiveMainhand),
                Ability::ToolSecondary => inst_ability(EquipSlot::ActiveOffhand)
                    .or_else(|| inst_ability(EquipSlot::ActiveMainhand)),
                Ability::SpeciesMovement => None, // TODO: Make not None
                Ability::MainWeaponAux(_) => inst_ability(EquipSlot::ActiveMainhand),
                Ability::OffWeaponAux(_) => inst_ability(EquipSlot::ActiveOffhand),
                Ability::GliderAux(_) => inst_ability(EquipSlot::Glider),
                Ability::Empty => None,
            },
        }
    }
}

#[derive(Copy, Clone, Serialize, Deserialize, Debug)]
pub enum PrimaryAbility {
    Tool,
    Empty,
}

impl From<PrimaryAbility> for Ability {
    fn from(primary: PrimaryAbility) -> Self {
        match primary {
            PrimaryAbility::Tool => Ability::ToolPrimary,
            PrimaryAbility::Empty => Ability::Empty,
        }
    }
}

#[derive(Copy, Clone, Serialize, Deserialize, Debug)]
pub enum SecondaryAbility {
    Tool,
    Empty,
}

impl From<SecondaryAbility> for Ability {
    fn from(primary: SecondaryAbility) -> Self {
        match primary {
            SecondaryAbility::Tool => Ability::ToolSecondary,
            SecondaryAbility::Empty => Ability::Empty,
        }
    }
}

#[derive(Copy, Clone, Serialize, Deserialize, Debug)]
pub enum MovementAbility {
    Species,
    Empty,
}

impl From<MovementAbility> for Ability {
    fn from(primary: MovementAbility) -> Self {
        match primary {
            MovementAbility::Species => Ability::SpeciesMovement,
            MovementAbility::Empty => Ability::Empty,
        }
    }
}

#[derive(Copy, Clone, Serialize, Deserialize, Debug, PartialEq, Eq)]
pub enum AuxiliaryAbility {
    MainWeapon(usize),
    OffWeapon(usize),
    Glider(usize),
    Empty,
}

impl From<AuxiliaryAbility> for Ability {
    fn from(primary: AuxiliaryAbility) -> Self {
        match primary {
            AuxiliaryAbility::MainWeapon(i) => Ability::MainWeaponAux(i),
            AuxiliaryAbility::OffWeapon(i) => Ability::OffWeaponAux(i),
            AuxiliaryAbility::Glider(i) => Ability::GliderAux(i),
            AuxiliaryAbility::Empty => Ability::Empty,
        }
    }
}

/// A lighter form of character state to pass around as needed for frontend
/// purposes
// Only add to this enum as needed for frontends, not necessary to immediately
// add a variant here when adding a new character state
#[derive(Copy, Clone, Hash, Eq, PartialEq, Debug, Serialize, Deserialize)]
pub enum CharacterAbilityType {
    BasicMelee(StageSection),
    BasicRanged,
    Boost,
    ChargedMelee(StageSection),
    ChargedRanged,
    DashMelee(StageSection),
    BasicBlock,
    ComboMelee2(StageSection),
    FinisherMelee(StageSection),
    DiveMelee(StageSection),
    RiposteMelee(StageSection),
    RapidMelee(StageSection),
    LeapMelee(StageSection),
    LeapShockwave(StageSection),
    Music(StageSection),
    Shockwave,
    BasicBeam,
    RapidRanged,
    BasicAura,
    SelfBuff,
    Other,
}

impl From<&CharacterState> for CharacterAbilityType {
    fn from(state: &CharacterState) -> Self {
        match state {
            CharacterState::BasicMelee(data) => Self::BasicMelee(data.stage_section),
            CharacterState::BasicRanged(_) => Self::BasicRanged,
            CharacterState::Boost(_) => Self::Boost,
            CharacterState::DashMelee(data) => Self::DashMelee(data.stage_section),
            CharacterState::BasicBlock(_) => Self::BasicBlock,
            CharacterState::LeapMelee(data) => Self::LeapMelee(data.stage_section),
            CharacterState::LeapShockwave(data) => Self::LeapShockwave(data.stage_section),
            CharacterState::ComboMelee2(data) => Self::ComboMelee2(data.stage_section),
            CharacterState::FinisherMelee(data) => Self::FinisherMelee(data.stage_section),
            CharacterState::DiveMelee(data) => Self::DiveMelee(data.stage_section),
            CharacterState::RiposteMelee(data) => Self::RiposteMelee(data.stage_section),
            CharacterState::RapidMelee(data) => Self::RapidMelee(data.stage_section),
            CharacterState::ChargedMelee(data) => Self::ChargedMelee(data.stage_section),
            CharacterState::ChargedRanged(_) => Self::ChargedRanged,
            CharacterState::Shockwave(_) => Self::Shockwave,
            CharacterState::BasicBeam(_) => Self::BasicBeam,
            CharacterState::RapidRanged(_) => Self::RapidRanged,
            CharacterState::BasicAura(_) => Self::BasicAura,
            CharacterState::SelfBuff(_) => Self::SelfBuff,
            CharacterState::Music(data) => Self::Music(data.stage_section),
            CharacterState::Idle(_)
            | CharacterState::Crawl
            | CharacterState::Climb(_)
            | CharacterState::Sit
            | CharacterState::Dance
            | CharacterState::Talk(_)
            | CharacterState::Glide(_)
            | CharacterState::GlideWield(_)
            | CharacterState::Stunned(_)
            | CharacterState::Equipping(_)
            | CharacterState::Wielding(_)
            | CharacterState::Roll(_)
            | CharacterState::Blink(_)
            | CharacterState::BasicSummon(_)
            | CharacterState::SpriteSummon(_)
            | CharacterState::UseItem(_)
            | CharacterState::Interact(_)
            | CharacterState::Skate(_)
            | CharacterState::Transform(_)
            | CharacterState::RegrowHead(_)
            | CharacterState::Wallrun(_)
            | CharacterState::StaticAura(_)
            | CharacterState::Throw(_)
            | CharacterState::LeapExplosionShockwave(_)
            | CharacterState::Explosion(_)
            | CharacterState::LeapRanged(_)
            | CharacterState::Simple(_) => Self::Other,
        }
    }
}

#[derive(Copy, Clone, Debug, PartialEq, Serialize, Deserialize, Default)]
pub enum Dodgeable {
    #[default]
    Roll,
    Jump,
    No,
}

#[derive(Clone, Copy, PartialEq, Debug, Serialize, Deserialize)]
pub enum Amount {
    PerHead(u32),
    Value(u32),
}

impl Amount {
    pub fn add(&mut self, value: u32) {
        match self {
            Self::PerHead(v) | Self::Value(v) => *v += value,
        }
    }

    pub fn compute(&self, heads: u32) -> u32 {
        match self {
            Amount::PerHead(v) => v * heads,
            Amount::Value(v) => *v,
        }
    }
}

impl Default for Amount {
    fn default() -> Self { Self::Value(1) }
}

#[derive(Clone, PartialEq, Debug, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
/// For documentation on individual fields, see the corresponding character
/// state file in 'common/src/states/'
pub enum CharacterAbility {
    BasicMelee {
        energy_cost: f32,
        buildup_duration: f32,
        swing_duration: f32,
        hit_timing: f32,
        recover_duration: f32,
        melee_constructor: MeleeConstructor,
        #[serde(default)]
        movement_modifier: MovementModifier,
        #[serde(default)]
        ori_modifier: OrientationModifier,
        frontend_specifier: Option<basic_melee::FrontendSpecifier>,
        #[serde(default)]
        meta: AbilityMeta,
    },
    BasicRanged {
        energy_cost: f32,
        buildup_duration: f32,
        recover_duration: f32,
        projectile: ProjectileConstructor,
        projectile_body: Body,
        projectile_light: Option<LightEmitter>,
        projectile_speed: f32,
        #[serde(default)]
        vertical_angle_offset: f32,
        #[serde(default)]
        num_projectiles: Amount,
        projectile_spread: Option<ProjectileSpread>,
        #[serde(default)]
        auto_aim: bool,
        #[serde(default)]
        movement_modifier: MovementModifier,
        #[serde(default)]
        ori_modifier: OrientationModifier,
        #[serde(default)]
        marker: Option<comp::FrontendMarker>,
        #[serde(default)]
        meta: AbilityMeta,
    },
    RapidRanged {
        #[serde(default)]
        initial_energy: f32,
        #[serde(default)]
        energy_cost: f32,
        buildup_duration: f32,
        shoot_duration: f32,
        recover_duration: f32,
        options: rapid_ranged::Options,
        projectile: ProjectileConstructor,
        projectile_body: Body,
        projectile_light: Option<LightEmitter>,
        projectile_speed: f32,
        specifier: Option<rapid_ranged::FrontendSpecifier>,
        #[serde(default)]
        meta: AbilityMeta,
    },
    Boost {
        movement_duration: f32,
        only_up: bool,
        speed: f32,
        max_exit_velocity: f32,
        #[serde(default)]
        meta: AbilityMeta,
    },
    GlideBoost {
        booster: glide::Boost,
        #[serde(default)]
        meta: AbilityMeta,
    },
    DashMelee {
        energy_cost: f32,
        energy_drain: f32,
        forward_speed: f32,
        buildup_duration: f32,
        charge_duration: f32,
        swing_duration: f32,
        recover_duration: f32,
        melee_constructor: MeleeConstructor,
        ori_modifier: f32,
        auto_charge: bool,
        #[serde(default)]
        charge_through: bool,
        #[serde(default)]
        frontend_specifier: Option<dash_melee::FrontendSpecifier>,
        #[serde(default)]
        meta: AbilityMeta,
    },
    BasicBlock {
        buildup_duration: f32,
        recover_duration: f32,
        max_angle: f32,
        block_strength: f32,
        parry_window: basic_block::ParryWindow,
        energy_cost: f32,
        energy_regen: f32,
        can_hold: bool,
        blocked_attacks: AttackFilters,
        #[serde(default)]
        meta: AbilityMeta,
    },
    Roll {
        energy_cost: f32,
        buildup_duration: f32,
        movement_duration: f32,
        recover_duration: f32,
        roll_strength: f32,
        attack_immunities: AttackFilters,
        was_cancel: bool,
        #[serde(default)]
        meta: AbilityMeta,
    },
    ComboMelee2 {
        strikes: Vec<combo_melee2::Strike<f32>>,
        energy_cost_per_strike: f32,
        specifier: Option<combo_melee2::FrontendSpecifier>,
        #[serde(default)]
        auto_progress: bool,
        #[serde(default)]
        meta: AbilityMeta,
    },
    LeapExplosionShockwave {
        energy_cost: f32,
        buildup_duration: f32,
        movement_duration: f32,
        swing_duration: f32,
        recover_duration: f32,
        forward_leap_strength: f32,
        vertical_leap_strength: f32,
        explosion_damage: f32,
        explosion_poise: f32,
        explosion_knockback: Knockback,
        explosion_radius: f32,
        min_falloff: f32,
        #[serde(default)]
        explosion_dodgeable: Dodgeable,
        #[serde(default)]
        destroy_terrain: Option<(f32, ColorPreset)>,
        #[serde(default)]
        replace_terrain: Option<(f32, TerrainReplacementPreset)>,
        #[serde(default)]
        eye_height: bool,
        #[serde(default)]
        reagent: Option<Reagent>,
        shockwave_damage: f32,
        shockwave_poise: f32,
        shockwave_knockback: Knockback,
        shockwave_angle: f32,
        shockwave_vertical_angle: f32,
        shockwave_speed: f32,
        shockwave_duration: f32,
        #[serde(default)]
        shockwave_dodgeable: Dodgeable,
        #[serde(default)]
        shockwave_damage_effect: Option<CombatEffect>,
        shockwave_damage_kind: DamageKind,
        shockwave_specifier: comp::shockwave::FrontendSpecifier,
        move_efficiency: f32,
        #[serde(default)]
        meta: AbilityMeta,
    },
    LeapMelee {
        energy_cost: f32,
        buildup_duration: f32,
        movement_duration: f32,
        swing_duration: f32,
        recover_duration: f32,
        melee_constructor: MeleeConstructor,
        forward_leap_strength: f32,
        vertical_leap_strength: f32,
        specifier: Option<leap_melee::FrontendSpecifier>,
        #[serde(default)]
        meta: AbilityMeta,
    },
    LeapShockwave {
        energy_cost: f32,
        buildup_duration: f32,
        movement_duration: f32,
        swing_duration: f32,
        recover_duration: f32,
        damage: f32,
        poise_damage: f32,
        knockback: Knockback,
        shockwave_angle: f32,
        shockwave_vertical_angle: f32,
        shockwave_speed: f32,
        shockwave_duration: f32,
        dodgeable: Dodgeable,
        move_efficiency: f32,
        damage_kind: DamageKind,
        specifier: comp::shockwave::FrontendSpecifier,
        damage_effect: Option<CombatEffect>,
        forward_leap_strength: f32,
        vertical_leap_strength: f32,
        #[serde(default)]
        meta: AbilityMeta,
    },
    ChargedMelee {
        energy_cost: f32,
        energy_drain: f32,
        buildup_strike: Option<(f32, MeleeConstructor)>,
        charge_duration: f32,
        swing_duration: f32,
        hit_timing: f32,
        recover_duration: f32,
        melee_constructor: MeleeConstructor,
        specifier: Option<charged_melee::FrontendSpecifier>,
        #[serde(default)]
        custom_combo: CustomCombo,
        #[serde(default)]
        meta: AbilityMeta,
        #[serde(default)]
        movement_modifier: MovementModifier,
        #[serde(default)]
        ori_modifier: OrientationModifier,
    },
    ChargedRanged {
        energy_cost: f32,
        energy_drain: f32,
        idle_drain: f32,
        projectile: ProjectileConstructor,
        buildup_duration: f32,
        charge_duration: f32,
        recover_duration: f32,
        projectile_body: Body,
        projectile_light: Option<LightEmitter>,
        initial_projectile_speed: f32,
        scaled_projectile_speed: f32,
        projectile_spread: Option<ProjectileSpread>,
        #[serde(default)]
        num_projectiles: Amount,
        marker: Option<comp::FrontendMarker>,
        move_speed: f32,
        #[serde(default)]
        meta: AbilityMeta,
    },
    Throw {
        energy_cost: f32,
        energy_drain: f32,
        buildup_duration: f32,
        charge_duration: f32,
        throw_duration: f32,
        recover_duration: f32,
        projectile: ProjectileConstructor,
        projectile_light: Option<LightEmitter>,
        projectile_dir: throw::ProjectileDir,
        initial_projectile_speed: f32,
        scaled_projectile_speed: f32,
        damage_effect: Option<CombatEffect>,
        move_speed: f32,
        #[serde(default)]
        meta: AbilityMeta,
    },
    Shockwave {
        energy_cost: f32,
        buildup_duration: f32,
        swing_duration: f32,
        recover_duration: f32,
        damage: f32,
        poise_damage: f32,
        knockback: Knockback,
        shockwave_angle: f32,
        shockwave_vertical_angle: f32,
        shockwave_speed: f32,
        shockwave_duration: f32,
        dodgeable: Dodgeable,
        move_efficiency: f32,
        damage_kind: DamageKind,
        specifier: comp::shockwave::FrontendSpecifier,
        ori_rate: f32,
        damage_effect: Option<CombatEffect>,
        timing: shockwave::Timing,
        emit_outcome: bool,
        minimum_combo: Option<u32>,
        #[serde(default)]
        combo_consumption: ComboConsumption,
        #[serde(default)]
        meta: AbilityMeta,
    },
    Explosion {
        energy_cost: f32,
        buildup_duration: f32,
        action_duration: f32,
        recover_duration: f32,
        damage: f32,
        poise: f32,
        knockback: Knockback,
        radius: f32,
        min_falloff: f32,
        #[serde(default)]
        dodgeable: Dodgeable,
        #[serde(default)]
        destroy_terrain: Option<(f32, ColorPreset)>,
        #[serde(default)]
        replace_terrain: Option<(f32, TerrainReplacementPreset)>,
        #[serde(default)]
        eye_height: bool,
        #[serde(default)]
        reagent: Option<Reagent>,
        #[serde(default)]
        movement_modifier: MovementModifier,
        #[serde(default)]
        ori_modifier: OrientationModifier,
        #[serde(default)]
        meta: AbilityMeta,
    },
    BasicBeam {
        buildup_duration: f32,
        recover_duration: f32,
        beam_duration: f64,
        damage: f32,
        tick_rate: f32,
        range: f32,
        #[serde(default)]
        dodgeable: Dodgeable,
        #[serde(default = "default_true")]
        blockable: bool,
        max_angle: f32,
        damage_effect: Option<CombatEffect>,
        energy_regen: f32,
        energy_drain: f32,
        ori_rate: f32,
        move_efficiency: f32,
        specifier: beam::FrontendSpecifier,
        #[serde(default)]
        meta: AbilityMeta,
    },
    BasicAura {
        buildup_duration: f32,
        cast_duration: f32,
        recover_duration: f32,
        targets: combat::GroupTarget,
        auras: Vec<aura::AuraBuffConstructor>,
        aura_duration: Option<Secs>,
        range: f32,
        energy_cost: f32,
        scales_with_combo: bool,
        specifier: Option<aura::Specifier>,
        #[serde(default)]
        meta: AbilityMeta,
    },
    StaticAura {
        buildup_duration: f32,
        cast_duration: f32,
        recover_duration: f32,
        energy_cost: f32,
        targets: combat::GroupTarget,
        auras: Vec<aura::AuraBuffConstructor>,
        aura_duration: Option<Secs>,
        range: f32,
        sprite_info: Option<static_aura::SpriteInfo>,
        #[serde(default)]
        meta: AbilityMeta,
    },
    Blink {
        buildup_duration: f32,
        recover_duration: f32,
        max_range: f32,
        frontend_specifier: Option<blink::FrontendSpecifier>,
        #[serde(default)]
        meta: AbilityMeta,
    },
    BasicSummon {
        buildup_duration: f32,
        cast_duration: f32,
        recover_duration: f32,
        summon_info: basic_summon::SummonInfo,
        #[serde(default)]
        movement_modifier: MovementModifier,
        #[serde(default)]
        ori_modifier: OrientationModifier,
        #[serde(default)]
        meta: AbilityMeta,
    },
    SelfBuff {
        buildup_duration: f32,
        cast_duration: f32,
        recover_duration: f32,
        buffs: Vec<self_buff::BuffDesc>,
        #[serde(default)]
        use_raw_buff_strength: bool,
        buff_cat: Option<buff::BuffCategory>,
        energy_cost: f32,
        #[serde(default = "default_true")]
        enforced_limit: bool,
        #[serde(default)]
        combo_cost: u32,
        combo_scaling: Option<ScalingKind>,
        #[serde(default)]
        meta: AbilityMeta,
        specifier: Option<self_buff::FrontendSpecifier>,
    },
    SpriteSummon {
        buildup_duration: f32,
        cast_duration: f32,
        recover_duration: f32,
        sprite: SpriteKind,
        del_timeout: Option<(f32, f32)>,
        summon_distance: (f32, f32),
        sparseness: f64,
        angle: f32,
        #[serde(default)]
        anchor: SpriteSummonAnchor,
        #[serde(default)]
        move_efficiency: f32,
        ori_modifier: f32,
        #[serde(default)]
        meta: AbilityMeta,
    },
    Music {
        play_duration: f32,
        ori_modifier: f32,
        #[serde(default)]
        meta: AbilityMeta,
    },
    FinisherMelee {
        energy_cost: f32,
        buildup_duration: f32,
        swing_duration: f32,
        recover_duration: f32,
        melee_constructor: MeleeConstructor,
        minimum_combo: u32,
        scaling: Option<finisher_melee::Scaling>,
        #[serde(default)]
        combo_consumption: ComboConsumption,
        #[serde(default)]
        meta: AbilityMeta,
    },
    DiveMelee {
        energy_cost: f32,
        vertical_speed: f32,
        buildup_duration: Option<f32>,
        movement_duration: f32,
        swing_duration: f32,
        recover_duration: f32,
        melee_constructor: MeleeConstructor,
        max_scaling: f32,
        #[serde(default)]
        meta: AbilityMeta,
    },
    RiposteMelee {
        energy_cost: f32,
        buildup_duration: f32,
        swing_duration: f32,
        recover_duration: f32,
        whiffed_recover_duration: f32,
        block_strength: f32,
        melee_constructor: MeleeConstructor,
        #[serde(default)]
        meta: AbilityMeta,
    },
    RapidMelee {
        buildup_duration: f32,
        swing_duration: f32,
        recover_duration: f32,
        energy_cost: f32,
        max_strikes: Option<u32>,
        melee_constructor: MeleeConstructor,
        move_modifier: f32,
        ori_modifier: f32,
        frontend_specifier: Option<rapid_melee::FrontendSpecifier>,
        #[serde(default)]
        minimum_combo: u32,
        #[serde(default)]
        meta: AbilityMeta,
    },
    Transform {
        buildup_duration: f32,
        recover_duration: f32,
        target: String,
        #[serde(default)]
        specifier: Option<transform::FrontendSpecifier>,
        /// Only set to `true` for admin only abilities since this disables
        /// persistence and is not intended to be used by regular players
        #[serde(default)]
        allow_players: bool,
        #[serde(default)]
        meta: AbilityMeta,
    },
    RegrowHead {
        buildup_duration: f32,
        recover_duration: f32,
        energy_cost: f32,
        #[serde(default)]
        specifier: Option<regrow_head::FrontendSpecifier>,
        #[serde(default)]
        meta: AbilityMeta,
    },
    LeapRanged {
        energy_cost: f32,
        buildup_duration: f32,
        buildup_melee_timing: f32,
        movement_duration: f32,
        movement_ranged_timing: f32,
        land_timeout: f32,
        recover_duration: f32,
        melee: Option<MeleeConstructor>,
        melee_required: bool,
        projectile: ProjectileConstructor,
        projectile_body: Body,
        projectile_light: Option<LightEmitter>,
        projectile_speed: f32,
        horiz_leap_strength: f32,
        vert_leap_strength: f32,
        #[serde(default)]
        meta: AbilityMeta,
    },
    Simple {
        energy_cost: f32,
        combo_cost: u32,
        buildup_duration: f32,
        #[serde(default)]
        meta: AbilityMeta,
    },
}

impl Default for CharacterAbility {
    fn default() -> Self {
        CharacterAbility::BasicMelee {
            energy_cost: 0.0,
            buildup_duration: 0.25,
            swing_duration: 0.25,
            hit_timing: 0.5,
            recover_duration: 0.5,
            melee_constructor: MeleeConstructor {
                kind: MeleeConstructorKind::Slash {
                    damage: 1.0,
                    knockback: 0.0,
                    poise: 0.0,
                    energy_regen: 0.0,
                },
                scaled: None,
                range: 3.5,
                angle: 15.0,
                multi_target: None,
                damage_effect: None,
                attack_effect: None,
                simultaneous_hits: 1,
                custom_combo: CustomCombo {
                    base: None,
                    conditional: None,
                },
                dodgeable: Dodgeable::Roll,
                blockable: true,
                precision_flank_multipliers: Default::default(),
                precision_flank_invert: false,
            },
            movement_modifier: Default::default(),
            ori_modifier: Default::default(),
            frontend_specifier: None,
            meta: Default::default(),
        }
    }
}

impl CharacterAbility {
    /// Attempts to fulfill requirements, mutating `update` (taking energy) if
    /// applicable.
    pub fn requirements_paid(&self, data: &JoinData, update: &mut StateUpdate) -> bool {
        let from_meta = {
            let AbilityMeta { requirements, .. } = self.ability_meta();
            requirements.requirements_met(data.stance, data.inventory)
        };
        from_meta
            && match self {
                CharacterAbility::Roll { energy_cost, .. }
                | CharacterAbility::StaticAura {
                    energy_cost,
                    sprite_info: Some(_),
                    ..
                } => {
                    data.physics.on_ground.is_some()
                        && update.energy.try_change_by(-*energy_cost).is_ok()
                },
                CharacterAbility::DashMelee { energy_cost, .. }
                | CharacterAbility::BasicMelee { energy_cost, .. }
                | CharacterAbility::BasicRanged { energy_cost, .. }
                | CharacterAbility::ChargedRanged { energy_cost, .. }
                | CharacterAbility::Throw { energy_cost, .. }
                | CharacterAbility::ChargedMelee { energy_cost, .. }
                | CharacterAbility::BasicBlock { energy_cost, .. }
                | CharacterAbility::RiposteMelee { energy_cost, .. }
                | CharacterAbility::ComboMelee2 {
                    energy_cost_per_strike: energy_cost,
                    ..
                }
                | CharacterAbility::StaticAura {
                    energy_cost,
                    sprite_info: None,
                    ..
                }
                | CharacterAbility::RegrowHead { energy_cost, .. } => {
                    update.energy.try_change_by(-*energy_cost).is_ok()
                },
                // Also can consume energy within state, so value checked before entering state too
                CharacterAbility::RapidRanged {
                    initial_energy,
                    energy_cost,
                    ..
                } => {
                    update.energy.current() >= *energy_cost + *initial_energy
                        && update.energy.try_change_by(-*initial_energy).is_ok()
                },
                CharacterAbility::LeapExplosionShockwave { energy_cost, .. }
                | CharacterAbility::LeapMelee { energy_cost, .. }
                | CharacterAbility::LeapShockwave { energy_cost, .. }
                | CharacterAbility::LeapRanged { energy_cost, .. } => {
                    update.vel.0.z >= 0.0 && update.energy.try_change_by(-*energy_cost).is_ok()
                },
                CharacterAbility::BasicAura {
                    energy_cost,
                    scales_with_combo,
                    ..
                } => {
                    ((*scales_with_combo && data.combo.is_some_and(|c| c.counter() > 0))
                        | !*scales_with_combo)
                        && update.energy.try_change_by(-*energy_cost).is_ok()
                },
                CharacterAbility::FinisherMelee {
                    energy_cost,
                    minimum_combo,
                    ..
                }
                | CharacterAbility::RapidMelee {
                    energy_cost,
                    minimum_combo,
                    ..
                }
                | CharacterAbility::SelfBuff {
                    energy_cost,
                    combo_cost: minimum_combo,
                    ..
                }
                | CharacterAbility::Simple {
                    energy_cost,
                    combo_cost: minimum_combo,
                    ..
                } => {
                    data.combo.is_some_and(|c| c.counter() >= *minimum_combo)
                        && update.energy.try_change_by(-*energy_cost).is_ok()
                },
                CharacterAbility::Shockwave {
                    energy_cost,
                    minimum_combo,
                    ..
                } => {
                    data.combo
                        .is_some_and(|c| c.counter() >= minimum_combo.unwrap_or(0))
                        && update.energy.try_change_by(-*energy_cost).is_ok()
                },
                CharacterAbility::Explosion { energy_cost, .. } => {
                    update.energy.try_change_by(-*energy_cost).is_ok()
                },
                CharacterAbility::DiveMelee {
                    buildup_duration,
                    energy_cost,
                    ..
                } => {
                    // If either in the air or is on ground and able to be activated from
                    // ground.
                    //
                    // NOTE: there is a check in CharacterState::try_from below that must be kept in
                    // sync with the conditions here (it determines whether this starts in a
                    // movement or buildup stage).
                    (data.physics.on_ground.is_none() || buildup_duration.is_some())
                        && update.energy.try_change_by(-*energy_cost).is_ok()
                },
                CharacterAbility::Boost { .. }
                | CharacterAbility::GlideBoost { .. }
                | CharacterAbility::BasicBeam { .. }
                | CharacterAbility::Blink { .. }
                | CharacterAbility::Music { .. }
                | CharacterAbility::BasicSummon { .. }
                | CharacterAbility::SpriteSummon { .. }
                | CharacterAbility::Transform { .. } => true,
            }
    }

    pub fn default_roll(current_state: Option<&CharacterState>) -> CharacterAbility {
        let remaining_duration = current_state
            .and_then(|char_state| {
                char_state.timer().zip(
                    char_state
                        .durations()
                        .zip(char_state.stage_section())
                        .and_then(|(durations, stage_section)| match stage_section {
                            StageSection::Buildup => durations.buildup,
                            StageSection::Recover => durations.recover,
                            _ => None,
                        }),
                )
            })
            .map_or(0.0, |(timer, duration)| {
                duration.as_secs_f32() - timer.as_secs_f32()
            })
            .max(0.0);

        CharacterAbility::Roll {
            // Energy cost increased by remaining duration
            energy_cost: 10.0 + 100.0 * remaining_duration,
            buildup_duration: 0.05,
            movement_duration: 0.36,
            recover_duration: 0.125,
            roll_strength: 3.3075,
            attack_immunities: AttackFilters {
                melee: true,
                projectiles: false,
                beams: true,
                ground_shockwaves: false,
                air_shockwaves: true,
                explosions: true,
                arcs: true,
                pools: true,
            },
            was_cancel: remaining_duration > 0.0,
            meta: Default::default(),
        }
    }

    #[must_use]
    pub fn adjusted_by_stats(mut self, stats: Stats) -> Self {
        use CharacterAbility::*;
        match self {
            BasicMelee {
                ref mut energy_cost,
                ref mut buildup_duration,
                ref mut swing_duration,
                ref mut recover_duration,
                ref mut melee_constructor,
                movement_modifier: _,
                ori_modifier: _,
                hit_timing: _,
                frontend_specifier: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *swing_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *energy_cost /= stats.energy_efficiency;
                *melee_constructor = melee_constructor.clone().adjusted_by_stats(stats);
            },
            BasicRanged {
                ref mut energy_cost,
                ref mut buildup_duration,
                ref mut recover_duration,
                ref mut projectile,
                projectile_body: _,
                projectile_light: _,
                ref mut projectile_speed,
                vertical_angle_offset: _,
                num_projectiles: _,
                projectile_spread: _,
                auto_aim: _,
                movement_modifier: _,
                ori_modifier: _,
                marker: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *projectile = projectile.clone().adjusted_by_stats(stats);
                *projectile_speed *= stats.range;
                *energy_cost /= stats.energy_efficiency;
            },
            RapidRanged {
                ref mut initial_energy,
                ref mut energy_cost,
                ref mut buildup_duration,
                ref mut shoot_duration,
                ref mut recover_duration,
                options: _,
                ref mut projectile,
                projectile_body: _,
                projectile_light: _,
                ref mut projectile_speed,
                specifier: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *shoot_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *projectile = projectile.clone().adjusted_by_stats(stats);
                *projectile_speed *= stats.range;
                *initial_energy /= stats.energy_efficiency;
                *energy_cost /= stats.energy_efficiency;
            },
            Boost {
                ref mut movement_duration,
                only_up: _,
                speed: ref mut boost_speed,
                max_exit_velocity: _,
                meta: _,
            } => {
                *movement_duration /= stats.speed;
                *boost_speed *= stats.power;
            },
            DashMelee {
                ref mut energy_cost,
                ref mut energy_drain,
                forward_speed: _,
                ref mut buildup_duration,
                charge_duration: _,
                ref mut swing_duration,
                ref mut recover_duration,
                ref mut melee_constructor,
                ori_modifier: _,
                auto_charge: _,
                charge_through: _,
                frontend_specifier: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *swing_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *energy_cost /= stats.energy_efficiency;
                *energy_drain /= stats.energy_efficiency;
                *melee_constructor = melee_constructor.clone().adjusted_by_stats(stats);
            },
            BasicBlock {
                ref mut buildup_duration,
                ref mut recover_duration,
                // Do we want angle to be adjusted by range?
                max_angle: _,
                ref mut block_strength,
                parry_window: _,
                ref mut energy_cost,
                energy_regen: _,
                can_hold: _,
                blocked_attacks: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *energy_cost /= stats.energy_efficiency;
                *block_strength *= stats.power;
            },
            Roll {
                ref mut energy_cost,
                ref mut buildup_duration,
                ref mut movement_duration,
                ref mut recover_duration,
                roll_strength: _,
                attack_immunities: _,
                was_cancel: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *movement_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *energy_cost /= stats.energy_efficiency;
            },
            ComboMelee2 {
                ref mut strikes,
                ref mut energy_cost_per_strike,
                specifier: _,
                auto_progress: _,
                meta: _,
            } => {
                *energy_cost_per_strike /= stats.energy_efficiency;
                *strikes = strikes
                    .iter_mut()
                    .map(|s| s.clone().adjusted_by_stats(stats))
                    .collect();
            },
            LeapExplosionShockwave {
                ref mut energy_cost,
                ref mut buildup_duration,
                ref mut movement_duration,
                ref mut swing_duration,
                ref mut recover_duration,
                forward_leap_strength: _,
                vertical_leap_strength: _,
                ref mut explosion_damage,
                ref mut explosion_poise,
                ref mut explosion_knockback,
                ref mut explosion_radius,
                min_falloff: _,
                explosion_dodgeable: _,
                destroy_terrain: _,
                replace_terrain: _,
                eye_height: _,
                reagent: _,
                ref mut shockwave_damage,
                ref mut shockwave_poise,
                ref mut shockwave_knockback,
                shockwave_angle: _,
                shockwave_vertical_angle: _,
                shockwave_speed: _,
                ref mut shockwave_duration,
                shockwave_dodgeable: _,
                ref mut shockwave_damage_effect,
                shockwave_damage_kind: _,
                shockwave_specifier: _,
                move_efficiency: _,
                meta: _,
            } => {
                *energy_cost /= stats.energy_efficiency;
                *buildup_duration /= stats.speed;
                *movement_duration /= stats.speed;
                *swing_duration /= stats.speed;
                *recover_duration /= stats.speed;

                *explosion_damage *= stats.power;
                *explosion_poise *= stats.effect_power;
                explosion_knockback.strength *= stats.effect_power;
                *explosion_radius *= stats.range;

                *shockwave_damage *= stats.power;
                *shockwave_poise *= stats.effect_power;
                shockwave_knockback.strength *= stats.effect_power;
                *shockwave_duration *= stats.range;
                if let Some(CombatEffect::Buff(combat::CombatBuff {
                    kind: _,
                    dur_secs: _,
                    strength,
                    chance: _,
                })) = shockwave_damage_effect
                {
                    *strength *= stats.buff_strength;
                }
            },
            LeapMelee {
                ref mut energy_cost,
                ref mut buildup_duration,
                movement_duration: _,
                ref mut swing_duration,
                ref mut recover_duration,
                ref mut melee_constructor,
                forward_leap_strength: _,
                vertical_leap_strength: _,
                specifier: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *swing_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *energy_cost /= stats.energy_efficiency;
                *melee_constructor = melee_constructor.clone().adjusted_by_stats(stats)
            },
            LeapShockwave {
                ref mut energy_cost,
                ref mut buildup_duration,
                movement_duration: _,
                ref mut swing_duration,
                ref mut recover_duration,
                ref mut damage,
                ref mut poise_damage,
                knockback: _,
                shockwave_angle: _,
                shockwave_vertical_angle: _,
                shockwave_speed: _,
                ref mut shockwave_duration,
                dodgeable: _,
                move_efficiency: _,
                damage_kind: _,
                specifier: _,
                ref mut damage_effect,
                forward_leap_strength: _,
                vertical_leap_strength: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *swing_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *damage *= stats.power;
                *poise_damage *= stats.effect_power;
                *shockwave_duration *= stats.range;
                *energy_cost /= stats.energy_efficiency;
                if let Some(CombatEffect::Buff(combat::CombatBuff {
                    kind: _,
                    dur_secs: _,
                    strength,
                    chance: _,
                })) = damage_effect
                {
                    *strength *= stats.buff_strength;
                }
            },
            ChargedMelee {
                ref mut energy_cost,
                ref mut energy_drain,
                ref mut buildup_strike,
                ref mut charge_duration,
                ref mut swing_duration,
                hit_timing: _,
                ref mut recover_duration,
                ref mut melee_constructor,
                specifier: _,
                meta: _,
                custom_combo: _,
                movement_modifier: _,
                ori_modifier: _,
            } => {
                *swing_duration /= stats.speed;
                *buildup_strike = buildup_strike
                    .as_ref()
                    .cloned()
                    .map(|(dur, strike)| (dur / stats.speed, strike.adjusted_by_stats(stats)));
                *charge_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *energy_cost /= stats.energy_efficiency;
                *energy_drain *= stats.speed / stats.energy_efficiency;
                *melee_constructor = melee_constructor.clone().adjusted_by_stats(stats);
            },
            ChargedRanged {
                ref mut energy_cost,
                ref mut energy_drain,
                ref mut idle_drain,
                ref mut projectile,
                ref mut buildup_duration,
                ref mut charge_duration,
                ref mut recover_duration,
                projectile_body: _,
                projectile_light: _,
                ref mut initial_projectile_speed,
                ref mut scaled_projectile_speed,
                projectile_spread: _,
                num_projectiles: _,
                marker: _,
                move_speed: _,
                meta: _,
            } => {
                *projectile = projectile.clone().adjusted_by_stats(stats);
                *buildup_duration /= stats.speed;
                *charge_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *initial_projectile_speed *= stats.range;
                *scaled_projectile_speed *= stats.range;
                *energy_cost /= stats.energy_efficiency;
                *energy_drain *= stats.speed / stats.energy_efficiency;
                *idle_drain /= stats.energy_efficiency;
            },
            Throw {
                ref mut energy_cost,
                ref mut energy_drain,
                ref mut buildup_duration,
                ref mut charge_duration,
                ref mut throw_duration,
                ref mut recover_duration,
                ref mut projectile,
                projectile_light: _,
                projectile_dir: _,
                ref mut initial_projectile_speed,
                ref mut scaled_projectile_speed,
                damage_effect: _,
                move_speed: _,
                meta: _,
            } => {
                *projectile = projectile.clone().adjusted_by_stats(stats);
                *energy_cost /= stats.energy_efficiency;
                *energy_drain *= stats.speed / stats.energy_efficiency;
                *buildup_duration /= stats.speed;
                *charge_duration /= stats.speed;
                *throw_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *initial_projectile_speed *= stats.range;
                *scaled_projectile_speed *= stats.range;
            },
            Shockwave {
                ref mut energy_cost,
                ref mut buildup_duration,
                ref mut swing_duration,
                ref mut recover_duration,
                ref mut damage,
                ref mut poise_damage,
                knockback: _,
                shockwave_angle: _,
                shockwave_vertical_angle: _,
                shockwave_speed: _,
                ref mut shockwave_duration,
                dodgeable: _,
                move_efficiency: _,
                damage_kind: _,
                specifier: _,
                ori_rate: _,
                ref mut damage_effect,
                timing: _,
                emit_outcome: _,
                minimum_combo: _,
                combo_consumption: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *swing_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *damage *= stats.power;
                *poise_damage *= stats.effect_power;
                *shockwave_duration *= stats.range;
                *energy_cost /= stats.energy_efficiency;
                *damage_effect = damage_effect
                    .as_ref()
                    .cloned()
                    .map(|de| de.adjusted_by_stats(stats));
            },
            Explosion {
                ref mut energy_cost,
                ref mut buildup_duration,
                ref mut action_duration,
                ref mut recover_duration,
                ref mut damage,
                poise: ref mut poise_damage,
                ref mut knockback,
                ref mut radius,
                min_falloff: _,
                dodgeable: _,
                destroy_terrain: _,
                replace_terrain: _,
                eye_height: _,
                reagent: _,
                movement_modifier: _,
                ori_modifier: _,
                meta: _,
            } => {
                *energy_cost /= stats.energy_efficiency;
                *buildup_duration /= stats.speed;
                *action_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *damage *= stats.power;
                *poise_damage *= stats.effect_power;
                knockback.strength *= stats.effect_power;
                *radius *= stats.range;
            },
            BasicBeam {
                ref mut buildup_duration,
                ref mut recover_duration,
                ref mut beam_duration,
                ref mut damage,
                ref mut tick_rate,
                ref mut range,
                dodgeable: _,
                blockable: _,
                max_angle: _,
                ref mut damage_effect,
                energy_regen: _,
                ref mut energy_drain,
                move_efficiency: _,
                ori_rate: _,
                specifier: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *damage *= stats.power;
                *tick_rate *= stats.speed;
                *range *= stats.range;
                // Duration modified to keep velocity constant
                *beam_duration *= stats.range as f64;
                *energy_drain /= stats.energy_efficiency;
                *damage_effect = damage_effect
                    .as_ref()
                    .cloned()
                    .map(|de| de.adjusted_by_stats(stats));
            },
            BasicAura {
                ref mut buildup_duration,
                ref mut cast_duration,
                ref mut recover_duration,
                targets: _,
                ref mut auras,
                aura_duration: _,
                ref mut range,
                ref mut energy_cost,
                scales_with_combo: _,
                specifier: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *cast_duration /= stats.speed;
                *recover_duration /= stats.speed;
                auras.iter_mut().for_each(
                    |aura::AuraBuffConstructor {
                         kind: _,
                         strength,
                         duration: _,
                         category: _,
                     }| {
                        *strength *= stats.diminished_buff_strength();
                    },
                );
                *range *= stats.range;
                *energy_cost /= stats.energy_efficiency;
            },
            StaticAura {
                ref mut buildup_duration,
                ref mut cast_duration,
                ref mut recover_duration,
                targets: _,
                ref mut auras,
                aura_duration: _,
                ref mut range,
                ref mut energy_cost,
                ref mut sprite_info,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *cast_duration /= stats.speed;
                *recover_duration /= stats.speed;
                auras.iter_mut().for_each(
                    |aura::AuraBuffConstructor {
                         kind: _,
                         strength,
                         duration: _,
                         category: _,
                     }| {
                        *strength *= stats.diminished_buff_strength();
                    },
                );
                *range *= stats.range;
                *energy_cost /= stats.energy_efficiency;
                *sprite_info = sprite_info.map(|mut si| {
                    si.summon_distance.0 *= stats.range;
                    si.summon_distance.1 *= stats.range;
                    si
                });
            },
            Blink {
                ref mut buildup_duration,
                ref mut recover_duration,
                ref mut max_range,
                frontend_specifier: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *max_range *= stats.range;
            },
            BasicSummon {
                ref mut buildup_duration,
                ref mut cast_duration,
                ref mut recover_duration,
                ref mut summon_info,
                movement_modifier: _,
                ori_modifier: _,
                meta: _,
            } => {
                // TODO: Figure out how/if power should affect this
                *buildup_duration /= stats.speed;
                *cast_duration /= stats.speed;
                *recover_duration /= stats.speed;
                summon_info.scale_range(stats.range);
            },
            SelfBuff {
                ref mut buildup_duration,
                ref mut cast_duration,
                ref mut recover_duration,
                ref mut buffs,
                use_raw_buff_strength,
                buff_cat: _,
                ref mut energy_cost,
                enforced_limit: _,
                combo_cost: _,
                combo_scaling: _,
                meta: _,
                specifier: _,
            } => {
                for buff in buffs.iter_mut() {
                    buff.data.strength *= if use_raw_buff_strength {
                        stats.buff_strength
                    } else {
                        stats.diminished_buff_strength()
                    };
                }
                *buildup_duration /= stats.speed;
                *cast_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *energy_cost /= stats.energy_efficiency;
            },
            SpriteSummon {
                ref mut buildup_duration,
                ref mut cast_duration,
                ref mut recover_duration,
                sprite: _,
                del_timeout: _,
                summon_distance: (ref mut inner_dist, ref mut outer_dist),
                sparseness: _,
                angle: _,
                anchor: _,
                move_efficiency: _,
                ori_modifier: _,
                meta: _,
            } => {
                // TODO: Figure out how/if power should affect this
                *buildup_duration /= stats.speed;
                *cast_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *inner_dist *= stats.range;
                *outer_dist *= stats.range;
            },
            Music {
                ref mut play_duration,
                ori_modifier: _,
                meta: _,
            } => {
                *play_duration /= stats.speed;
            },
            FinisherMelee {
                ref mut energy_cost,
                ref mut buildup_duration,
                ref mut swing_duration,
                ref mut recover_duration,
                ref mut melee_constructor,
                minimum_combo: _,
                scaling: _,
                combo_consumption: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *swing_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *energy_cost /= stats.energy_efficiency;
                *melee_constructor = melee_constructor.clone().adjusted_by_stats(stats);
            },
            DiveMelee {
                ref mut energy_cost,
                vertical_speed: _,
                movement_duration: _,
                ref mut buildup_duration,
                ref mut swing_duration,
                ref mut recover_duration,
                ref mut melee_constructor,
                max_scaling: _,
                meta: _,
            } => {
                *buildup_duration = buildup_duration.map(|b| b / stats.speed);
                *swing_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *energy_cost /= stats.energy_efficiency;
                *melee_constructor = melee_constructor.clone().adjusted_by_stats(stats);
            },
            RiposteMelee {
                ref mut energy_cost,
                ref mut buildup_duration,
                ref mut swing_duration,
                ref mut recover_duration,
                ref mut whiffed_recover_duration,
                ref mut block_strength,
                ref mut melee_constructor,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *swing_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *whiffed_recover_duration /= stats.speed;
                *energy_cost /= stats.energy_efficiency;
                *block_strength *= stats.power;
                *melee_constructor = melee_constructor.clone().adjusted_by_stats(stats);
            },
            RapidMelee {
                ref mut buildup_duration,
                ref mut swing_duration,
                ref mut recover_duration,
                ref mut energy_cost,
                ref mut melee_constructor,
                max_strikes: _,
                move_modifier: _,
                ori_modifier: _,
                minimum_combo: _,
                frontend_specifier: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *swing_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *energy_cost /= stats.energy_efficiency;
                *melee_constructor = melee_constructor.clone().adjusted_by_stats(stats);
            },
            Transform {
                ref mut buildup_duration,
                ref mut recover_duration,
                target: _,
                specifier: _,
                allow_players: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *recover_duration /= stats.speed;
            },
            GlideBoost { .. } => {},
            RegrowHead {
                ref mut buildup_duration,
                ref mut recover_duration,
                ref mut energy_cost,
                specifier: _,
                meta: _,
            } => {
                *buildup_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *energy_cost /= stats.energy_efficiency;
            },
            LeapRanged {
                ref mut energy_cost,
                ref mut buildup_duration,
                buildup_melee_timing: _,
                movement_duration: _,
                movement_ranged_timing: _,
                land_timeout: _,
                ref mut recover_duration,
                ref mut melee,
                melee_required: _,
                ref mut projectile,
                projectile_body: _,
                projectile_light: _,
                ref mut projectile_speed,
                horiz_leap_strength: _,
                vert_leap_strength: _,
                meta: _,
            } => {
                *energy_cost /= stats.energy_efficiency;
                *buildup_duration /= stats.speed;
                *recover_duration /= stats.speed;
                *melee = melee.as_ref().cloned().map(|m| m.adjusted_by_stats(stats));
                *projectile = projectile.clone().adjusted_by_stats(stats);
                *projectile_speed *= stats.range;
            },
            Simple {
                ref mut energy_cost,
                combo_cost: _,
                ref mut buildup_duration,
                meta: _,
            } => {
                *energy_cost /= stats.energy_efficiency;
                *buildup_duration /= stats.speed;
            },
        }
        self
    }

    pub fn energy_cost(&self) -> f32 {
        use CharacterAbility::*;
        match self {
            BasicMelee { energy_cost, .. }
            | BasicRanged { energy_cost, .. }
            | RapidRanged { energy_cost, .. }
            | DashMelee { energy_cost, .. }
            | Roll { energy_cost, .. }
            | LeapExplosionShockwave { energy_cost, .. }
            | LeapMelee { energy_cost, .. }
            | LeapShockwave { energy_cost, .. }
            | ChargedMelee { energy_cost, .. }
            | ChargedRanged { energy_cost, .. }
            | Throw { energy_cost, .. }
            | Shockwave { energy_cost, .. }
            | Explosion { energy_cost, .. }
            | BasicAura { energy_cost, .. }
            | BasicBlock { energy_cost, .. }
            | SelfBuff { energy_cost, .. }
            | FinisherMelee { energy_cost, .. }
            | ComboMelee2 {
                energy_cost_per_strike: energy_cost,
                ..
            }
            | DiveMelee { energy_cost, .. }
            | RiposteMelee { energy_cost, .. }
            | RapidMelee { energy_cost, .. }
            | StaticAura { energy_cost, .. }
            | RegrowHead { energy_cost, .. }
            | LeapRanged { energy_cost, .. }
            | Simple { energy_cost, .. } => *energy_cost,
            BasicBeam { energy_drain, .. } => {
                if *energy_drain > f32::EPSILON {
                    1.0
                } else {
                    0.0
                }
            },
            Boost { .. }
            | GlideBoost { .. }
            | Blink { .. }
            | Music { .. }
            | BasicSummon { .. }
            | SpriteSummon { .. }
            | Transform { .. } => 0.0,
        }
    }

    #[expect(clippy::bool_to_int_with_if)]
    pub fn combo_cost(&self) -> u32 {
        use CharacterAbility::*;
        match self {
            BasicAura {
                scales_with_combo, ..
            } => {
                if *scales_with_combo {
                    1
                } else {
                    0
                }
            },
            FinisherMelee {
                minimum_combo: combo,
                ..
            }
            | RapidMelee {
                minimum_combo: combo,
                ..
            }
            | SelfBuff {
                combo_cost: combo, ..
            }
            | Simple {
                combo_cost: combo, ..
            } => *combo,
            Shockwave {
                minimum_combo: combo,
                ..
            } => combo.unwrap_or(0),
            BasicMelee { .. }
            | BasicRanged { .. }
            | RapidRanged { .. }
            | DashMelee { .. }
            | Roll { .. }
            | LeapExplosionShockwave { .. }
            | LeapMelee { .. }
            | LeapShockwave { .. }
            | Explosion { .. }
            | ChargedMelee { .. }
            | ChargedRanged { .. }
            | Throw { .. }
            | BasicBlock { .. }
            | ComboMelee2 { .. }
            | DiveMelee { .. }
            | RiposteMelee { .. }
            | BasicBeam { .. }
            | Boost { .. }
            | GlideBoost { .. }
            | Blink { .. }
            | Music { .. }
            | BasicSummon { .. }
            | SpriteSummon { .. }
            | Transform { .. }
            | StaticAura { .. }
            | RegrowHead { .. }
            | LeapRanged { .. } => 0,
        }
    }

    // TODO: Maybe consider making CharacterAbility a struct at some point?
    pub fn ability_meta(&self) -> AbilityMeta {
        use CharacterAbility::*;
        match self {
            BasicMelee { meta, .. }
            | BasicRanged { meta, .. }
            | RapidRanged { meta, .. }
            | DashMelee { meta, .. }
            | Roll { meta, .. }
            | LeapExplosionShockwave { meta, .. }
            | LeapMelee { meta, .. }
            | LeapShockwave { meta, .. }
            | ChargedMelee { meta, .. }
            | ChargedRanged { meta, .. }
            | Throw { meta, .. }
            | Shockwave { meta, .. }
            | Explosion { meta, .. }
            | BasicAura { meta, .. }
            | BasicBlock { meta, .. }
            | SelfBuff { meta, .. }
            | BasicBeam { meta, .. }
            | Boost { meta, .. }
            | GlideBoost { meta, .. }
            | ComboMelee2 { meta, .. }
            | Blink { meta, .. }
            | BasicSummon { meta, .. }
            | SpriteSummon { meta, .. }
            | FinisherMelee { meta, .. }
            | Music { meta, .. }
            | DiveMelee { meta, .. }
            | RiposteMelee { meta, .. }
            | RapidMelee { meta, .. }
            | Transform { meta, .. }
            | StaticAura { meta, .. }
            | RegrowHead { meta, .. }
            | LeapRanged { meta, .. }
            | Simple { meta, .. } => *meta,
        }
    }

    #[must_use = "method returns new ability and doesn't mutate the original value"]
    pub fn adjusted_by_skills(mut self, skillset: &SkillSet, tool: Option<ToolKind>) -> Self {
        match tool {
            Some(ToolKind::Sceptre) => self.adjusted_by_sceptre_skills(skillset),
            Some(ToolKind::Pick) => self.adjusted_by_mining_skills(skillset),
            None | Some(_) => {},
        }
        self
    }

    fn adjusted_by_mining_skills(&mut self, skillset: &SkillSet) {
        use skills::MiningSkill::Speed;

        if let CharacterAbility::BasicMelee {
            buildup_duration,
            swing_duration,
            recover_duration,
            ..
        } = self
            && let Ok(level) = skillset.skill_level(Skill::Pick(Speed))
        {
            let modifiers = SKILL_MODIFIERS.mining_tree;

            let speed = modifiers.speed.powi(level.into());
            *buildup_duration /= speed;
            *swing_duration /= speed;
            *recover_duration /= speed;
        }
    }

    fn adjusted_by_sceptre_skills(&mut self, skillset: &SkillSet) {
        use skills::{SceptreSkill::*, Skill::Sceptre};

        match self {
            CharacterAbility::BasicBeam {
                damage,
                range,
                beam_duration,
                damage_effect,
                energy_regen,
                ..
            } => {
                let modifiers = SKILL_MODIFIERS.sceptre_tree.beam;
                if let Ok(level) = skillset.skill_level(Sceptre(LDamage)) {
                    *damage *= modifiers.damage.powi(level.into());
                }
                if let Ok(level) = skillset.skill_level(Sceptre(LRange)) {
                    let range_mod = modifiers.range.powi(level.into());
                    *range *= range_mod;
                    // Duration modified to keep velocity constant
                    *beam_duration *= range_mod as f64;
                }
                if let Ok(level) = skillset.skill_level(Sceptre(LRegen)) {
                    *energy_regen *= modifiers.energy_regen.powi(level.into());
                }
                if let (Ok(level), Some(CombatEffect::Lifesteal(lifesteal))) =
                    (skillset.skill_level(Sceptre(LLifesteal)), damage_effect)
                {
                    *lifesteal *= modifiers.lifesteal.powi(level.into());
                }
            },
            CharacterAbility::BasicAura {
                auras,
                range,
                energy_cost,
                specifier: Some(aura::Specifier::HealingAura),
                ..
            } => {
                let modifiers = SKILL_MODIFIERS.sceptre_tree.healing_aura;
                if let Ok(level) = skillset.skill_level(Sceptre(HHeal)) {
                    auras.iter_mut().for_each(|ref mut aura| {
                        aura.strength *= modifiers.strength.powi(level.into());
                    });
                }
                if let Ok(level) = skillset.skill_level(Sceptre(HDuration)) {
                    auras.iter_mut().for_each(|ref mut aura| {
                        if let Some(ref mut duration) = aura.duration {
                            *duration *= modifiers.duration.powi(level.into()) as f64;
                        }
                    });
                }
                if let Ok(level) = skillset.skill_level(Sceptre(HRange)) {
                    *range *= modifiers.range.powi(level.into());
                }
                if let Ok(level) = skillset.skill_level(Sceptre(HCost)) {
                    *energy_cost *= modifiers.energy_cost.powi(level.into());
                }
            },
            CharacterAbility::BasicAura {
                auras,
                range,
                energy_cost,
                specifier: Some(aura::Specifier::WardingAura),
                ..
            } => {
                let modifiers = SKILL_MODIFIERS.sceptre_tree.warding_aura;
                if let Ok(level) = skillset.skill_level(Sceptre(AStrength)) {
                    auras.iter_mut().for_each(|ref mut aura| {
                        aura.strength *= modifiers.strength.powi(level.into());
                    });
                }
                if let Ok(level) = skillset.skill_level(Sceptre(ADuration)) {
                    auras.iter_mut().for_each(|ref mut aura| {
                        if let Some(ref mut duration) = aura.duration {
                            *duration *= modifiers.duration.powi(level.into()) as f64;
                        }
                    });
                }
                if let Ok(level) = skillset.skill_level(Sceptre(ARange)) {
                    *range *= modifiers.range.powi(level.into());
                }
                if let Ok(level) = skillset.skill_level(Sceptre(ACost)) {
                    *energy_cost *= modifiers.energy_cost.powi(level.into());
                }
            },
            _ => {},
        }
    }
}

/// Small helper for #[serde(default)] booleans
fn default_true() -> bool { true }

#[derive(Debug)]
pub enum CharacterStateCreationError {
    MissingHandInfo,
    MissingItem,
    InvalidItemKind,
}

impl TryFrom<(&CharacterAbility, AbilityInfo, &JoinData<'_>)> for CharacterState {
    type Error = CharacterStateCreationError;

    fn try_from(
        (ability, ability_info, data): (&CharacterAbility, AbilityInfo, &JoinData),
    ) -> Result<Self, Self::Error> {
        Ok(match ability {
            CharacterAbility::BasicMelee {
                buildup_duration,
                swing_duration,
                hit_timing,
                recover_duration,
                melee_constructor,
                movement_modifier,
                ori_modifier,
                frontend_specifier,
                energy_cost: _,
                meta: _,
            } => CharacterState::BasicMelee(basic_melee::Data {
                static_data: basic_melee::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    swing_duration: Duration::from_secs_f32(*swing_duration),
                    hit_timing: hit_timing.clamp(0.0, 1.0),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    melee_constructor: melee_constructor.clone(),
                    movement_modifier: *movement_modifier,
                    ori_modifier: *ori_modifier,
                    frontend_specifier: *frontend_specifier,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                exhausted: false,
                movement_modifier: movement_modifier.buildup,
                ori_modifier: ori_modifier.buildup,
            }),
            CharacterAbility::BasicRanged {
                buildup_duration,
                recover_duration,
                projectile,
                projectile_body,
                projectile_light,
                projectile_speed,
                vertical_angle_offset,
                energy_cost: _,
                num_projectiles,
                projectile_spread,
                auto_aim,
                movement_modifier,
                ori_modifier,
                marker,
                meta: _,
            } => CharacterState::BasicRanged(basic_ranged::Data {
                static_data: basic_ranged::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    projectile: projectile.clone(),
                    projectile_body: *projectile_body,
                    projectile_light: *projectile_light,
                    projectile_speed: *projectile_speed,
                    vertical_angle_offset: *vertical_angle_offset,
                    num_projectiles: *num_projectiles,
                    projectile_spread: *projectile_spread,
                    auto_aim: *auto_aim,
                    ability_info,
                    movement_modifier: *movement_modifier,
                    ori_modifier: *ori_modifier,
                    marker: *marker,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                exhausted: false,
                movement_modifier: movement_modifier.buildup,
                ori_modifier: ori_modifier.buildup,
            }),
            CharacterAbility::Boost {
                movement_duration,
                only_up,
                speed,
                max_exit_velocity,
                meta: _,
            } => CharacterState::Boost(boost::Data {
                static_data: boost::StaticData {
                    movement_duration: Duration::from_secs_f32(*movement_duration),
                    only_up: *only_up,
                    speed: *speed,
                    max_exit_velocity: *max_exit_velocity,
                    ability_info,
                },
                timer: Duration::default(),
            }),
            CharacterAbility::GlideBoost { booster, meta: _ } => {
                let scale = data.body.dimensions().z.sqrt();
                let mut glide_data = glide::Data::new(scale * 4.5, scale, *data.ori);
                glide_data.booster = Some(*booster);

                CharacterState::Glide(glide_data)
            },
            CharacterAbility::DashMelee {
                energy_cost: _,
                energy_drain,
                forward_speed,
                buildup_duration,
                charge_duration,
                swing_duration,
                recover_duration,
                melee_constructor,
                ori_modifier,
                auto_charge,
                charge_through,
                frontend_specifier,
                meta: _,
            } => CharacterState::DashMelee(dash_melee::Data {
                static_data: dash_melee::StaticData {
                    energy_drain: *energy_drain,
                    forward_speed: *forward_speed,
                    auto_charge: *auto_charge,
                    charge_through: *charge_through,
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    charge_duration: Duration::from_secs_f32(*charge_duration),
                    swing_duration: Duration::from_secs_f32(*swing_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    melee_constructor: melee_constructor.clone(),
                    ori_modifier: *ori_modifier,
                    frontend_specifier: *frontend_specifier,
                    ability_info,
                },
                auto_charge: false,
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
            }),
            CharacterAbility::BasicBlock {
                buildup_duration,
                recover_duration,
                max_angle,
                block_strength,
                parry_window,
                energy_cost,
                energy_regen,
                can_hold,
                blocked_attacks,
                meta: _,
            } => CharacterState::BasicBlock(basic_block::Data {
                static_data: basic_block::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    max_angle: *max_angle,
                    block_strength: *block_strength,
                    parry_window: *parry_window,
                    energy_cost: *energy_cost,
                    energy_regen: *energy_regen,
                    can_hold: *can_hold,
                    blocked_attacks: *blocked_attacks,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                is_parry: false,
            }),
            CharacterAbility::Roll {
                energy_cost: _,
                buildup_duration,
                movement_duration,
                recover_duration,
                roll_strength,
                attack_immunities,
                was_cancel,
                meta: _,
            } => CharacterState::Roll(roll::Data {
                static_data: roll::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    movement_duration: Duration::from_secs_f32(*movement_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    roll_strength: *roll_strength,
                    attack_immunities: *attack_immunities,
                    was_cancel: *was_cancel,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                was_wielded: false, // false by default. utils might set it to true
                prev_aimed_dir: None,
                is_sneaking: false,
            }),
            CharacterAbility::ComboMelee2 {
                strikes,
                energy_cost_per_strike,
                specifier,
                auto_progress,
                meta: _,
            } => CharacterState::ComboMelee2(combo_melee2::Data {
                static_data: combo_melee2::StaticData {
                    strikes: strikes.iter().cloned().map(|s| s.to_duration()).collect(),
                    energy_cost_per_strike: *energy_cost_per_strike,
                    specifier: *specifier,
                    auto_progress: *auto_progress,
                    ability_info,
                },
                exhausted: false,
                start_next_strike: false,
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                completed_strikes: 0,
                movement_modifier: strikes.first().and_then(|s| s.movement_modifier.buildup),
                ori_modifier: strikes.first().and_then(|s| s.ori_modifier.buildup),
            }),
            CharacterAbility::LeapExplosionShockwave {
                energy_cost: _,
                buildup_duration,
                movement_duration,
                swing_duration,
                recover_duration,
                forward_leap_strength,
                vertical_leap_strength,
                explosion_damage,
                explosion_poise,
                explosion_knockback,
                explosion_radius,
                min_falloff,
                explosion_dodgeable,
                destroy_terrain,
                replace_terrain,
                eye_height,
                reagent,
                shockwave_damage,
                shockwave_poise,
                shockwave_knockback,
                shockwave_angle,
                shockwave_vertical_angle,
                shockwave_speed,
                shockwave_duration,
                shockwave_dodgeable,
                shockwave_damage_effect,
                shockwave_damage_kind,
                shockwave_specifier,
                move_efficiency,
                meta: _,
            } => CharacterState::LeapExplosionShockwave(leap_explosion_shockwave::Data {
                static_data: leap_explosion_shockwave::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    movement_duration: Duration::from_secs_f32(*movement_duration),
                    swing_duration: Duration::from_secs_f32(*swing_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    forward_leap_strength: *forward_leap_strength,
                    vertical_leap_strength: *vertical_leap_strength,
                    explosion_damage: *explosion_damage,
                    explosion_poise: *explosion_poise,
                    explosion_knockback: *explosion_knockback,
                    explosion_radius: *explosion_radius,
                    min_falloff: *min_falloff,
                    explosion_dodgeable: *explosion_dodgeable,
                    destroy_terrain: *destroy_terrain,
                    replace_terrain: *replace_terrain,
                    eye_height: *eye_height,
                    reagent: *reagent,
                    shockwave_damage: *shockwave_damage,
                    shockwave_poise: *shockwave_poise,
                    shockwave_knockback: *shockwave_knockback,
                    shockwave_angle: *shockwave_angle,
                    shockwave_vertical_angle: *shockwave_vertical_angle,
                    shockwave_speed: *shockwave_speed,
                    shockwave_duration: Duration::from_secs_f32(*shockwave_duration),
                    shockwave_dodgeable: *shockwave_dodgeable,
                    shockwave_damage_effect: shockwave_damage_effect.clone(),
                    shockwave_damage_kind: *shockwave_damage_kind,
                    shockwave_specifier: *shockwave_specifier,
                    move_efficiency: *move_efficiency,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                exhausted: false,
            }),
            CharacterAbility::LeapMelee {
                energy_cost: _,
                buildup_duration,
                movement_duration,
                swing_duration,
                recover_duration,
                melee_constructor,
                forward_leap_strength,
                vertical_leap_strength,
                specifier,
                meta: _,
            } => CharacterState::LeapMelee(leap_melee::Data {
                static_data: leap_melee::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    movement_duration: Duration::from_secs_f32(*movement_duration),
                    swing_duration: Duration::from_secs_f32(*swing_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    melee_constructor: melee_constructor.clone(),
                    forward_leap_strength: *forward_leap_strength,
                    vertical_leap_strength: *vertical_leap_strength,
                    ability_info,
                    specifier: *specifier,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                exhausted: false,
            }),
            CharacterAbility::LeapShockwave {
                energy_cost: _,
                buildup_duration,
                movement_duration,
                swing_duration,
                recover_duration,
                damage,
                poise_damage,
                knockback,
                shockwave_angle,
                shockwave_vertical_angle,
                shockwave_speed,
                shockwave_duration,
                dodgeable,
                move_efficiency,
                damage_kind,
                specifier,
                damage_effect,
                forward_leap_strength,
                vertical_leap_strength,
                meta: _,
            } => CharacterState::LeapShockwave(leap_shockwave::Data {
                static_data: leap_shockwave::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    movement_duration: Duration::from_secs_f32(*movement_duration),
                    swing_duration: Duration::from_secs_f32(*swing_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    damage: *damage,
                    poise_damage: *poise_damage,
                    knockback: *knockback,
                    shockwave_angle: *shockwave_angle,
                    shockwave_vertical_angle: *shockwave_vertical_angle,
                    shockwave_speed: *shockwave_speed,
                    shockwave_duration: Duration::from_secs_f32(*shockwave_duration),
                    dodgeable: *dodgeable,
                    move_efficiency: *move_efficiency,
                    damage_kind: *damage_kind,
                    specifier: *specifier,
                    damage_effect: damage_effect.clone(),
                    forward_leap_strength: *forward_leap_strength,
                    vertical_leap_strength: *vertical_leap_strength,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                exhausted: false,
            }),
            CharacterAbility::ChargedMelee {
                energy_cost,
                energy_drain,
                buildup_strike,
                charge_duration,
                swing_duration,
                hit_timing,
                recover_duration,
                melee_constructor,
                specifier,
                custom_combo,
                meta: _,
                movement_modifier,
                ori_modifier,
            } => CharacterState::ChargedMelee(charged_melee::Data {
                static_data: charged_melee::StaticData {
                    energy_cost: *energy_cost,
                    energy_drain: *energy_drain,
                    buildup_strike: buildup_strike
                        .as_ref()
                        .map(|(dur, strike)| (Duration::from_secs_f32(*dur), strike.clone())),
                    charge_duration: Duration::from_secs_f32(*charge_duration),
                    swing_duration: Duration::from_secs_f32(*swing_duration),
                    hit_timing: *hit_timing,
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    melee_constructor: melee_constructor.clone(),
                    ability_info,
                    specifier: *specifier,
                    custom_combo: *custom_combo,
                    movement_modifier: *movement_modifier,
                    ori_modifier: *ori_modifier,
                },
                stage_section: if buildup_strike.is_some() {
                    StageSection::Buildup
                } else {
                    StageSection::Charge
                },
                timer: Duration::default(),
                exhausted: false,
                charge_amount: 0.0,
                movement_modifier: movement_modifier.buildup,
                ori_modifier: ori_modifier.buildup,
            }),
            CharacterAbility::ChargedRanged {
                energy_cost: _,
                energy_drain,
                idle_drain,
                projectile,
                buildup_duration,
                charge_duration,
                recover_duration,
                projectile_body,
                projectile_light,
                initial_projectile_speed,
                scaled_projectile_speed,
                projectile_spread,
                num_projectiles,
                marker,
                move_speed,
                meta: _,
            } => CharacterState::ChargedRanged(charged_ranged::Data {
                static_data: charged_ranged::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    charge_duration: Duration::from_secs_f32(*charge_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    energy_drain: *energy_drain,
                    idle_drain: *idle_drain,
                    projectile: projectile.clone(),
                    projectile_body: *projectile_body,
                    projectile_light: *projectile_light,
                    initial_projectile_speed: *initial_projectile_speed,
                    scaled_projectile_speed: *scaled_projectile_speed,
                    projectile_spread: *projectile_spread,
                    num_projectiles: *num_projectiles,
                    marker: *marker,
                    move_speed: *move_speed,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                exhausted: false,
            }),
            CharacterAbility::RapidRanged {
                initial_energy: _,
                energy_cost,
                buildup_duration,
                shoot_duration,
                recover_duration,
                options,
                projectile,
                projectile_body,
                projectile_light,
                projectile_speed,
                specifier,
                meta: _,
            } => CharacterState::RapidRanged(rapid_ranged::Data {
                static_data: rapid_ranged::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    shoot_duration: Duration::from_secs_f32(*shoot_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    energy_cost: *energy_cost,
                    options: *options,
                    projectile: projectile.clone(),
                    projectile_body: *projectile_body,
                    projectile_light: *projectile_light,
                    projectile_speed: *projectile_speed,
                    ability_info,
                    specifier: *specifier,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                projectiles_fired: 0,
                speed: 1.0,
            }),
            CharacterAbility::Throw {
                energy_cost: _,
                energy_drain,
                buildup_duration,
                charge_duration,
                throw_duration,
                recover_duration,
                projectile,
                projectile_light,
                projectile_dir,
                initial_projectile_speed,
                scaled_projectile_speed,
                damage_effect,
                move_speed,
                meta: _,
            } => {
                let hand_info = if let Some(hand_info) = ability_info.hand {
                    hand_info
                } else {
                    return Err(CharacterStateCreationError::MissingHandInfo);
                };

                let equip_slot = hand_info.to_equip_slot();

                let equipped_item =
                    if let Some(item) = data.inventory.and_then(|inv| inv.equipped(equip_slot)) {
                        item
                    } else {
                        return Err(CharacterStateCreationError::MissingItem);
                    };

                let item_hash = equipped_item.item_hash();

                let tool_kind = if let ItemKind::Tool(Tool { kind, .. }) = *equipped_item.kind() {
                    kind
                } else {
                    return Err(CharacterStateCreationError::InvalidItemKind);
                };

                CharacterState::Throw(throw::Data {
                    static_data: throw::StaticData {
                        buildup_duration: Duration::from_secs_f32(*buildup_duration),
                        charge_duration: Duration::from_secs_f32(*charge_duration),
                        throw_duration: Duration::from_secs_f32(*throw_duration),
                        recover_duration: Duration::from_secs_f32(*recover_duration),
                        energy_drain: *energy_drain,
                        projectile: projectile.clone(),
                        projectile_light: *projectile_light,
                        projectile_dir: *projectile_dir,
                        initial_projectile_speed: *initial_projectile_speed,
                        scaled_projectile_speed: *scaled_projectile_speed,
                        move_speed: *move_speed,
                        ability_info,
                        damage_effect: damage_effect.clone(),
                        equip_slot,
                        item_hash,
                        hand_info,
                        tool_kind,
                    },
                    timer: Duration::default(),
                    stage_section: StageSection::Buildup,
                    exhausted: false,
                })
            },
            CharacterAbility::Shockwave {
                energy_cost: _,
                buildup_duration,
                swing_duration,
                recover_duration,
                damage,
                poise_damage,
                knockback,
                shockwave_angle,
                shockwave_vertical_angle,
                shockwave_speed,
                shockwave_duration,
                dodgeable,
                move_efficiency,
                damage_kind,
                specifier,
                ori_rate,
                damage_effect,
                timing,
                emit_outcome,
                minimum_combo,
                combo_consumption,
                meta: _,
            } => CharacterState::Shockwave(shockwave::Data {
                static_data: shockwave::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    swing_duration: Duration::from_secs_f32(*swing_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    damage: *damage,
                    poise_damage: *poise_damage,
                    knockback: *knockback,
                    shockwave_angle: *shockwave_angle,
                    shockwave_vertical_angle: *shockwave_vertical_angle,
                    shockwave_speed: *shockwave_speed,
                    shockwave_duration: Duration::from_secs_f32(*shockwave_duration),
                    dodgeable: *dodgeable,
                    move_efficiency: *move_efficiency,
                    damage_effect: damage_effect.clone(),
                    ability_info,
                    damage_kind: *damage_kind,
                    specifier: *specifier,
                    ori_rate: *ori_rate,
                    timing: *timing,
                    emit_outcome: *emit_outcome,
                    minimum_combo: *minimum_combo,
                    combo_on_use: data.combo.map_or(0, |c| c.counter()),
                    combo_consumption: *combo_consumption,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
            }),
            CharacterAbility::Explosion {
                energy_cost: _,
                buildup_duration,
                action_duration,
                recover_duration,
                damage,
                poise,
                knockback,
                radius,
                min_falloff,
                dodgeable,
                destroy_terrain,
                replace_terrain,
                eye_height,
                reagent,
                movement_modifier,
                ori_modifier,
                meta: _,
            } => CharacterState::Explosion(explosion::Data {
                static_data: explosion::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    action_duration: Duration::from_secs_f32(*action_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    damage: *damage,
                    poise: *poise,
                    knockback: *knockback,
                    radius: *radius,
                    min_falloff: *min_falloff,
                    dodgeable: *dodgeable,
                    destroy_terrain: *destroy_terrain,
                    replace_terrain: *replace_terrain,
                    eye_height: *eye_height,
                    reagent: *reagent,
                    movement_modifier: *movement_modifier,
                    ori_modifier: *ori_modifier,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                movement_modifier: movement_modifier.buildup,
                ori_modifier: ori_modifier.buildup,
            }),
            CharacterAbility::BasicBeam {
                buildup_duration,
                recover_duration,
                beam_duration,
                damage,
                tick_rate,
                range,
                dodgeable,
                blockable,
                max_angle,
                damage_effect,
                energy_regen,
                energy_drain,
                move_efficiency,
                ori_rate,
                specifier,
                meta: _,
            } => CharacterState::BasicBeam(basic_beam::Data {
                static_data: basic_beam::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    beam_duration: Secs(*beam_duration),
                    damage: *damage,
                    tick_rate: *tick_rate,
                    range: *range,
                    dodgeable: *dodgeable,
                    blockable: *blockable,
                    end_radius: max_angle.to_radians().tan() * *range,
                    damage_effect: damage_effect.clone(),
                    energy_regen: *energy_regen,
                    energy_drain: *energy_drain,
                    ability_info,
                    move_efficiency: *move_efficiency,
                    ori_rate: *ori_rate,
                    specifier: *specifier,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                aim_dir: data.ori.look_dir(),
                beam_offset: data.pos.0,
            }),
            CharacterAbility::BasicAura {
                buildup_duration,
                cast_duration,
                recover_duration,
                targets,
                auras,
                aura_duration,
                range,
                energy_cost: _,
                scales_with_combo,
                specifier,
                meta: _,
            } => CharacterState::BasicAura(basic_aura::Data {
                static_data: basic_aura::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    cast_duration: Duration::from_secs_f32(*cast_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    targets: *targets,
                    auras: auras.clone(),
                    aura_duration: *aura_duration,
                    range: *range,
                    ability_info,
                    scales_with_combo: *scales_with_combo,
                    combo_at_cast: data.combo.map_or(0, |c| c.counter()),
                    specifier: *specifier,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
            }),
            CharacterAbility::StaticAura {
                buildup_duration,
                cast_duration,
                recover_duration,
                targets,
                auras,
                aura_duration,
                range,
                energy_cost: _,
                sprite_info,
                meta: _,
            } => CharacterState::StaticAura(static_aura::Data {
                static_data: static_aura::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    cast_duration: Duration::from_secs_f32(*cast_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    targets: *targets,
                    auras: auras.clone(),
                    aura_duration: *aura_duration,
                    range: *range,
                    ability_info,
                    sprite_info: *sprite_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                achieved_radius: sprite_info.map(|si| si.summon_distance.0.floor() as i32 - 1),
            }),
            CharacterAbility::Blink {
                buildup_duration,
                recover_duration,
                max_range,
                frontend_specifier,
                meta: _,
            } => CharacterState::Blink(blink::Data {
                static_data: blink::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    max_range: *max_range,
                    frontend_specifier: *frontend_specifier,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
            }),
            CharacterAbility::BasicSummon {
                buildup_duration,
                cast_duration,
                recover_duration,
                summon_info,
                movement_modifier,
                ori_modifier,
                meta: _,
            } => CharacterState::BasicSummon(basic_summon::Data {
                static_data: basic_summon::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    cast_duration: Duration::from_secs_f32(*cast_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    summon_info: summon_info.clone(),
                    movement_modifier: *movement_modifier,
                    ori_modifier: *ori_modifier,
                    ability_info,
                },
                summon_count: 0,
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                movement_modifier: movement_modifier.buildup,
                ori_modifier: ori_modifier.buildup,
            }),
            CharacterAbility::SelfBuff {
                buildup_duration,
                cast_duration,
                recover_duration,
                buffs,
                use_raw_buff_strength: _,
                buff_cat,
                energy_cost: _,
                combo_cost,
                combo_scaling,
                enforced_limit,
                meta: _,
                specifier,
            } => CharacterState::SelfBuff(self_buff::Data {
                static_data: self_buff::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    cast_duration: Duration::from_secs_f32(*cast_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    buffs: buffs.clone(),
                    buff_cat: buff_cat.clone(),
                    combo_cost: *combo_cost,
                    combo_scaling: *combo_scaling,
                    combo_on_use: data.combo.map_or(0, |c| c.counter()),
                    enforced_limit: *enforced_limit,
                    ability_info,
                    specifier: *specifier,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
            }),
            CharacterAbility::SpriteSummon {
                buildup_duration,
                cast_duration,
                recover_duration,
                sprite,
                del_timeout,
                summon_distance,
                sparseness,
                angle,
                anchor,
                move_efficiency,
                ori_modifier,
                meta: _,
            } => CharacterState::SpriteSummon(sprite_summon::Data {
                static_data: sprite_summon::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    cast_duration: Duration::from_secs_f32(*cast_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    sprite: *sprite,
                    del_timeout: *del_timeout,
                    summon_distance: *summon_distance,
                    sparseness: *sparseness,
                    angle: *angle,
                    anchor: *anchor,
                    move_efficiency: *move_efficiency,
                    ori_modifier: *ori_modifier,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                achieved_radius: summon_distance.0.floor() as i32 - 1,
            }),
            CharacterAbility::Music {
                play_duration,
                ori_modifier,
                meta: _,
            } => CharacterState::Music(music::Data {
                static_data: music::StaticData {
                    play_duration: Duration::from_secs_f32(*play_duration),
                    ori_modifier: *ori_modifier,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Action,
                exhausted: false,
            }),
            CharacterAbility::FinisherMelee {
                energy_cost: _,
                buildup_duration,
                swing_duration,
                recover_duration,
                melee_constructor,
                minimum_combo,
                scaling,
                combo_consumption,
                meta: _,
            } => CharacterState::FinisherMelee(finisher_melee::Data {
                static_data: finisher_melee::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    swing_duration: Duration::from_secs_f32(*swing_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    melee_constructor: melee_constructor.clone(),
                    scaling: *scaling,
                    minimum_combo: *minimum_combo,
                    combo_on_use: data.combo.map_or(0, |c| c.counter()),
                    combo_consumption: *combo_consumption,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                exhausted: false,
            }),
            CharacterAbility::DiveMelee {
                buildup_duration,
                movement_duration,
                swing_duration,
                recover_duration,
                melee_constructor,
                energy_cost: _,
                vertical_speed,
                max_scaling,
                meta: _,
            } => CharacterState::DiveMelee(dive_melee::Data {
                static_data: dive_melee::StaticData {
                    buildup_duration: buildup_duration.map(Duration::from_secs_f32),
                    movement_duration: Duration::from_secs_f32(*movement_duration),
                    swing_duration: Duration::from_secs_f32(*swing_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    vertical_speed: *vertical_speed,
                    melee_constructor: melee_constructor.clone(),
                    max_scaling: *max_scaling,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: if data.physics.on_ground.is_none() || buildup_duration.is_none() {
                    StageSection::Movement
                } else {
                    StageSection::Buildup
                },
                exhausted: false,
                max_vertical_speed: 0.0,
            }),
            CharacterAbility::RiposteMelee {
                energy_cost: _,
                buildup_duration,
                swing_duration,
                recover_duration,
                whiffed_recover_duration,
                block_strength,
                melee_constructor,
                meta: _,
            } => CharacterState::RiposteMelee(riposte_melee::Data {
                static_data: riposte_melee::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    swing_duration: Duration::from_secs_f32(*swing_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    whiffed_recover_duration: Duration::from_secs_f32(*whiffed_recover_duration),
                    block_strength: *block_strength,
                    melee_constructor: melee_constructor.clone(),
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                exhausted: false,
                whiffed: true,
            }),
            CharacterAbility::RapidMelee {
                buildup_duration,
                swing_duration,
                recover_duration,
                melee_constructor,
                energy_cost,
                max_strikes,
                move_modifier,
                ori_modifier,
                minimum_combo,
                frontend_specifier,
                meta: _,
            } => CharacterState::RapidMelee(rapid_melee::Data {
                static_data: rapid_melee::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    swing_duration: Duration::from_secs_f32(*swing_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    melee_constructor: melee_constructor.clone(),
                    energy_cost: *energy_cost,
                    max_strikes: *max_strikes,
                    move_modifier: *move_modifier,
                    ori_modifier: *ori_modifier,
                    minimum_combo: *minimum_combo,
                    frontend_specifier: *frontend_specifier,
                    ability_info,
                },
                timer: Duration::default(),
                current_strike: 1,
                stage_section: StageSection::Buildup,
                exhausted: false,
            }),
            CharacterAbility::Transform {
                buildup_duration,
                recover_duration,
                target,
                specifier,
                allow_players,
                meta: _,
            } => CharacterState::Transform(transform::Data {
                static_data: transform::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    specifier: *specifier,
                    allow_players: *allow_players,
                    target: target.to_owned(),
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
            }),
            CharacterAbility::RegrowHead {
                buildup_duration,
                recover_duration,
                energy_cost,
                specifier,
                meta: _,
            } => CharacterState::RegrowHead(regrow_head::Data {
                static_data: regrow_head::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    specifier: *specifier,
                    energy_cost: *energy_cost,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
            }),
            CharacterAbility::LeapRanged {
                energy_cost: _,
                buildup_duration,
                buildup_melee_timing,
                movement_duration,
                movement_ranged_timing,
                land_timeout,
                recover_duration,
                melee,
                melee_required,
                projectile,
                projectile_body,
                projectile_light,
                projectile_speed,
                horiz_leap_strength,
                vert_leap_strength,
                meta: _,
            } => CharacterState::LeapRanged(leap_ranged::Data {
                static_data: leap_ranged::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    buildup_melee_timing: *buildup_melee_timing,
                    movement_duration: Duration::from_secs_f32(*movement_duration),
                    movement_ranged_timing: *movement_ranged_timing,
                    land_timeout: Duration::from_secs_f32(*land_timeout),
                    recover_duration: Duration::from_secs_f32(*recover_duration),
                    melee: melee.clone(),
                    melee_required: *melee_required,
                    projectile: projectile.clone(),
                    projectile_body: *projectile_body,
                    projectile_light: *projectile_light,
                    projectile_speed: *projectile_speed,
                    horiz_leap_strength: *horiz_leap_strength,
                    vert_leap_strength: *vert_leap_strength,
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
                melee_done: false,
                ranged_done: false,
            }),
            CharacterAbility::Simple {
                energy_cost: _,
                combo_cost: _,
                buildup_duration,
                meta: _,
            } => CharacterState::Simple(simple::Data {
                static_data: simple::StaticData {
                    buildup_duration: Duration::from_secs_f32(*buildup_duration),
                    ability_info,
                },
                timer: Duration::default(),
                stage_section: StageSection::Buildup,
            }),
        })
    }
}

#[derive(Copy, Clone, Debug, PartialEq, Serialize, Deserialize, Default)]
#[serde(deny_unknown_fields)]
pub struct AbilityMeta {
    #[serde(default)]
    pub capabilities: Capability,
    #[serde(default)]
    /// This is an event that gets emitted when the ability is first activated
    pub init_event: Option<AbilityInitEvent>,
    #[serde(default)]
    pub requirements: AbilityRequirements,
    /// Adjusts stats of ability when activated based on context.
    // If we ever add more, I guess change to a vec? Or maybe just an array if we want to keep
    // AbilityMeta small?
    pub contextual_stats: Option<StatAdj>,
    /// If provided, multiplies the precision power from armor for this ability
    pub precision_power_mult: Option<f32>,
}

impl StatAdj {
    pub fn equivalent_stats(&self, data: &JoinData) -> Stats {
        let mut stats = Stats::one();
        let add = match self.context {
            StatContext::PoiseResilience(base) => {
                let poise_res = combat::compute_poise_resilience(data.inventory, data.msm);
                poise_res.unwrap_or(0.0) / base.max(0.1)
            },
            StatContext::Stealth(base) => {
                let stealth = combat::compute_stealth(data.inventory, data.msm);
                stealth / base.max(0.1)
            },
        };
        match self.field {
            StatField::EffectPower => {
                stats.effect_power += add;
            },
            StatField::BuffStrength => {
                stats.buff_strength += add;
            },
            StatField::Power => {
                stats.power += add;
            },
        }
        stats
    }
}

#[derive(Copy, Clone, Debug, PartialEq, Serialize, Deserialize)]
pub struct StatAdj {
    /// If this much of the stat is achieved, 1.0 will be added to the affected
    /// stat
    pub context: StatContext,
    pub field: StatField,
}

#[derive(Copy, Clone, Debug, PartialEq, Serialize, Deserialize)]
pub enum StatContext {
    PoiseResilience(f32),
    Stealth(f32),
}

#[derive(Copy, Clone, Debug, PartialEq, Serialize, Deserialize)]
pub enum StatField {
    EffectPower,
    BuffStrength,
    Power,
}

#[derive(Copy, Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub enum AbilityReqItem {
    Firedrop,
    PoisonClot,
    GelidGel,
    LevinDust,
}

impl AbilityReqItem {
    pub fn item_def_id(&self) -> ItemDefinitionIdOwned {
        match self {
            Self::Firedrop => {
                ItemDefinitionIdOwned::Simple(String::from("common.items.consumable.firedrop"))
            },
            Self::PoisonClot => {
                ItemDefinitionIdOwned::Simple(String::from("common.items.consumable.poison_clot"))
            },
            Self::GelidGel => {
                ItemDefinitionIdOwned::Simple(String::from("common.items.consumable.gelid_gel"))
            },
            Self::LevinDust => {
                ItemDefinitionIdOwned::Simple(String::from("common.items.consumable.levin_dust"))
            },
        }
    }
}

// TODO: Later move over things like energy and combo into here
#[derive(Copy, Clone, Debug, PartialEq, Eq, Serialize, Deserialize, Default)]
pub struct AbilityRequirements {
    pub stance: Option<Stance>,
    pub item: Option<AbilityReqItem>,
}

impl AbilityRequirements {
    pub fn requirements_met(&self, stance: Option<&Stance>, inv: Option<&Inventory>) -> bool {
        let AbilityRequirements {
            stance: req_stance,
            item,
        } = self;
        let stance_met = req_stance
            .is_none_or(|req_stance| stance.is_some_and(|char_stance| req_stance == *char_stance));
        let item_met = item.is_none_or(|item| {
            inv.is_some_and(|inv| {
                inv.get_slot_of_item_by_def_id(&item.item_def_id())
                    .is_some()
            })
        });
        stance_met && item_met
    }
}

bitflags::bitflags! {
    #[derive(Copy, Clone, Debug, PartialEq, Eq, Default, Serialize, Deserialize)]
    // If more are ever needed, first check if any not used anymore, as some were only used in intermediary stages so may be free
    pub struct Capability: u8 {
        // The ability will parry all blockable attacks in the buildup portion
        const PARRIES             = 0b00000001;
        // Allows blocking to interrupt the ability at any point
        const BLOCK_INTERRUPT     = 0b00000010;
        // The ability will block melee attacks in the buildup portion
        const BLOCKS              = 0b00000100;
        // When in the ability, an entity only receives half as much poise damage
        const POISE_RESISTANT     = 0b00001000;
        // WHen in the ability, an entity only receives half as much knockback
        const KNOCKBACK_RESISTANT = 0b00010000;
        // The ability will parry melee attacks in the buildup portion
        const PARRIES_MELEE       = 0b00100000;
    }
}

#[derive(
    Copy, Clone, Debug, PartialEq, Eq, Serialize, Deserialize, Hash, PartialOrd, Ord, Default,
)]
pub enum Stance {
    #[default]
    None,
    Sword(SwordStance),
    Bow(BowStance),
}

impl Stance {
    pub fn pseudo_ability_id(&self) -> &str {
        match self {
            Stance::Sword(SwordStance::Heavy) => "veloren.core.pseudo_abilities.sword.heavy_stance",
            Stance::Sword(SwordStance::Agile) => "veloren.core.pseudo_abilities.sword.agile_stance",
            Stance::Sword(SwordStance::Defensive) => {
                "veloren.core.pseudo_abilities.sword.defensive_stance"
            },
            Stance::Sword(SwordStance::Crippling) => {
                "veloren.core.pseudo_abilities.sword.crippling_stance"
            },
            Stance::Sword(SwordStance::Cleaving) => {
                "veloren.core.pseudo_abilities.sword.cleaving_stance"
            },
            Stance::Bow(BowStance::Barrage) => "common.abilities.bow.barrage",
            Stance::Bow(BowStance::Scatterburst) => "common.abilities.bow.scatterburst",
            Stance::Bow(BowStance::IgniteArrow) => "common.abilities.bow.ignite_arrow",
            Stance::Bow(BowStance::DrenchArrow) => "common.abilities.bow.drench_arrow",
            Stance::Bow(BowStance::FreezeArrow) => "common.abilities.bow.freeze_arrow",
            Stance::Bow(BowStance::JoltArrow) => "common.abilities.bow.jolt_arrow",
            Stance::Bow(BowStance::PiercingGale) => "common.abilities.bow.piercing_gale",
            Stance::Bow(BowStance::Hawkstrike) => "common.abilities.bow.hawkstrike",
            Stance::Bow(BowStance::Fusillade) => "common.abilities.bow.fusillade",
            Stance::Bow(BowStance::DeathVolley) => "common.abilities.bow.death_volley",
            Stance::None => "veloren.core.pseudo_abilities.no_stance",
        }
    }
}

#[derive(Copy, Clone, Debug, PartialEq, Eq, Serialize, Deserialize, Hash, PartialOrd, Ord)]
pub enum SwordStance {
    Crippling,
    Cleaving,
    Defensive,
    Heavy,
    Agile,
}

#[derive(Copy, Clone, Debug, PartialEq, Eq, Serialize, Deserialize, Hash, PartialOrd, Ord)]
pub enum BowStance {
    Barrage,
    Scatterburst,
    IgniteArrow,
    DrenchArrow,
    FreezeArrow,
    JoltArrow,
    PiercingGale,
    Hawkstrike,
    Fusillade,
    DeathVolley,
}

#[derive(Copy, Clone, Debug, PartialEq, Serialize, Deserialize)]
pub enum AbilityInitEvent {
    EnterStance(Stance),
    GainBuff {
        kind: buff::BuffKind,
        strength: f32,
        duration: Option<Secs>,
    },
}

impl Component for Stance {
    type Storage = DerefFlaggedStorage<Self, specs::VecStorage<Self>>;
}