Struct StonesSettings

pub struct StonesSettings {
    pub global_trigger_cooldown_ticks: u64,
    pub tier_coefficients: Vec<StoneTierCoefficient>,
    pub rarity_weights: Vec<StoneRarityWeight>,
    pub socket_unlocks: Vec<StoneSocketUnlock>,
    pub upgrade_ladder: Vec<StoneUpgradeStep>,
    pub max_stone_level: i64,
    pub kill_drop: StoneKillDropSettings,
    pub milestone_grants: Vec<StoneMilestoneGrant>,
}

All Trigger/Effect Stone tunables.

Fields

global_trigger_cooldown_ticks: u64

One trigger cooldown for the whole build, not per slot. A Core event checks all five socketed triggers at once, every matching one fires, then this cooldown runs; a condition that comes true while it runs is lost and the sequence counter behind it restarts.

It is the only rate limit the mechanic has — it bounds a five-Legendary build to 5 × 8 = 40 gauge per window.

tier_coefficients: Vec<StoneTierCoefficient>

rarity_weights: Vec<StoneRarityWeight>

BAL-012: the rarity step of the kill-drop roll. One row per [StoneTier], checked by GameConfig::validate_stones.

socket_unlocks: Vec<StoneSocketUnlock>

upgrade_ladder: Vec<StoneUpgradeStep>

Cost of every level above the first, in raw copies. One rung per level in 2..=max_stone_level, no gaps (GameConfig::validate_stones).

Triggers and effects read the same ladder but never share copies: a copy is a copy of one catalog entry, and the two catalogs share no ids.

max_stone_level: i64

kill_drop: StoneKillDropSettings

milestone_grants: Vec<StoneMilestoneGrant>

BAL-024/BAL-025: guaranteed one-time packages at the equipment item gates. Reaching chapter guarantees OWNERSHIP of every listed template — a missing one is granted as a single copy, an already owned one is left alone, so the check is idempotent and never inflates recurring drops.

Implementations

impl StonesSettings

pub fn is_socket_unlocked( &self, item_type: ItemType, socket: StoneSocketSlot, chapter_level: i64, ) -> bool

Whether socket on item_type is open at chapter_level. An unscheduled socket never opens — the config carries all 15 entries and GameConfig::validate enforces that, so this is a safety net, not a reachable state.

pub fn tier_coefficient( &self, trigger_tier: StoneTier, effect_tier: StoneTier, ) -> f64

Effect power multiplier for a (trigger, effect) tier pair. 1.0 when the pair is missing, which is also the shipped value of every cell.

pub fn upgrade_copies_required(&self, target_level: i64) -> Option<i64>

Raw copies needed to take a stone to target_level, not counting the stone itself.

None means the ladder has no rung for that level — either the stone is already at the cap or the config has a gap. GameConfig::validate_stones rules the gap out at load time, so a live None is the cap.

pub fn dropped_kind(&self, roll: f64) -> StoneKind

Which collection the drop roll roll (in [0, 1)) produces.

pub fn dropped_tier(&self, roll: f64) -> StoneTier

Which rarity the drop roll roll (in [0, 1)) produces.

roll is a fraction of the weight SUM, so the rows stay relative and a designer can retune one tier without rebalancing the rest to 100. Negative weights are floored at zero; an all-zero table degenerates to the first row rather than dropping nothing.

Trait Implementations

impl Clone for StonesSettings

fn clone(&self) -> StonesSettings

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StonesSettings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StonesSettings

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<StonesSettings> for JsValue

where StonesSettings: Serialize,

fn from(value: StonesSettings) -> Self

Converts to this type from the input type.

impl FromWasmAbi for StonesSettings

where Self: DeserializeOwned,

type Abi = <JsType as FromWasmAbi>::Abi

The Wasm ABI type that this converts from when coming back out from the ABI boundary.

unsafe fn from_abi(js: Self::Abi) -> Self

Recover a Self from Self::Abi.

impl IntoWasmAbi for StonesSettings

where StonesSettings: Serialize,

type Abi = <JsType as IntoWasmAbi>::Abi

The Wasm ABI type that this converts into when crossing the ABI boundary.

fn into_abi(self) -> Self::Abi

Convert self into Self::Abi so that it can be sent across the wasm ABI boundary.

impl JsonSchema for StonesSettings

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl OptionFromWasmAbi for StonesSettings

where Self: DeserializeOwned,

fn is_none(js: &Self::Abi) -> bool

Tests whether the argument is a “none” instance. If so it will be deserialized as None, and otherwise it will be passed to FromWasmAbi.

impl OptionIntoWasmAbi for StonesSettings

where StonesSettings: Serialize,

fn none() -> Self::Abi

Returns an ABI instance indicating “none”, which JS will interpret as the None branch of this option.

impl RefFromWasmAbi for StonesSettings

where Self: DeserializeOwned,

type Abi = <JsType as RefFromWasmAbi>::Abi

The Wasm ABI type references to Self are recovered from.

type Anchor = SelfOwner<StonesSettings>

The type that holds the reference to Self for the duration of the invocation of the function that has an &Self parameter. This is required to ensure that the lifetimes don’t persist beyond one function call, and so that they remain anonymous.

unsafe fn ref_from_abi(js: Self::Abi) -> Self::Anchor

Recover a Self::Anchor from Self::Abi.

impl Serialize for StonesSettings

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Tsify for StonesSettings

const DECL: &'static str = "/**\n * All Trigger/Effect Stone tunables.\n */\nexport interface StonesSettings {\n /**\n * One trigger cooldown for the whole build, not per slot. A Core event\n * checks all five socketed triggers at once, every matching one fires,\n * then this cooldown runs; a condition that comes true while it runs is\n * lost and the sequence counter behind it restarts.\n *\n * It is the only rate limit the mechanic has \u{2014} it bounds a five-Legendary\n * build to `5 \u{d7} 8 = 40` gauge per window.\n */\n global_trigger_cooldown_ticks: number;\n tier_coefficients: StoneTierCoefficient[];\n /**\n * BAL-012: the rarity step of the kill-drop roll. One row per\n * [`StoneTier`], checked by `GameConfig::validate_stones`.\n */\n rarity_weights: StoneRarityWeight[];\n socket_unlocks: StoneSocketUnlock[];\n /**\n * Cost of every level above the first, in raw copies. One rung per level\n * in `2..=max_stone_level`, no gaps (`GameConfig::validate_stones`).\n *\n * Triggers and effects read the same ladder but never share copies: a\n * copy is a copy of one catalog entry, and the two catalogs share no ids.\n */\n upgrade_ladder: StoneUpgradeStep[];\n max_stone_level: number;\n kill_drop: StoneKillDropSettings;\n /**\n * BAL-024/BAL-025: guaranteed one-time packages at the equipment item\n * gates. Reaching `chapter` guarantees OWNERSHIP of every listed\n * template \u{2014} a missing one is granted as a single copy, an already owned\n * one is left alone, so the check is idempotent and never inflates\n * recurring drops.\n */\n milestone_grants: StoneMilestoneGrant[];\n}"

const SERIALIZATION_CONFIG: SerializationConfig

type JsType = JsType

fn into_js(&self) -> Result<Self::JsType, Error>

where Self: Serialize,

fn from_js<T>(js: T) -> Result<Self, Error>

where T: Into<JsValue>, Self: DeserializeOwned,

impl VectorFromWasmAbi for StonesSettings

where Self: DeserializeOwned,

type Abi = <JsType as VectorFromWasmAbi>::Abi

unsafe fn vector_from_abi(js: Self::Abi) -> Box<[Self]>

impl VectorIntoWasmAbi for StonesSettings

where StonesSettings: Serialize,

type Abi = <JsType as VectorIntoWasmAbi>::Abi

fn vector_into_abi(vector: Box<[Self]>) -> Self::Abi

impl WasmDescribe for StonesSettings

fn describe()

impl WasmDescribeVector for StonesSettings

fn describe_vector()