Struct ArtifactsSettings

pub struct ArtifactsSettings {
    pub unlock_chapter: i64,
    pub starter_artifact_id: ArtifactTemplateId,
    pub max_artifact_level: i64,
    pub upgrade_ladder: Vec<ArtifactUpgradeStep>,
    pub socket_unlocks: Vec<ArtifactSocketUnlock>,
    pub max_stone_level: i64,
    pub stone_upgrade_ladder: Vec<ArtifactUpgradeStep>,
    pub halfway_bell_threshold_share: f64,
    pub thin_mirror_share: f64,
    pub stone_drop: ArtifactStoneDropSettings,
}

All artifact tunables.

Fields

unlock_chapter: i64

Chapter at which the artifact navigation vertical becomes visible.

UI only — it gates NOTHING about ownership. Since the acquisition pass there is no per-template chapter gate at all: the starter is granted at character creation, and every other artifact is a bundle reward (today, the top-1 weekly rating bundles).

starter_artifact_id: ArtifactTemplateId

The guaranteed freebie. It exists so the stone system does not depend on a rare drop, so it must always resolve to a real catalog entry — GameConfig::validate_artifacts checks that.

max_artifact_level: i64

upgrade_ladder: Vec<ArtifactUpgradeStep>

socket_unlocks: Vec<ArtifactSocketUnlock>

max_stone_level: i64

stone_upgrade_ladder: Vec<ArtifactUpgradeStep>

halfway_bell_threshold_share: f64

ART-03 Halfway Bell’s only number, and deliberately a share rather than an absolute threshold: FlipSettings::progress_threshold is a balance knob that moves (the stones vertical rescales it), and a hard number here would silently stop meaning “halfway” the moment it did.

thin_mirror_share: f64

ART-02 Thin Mirror’s only number: the share of Law Power a hidden law woken by the World Law applies its effect at.

stone_drop: ArtifactStoneDropSettings

Implementations

impl ArtifactsSettings

pub fn is_socket_unlocked( &self, socket: ArtifactSocketSlot, chapter_level: i64, ) -> bool

Whether socket is open at chapter_level. An unscheduled socket never opens; GameConfig::validate_artifacts requires all six to be scheduled, so this is a safety net rather than a reachable state.

pub fn flip_threshold_share(&self, law: Option<ArtifactWorldLaw>) -> f64

The share of the configured flip threshold law moves the bar to.

1.0 for every law but ART-03, so the caller never has to know which law is which — and a nonsense configured share reads as “no change” rather than as an instant or unreachable flip.

pub fn thin_mirror_share(&self, law: Option<ArtifactWorldLaw>) -> f64

The share of Law Power hidden laws run at under ART-02 Thin Mirror, or 0.0 for every other worn artifact (and for nothing worn).

A nonsense configured share reads as “no wake” rather than as a free full-strength second build — the conservative direction, since this rule switches on half the build.

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

Raw copies needed to take an artifact to target_level. None means the ladder has no such rung — at the cap, or a config gap that validation rules out at load time.

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

Same, for an artifact stone.

pub fn earliest_unlock_of(&self, column: ArtifactSocketColumn) -> Option<i64>

The unlock chapter of the first socket of column, used by validation and by tests to state the “left column first” rule without repeating the slot list.

Trait Implementations

impl Clone for ArtifactsSettings

fn clone(&self) -> ArtifactsSettings

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ArtifactsSettings

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ArtifactsSettings

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<ArtifactsSettings> for JsValue

where ArtifactsSettings: Serialize,

fn from(value: ArtifactsSettings) -> Self

Converts to this type from the input type.

impl FromWasmAbi for ArtifactsSettings

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 ArtifactsSettings

where ArtifactsSettings: 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 ArtifactsSettings

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 ArtifactsSettings

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 ArtifactsSettings

where ArtifactsSettings: 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 ArtifactsSettings

where Self: DeserializeOwned,

type Abi = <JsType as RefFromWasmAbi>::Abi

The Wasm ABI type references to Self are recovered from.

type Anchor = SelfOwner<ArtifactsSettings>

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 ArtifactsSettings

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 ArtifactsSettings

const DECL: &'static str = "/**\n * All artifact tunables.\n */\nexport interface ArtifactsSettings {\n /**\n * Chapter at which the artifact navigation vertical becomes visible.\n *\n * UI only \u{2014} it gates NOTHING about ownership. Since the acquisition pass\n * there is no per-template chapter gate at all: the starter is granted at\n * character creation, and every other artifact is a bundle reward (today,\n * the top-1 weekly rating bundles).\n */\n unlock_chapter: number;\n /**\n * The guaranteed freebie. It exists so the stone system does not depend on\n * a rare drop, so it must always resolve to a real catalog entry \u{2014}\n * `GameConfig::validate_artifacts` checks that.\n */\n starter_artifact_id: ArtifactTemplateId;\n max_artifact_level: number;\n upgrade_ladder: ArtifactUpgradeStep[];\n socket_unlocks: ArtifactSocketUnlock[];\n max_stone_level: number;\n stone_upgrade_ladder: ArtifactUpgradeStep[];\n /**\n * `ART-03 Halfway Bell`\\\'s only number, and deliberately a **share** rather\n * than an absolute threshold: `FlipSettings::progress_threshold` is a\n * balance knob that moves (the stones vertical rescales it), and a hard\n * number here would silently stop meaning \\\"halfway\\\" the moment it did.\n */\n halfway_bell_threshold_share: number;\n /**\n * `ART-02 Thin Mirror`\\\'s only number: the share of Law Power a hidden law\n * woken by the World Law applies its effect at.\n */\n thin_mirror_share: number;\n stone_drop: ArtifactStoneDropSettings;\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 ArtifactsSettings

where Self: DeserializeOwned,

type Abi = <JsType as VectorFromWasmAbi>::Abi

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

impl VectorIntoWasmAbi for ArtifactsSettings

where ArtifactsSettings: Serialize,

type Abi = <JsType as VectorIntoWasmAbi>::Abi

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

impl WasmDescribe for ArtifactsSettings

fn describe()

impl WasmDescribeVector for ArtifactsSettings

fn describe_vector()