LCOV - code coverage report
Current view: top level - balance - metrics.go Coverage Total Hit
Test: coverage.lcov Lines: 83.7 % 49 41
Test Date: 2026-11-19 00:25:22 Functions: - 0 0

            Line data    Source code
       1              : package balance
       2              : 
       3              : import (
       4              :         "github.com/kijimaD/ruins/internal/consts"
       5              :         "github.com/kijimaD/ruins/internal/raw"
       6              :         "github.com/kijimaD/ruins/internal/rawschema"
       7              :         "github.com/kijimaD/ruins/internal/world/query"
       8              : )
       9              : 
      10              : // ExpectedDamagePerAttack は1回の攻撃で与える期待ダメージを閉形式で返す。熟練度倍率のない静的下限で、
      11              : // スキルを織り込むときは ExpectedDamagePerAttackWithSkill を使う。
      12              : func ExpectedDamagePerAttack(attacker, defender CombatantStats, weapon WeaponStats) float64 {
      13            1 :         return ExpectedDamagePerAttackWithSkill(attacker, defender, weapon, consts.PercentBase)
      14            1 : }
      15              : 
      16              : // ExpectedDamagePerAttackWithSkill は熟練度倍率 skillMult を織り込んだ1回の期待ダメージを返す。属性耐性は無いものとする。
      17              : // 1回の攻撃のダメージ分布 attackDamagePMF の期待値で、skillMult が PercentBase なら静的下限に一致する。
      18              : // CalcHitRate は MinHitRate 以上へクランプし、命中は MinDamage 以上なので、期待ダメージは常に正になる。
      19              : func ExpectedDamagePerAttackWithSkill(attacker, defender CombatantStats, weapon WeaponStats, skillMult consts.Percent) float64 {
      20            1 :         sum := 0.0
      21            1 :         for _, dp := range attackDamagePMF(attacker, defender, weapon, skillMult) {
      22            1 :                 sum += float64(dp.dmg) * dp.p
      23            1 :         }
      24            1 :         return sum
      25              : }
      26              : 
      27              : // ExpectedTTK は attacker が defender を倒すのに要する撃破所要打数を返す。HP を1撃期待ダメージで割った連続近似で、
      28              : // オーバーキルは無視する。難易度の比較指標。期待ダメージ0なら倒せず 0 を返す。
      29              : func ExpectedTTK(attacker, defender CombatantStats, weapon WeaponStats) float64 {
      30            1 :         return ExpectedTTKWithSkill(attacker, defender, weapon, consts.PercentBase)
      31            1 : }
      32              : 
      33              : // ExpectedTTKWithSkill は熟練度倍率 skillMult を織り込んだ撃破所要打数を返す。スキルの手応えを
      34              : // 撃破速度で見るときに使う。
      35              : func ExpectedTTKWithSkill(attacker, defender CombatantStats, weapon WeaponStats, skillMult consts.Percent) float64 {
      36            1 :         dmg := ExpectedDamagePerAttackWithSkill(attacker, defender, weapon, skillMult)
      37            1 :         if dmg <= 0 {
      38            0 :                 return 0
      39            0 :         }
      40            1 :         return float64(defender.HP) / dmg
      41              : }
      42              : 
      43              : // DayMetric は経過日1日ぶんの序盤戦闘の難易度指標。危険度から敵プールを引き、
      44              : // プレイヤーと敵の期待撃破ターンを重み付き期待で評価する。
      45              : type DayMetric struct {
      46              :         Day        int     // 経過日数
      47              :         Danger     int     // その日の危険度
      48              :         PlayerTTK  float64 // プレイヤーが敵を倒す期待ターン。小さいほど有利
      49              :         EnemyTTK   float64 // 敵がプレイヤーを倒す期待ターン。大きいほど安全
      50              :         PowerRatio float64 // 戦力比 EnemyTTK / PlayerTTK。1超で有利、1近傍で拮抗、1未満で劣勢
      51              : }
      52              : 
      53              : // DifficultyCurve は経過日 1..days の序盤戦闘難易度を返す。dangerLevel(day) から敵テーブルの該当帯を重みで期待し、
      54              : // 期待撃破ターンと比を評価する。静的下限で見る。スキル込みは DifficultyCurveWithSkill。乱数なし。
      55              : func DifficultyCurve(master rawschema.Raws, player CombatantStats, playerWeapon WeaponStats, enemyTableName string, days int) ([]DayMetric, error) {
      56            1 :         return DifficultyCurveWithSkill(master, player, playerWeapon, enemyTableName, days, consts.PercentBase)
      57            1 : }
      58              : 
      59              : // DifficultyCurveWithSkill は熟練度倍率 skillMult を織り込んだ難易度カーブを返す。倍率はプレイヤー側だけに効き、
      60              : // スキル成長ぶんを実ゲームと同じ base 全体への切り捨てで反映する。
      61              : func DifficultyCurveWithSkill(master rawschema.Raws, player CombatantStats, playerWeapon WeaponStats, enemyTableName string, days int, skillMult consts.Percent) ([]DayMetric, error) {
      62            1 :         table, err := raw.GetEnemyTable(master, enemyTableName)
      63            1 :         if err != nil {
      64            0 :                 return nil, err
      65            0 :         }
      66              : 
      67            1 :         out := make([]DayMetric, 0, days)
      68            1 :         for day := 1; day <= days; day++ {
      69            1 :                 danger := int(query.DangerLevelForDay(day))
      70            1 : 
      71            1 :                 var wSum, playerTTKSum, enemyTTKSum float64
      72            1 :                 for _, entry := range raw.EnemyEntriesAt(table, danger) {
      73            1 :                         enemy, err := LoadCombatantFromMember(master, entry.Id)
      74            1 :                         if err != nil {
      75            0 :                                 return nil, err
      76            0 :                         }
      77              :                         // LoadEnemyWeapon は武器を持たない敵を内部で素手へフォールバックする。それでもエラーなら
      78              :                         // 本物のデータ異常なので握り潰さず伝播する。LoadCombatantFromMember と扱いを揃える。
      79            1 :                         enemyWeapon, err := LoadEnemyWeapon(master, entry.Id)
      80            1 :                         if err != nil {
      81            0 :                                 return nil, err
      82            0 :                         }
      83            1 :                         w := entry.Weight
      84            1 :                         wSum += w
      85            1 :                         playerTTKSum += w * ExpectedTTKWithSkill(player, enemy, playerWeapon, skillMult)
      86            1 :                         enemyTTKSum += w * ExpectedTTK(enemy, player, enemyWeapon)
      87              :                 }
      88            1 :                 if wSum == 0 {
      89              :                         // この危険度に敵がいない帯。カーブに穴を残さないよう空の指標を置く
      90            1 :                         out = append(out, DayMetric{Day: day, Danger: danger})
      91            1 :                         continue
      92              :                 }
      93              : 
      94            1 :                 playerTTK := playerTTKSum / wSum
      95            1 :                 enemyTTK := enemyTTKSum / wSum
      96            1 :                 powerRatio := 0.0
      97            1 :                 if playerTTK > 0 {
      98            1 :                         powerRatio = enemyTTK / playerTTK
      99            1 :                 }
     100            1 :                 out = append(out, DayMetric{Day: day, Danger: danger, PlayerTTK: playerTTK, EnemyTTK: enemyTTK, PowerRatio: powerRatio})
     101              :         }
     102            1 :         return out, nil
     103              : }
        

Generated by: LCOV version 2.0-1