Introduction

Aminus is a genshin impact damage and stat calculation library and framework.

let ayaka = StatFactory::get_character_base_stats("ayaka", 90).unwrap()
    .chain(Box::new(StatFactory::get_weapon_base_stats("mistsplitter", 90).unwrap()))
    .chain(Box::new(StatTable::of(&[ //snapshot buffs
        (Stat::ATKPercent, 0.88),
        (Stat::CritRate, 0.55),
        (Stat::CryoDMGBonus, 0.73),
        (Stat::NormalATKDMGBonus, 0.3),
        (Stat::ChargeATKDMGBonus, 0.3),
        (Stat::CryoResistanceReduction, 0.4),
    ])));
let rotation = Rotation::of(vec![
    default_cryo_na_formula!("n1", &ayaka, 0.84, 3, None),
    default_cryo_na_formula!("n2", &ayaka, 0.894, 2, None),
    default_cryo_na_formula!("ca", &ayaka, 3.039, 2, None),
    default_cryo_e_formula!("skill", &ayaka, 4.07, 2, None),
    default_cryo_q_formula!("burstcuts", &ayaka, 1.91, 19, None),
    default_cryo_q_formula!("burstexplosion", &ayaka, 2.86, 1, None),
]);
let ayaka = optimizers::optimal_kqmc_5_artifacts_stats(&StatTable::unbox(ayaka), &rotation, 1.40);
let dps = rotation.evaluate(&ayaka)/21.;

Why use Aminus

Aminus is a programmatic alternative to using spread-sheets for genshin impact metagaming and theorycrafting use cases.

You can use Aminus for any use-case where you want to model stats or calculate damage. Such as for doing teamdps calculations, gearing/upgrade (eg: weapon, artifact, constelation, talents) comparison, estimating energy-recharge requirements ect.

Front End

Aminus provides a set of primatives and abstractions for damage-stat calculation.

Primatives

Attribute:
enum that represents a stat type.

eg: FlatATK, ATK%, Crit-Rate, Dmg%

StatValue:
a pair between an attribute and a given value

eg: (CritRate, 60%)

some entity (character, weapon artifact) may have crit rate as a stat attribute but a StatValue specifies how much of a attribute it has.

StatTable: a collection/data structure of multiple stat to value mappings.

eg: ((ATK%, 20%), (CritRate, 60%), (CritDMG, 120%))

this can be used to model any in-game "stat table", from the representation of a character's total stats to total amount of stats given from a weapon or artifact piece

Operation

a computation that takes StatTable(s) and computes it to resulting StatTable or number

ops can unary: (StatTable)->StatTable, turnary: (StatTable,StatTable)->StatTable

most common use for operations is to apply some formula to a stattable to compute damage. or to merge 2 stat tables without mutation

Rotation

specififes a sequence of actions (normal attack, skill, burst) a character performs to deal damage.

a rotation is just a collection of (StatTable)->number operations where the StatTable represents a character's total stats used for this action while then number is the damage output of the action.

Installation

1. Clone The Repository

git clone https://github.com/lambdv/aminus.git 

2. Navigate into the directory

cd aminus

3. Install Dependencies

cargo build