afnm-types 0.6.29 → 0.6.32

package/dist/GameScreen.d.ts

@@ -1 +1 @@
-export type GameScreen = 'location' | 'recipe' | 'mission' | 'craftingHall' | 'manual' | 'cultivation' | 'map' | 'healer' | 'market' | 'favour' | 'herbField' | 'mine' | 'recipeLibrary' | 'requestBoard' | 'compendium' | 'library' | 'altar' | 'research' | 'reforge' | 'pillarGrid' | 'fallenStar' | 'trainingGround' | 'lifeScreen';
+export type GameScreen = 'location' | 'recipe' | 'mission' | 'craftingHall' | 'manual' | 'cultivation' | 'map' | 'healer' | 'market' | 'favour' | 'herbField' | 'mine' | 'recipeLibrary' | 'requestBoard' | 'compendium' | 'library' | 'altar' | 'research' | 'reforge' | 'pillarGrid' | 'fallenStar' | 'trainingGround' | 'tenThousandFlames' | 'lifeScreen';

package/dist/alternativeStart.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { Tutorial } from './tutorial';
 import { TriggeredEvent, GameEvent } from './event';
 import { ItemDesc } from './item';
@@ -19,16 +20,15 @@ export interface AlternativeStart {
     /**
      * Description shown in the selection UI explaining this start option
      */
-    description: string;
+    description: Translatable;
     /**
      * The root event that plays when starting the game.
      * This replaces the default newGameEvent.
      */
     rootEvent: GameEvent;
     /**
-     * The starting location name. This becomes the root for location discovery
-     * (used by discoverUnlockedLocations). All location searches will branch
-     * from this location.
+     * The starting location name. This location will be registered as a root
+     * for discovery (if not already) and the player will start here.
      */
     startLocation: string;
     /**

package/dist/auction.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { Item, ItemDesc } from './item';
 export interface Auction {
     characters: AuctionCharacterData[];
@@ -46,7 +47,7 @@ export interface AuctionCharacterData {
     speech?: Speech;
 }
 export interface Speech {
-    text: string;
+    text: Translatable;
     id: number;
     persistent: boolean;
 }
@@ -59,7 +60,7 @@ export interface AuctionAbility {
         name: string;
         amount: number;
     };
-    tooltip: string;
+    tooltip: Translatable;
     effects: AuctionAbilityEffect[];
 }
 export type AuctionAbilityEffect = DesireAbilityEffect | BuildResourceAbilityEffect | EliminateAbilityEffect;
@@ -82,7 +83,7 @@ export interface AuctionResource {
     name: string;
     icon: string;
     colour: string;
-    tooltip: string;
+    tooltip: Translatable;
     bidMult?: number;
     degeneration?: 'bid' | 'item';
 }

package/dist/background.d.ts

@@ -1,9 +1,10 @@
+import { Translatable } from './translatable';
 import { Destiny } from './destiny';
 import { Item } from './item';
 import { CombatStatistic, CraftingStatistic, PhysicalStatistic, Scaling, SocialStatistic } from './stat';
 export interface Background {
     name: string;
-    description: string;
+    description: Translatable;
     physicalStats?: Partial<Record<PhysicalStatistic, number>>;
     socialStats?: Partial<Record<SocialStatistic, number>>;
     rawStats?: Partial<Record<CombatStatistic | CraftingStatistic, Scaling>>;

package/dist/breakthrough.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { ReactNode } from 'react';
 import { CombatEntity, CraftingEntity, PlayerEntity, StoredStance, StoredStyle } from './entity';
 import { ItemDesc } from './item';
@@ -12,6 +13,34 @@ export interface Position {
 export interface PositionAndRotation extends Position {
     rotation: number;
 }
+/** Tracks which of the 6 core essences have been placed in the gate */
+export interface EssenceGate {
+    breath: boolean;
+    pulse: boolean;
+    echo: boolean;
+    growth: boolean;
+    marrow: boolean;
+    scar: boolean;
+}
+/** A lifeform stored in the player's soul realm */
+export interface StoredLifeform {
+    id: string;
+    baseForm: string;
+    currentForm: string;
+    slottedEssences: string[];
+    stances: StoredStance[];
+    currentStyle?: StoredStyle;
+    storedStyles?: StoredStyle[];
+    evolutionPath: string[];
+}
+/** State for the Life Flourishing breakthrough system */
+export interface LifeFlourishingState {
+    essenceGate: EssenceGate;
+    storedLifeforms: StoredLifeform[];
+    manifestedLifeformId?: string;
+    fightsInstead?: boolean;
+    creatingNewLifeform?: boolean;
+}
 export interface BreakthroughState {
     mundane?: {
         pill?: string;
@@ -45,16 +74,7 @@ export interface BreakthroughState {
         }[];
         tilePool?: number;
     };
-    lifeFlourishing?: {
-        slottedEssences: string[];
-        selectedLifeform?: string;
-        fightsInstead?: boolean;
-        lifeformEntity?: {
-            stances: StoredStance[];
-            currentStyle?: StoredStyle;
-            storedStyles?: StoredStyle[];
-        };
-    };
+    lifeFlourishing?: LifeFlourishingState;
     previous: Partial<{
         [key in Realm]: BreakthroughBase;
     }>;
@@ -66,7 +86,7 @@ export interface BreakthroughState {
 }
 export interface BreakthroughBase {
     name: string;
-    description: string;
+    description: Translatable;
     physicalStats: Partial<{
         [key in PhysicalStatistic]: number;
     }>;

package/dist/buff.d.ts

@@ -1,6 +1,8 @@
+import { Translatable } from './translatable';
 import { TechniqueElement } from './element';
 import { CombatStatistic, Scaling } from './stat';
 import { DamageType } from './DamageType';
+import type { CombatEntity } from './entity';
 export type TechniqueCondition = ChanceTechniqueCondition | BuffTechniqueCondition | HpTechniqueCondition | ConditionTechniqueCondition;
 export type DamageModifier = MultiplyDamageModifier | ReduceDamageModifier | ExpressionDamageModifier;
 interface MultiplyDamageModifier {
@@ -42,23 +44,22 @@ export interface Buff {
     colour?: string;
     canStack: boolean;
     effectHint?: string;
-    tooltip?: string;
-    additionalTooltip?: string;
+    tooltip?: Translatable;
+    additionalTooltip?: Translatable;
     flag?: string;
     condition?: TechniqueCondition;
     removeOnConditionFailed?: boolean;
-    statsTooltip?: string;
+    statsTooltip?: Translatable;
     stats: Partial<{
         [key in CombatStatistic]: Scaling;
     }> | undefined;
     charisma?: number;
     masteryPoints?: number;
     speed?: number;
-    applicationStats?: Record<CombatStatistic, number>;
-    applicationVariables?: Record<string, number>;
-    appliedByOpponent?: boolean;
+    applicationEntity?: CombatEntity;
     allowMultipleInstances?: boolean;
     storedVariables?: Record<string, string>;
+    storedValues?: Record<string, number>;
     uniqueId?: string;
     internalState?: Record<string, number>;
     initialState?: Record<string, string>;
@@ -92,6 +93,27 @@ export interface Buff {
         damageModifier: DamageModifier;
         effects?: BuffEffect[];
     }[];
+    /** Amplifies outgoing damage/barrier/heal effects. Runs before the effect is applied. */
+    techniqueAmplifierEffects?: {
+        trigger?: TechniqueCondition;
+        amplifier: {
+            kind: 'multiply';
+            value: number;
+        };
+        effects?: BuffEffect[];
+        appliesTo: ('damage' | 'barrier' | 'heal')[];
+    }[];
+    /** Amplifies buff creation. Modifies stack count when matching buffs are created on self. */
+    buffAmplifierEffects?: {
+        trigger?: TechniqueCondition;
+        /** Matches buffs by name, buffType, or flag */
+        target: string;
+        modifier: {
+            kind: 'add' | 'multiply';
+            value: number;
+        };
+        effects?: BuffEffect[];
+    }[];
     priority?: number;
     afterTechnique?: boolean;
     combatImage?: BuffCombatImage;
@@ -173,7 +195,7 @@ export interface FormationCombatImage extends BaseCombatImage {
     scale?: number;
     showSingleInstance?: boolean;
 }
-export type BuffEffect = DamageEffect | DamageSelfEffect | HealEffect | BarrierEffect | CreateBuffSelfEffect | ConsumeBuffSelfEffect | CreateBuffTargetEffect | ConsumeBuffTargetEffect | NegateEffect | AddEffect | MultiplyEffect | MergeEffect | TriggerEffect | ModifyBuffGroupEffect | CleanseToxicityEffect | SetStateEffect;
+export type BuffEffect = DamageEffect | DamageSelfEffect | HealEffect | BarrierEffect | CreateBuffSelfEffect | ConsumeBuffSelfEffect | CreateBuffTargetEffect | ConsumeBuffTargetEffect | NegateEffect | AddEffect | MultiplyEffect | MergeEffect | TriggerEffect | ModifyBuffGroupEffect | CleanseToxicityEffect | SetStateEffect | ConvertSelfEffect;
 interface BaseBuff {
     condition?: TechniqueCondition;
     triggerKey?: string;
@@ -268,4 +290,10 @@ interface SetStateEffect extends BaseBuff {
     value: Scaling;
     mode?: 'set' | 'add';
 }
+interface ConvertSelfEffect extends BaseBuff {
+    kind: 'convertSelf';
+    source: Buff;
+    target: Buff;
+    amount: Scaling;
+}
 export {};

package/dist/calendar.d.ts

@@ -9,4 +9,6 @@ export interface CalendarEvent {
     location?: string;
     recurrenceYears: number;
     realm?: Realm;
+    /** If true, event can be re-entered multiple times during its active month */
+    reentrant?: boolean;
 }

package/dist/character.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { SvgIconTypeMap } from '@mui/material';
 import { OverridableComponent } from '@mui/material/OverridableComponent';
 import { Buff } from './buff';
@@ -189,7 +190,7 @@ export interface AidBreakthroughCharacterInteraction extends BaseCharacterIntera
 export interface CustomCharacterInteractionBlock {
     condition: string;
     name: string;
-    tooltip: string;
+    tooltip: Translatable;
     icon: OverridableComponent<SvgIconTypeMap<{}, 'svg'>>;
     interaction: CustomCharacterInteraction;
     cooldown?: number;
@@ -254,17 +255,17 @@ export interface CharacterRelationshipDefinition {
     requiredApproval: number;
     relationshipCategory: CharacterRelationship;
     name: string;
-    tooltip: string;
+    tooltip: Translatable;
     followCharacter?: FollowCharacterDefinition;
     dualCultivation?: DualCultivationDefinition;
     progressionEvent: {
         name: string;
-        tooltip: string;
+        tooltip: Translatable;
         event: EventStep[];
         locationOverride?: string;
         requirement?: {
             condition: string;
-            tooltip: string;
+            tooltip: Translatable;
         };
     };
 }

package/dist/crafting.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { ReactNode } from 'react';
 import { SvgIconTypeMap } from '@mui/material';
 import { OverridableComponent } from '@mui/material/OverridableComponent';
@@ -18,14 +19,14 @@ export interface RecipeConditionEffect {
     name: string;
     colour: string;
     conditionEffects: Record<CraftingCondition, {
-        tooltip: string;
+        tooltip: Translatable;
         effects: CraftingConditionEffect[];
     }>;
 }
 export type RecipeHarmonyType = 'forge' | 'alchemical' | 'inscription' | 'resonance';
 export interface HarmonyTypeConfig {
     name: string;
-    description: string;
+    description: Translatable;
     processEffect: (harmonyData: HarmonyData, technique: CraftingTechnique, progressState: ProgressState, entity: CraftingEntity, state: CraftingState) => void;
     initEffect: (harmonyData: HarmonyData, entity: CraftingEntity) => void;
     renderComponent: (harmonyData: HarmonyData) => ReactNode;

package/dist/craftingState.d.ts

@@ -69,6 +69,12 @@ export interface SuccessCraftingResult {
     refund: ItemDesc[];
 }
 export type CraftingResult = FailedCraftingResult | SuccessCraftingResult;
+export interface CraftingTrainingMode {
+    flagKey: string;
+    tier: number;
+    recipeTypeId: string;
+    conditionName?: string;
+}
 export interface CraftingState {
     player?: CraftingEntity;
     recipe?: RecipeItem;
@@ -77,4 +83,5 @@ export interface CraftingState {
     consumedPills: number;
     craftingLog: string[];
     craftResult?: CraftingResult;
+    trainingMode?: CraftingTrainingMode;
 }

package/dist/craftingTechnique.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { CraftingBuff, CraftingTechniqueCondition } from './craftingBuff';
 import { Rarity } from './rarity';
 import { Realm } from './realm';
@@ -61,6 +62,7 @@ export interface CraftingTechnique {
     currentCooldown: number;
     justClicked?: true;
     mastery?: CraftingTechniqueMastery[];
+    masteryKindPools?: CraftingTechniqueEffectKind[];
     upgradeMasteries?: {
         [key: string]: CraftingTechniqueMasteryRarityMap;
     };
@@ -116,7 +118,7 @@ export interface CraftingRecipeStats {
 export type CraftingTechniqueMastery = ControlMastery | IntensityMastery | CritChanceTechniqueMastery | CritMultiplierTechniqueMastery | EffectTechniqueMastery | UpgradeCraftingTechniqueMastery | PoolCostMastery | StabilityCostMastery | SuccessChanceMastery;
 interface BaseCraftingTechniqueMastery {
     condition?: CraftingTechniqueCondition;
-    tooltip?: string;
+    tooltip?: Translatable;
     rarity?: Rarity;
 }
 interface ControlMastery extends BaseCraftingTechniqueMastery {
@@ -153,7 +155,7 @@ export interface SuccessChanceMastery extends BaseCraftingTechniqueMastery {
 }
 export interface UpgradeCraftingTechniqueMastery extends BaseCraftingTechniqueMastery {
     kind: 'upgrade';
-    tooltip: string;
+    tooltip: Translatable;
     upgradeKey: string;
     change: number;
     shouldMultiply?: boolean;

package/dist/destiny.d.ts

@@ -1,7 +1,8 @@
+import { Translatable } from './translatable';
 import { CombatStatistic, CraftingStatistic, Scaling } from './stat';
 export interface Destiny {
     name: string;
-    description: string;
+    description: Translatable;
     combatStats?: Partial<{
         [key in CombatStatistic]: Scaling;
     }>;

package/dist/dualCultivation.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 declare const intimateStats: readonly ["satisfaction", "energy", "painThreshold"];
 export type IntimateStat = (typeof intimateStats)[number];
 declare const intimateResources: readonly ["pain", "harmony", "excitement", "rhythm"];
@@ -6,7 +7,7 @@ declare const intimateTechniqueTypes: string[];
 export type IntimateTechniqueType = (typeof intimateTechniqueTypes)[number];
 export type IntimateTrait = {
     name: string;
-    description: string;
+    description: Translatable;
     stats: Partial<Record<IntimateStat, number>>;
     typeMultiplier: Partial<Record<IntimateTechniqueType, number>>;
 };
@@ -34,7 +35,7 @@ interface ResourceEffect {
 }
 export interface DualCultivationMessage {
     id: number;
-    text: string;
+    text: Translatable;
     bindPoint: 'energy' | 'satisfaction' | 'resource' | 'player' | 'partner';
     color: string;
     position?: {

package/dist/entity.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { SoundEffectName } from './audio';
 import { Buff } from './buff';
 import { CraftingBuff } from './craftingBuff';
@@ -13,6 +14,7 @@ export interface CombatEffectTracking {
     damage: number;
     healing: number;
     barrier: number;
+    damageTaken: number;
 }
 export declare const entityTypes: readonly ["Player", "Lifeform", "Enemy"];
 export type EntityType = (typeof entityTypes)[number];
@@ -20,6 +22,7 @@ export declare const sexes: readonly ["male", "female"];
 export type Sex = (typeof sexes)[number];
 export interface PlayerEntity {
     imageIndex: number;
+    originalImageIndex?: number;
     customImagePath?: string;
     customImages?: {
         idle?: string;
@@ -70,6 +73,7 @@ export interface PlayerEntity {
     background: string[];
     monthBuffs?: Buff[];
     injured?: boolean;
+    party?: PartyMemberConfig[];
 }
 export type EnemyDifficulty = 'veryeasy' | 'easy' | 'mediumEasy' | 'medium' | 'medium+' | 'mediumhard' | 'hard' | 'hard+' | 'veryhard' | 'veryhard+' | 'veryhard++' | 'veryhard+++' | 'veryhard++++';
 export type BattleLength = 'halfround' | '1round' | 'veryshort' | 'short' | 'medium' | 'long' | 'verylong' | 'verylong+' | 'verylong++' | 'verylong+++' | 'verylong++++';
@@ -168,10 +172,13 @@ export interface EnemyEntity {
     };
     preconfiguredCombatEntity?: CombatEntity;
     phases?: EnemyEntity[];
+    party?: PartyMemberConfig[];
+    preservePartyMembers?: boolean;
 }
+export type PartyMemberConfig = EnemyEntity;
 export interface CombatMessage {
     id: number;
-    text: string;
+    text: Translatable;
     bindPoint: 'hp' | 'buff' | 'technique';
     color: string;
     position?: {
@@ -204,7 +211,7 @@ export interface CraftingEntity {
 }
 export interface CraftingMessage {
     id: number;
-    text: string;
+    text: Translatable;
     bindPoint: 'pool' | 'stability' | 'perfection' | 'completion' | 'buff' | 'technique';
     color: string;
     position?: {
@@ -219,6 +226,7 @@ export interface CombatArtefact extends ArtefactItem {
 }
 export interface CombatEntity {
     entityType: EntityType;
+    name?: string;
     image: string;
     supportImage?: {
         image: string;
@@ -269,9 +277,13 @@ export interface CombatEntity {
         };
     };
     realm: Realm;
+    realmProgress: RealmProgress;
     stats: CombatStatsMap;
     stance: Stance;
+    stances?: Stance[];
     stanceRotationIndex: number;
+    stanceRotation: StanceRule[];
+    rotationOverrides?: StanceRule[];
     usedOverrides: boolean[];
     usedPills: boolean[];
     defenseFactor: number;
@@ -288,6 +300,9 @@ export interface CombatEntity {
     };
     disableBreathing?: boolean;
     effectTracking: Record<string, CombatEffectTracking>;
+    party?: CombatEntity[];
+    isPartyMember?: boolean;
+    partyMemberIndex?: number;
 }
 export type StanceRule = SingleStance | RandomStance;
 export interface SingleStance {

package/dist/event.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { GameScreen } from './GameScreen';
 import { MusicName, SoundEffectName } from './audio';
 import { Buff } from './buff';
@@ -34,14 +35,14 @@ export type EventStep = TextStep | SpeechStep | CombatStep | CraftingStep | Choi
 export interface TextStep {
     kind: 'text';
     condition?: string;
-    text: string;
+    text: Translatable;
     sfx?: SoundEffectName;
 }
 export interface SpeechStep {
     kind: 'speech';
     condition?: string;
     character: string;
-    text: string;
+    text: Translatable;
 }
 export interface CombatStep {
     kind: 'combat';
@@ -75,7 +76,7 @@ export interface ChoiceStep {
     choices: ChoiceStepChoice[];
 }
 export interface ChoiceStepChoice {
-    text: string;
+    text: Translatable;
     showCondition?: string;
     condition?: EventChoiceCondition;
     hideIfDisabled?: boolean;
@@ -483,7 +484,7 @@ export interface StoneCuttingStep {
 export interface GiveItemStep {
     kind: 'giveItem';
     condition?: string;
-    description: string;
+    description: Translatable;
     itemNames: string[];
     branches: {
         item: string;

package/dist/guild.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { SvgIconTypeMap } from '@mui/material';
 import { OverridableComponent } from '@mui/material/OverridableComponent';
 import { EventStep } from './event';
@@ -9,7 +10,7 @@ export interface GuildMission {
 }
 export interface Guild {
     name: string;
-    description: string;
+    description: Translatable;
     icon: string;
     image: string;
     backgroundLocation: string;

package/dist/house.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { SvgIconTypeMap } from '@mui/material';
 import { OverridableComponent } from '@mui/material/OverridableComponent';
 import { ScreenEffectType } from './ScreenEffectType';
@@ -8,7 +9,7 @@ import { Rarity } from './rarity';
 import { Realm } from './realm';
 export interface House {
     name: string;
-    description: string;
+    description: Translatable;
     background: string;
     screenEffect: ScreenEffectType;
     transportSeal: TransportSealItem;
@@ -27,7 +28,7 @@ export interface RoomDef {
 export type Room = BuffRoom | CultivationRoom | CraftingRoom | CompendiumRoom | HealerRoom | TeleportRoom;
 interface RoomBase {
     name: string;
-    description: string;
+    description: Translatable;
     realm: Realm | 'any';
     rarity: Rarity;
     icon: OverridableComponent<SvgIconTypeMap<{}, 'svg'>>;

package/dist/item.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { Buff } from './buff';
 import { CraftingBuff } from './craftingBuff';
 import { CraftingTechniqueEffect } from './craftingTechnique';
@@ -22,7 +23,7 @@ export type Item = TechniqueItem | TechniqueCrystalItem | TechniqueShardItem | T
 interface ItemBase {
     kind: ItemKind;
     name: string;
-    description: string;
+    description: Translatable;
     icon: string;
     stacks: number;
     rarity: Rarity;
@@ -156,16 +157,20 @@ export interface ArtefactTechnique {
     effects: TechniqueEffect[];
     i?: number;
 }
-export type PillKind = 'combat' | 'crafting' | 'advancement' | 'consumable';
+export type PillKind = 'combat' | 'crafting' | 'advancement' | 'consumable' | 'appearance_change';
 interface BasePillItem extends ItemBase {
     kind: 'pill';
     pillKind: PillKind;
 }
-export type PillItem = CombatPillItem | CraftingPillItem | MiscPillItem | ConsumablePillItem;
+export type PillItem = CombatPillItem | CraftingPillItem | MiscPillItem | ConsumablePillItem | AppearanceChangePillItem;
 export interface MiscPillItem extends BasePillItem {
     pillKind: 'advancement';
     toxicity?: undefined;
 }
+export interface AppearanceChangePillItem extends BasePillItem {
+    pillKind: 'appearance_change';
+    toxicity?: undefined;
+}
 export interface CombatPillItem extends BasePillItem {
     pillKind: 'combat';
     toxicity: number;
@@ -248,6 +253,11 @@ export interface MountItem extends ItemBase {
     masteryPoints?: number;
     qiAbsorption?: number;
     customTransform?: string;
+    explorationBonus?: number;
+    buffs?: {
+        buff: Buff;
+        buffStacks: Scaling;
+    }[];
 }
 export interface ElixirItem extends ItemBase {
     kind: 'elixir';
@@ -318,6 +328,11 @@ export interface MountEnchantment extends Enchantment {
     speed?: number;
     masteryPoints?: number;
     qiAbsorption?: number;
+    explorationBonus?: number;
+    buffs?: {
+        buff: Buff;
+        buffStacks: Scaling;
+    }[];
 }
 export interface RegionMonsters {
     mob: EnemyEntity[];
@@ -379,6 +394,7 @@ export interface CondensationArtEnchantment extends Enchantment {
     masteryPoints?: number;
     speed?: number;
     restoredDroplets?: number;
+    combatStats?: Partial<CombatStatsMap>;
 }
 export type FormationKind = 'qiDensity';
 export type FormationItem = QiDensityFormationItem;
@@ -410,7 +426,7 @@ export interface PillarShardVariant {
 }
 export interface PillarShardItem extends ItemBase {
     kind: 'pillar_shard';
-    tooltip: string;
+    tooltip: Translatable;
     maxInstances?: number;
     variants?: PillarShardVariant[];
     stability?: number;

package/dist/keybindings.js

@@ -28,7 +28,7 @@ export const keybindingDefinitions = [
     {
         action: 'pause',
         category: 'general',
-        displayName: 'Pause/Menu',
+        displayName: 'Pause / Menu',
         description: 'Open pause menu or settings (not rebindable)',
         defaultKey: 'Escape',
         allowRebind: false,

package/dist/life.d.ts

@@ -1,14 +1,11 @@
 import { Buff } from './buff';
 import { StoredStance, StoredStyle } from './entity';
 import { Realm } from './realm';
-import { PhysicalStatistic } from './stat';
 import { Technique } from './technique';
 export interface LifeForm {
     name: string;
-    description: string;
     image: string;
     realm: Realm;
-    baseStats: Record<PhysicalStatistic, number>;
     buffs: Buff[];
     techniques: Technique[];
 }

package/dist/location.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { ScreenEffectType } from './ScreenEffectType';
 import { EventStep } from './event';
 import { Rarity } from './rarity';
@@ -11,7 +12,7 @@ import { AmbienceName, MusicName } from './audio';
 export interface GameLocation {
     name: string;
     displayName?: string;
-    description: string;
+    description: Translatable;
     image: string;
     icon: string;
     screenEffect: ScreenEffectType;
@@ -35,6 +36,27 @@ export interface GameLocation {
     realmProgress?: RealmProgress;
     reputationName?: string;
 }
+/**
+ * A root location that serves as an entry point for location discovery.
+ * The map system discovers all locations reachable from root locations whose
+ * conditions are met.
+ *
+ * Root locations that are not connected to other roots by paths can only be
+ * traveled to via transport seals or event steps (useful for secret/hidden areas).
+ *
+ * The main game root (Nine Mountain Sect) uses condition '1' to always be visible.
+ * Mod roots can use conditions to only appear after certain events/flags.
+ */
+export interface RootLocation {
+    /** The name of the location to use as a discovery root (must exist in locationMap) */
+    locationName: string;
+    /**
+     * Condition expression that determines when this root becomes active.
+     * Uses the same expression syntax as other conditions (e.g., "questFlag == 1").
+     * Use '1' for roots that should always be discovered.
+     */
+    condition: string;
+}
 interface LinkBase {
     location: GameLocation;
     distance: number;
@@ -85,8 +107,8 @@ export interface CraftingMission {
     condition: string;
 }
 export declare const exploresPerUnlock = 3;
-export type BuildingType = 'cultivation' | 'manual' | 'crafting' | 'mission' | 'craftingHall' | 'healer' | 'market' | 'favourExchange' | 'vault' | 'custom' | 'herbField' | 'mine' | 'recipe' | 'requestBoard' | 'compendium' | 'mysticalRegion' | 'trainingGround' | 'library' | 'house' | 'altar' | 'research' | 'reforge' | 'guild' | 'modBuilding';
-export type LocationBuilding = CultivationBuilding | ManualBuilding | CraftingBuilding | MissionBuilding | CraftingHallBuilding | HealerBuilding | MarketBuilding | VaultBuilding | FavourExchangeBuilding | CustomBuilding | HerbFieldBuilding | MineBuilding | RecipeLibraryBuilding | RequestBoardBuilding | CompendiumBuilding | MysticalRegionBuilding | TrainingGroundBuilding | LibraryBuilding | HouseBuilding | CompressionAltarBuilding | ResearchBuilding | ReforgeBuilding | GuildBuilding | ModBuilding;
+export type BuildingType = 'cultivation' | 'manual' | 'crafting' | 'mission' | 'craftingHall' | 'healer' | 'market' | 'favourExchange' | 'vault' | 'custom' | 'herbField' | 'mine' | 'recipe' | 'requestBoard' | 'compendium' | 'mysticalRegion' | 'trainingGround' | 'library' | 'house' | 'altar' | 'research' | 'reforge' | 'guild' | 'tenThousandFlames' | 'modBuilding';
+export type LocationBuilding = CultivationBuilding | ManualBuilding | CraftingBuilding | MissionBuilding | CraftingHallBuilding | HealerBuilding | MarketBuilding | VaultBuilding | FavourExchangeBuilding | CustomBuilding | HerbFieldBuilding | MineBuilding | RecipeLibraryBuilding | RequestBoardBuilding | CompendiumBuilding | MysticalRegionBuilding | TrainingGroundBuilding | LibraryBuilding | HouseBuilding | CompressionAltarBuilding | ResearchBuilding | ReforgeBuilding | GuildBuilding | TenThousandFlamesBuilding | ModBuilding;
 export type LocationBuildingState = MissionBuildingState | CraftingHallBuildingState | ShopBuildingState | RequestBoardBuildingState | HouseBuildingState | CompressionAltarBuildingState;
 interface BuildingBase {
     kind: BuildingType;
@@ -208,6 +230,9 @@ export interface MysticalRegionBuilding extends BuildingBase {
 export interface TrainingGroundBuilding extends BuildingBase {
     kind: 'trainingGround';
 }
+export interface TenThousandFlamesBuilding extends BuildingBase {
+    kind: 'tenThousandFlames';
+}
 export type CustomBuildingPosition = 'top' | 'topleft' | 'topright' | 'belowtop' | 'belowtopleft' | 'belowtopright' | 'middleleft' | 'middle' | 'middleright' | 'bottom' | 'bottomleft' | 'bottomright';
 export interface CustomBuilding extends BuildingBase {
     kind: 'custom';

package/dist/location.js

@@ -23,5 +23,6 @@ export const buildingTypeToName = {
     research: 'Vault of Infinite Reflections',
     reforge: `Infusion Workshop`,
     guild: '',
+    tenThousandFlames: 'Furnace of Ten Thousand Flames',
     modBuilding: '',
 };

package/dist/mine.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { EventStep } from './event';
 import { ItemDesc } from './item';
 import { Rarity } from './rarity';
@@ -40,7 +41,7 @@ export type MineChamber = OreChamber | EventChamber | RandomDropChamber | Releas
 interface BaseChamber {
     icon: string;
     name: string;
-    description: string;
+    description: Translatable;
     rarity: Rarity;
     condition: string;
     isUnique?: boolean;

package/dist/mod.d.ts

@@ -36,6 +36,40 @@ import { PuppetType } from './trainingGround';
 import { TechniqueElement } from './element';
 import { AlternativeStart } from './alternativeStart';
 import { Tutorial } from './tutorial';
+import { Sex } from './entity';
+/**
+ * Sprite images for a custom player character.
+ * All images should be strings (either mod:// URLs for mod assets, or data: URLs).
+ */
+export interface PlayerSpriteImages {
+    /** Base/idle image shown in most UI contexts */
+    base: string;
+    /** Image shown when using aggressive stance techniques */
+    aggressive: string;
+    /** Image shown when using defensive stance techniques */
+    defensive: string;
+    /** Image shown when the player is hit */
+    hit: string;
+    /** Image shown when using offensive stance techniques */
+    offensive: string;
+    /** Image shown when using support stance techniques */
+    support: string;
+    /** Image shown when using utility stance techniques */
+    utility: string;
+}
+/**
+ * A custom player sprite that can be selected during character creation.
+ */
+export interface PlayerSprite {
+    /** Unique identifier for this sprite */
+    id: string;
+    /** Display name shown in character creation */
+    name: string;
+    /** Which gender this sprite is available for: 'male', 'female', or 'both' */
+    gender: Sex | 'both';
+    /** The sprite images for different poses/situations */
+    sprites: PlayerSpriteImages;
+}
 export interface ModMetadata {
     name: string;
     version: string;
@@ -483,6 +517,25 @@ export interface ModAPI {
          * linkLocations('Liang Tiao Village', { location: myLocation, distance: 5, condition: "my_unlock_flag" });
          */
         linkLocations: (existing: string, link: ConditionalLink | ExplorationLink) => void;
+        /**
+         * Register a location as a root for discovery.
+         * Root locations are entry points for the map discovery system - all locations
+         * reachable from a root will be discovered when its condition is met.
+         *
+         * Use this for secret areas or alternative starting points that aren't
+         * connected to the main map by paths. Players can only travel to unconnected
+         * roots via transport seals or event teleportation.
+         *
+         * @param locationName - Name of the location to mark as root (must already exist)
+         * @param condition - Condition expression for when this root is active (use '1' for always)
+         * @example
+         * // Always-active root for an alternative start area
+         * registerRootLocation('Hidden Valley', '1');
+         *
+         * // Conditional root that unlocks after finding a secret
+         * registerRootLocation('Ancient Ruins', 'foundAncientMap == 1');
+         */
+        registerRootLocation: (locationName: string, condition: string) => void;
         /**
          * Add buildings to an existing location.
          * @param location - Location key
@@ -654,6 +707,28 @@ export interface ModAPI {
          * });
          */
         addAlternativeStart: (start: AlternativeStart) => void;
+        /**
+         * Register a custom player sprite for character creation.
+         * Custom sprites will appear in the character creation screen alongside
+         * the default sprites for the specified gender.
+         * @param sprite - Player sprite configuration with id, name, gender, and all required images
+         * @example
+         * addPlayerSprite({
+         *   id: 'myCustomCharacter',
+         *   name: 'Custom Cultivator',
+         *   gender: 'male',
+         *   sprites: {
+         *     base: baseImage,
+         *     aggressive: aggressiveImage,
+         *     defensive: defensiveImage,
+         *     hit: hitImage,
+         *     offensive: offensiveImage,
+         *     support: supportImage,
+         *     utility: utilityImage,
+         *   }
+         * });
+         */
+        addPlayerSprite: (sprite: PlayerSprite) => void;
     };
     utils: {
         /**

package/dist/quest.d.ts

@@ -1,8 +1,9 @@
+import { Translatable } from './translatable';
 import { EventStep, GameEvent } from './event';
 import { ItemDesc } from './item';
 export interface Quest {
     name: string;
-    description: string;
+    description: Translatable;
     category: 'main' | 'side' | 'missionHall' | 'craftingHall' | 'requestBoard' | 'guild';
     guild?: string;
     steps: QuestStep[];
@@ -45,7 +46,7 @@ interface GuildApprovalQuestReward {
 }
 export type QuestStep = EventQuestStep | ConditionQuestStep | CollectQuestStep | MissionHallQuestStep | FlagValueQuestStep | SpeakToCharacterQuestStep | KillQuestStep | WaitQuestStep | RaidQuestStep;
 interface QuestStepBase {
-    hint: string;
+    hint: Translatable;
 }
 interface EventQuestStep extends QuestStepBase {
     kind: 'event';

package/dist/reduxState.d.ts

@@ -319,12 +319,6 @@ export interface NewGameState {
 export interface GameDataState {
     flags: Record<string, number>;
     mapExploration: Record<string, number>;
-    /**
-     * The root location name for location discovery.
-     * Defaults to "Nine Mountain Sect" if not set.
-     * Can be changed by alternative starts.
-     */
-    discoveryRoot?: string;
 }
 export interface HistoryItem {
     text: string;
@@ -366,6 +360,11 @@ export interface GameEventState {
         [key: string]: StoredEventState;
     };
     analyticsToReport: ReportAnalyticsStep[];
+    /**
+     * Hash of the event content for "skip seen dialogue" feature.
+     * Generated when event starts using hashEventContent().
+     */
+    eventHash?: string;
 }
 export interface RecipeFilters {
     hideCompleted: boolean;

package/dist/simpleEvent.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 export interface SimpleGameEvent {
     location: string;
     steps: SimpleEventStep[];
@@ -5,19 +6,19 @@ export interface SimpleGameEvent {
 export type SimpleEventStep = TextStep | SpeechStep | ChoiceStep;
 interface TextStep {
     kind: 'text';
-    text: string;
+    text: Translatable;
 }
 interface SpeechStep {
     kind: 'speech';
     character: string;
-    text: string;
+    text: Translatable;
 }
 interface ChoiceStep {
     kind: `choice`;
     choices: ChoiceStepChoice[];
 }
 export interface ChoiceStepChoice {
-    text: string;
+    text: Translatable;
     children: SimpleEventStep[];
 }
 export {};

package/dist/stat.d.ts

@@ -3,7 +3,7 @@ import { TechniqueElement } from './element';
 export declare const physicalStatistics: readonly ["eyes", "meridians", "dantian", "muscles", "digestion", "flesh"];
 export declare const socialStatistics: readonly ["age", "lifespan", "charisma", "battlesense", "craftskill", "artefactslots", "talismanslots", "condenseEfficiency", "pillsPerRound"];
 export declare const craftingStatistics: readonly ["maxpool", "pool", "maxtoxicity", "toxicity", "resistance", "itemEffectiveness", "control", "intensity", "critchance", "critmultiplier", "pillsPerRound", "poolCostPercentage", "stabilityCostPercentage", "successChanceBonus"];
-export declare const combatStatistics: readonly ["maxhp", "hp", "maxbarrier", "barrier", "maxtoxicity", "toxicity", "resistance", "pillsPerRound", "itemEffectiveness", "power", "artefactpower", "critchance", "defense", "dr", "barrierMitigation", "lifesteal", "critmultiplier", "vulnerability", "weakness", "fistBoost", "blossomBoost", "weaponBoost", "cloudBoost", "bloodBoost", "celestialBoost", "fistAffinity", "blossomAffinity", "weaponAffinity", "cloudAffinity", "bloodAffinity", "celestialAffinity", "noneAffinity", "qiDroplets", "fistDisabled", "bloodDisabled", "blossomDisabled", "cloudDisabled", "celestialDisabled", "weaponDisabled", "fistResistance", "blossomResistance", "weaponResistance", "cloudResistance", "bloodResistance", "celestialResistance", "damageBoost", "healingBoost", "barrierBoost", "overheal"];
+export declare const combatStatistics: readonly ["maxhp", "hp", "maxbarrier", "barrier", "maxtoxicity", "toxicity", "resistance", "pillsPerRound", "itemEffectiveness", "power", "artefactpower", "critchance", "defense", "protection", "dr", "barrierMitigation", "lifesteal", "critmultiplier", "vulnerability", "weakness", "fistBoost", "blossomBoost", "weaponBoost", "cloudBoost", "bloodBoost", "celestialBoost", "fistAffinity", "blossomAffinity", "weaponAffinity", "cloudAffinity", "bloodAffinity", "celestialAffinity", "noneAffinity", "qiDroplets", "fistDisabled", "bloodDisabled", "blossomDisabled", "cloudDisabled", "celestialDisabled", "weaponDisabled", "fistResistance", "blossomResistance", "weaponResistance", "cloudResistance", "bloodResistance", "celestialResistance", "damageBoost", "healingBoost", "barrierBoost", "overheal", "barrierBleed", "formationPartRecovery"];
 export type PhysicalStatistic = (typeof physicalStatistics)[number];
 export type SocialStatistic = (typeof socialStatistics)[number];
 export type CraftingStatistic = (typeof craftingStatistics)[number];

package/dist/stat.js

@@ -47,6 +47,7 @@ export const combatStatistics = [
     'artefactpower',
     'critchance',
     'defense',
+    'protection',
     'dr',
     'barrierMitigation',
     'lifesteal',
@@ -83,6 +84,8 @@ export const combatStatistics = [
     'healingBoost',
     'barrierBoost',
     'overheal',
+    'barrierBleed',
+    'formationPartRecovery',
 ];
 export const baseStatNumber = 10;
 export const expectedHpPerFlesh = 1000;
@@ -108,6 +111,7 @@ export const combatStatToName = {
     artefactpower: 'Artefact Power',
     critchance: 'Crit Chance',
     defense: 'Defense',
+    protection: 'Protection',
     dr: 'Damage Resistance',
     barrierMitigation: 'Barrier Effectiveness',
     lifesteal: 'Life Steal',
@@ -146,6 +150,8 @@ export const combatStatToName = {
     healingBoost: 'Healing Boost',
     barrierBoost: 'Barrier Boost',
     overheal: 'Overheal',
+    barrierBleed: 'Barrier Bleed',
+    formationPartRecovery: 'Formation Part Recovery',
 };
 export const combatStatToDescription = {
     maxhp: 'The amount of damage you can take before you are unable to continue.',
@@ -156,7 +162,8 @@ export const combatStatToDescription = {
     resistance: 'Your resistance to the effects of pill toxicity, increasing the number of pills you can digest.',
     toxicity: '',
     power: 'The strength of your techniques. This affects damage dealt, healing, barrier gained, and the strength of your buffs and debuffs.',
-    defense: 'Your resistance to damage.',
+    defense: 'Your base resistance to damage.',
+    protection: '',
     dr: '',
     lifesteal: '',
     critchance: 'Your chance to get a critical effect on damage, healing, and barrier. Crit chance over 100% converts to bonus crit damage at a 1:3 ratio.',
@@ -197,6 +204,8 @@ export const combatStatToDescription = {
     healingBoost: '',
     barrierBoost: '',
     overheal: '',
+    barrierBleed: '',
+    formationPartRecovery: '',
 };
 // Uncommon stats that need auxiliary tooltips when they appear on buffs
 // These descriptions only show as aux tooltips in buff tooltips, not in the stats dialog
@@ -205,6 +214,11 @@ export const uncommonStatTooltips = {
     healingBoost: '<n>Healing Boost</n> increases all healing received by a percentage.',
     barrierBoost: '<n>Barrier Boost</n> increases all barrier gained by a percentage.',
     overheal: '<n>Overheal</n> converts a percentage of healing beyond your maximum health into barrier.',
+    protection: '<n>Protection</n> reduces damage taken to your health. Does not affect damage taken to your barrier.',
+    weakness: '<n>Weakness</n> reduces your power.',
+    vulnerability: '<n>Vulnerability</n> increases damage taken to your <n>health</n>. Does not affect damage taken to your barrier.',
+    barrierBleed: '<n>Barrier Bleed</n> causes a percentage of your damage to bypass the enemy barrier and strike their health directly.',
+    formationPartRecovery: 'Each point of <n>Formation Part Recovery</n> returns a <n>Formation Part</n> used in combat back to your Spatial Ring after battle.',
 };
 export const craftingStatToName = {
     maxpool: 'Max Qi Pool',

package/dist/technique.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 import { Buff, TechniqueCondition } from './buff';
 import { DamageType } from './DamageType';
 import { TechniqueElement } from './element';
@@ -143,7 +144,7 @@ interface TriggerEffect extends BaseTechniqueEffect {
 export type TechniqueMastery = PowerTechniqueMastery | EffectTechniqueMastery | CritChanceTechniqueMastery | CritMultiplierTechniqueMastery | UpgradeTechniqueMastery;
 interface BaseTechniqueMastery {
     condition?: TechniqueCondition;
-    tooltip?: string;
+    tooltip?: Translatable;
     rarity?: Rarity;
 }
 interface PowerTechniqueMastery extends BaseTechniqueMastery {
@@ -164,7 +165,7 @@ interface EffectTechniqueMastery extends BaseTechniqueMastery {
 }
 export interface UpgradeTechniqueMastery extends BaseTechniqueMastery {
     kind: 'upgrade';
-    tooltip: string;
+    tooltip: Translatable;
     upgradeKey: string;
     change: number;
     shouldMultiply?: boolean;

package/dist/trainingGround.d.ts

@@ -1,8 +1,9 @@
+import { Translatable } from './translatable';
 import { EnemyEntity, Realm, RealmProgress } from '.';
 export interface PuppetType {
     id: string;
     name: string;
-    description: string;
+    description: Translatable;
     image: string;
     baseMultiplier: number;
     multiplierGrowth: number;

package/dist/translatable.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A deferred translation object. Instead of calling t() immediately,
+ * store the key and variables to be resolved at render time.
+ * This ensures language changes take effect without reload.
+ */
+export interface TranslatableString {
+    readonly _translatable: true;
+    readonly key: string;
+    readonly variables?: Record<string, string | number>;
+}
+/**
+ * A deferred plural translation object. Stores both singular and plural keys
+ * to be resolved at render time based on a count value.
+ */
+export interface TranslatablePlural {
+    readonly _translatable: true;
+    readonly _plural: true;
+    readonly countVar: string;
+    readonly one: string;
+    readonly other: string;
+    readonly variables?: Record<string, string | number>;
+}
+/**
+ * A value that can be either a plain string or a deferred translation object.
+ * Plain strings are translated as-is. TranslatableString objects are resolved
+ * at render time with their stored variables.
+ */
+export type Translatable = string | TranslatableString | TranslatablePlural;

package/dist/translatable.js

@@ -0,0 +1 @@
+export {};

package/dist/tutorial.d.ts

@@ -1,3 +1,4 @@
+import { Translatable } from './translatable';
 export interface Tutorial {
     name: string;
     steps: TutorialStep[];
@@ -12,11 +13,11 @@ export interface ClickTutorialStep {
 export interface DescribeTutorialStep {
     kind: 'describe';
     elementId: string;
-    description: string;
+    description: Translatable;
 }
 export interface GeneralTutorialStep {
     kind: 'general';
-    description: string;
+    description: Translatable;
     elementId?: undefined;
 }
 export interface SuspendContStep {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "afnm-types",
-  "version": "0.6.29",
+  "version": "0.6.32",
   "description": "Type definitions for Ascend From Nine Mountains",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",