configs/

game_settings.rs

use essences::{
    currency::CurrencyId, fighting::FightTemplateId, items::AttributeId, offers::ShopTab,
};
use schema_loader::{
    attribute_link_id_array_schema, attribute_link_id_schema, class_id_schema,
    currency_link_id_array_schema, currency_link_id_schema, fight_template_link_id_schema,
    vassal_task_id_schema,
};
use schemars::JsonSchema;

use serde::{Deserialize, Serialize};
use tsify_next::Tsify;

use crate::validated_types::{PositiveI64, WeightMultiplier};

/// One band of the Mastery Shard schedule (BAL-035): every campaign-boss FIRST
/// clear up to `up_to_clear` pays `shards`.
///
/// Bands rather than a formula because the schedule is authored against exact
/// cumulative totals — `100` Shards by the tenth clear, `4,000` by the
/// hundredth, `16,000` by state ch300 — and those totals are what the Mastery
/// price ladder was priced against.
#[derive(Clone, Copy, Debug, Deserialize, Serialize, JsonSchema, Tsify)]
pub struct MasteryShardBand {
    #[schemars(
        title = "По какое первое прохождение действует полоса",
        description = "Включительно. Последняя полоса действует и дальше неё."
    )]
    pub up_to_clear: i64,

    #[schemars(title = "Осколков за одно первое прохождение в этой полосе")]
    pub shards: i64,
}

/// Mastery income (BAL-035): what a campaign-boss first clear pays toward the
/// shared Class Level.
#[derive(Clone, Debug, Deserialize, Serialize, JsonSchema, Tsify)]
pub struct MasterySettings {
    #[schemars(
        title = "Валюта осколков мастерства",
        schema_with = "currency_link_id_schema"
    )]
    pub shard_currency_id: CurrencyId,

    #[schemars(
        title = "Валюта кристаллов мастерства",
        schema_with = "currency_link_id_schema"
    )]
    pub crystal_currency_id: CurrencyId,

    #[schemars(
        title = "Полосы выдачи осколков",
        description = "По полосе на каждые десять первых прохождений; последняя действует и за своим краем."
    )]
    pub shard_bands: Vec<MasteryShardBand>,

    #[schemars(
        title = "Шанс кристалла за первое прохождение",
        description = "Доля от 0 до 1. Повторные победы кристалл не роллят."
    )]
    pub crystal_chance: f64,

    #[schemars(
        title = "Гарантия кристалла после N неудач подряд",
        description = "На этом по счёту неудачном ролле кристалл выдаётся гарантированно. 0 — гарантии нет."
    )]
    pub crystal_pity_clears: i64,
}

impl MasterySettings {
    /// Shards paid by the `clear`-th campaign-boss FIRST clear (1-based). The
    /// last band runs on past its own edge, so a player deeper than the
    /// authored schedule keeps earning at its final rate instead of dropping to
    /// nothing.
    pub fn shards_for_clear(&self, clear: i64) -> i64 {
        if clear <= 0 {
            return 0;
        }
        let mut bands: Vec<&MasteryShardBand> = self.shard_bands.iter().collect();
        bands.sort_by_key(|band| band.up_to_clear);
        bands
            .iter()
            .find(|band| clear <= band.up_to_clear)
            .or(bands.last())
            .map_or(0, |band| band.shards.max(0))
    }
}

/// The three scalars the approximate `P_ui` estimator needs beyond the
/// per-template coefficients (BAL-030). Everything else it reads is authored on
/// the templates themselves, so a new law or stone brings its own Power row.
#[derive(Clone, Copy, Debug, Deserialize, Serialize, JsonSchema, Tsify)]
pub struct PowerEstimatorSettings {
    #[schemars(
        title = "Эталонная частота триггера, раз в секунду",
        description = "Частота, при которой авторские множители эффектов взяты как есть. Реальный триггер масштабирует их отношением своей частоты к этой."
    )]
    pub reference_trigger_proc_rate: f64,

    #[schemars(
        title = "Множитель Power пакета из одного триггера",
        description = "Минимальный положительный вклад экипировки, у которой есть только триггер: шкала сама по себе ещё не даёт измеримых DPS/EHP, но прирост Power обязан быть виден."
    )]
    pub trigger_only_q: f64,

    #[schemars(
        title = "Ожидаемая заполненность моста",
        description = "Доля ёмкости моста, доставляемая за фазу, пока нет trace. Входит в множитель Power моста."
    )]
    pub bridge_expected_fill: f64,
}

#[derive(Clone, Debug, Deserialize, Serialize, JsonSchema, Tsify)]
pub struct GameSettings {
    #[schemars(title = "Настройки оценки Power")]
    pub power_estimator: PowerEstimatorSettings,

    #[schemars(title = "Мастерство класса: доход за первые прохождения боссов")]
    pub mastery: MasterySettings,

    #[schemars(
        title = "Обязательные атрибуты предметов",
        description = "Атрибуты, которые обязательно будут на предметах их сундука",
        schema_with = "attribute_link_id_array_schema"
    )]
    pub required_attributes: Vec<AttributeId>,

    #[schemars(
        title = "Id вассальной таски брыкания",
        schema_with = "vassal_task_id_schema"
    )]
    pub resist_task_id: uuid::Uuid,

    #[schemars(title = "Id аттрибута хп", schema_with = "attribute_link_id_schema")]
    pub hp_attribute_id: uuid::Uuid,

    #[schemars(
        title = "Id тайм скип билетика",
        schema_with = "currency_link_id_schema"
    )]
    pub time_skip_ticket_currency_id: CurrencyId,

    #[schemars(title = "Сколько секунд апгрейда сундука скипает тайм скип билетик")]
    pub chest_upgrade_skip_ticket_skips_sec: u64,

    #[schemars(
        title = "Id валюты для скипа прокачки сундука",
        schema_with = "currency_link_id_schema"
    )]
    pub chest_upgrade_skip_currency_id: CurrencyId,

    #[schemars(title = "Сколько секунд апгрейда сундука скипает одна единица валюты")]
    pub chest_upgrade_skip_currency_skips_sec: u64,

    // #[schemars(title = "Ключ значения для повторяющихся квестов в custom_values")]
    // pub loop_tasks_custom_values_key: String,

    // #[schemars(title = "Дефолтное значение для повторяющихся квестов в custom_values")]
    // pub loop_tasks_custom_values_default_value: i64,
    #[schemars(title = "Настройки гачи способностей")]
    pub ability_gacha: AbilityGachaSettings,

    #[schemars(
        title = "Id валюты для открытия сундука предметов",
        schema_with = "currency_link_id_schema"
    )]
    pub item_case_currency_id: CurrencyId,

    #[schemars(
        title = "Id изначального класса персонажа",
        schema_with = "class_id_schema"
    )]
    pub initial_class_id: uuid::Uuid,

    #[schemars(title = "Длительность хранения сообщения в часах")]
    pub chat_message_ttl_secs: u64,

    #[schemars(
        title = "Базовое значение атрибута speed",
        description = "Значение атрибута speed на entity, при котором кулдауны идут 1:1 (\"100%\"). При speed выше базового кулдауны идут быстрее, при меньшем — медленнее."
    )]
    pub baseline_speed: u64,

    #[schemars(
        title = "Id валют для отрисовки на главном экране",
        schema_with = "currency_link_id_array_schema"
    )]
    pub currency_ids_to_show: Vec<CurrencyId>,

    #[schemars(title = "Настройки гачи петов")]
    pub pet_gacha: PetGachaSettings,

    #[schemars(title = "Длительность паузы между открытиями сундука")]
    pub auto_chest_pause_duration_ticks: u64,

    /// Клиент показывает шары пачки по одному, поэтому пауза перед следующим
    /// автооткрытием растёт с размером выданной пачки:
    /// `auto_chest_pause_duration_ticks + n × auto_chest_per_ball_pause_ticks`.
    /// Без этой добавки сервер обгоняет анимацию и очередь шаров на клиенте
    /// растёт без ограничения.
    #[schemars(title = "Добавка к паузе автосундука за каждый шар выданной пачки")]
    pub auto_chest_per_ball_pause_ticks: u64,

    #[schemars(
        title = "Id битвы для арены",
        schema_with = "fight_template_link_id_schema"
    )]
    pub arena_fight_template_id: FightTemplateId,

    #[schemars(
        title = "Id битвы для вассального pvp",
        schema_with = "fight_template_link_id_schema"
    )]
    pub vassal_fight_id: FightTemplateId,

    #[schemars(title = "Как часто срабатывает эвент fight_progress_tick")]
    pub fight_progress_tick: u64,

    #[schemars(title = "Частота обновления мощи персонажа в базе")]
    pub db_power_update_frequency: u64,

    #[schemars(title = "Юзернейм подставляющийся игроку удалившему аккаунт")]
    pub deleted_user_username: String,

    #[schemars(
        title = "Id валюты бриллиантов",
        schema_with = "currency_link_id_schema"
    )]
    pub diamond_currency_id: CurrencyId,

    #[schemars(title = "Минимальный интервал между сменами username (секунды)")]
    pub username_change_cooldown_sec: u64,

    #[schemars(title = "Минимальная длина username")]
    pub username_min_length: usize,

    #[schemars(title = "Максимальная длина username")]
    pub username_max_length: usize,

    #[schemars(title = "До какого числа обновлять кол-во ключей у пользователя")]
    pub dungeons_keys_reset_amount: i64,

    #[schemars(title = "Настройки ежедневного ресета валют")]
    pub daily_currency_resets: Vec<DailyCurrencyReset>,

    #[schemars(title = "Вкладка магазина, открываемая по умолчанию")]
    pub default_shop_tab: ShopTab,

    #[schemars(
        title = "Глава, на которой показывается окно \"оцените нас\"",
        description = "Если задано, сервер эмитит событие ShowRateUs, когда игрок впервые достигает этой главы. None отключает автоматический показ."
    )]
    pub rate_us_chapter: Option<i64>,

    #[serde(default)]
    #[schemars(
        title = "Рост награды босса за главу",
        description = "Множитель валюты, выпадающей с босса главы, растёт как boss_reward_chapter_growth^(глава) — глубже глава, больше падает с босса (\"пушить выгодно\"). Масштабируются только боссы (is_boss) в кампанийных боях; треш и не-кампания не затронуты. None или <=1.0 отключает (множитель 1.0)."
    )]
    pub boss_reward_chapter_growth: Option<f64>,

    #[serde(default)]
    #[schemars(
        title = "Потолок множителя награды босса",
        description = "Верхняя граница множителя из boss_reward_chapter_growth (защищает экономику/overflow на глубоких главах). None = без доп. потолка (но множитель всё равно ограничен здравым пределом в коде)."
    )]
    pub boss_reward_max_multiplier: Option<f64>,

    #[serde(default)]
    #[schemars(
        title = "Экспонента цены продажи предмета",
        description = "Показатель степени в формуле цены продажи floor(eff^exp · coef). Меньше 1 — доход от продаж растёт сублинейно (голд-фаусет уплощается, чтобы геометрический сток апгрейда сундука связывал прогресс). None = зашитая константа (0.45). Env OVERLORD_BAL_SELL_EXP (сим-свип) перекрывает это значение."
    )]
    pub sell_price_exp: Option<f64>,

    #[serde(default)]
    #[schemars(
        title = "Коэффициент цены продажи предмета",
        description = "Коэффициент в формуле цены продажи floor(eff^exp · coef); якорит цену на низких eff (ранняя игра). None = зашитая константа (87). Env OVERLORD_BAL_SELL_COEF (сим-свип) перекрывает это значение."
    )]
    pub sell_price_coef: Option<f64>,

    /// Name of the native `default_loop_task` fn used to recover the active loop
    /// task when `active_loop_task_id` is set but the loop-task list rebuilt
    /// Production defaults to `"default_loop_task_const"`; the test fixture
    /// overrides it to `"test_default_loop_task"` (which returns the fixture's
    /// own loop-task id `305300e2`). Same postcard-symmetry / schema-skip
    /// reasoning as `item_price_script`.
    #[serde(default = "default_default_loop_task_behavior")]
    #[schemars(skip)]
    pub default_loop_task_behavior: String,
}

/// Default selector for [`GameSettings::default_loop_task_behavior`].
fn default_default_loop_task_behavior() -> String {
    "default_loop_task_const".to_string()
}

#[derive(Clone, Debug, Deserialize, Serialize, JsonSchema, Tsify)]
pub struct AbilityGachaSettings {
    #[schemars(
        title = "Id валюты для открытия гачи скиллов",
        schema_with = "currency_link_id_schema"
    )]
    pub currency_id: CurrencyId,

    #[schemars(title = "Цена 1 крутки в бриллиантах")]
    pub roll_price_in_diamonds: PositiveI64,

    /// Стоимость маленькой крутки в gacha-билетах.
    /// Она же — количество дропов и очки прогресса (тикеты = поинты = дропы).
    #[schemars(title = "Стоимость маленькой крутки")]
    pub small_roll_cost: PositiveI64,

    /// Стоимость большой крутки в gacha-билетах (она же — очки прогресса).
    #[schemars(title = "Стоимость большой крутки")]
    pub big_roll_cost: PositiveI64,

    /// Бонусные дропы в большой крутке сверх стоимости. Итого дропов = cost + bonus.
    #[schemars(title = "Бонусные дропы в большой крутке")]
    pub big_roll_bonus_drops: u8,

    /// Максимальное число слотов вишлиста.
    #[schemars(title = "Количество слотов вишлиста")]
    pub wishlist_slots: u8,

    /// Множитель веса для способностей из вишлиста при розыгрыше.
    /// Значение `2.0` означает, что вишлист-абилка выпадает вдвое чаще обычной.
    #[schemars(title = "Множитель веса вишлиста")]
    pub wishlist_weight_multiplier: WeightMultiplier,

    /// Валюта для прокачки уровней слотов способностей (Stardust).
    #[schemars(
        title = "Валюта прокачки слотов способностей",
        schema_with = "currency_link_id_schema"
    )]
    pub slot_upgrade_currency_id: CurrencyId,

    /// Максимальный уровень слота способности.
    #[schemars(title = "Максимальный уровень слота способности")]
    pub slot_max_level: PositiveI64,

    /// Стоимость повышения слота до каждого уровня.
    /// Индекс `0` соответствует прокачке на уровень `1`.
    #[schemars(title = "Стоимости уровней слотов способностей")]
    pub slot_level_costs: Vec<PositiveI64>,

    /// Бонус к `AbilityLevel` по уровню слота.
    /// Индекс = уровень слота, значение = дополнительный уровень способности.
    #[schemars(title = "Бонус уровня способности от уровня слота")]
    pub slot_level_bonus_levels: Vec<i64>,
}

#[derive(Clone, Debug, Deserialize, Serialize, JsonSchema, Tsify)]
pub struct PetGachaSettings {
    #[schemars(
        title = "Id валюты для открытия гачи петов",
        schema_with = "currency_link_id_schema"
    )]
    pub currency_id: CurrencyId,

    #[schemars(title = "Цена 1 крутки в бриллиантах")]
    pub roll_price_in_diamonds: PositiveI64,

    /// Стоимость маленькой крутки в gacha-билетах.
    /// Она же — количество дропов и очки прогресса (тикеты = поинты = дропы).
    #[schemars(title = "Стоимость маленькой крутки")]
    pub small_roll_cost: PositiveI64,

    /// Стоимость большой крутки в gacha-билетах (она же — очки прогресса).
    #[schemars(title = "Стоимость большой крутки")]
    pub big_roll_cost: PositiveI64,

    /// Бонусные дропы в большой крутке сверх стоимости. Итого дропов = cost + bonus.
    #[schemars(title = "Бонусные дропы в большой крутке")]
    pub big_roll_bonus_drops: u8,

    /// Максимальное число слотов вишлиста.
    #[schemars(title = "Количество слотов вишлиста")]
    pub wishlist_slots: u8,

    /// Множитель веса для петов из вишлиста при розыгрыше.
    /// Значение `2.0` означает, что вишлист-пет выпадает вдвое чаще обычного.
    #[schemars(title = "Множитель веса вишлиста")]
    pub wishlist_weight_multiplier: WeightMultiplier,

    /// BAL-032: after this many consecutive rolls that produced no NEW pet, the
    /// next roll is forced onto a template the player does not own yet.
    ///
    /// A pure safety net on top of the ordinary weights — the wishlist `×2`
    /// multiplier is unchanged, and the counter resets on any first copy however
    /// it was obtained. `0` disables it.
    #[schemars(
        title = "Пити первой копии пета, роллов",
        description = "После стольких роллов подряд без новой копии следующий ролл гарантирует ещё не полученного пета. 0 — выключено."
    )]
    pub first_copy_pity_pulls: i64,
}

#[derive(Clone, Debug, Deserialize, Serialize, JsonSchema, Tsify)]
pub struct DailyCurrencyReset {
    #[schemars(
        title = "ID валюты для ресета",
        schema_with = "currency_link_id_schema"
    )]
    pub currency_id: CurrencyId,

    #[schemars(title = "Значение, до которого ресетить валюту")]
    pub reset_amount: i64,
}

impl GameSettings {
    pub fn get_daily_currency_reset_amount(&self, currency_id: CurrencyId) -> anyhow::Result<i64> {
        self.daily_currency_resets
            .iter()
            .find(|reset| reset.currency_id == currency_id)
            .map(|reset| reset.reset_amount)
            .ok_or_else(|| {
                anyhow::anyhow!(
                    "Currency {} not found in daily_currency_resets",
                    currency_id
                )
            })
    }
}