@wayward/types 2.15.4-beta.dev.20260403.1 → 2.15.4-beta.dev.20260407.1

package/definitions/game/game/curse/Curse.d.ts

@@ -80,6 +80,7 @@ export declare const CURSE_EVENTS_DEFAULT_RADIUS = 25;
  */
 export declare const CURSE_EVENTS_COOLDOWN_RANGE: IRangeRange;
 export declare const CURSE_EVENTS_FIRST_NIGHT = 3;
+export declare const CURSE_EVENTS_DEFAULT_EVENT_COOLDOWN = 3;
 /**
  * Each tick after a curse event ends, one entity of each type spawned by the event has this chance to despawn.
  * If the entity is on a tile that can be seen by a player, it will not despawn.
@@ -103,6 +104,7 @@ export declare const CURSE_EVENTS_RUNE_CHANCE_MULTIPLIER_LUCKY: IRange<number>;
  */
 export declare const CURSE_EVENTS_RUNES_KILL_TAME: Array<WeightedOption<IRange>>;
 export declare const CURSE_EVENTS_RUNES_SURVIVED: IRange<number>;
+export declare const CURSE_SCRIPT_REPEAT_INFINITE_ITERATIONS = 99999999;
 export declare const CURSE_EVENTS_CREATURE_WANDER_CURSEBEARER_PRIORITY: IRange<number>;
 export declare const CURSE_EVENTS_VISUAL_EXPLORED_FADE_TURNS = 30;
 export declare const CURSE_EVENTS_VISUAL_EXPLORED_FAST_PHASE_TURNS = 50;
@@ -128,6 +130,9 @@ declare namespace Curse {
     function resetCooldown(island: Island): void;
     function updateRuneItemsDisplay(island: Island): void;
     function tickCurse(island: Island, humans: Human[]): void;
+    function executeScriptAction(island: Island, event: CurseEventInstance, path: Array<string | number>): boolean;
+    function skipScriptWait(event: CurseEventInstance, path: Array<string | number>): boolean;
+    function restartScriptBranch(event: CurseEventInstance, path: Array<string | number>): boolean;
     function reload(island: Island, isNew?: boolean): void;
     function spawnCurseEvents(island: Island, humans: Human[], requiresEvents: boolean): void;
     function attemptCurseEventSpawn(category: CurseCategory | null, human: Human, curse: number, humans: Human[], events: CurseEventInstance[], allowDependents?: boolean): CurseEventInstance | undefined;
@@ -147,6 +152,7 @@ declare const SYMBOL_CURSE_EVENT_ACTIVE_SUBSCRIBER_INSTANCE: unique symbol;
 type CurseVisualHiddenExploredTilesByZ = Partial<Record<number, number[]>>;
 type CurseVisualFastStepsByZ = Partial<Record<number, number>>;
 type CurseVisualOriginsByZ = Partial<Record<number, IVector2>>;
+type CurseEventCooldowns = Partial<Record<CurseEventType, number>>;
 interface Curse {
     night?: true;
     globalCurse?: number;
@@ -158,6 +164,7 @@ interface Curse {
     visualStateRestoreOriginsByZ?: CurseVisualOriginsByZ;
     visualStateWeightedRestoreStepsByZ?: CurseVisualFastStepsByZ;
     cooldown?: number;
+    eventCooldowns?: CurseEventCooldowns;
     ephemeralCreatures?: number[];
     [SYMBOL_CURSE_EVENT_GLOBAL_SUBSCRIBER_INSTANCE]?: CurseEventSubscriber;
     [SYMBOL_CURSE_EVENT_ACTIVE_SUBSCRIBER_INSTANCE]?: CurseEventSubscriber;
@@ -180,6 +187,8 @@ interface ScriptProcessState {
     path: Array<string | number>;
     /** Iterations remaining for a Repeat block, or ticks remaining for an EndCondition. */
     iterationsRemaining?: number;
+    /** The original iteration count when the current step or branch was initialized. */
+    iterationsTotal?: number;
     /** The state of any child processes started by a Simultaneously or Repeat block. */
     childProcesses?: ScriptProcessState[];
 }

package/definitions/game/game/curse/CurseEvent.d.ts

@@ -124,6 +124,11 @@ export interface CurseEvent {
      * All curse events default to a weight of 1, so setting this to 0.5 would make it half as likely as any other event.
      */
     weight?: number;
+    /**
+     * The number of eligible curse event nights that must pass before this event can appear again.
+     * Defaults to 1.
+     */
+    cooldown?: number;
     revealOn: ArrayOr<CurseEventRevealCondition>;
     discoverOn: ArrayOr<CurseEventRevealCondition>;
     effects?(context: CurseEventContext, effects: StatusEffectList): StatusEffectList;

package/definitions/game/game/curse/event/CurseEventSuffusedWithMagic.d.ts

@@ -0,0 +1,13 @@
+/*!
+ * Copyright 2011-2025 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+import { CurseEvent } from "@wayward/game/game/curse/CurseEvent";
+declare const _default: CurseEvent;
+export default _default;

package/definitions/game/game/doodad/Doodad.d.ts

@@ -32,7 +32,9 @@ import type { ContainerSort, DisplayableItemType, IContainer, IItemVehicle, ILiq
 import { ItemType } from "@wayward/game/game/item/IItem";
 import type Item from "@wayward/game/game/item/Item";
 import type { IHasMagic } from "@wayward/game/game/magic/IMagicalProperty";
+import type { IMagicalPropertyManagerEvents } from "@wayward/game/game/magic/MagicalPropertyManager";
 import MagicalPropertyManager from "@wayward/game/game/magic/MagicalPropertyManager";
+import MagicalPropertyType from "@wayward/game/game/magic/MagicalPropertyType";
 import type { Reference, ReferenceType } from "@wayward/game/game/reference/IReferenceManager";
 import type { IHasInsulation, IInsulationResult, TempType } from "@wayward/game/game/temperature/ITemperature";
 import type Tile from "@wayward/game/game/tile/Tile";
@@ -45,7 +47,10 @@ import type { IUnserializedCallback } from "@wayward/game/save/serializer/ISeria
 import type { IVector3 } from "@wayward/game/utilities/math/IVector";
 import type { IRGB } from "@wayward/utilities/Color";
 import type { IEventEmitter } from "@wayward/utilities/event/EventEmitter";
-export interface IDoodadEvents extends IEntityMovableEvents, IQualityEvents {
+type DoodadMagicEvents = {
+    [EVENT in keyof IMagicalPropertyManagerEvents as `magic${Capitalize<EVENT>}`]: IMagicalPropertyManagerEvents[EVENT];
+};
+export interface IDoodadEvents extends IEntityMovableEvents, IQualityEvents, DoodadMagicEvents {
     /**
      * Called when an doodad is being updated
      * @param tile The tile the doodad is on
@@ -112,6 +117,7 @@ export default class Doodad extends EntityMovable<IDoodadDescription, DoodadType
     hitchedCreature?: number;
     magic?: MagicalPropertyManager;
     meltDecay?: number;
+    note?: string;
     orientation?: DoorOrientation;
     quality?: Quality;
     sort?: ContainerSort;
@@ -158,6 +164,7 @@ export default class Doodad extends EntityMovable<IDoodadDescription, DoodadType
     isContainer(): this is IUncastableContainer;
     toString(): string;
     getRegistrarId(): number;
+    get litDescription(): IDoodadDescription | undefined;
     /**
      * Entity controlling this doodad (for wheel barrows)
      */
@@ -231,6 +238,10 @@ export default class Doodad extends EntityMovable<IDoodadDescription, DoodadType
      */
     getBuilder(): Player | undefined;
     removeMagic(): void;
+    private pipingMagic;
+    protected pipeMagicalPropertyManagerEvents(magic: MagicalPropertyManager): void;
+    protected onMagicSet(type: MagicalPropertyType, _subType?: number, value?: number, previousValue?: number, curse?: true): void;
+    protected onMagicRemove(type: MagicalPropertyType): void;
     unhitch(): void;
     damage(forceBreak?: boolean, skipDropAsItem?: boolean, skipSound?: boolean, skipResources?: boolean, damage?: number): void;
     getDefaultDurability(random?: import("@wayward/utilities/random/Random").Random<import("@wayward/utilities/random/generators/LegacySeededGenerator").LegacySeededGenerator | import("@wayward/utilities/random/generators/PCGSeededGenerator").PCGSeededGenerator>): number;
@@ -408,6 +419,9 @@ export default class Doodad extends EntityMovable<IDoodadDescription, DoodadType
      */
     stokeFire(stokeValue: number, human?: Human): boolean;
     getDecayAtStartWithMagical(): number;
+    protected clampDecayToMax(type: MagicalPropertyType): void;
+    protected clampDurabilityToMax(type: MagicalPropertyType): void;
+    protected updateDurabilityForPersistence(type: MagicalPropertyType, value?: number, previousValue?: number, curse?: true): void;
     canCauseDamage(): boolean;
     /**
      * Decay over time
@@ -424,3 +438,4 @@ export default class Doodad extends EntityMovable<IDoodadDescription, DoodadType
     private postProcessDecay;
     private randomAshSpawn;
 }
+export {};

package/definitions/game/game/doodad/DoodadManager.d.ts

@@ -62,7 +62,8 @@ export default class DoodadManager extends EntityManager<Doodad> {
     loadEntity(doodad: Doodad): void;
     isGroup(doodadType: DoodadType | DoodadTypeGroup): doodadType is DoodadTypeGroup;
     isInGroup(doodadType: DoodadType, doodadGroup: DoodadTypeGroup | DoodadType): boolean;
-    getGroups(doodad: DoodadType): DoodadTypeGroup[];
+    getGroups(doodad?: DoodadType): DoodadTypeGroup[];
+    getVisibleGroups(doodad: Doodad): DoodadTypeGroup[];
     /**
      * Checks if a number is a DoodadType or DoodadTypeExtra.
      * @param type a number (DoodadType/DoodadTypeExtra enum).
@@ -86,8 +87,12 @@ export default class DoodadManager extends EntityManager<Doodad> {
      */
     updateAllAsync(ticks: number, playingHumans: Human[], playerHumanTiles: Set<Tile>, onProgress: (progess: number) => Promise<void>): Promise<void>;
     verifyAndFixItemWeights(): void;
+    /**
+     * Gets the nearest affective scarecrow in the given group, or, if no group is provided, gets the nearest scarecrow that isn't in a specialized group
+     */
     getScarecrowInRange(tile: Tile, group?: DoodadTypeGroup): Doodad | undefined;
     getScarecrowInLineOfSight(creature: Creature, isClientside: boolean): Doodad | undefined;
+    getCursedScarecrowSpawnChance(tile: Tile, curseEvent?: boolean): number;
     addScarecrow(doodad: Doodad): void;
     removeScarecrow(doodad: Doodad): void;
     /**

package/definitions/game/game/doodad/DoodadUtilities.d.ts

@@ -9,7 +9,7 @@
  * https://github.com/WaywardGame/types/wiki
  */
 import type Doodad from "@wayward/game/game/doodad/Doodad";
-import type { DoodadType, IScareRadius } from "@wayward/game/game/doodad/IDoodad";
+import type { DoodadType, IDoodadDescription, IScareRadius } from "@wayward/game/game/doodad/IDoodad";
 import { GrowingStage } from "@wayward/game/game/doodad/IDoodad";
 import type Human from "@wayward/game/game/entity/Human";
 import type Item from "@wayward/game/game/item/Item";
@@ -21,7 +21,12 @@ declare namespace DoodadUtilities {
     export function wouldWalkingOnDealNormalDamage(doodad: DoodadIn, human?: Human): boolean;
     export function isDangerous(doodad: DoodadIn, human?: Human): boolean;
     export function canCauseStatus(doodad: DoodadIn): boolean;
-    export function getScareRadius(doodad: Doodad | Item): IScareRadius;
+    export function getScareRadius(doodad: Doodad | Item, description?: IDoodadDescription | undefined): IScareRadius | undefined;
+    export function getCursedScarecrowSpawnBonus(doodad: Doodad | Item): {
+        radius: number;
+        naturalSpawnChance: number;
+        curseEventSpawnChance: number;
+    } | undefined;
     export {};
 }
 export default DoodadUtilities;

package/definitions/game/game/doodad/IDoodad.d.ts

@@ -619,4 +619,5 @@ export interface IDoodadGetNameOptions {
      */
     ignoreDiscovery: boolean;
 }
+export declare const DOODAD_GROUP_HIDE_CONDITIONS: Array<(doodad: Doodad, group: DoodadTypeGroup) => boolean>;
 export {};

package/definitions/game/game/doodad/IScarecrows.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright 2011-2025 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+import { DoodadTypeGroup } from "@wayward/game/game/doodad/IDoodad";
+export declare const SPECIALIZED_SCARECROW_GROUPS: DoodadTypeGroup[];

package/definitions/game/game/entity/Human.d.ts

@@ -75,6 +75,10 @@ interface IEquip {
     item: Item;
     equipType: EquipType;
 }
+interface IThrowDamageBreakdown extends IAttack {
+    baseDamage: number;
+    magicalBonus: number;
+}
 export default abstract class Human<DescriptionType = unknown, TypeType extends number = number, EntityReferenceType extends ReferenceType.Player | ReferenceType.NPC = ReferenceType.Player | ReferenceType.NPC, TagType = unknown> extends EntityWithStats<DescriptionType, TypeType, EntityReferenceType, TagType> implements IHasInsulation, IContainer {
     static getNameTranslation(): TranslationImpl;
     event: IEventEmitter<this, IHumanEvents>;
@@ -242,6 +246,7 @@ export default abstract class Human<DescriptionType = unknown, TypeType extends
      */
     damageRandomEquipment(amount?: number): void;
     getDamageModifier(): number;
+    getThrowDamageBreakdown(weapon?: Item): IThrowDamageBreakdown;
     calculateDamageAmount(attackType: AttackType, weapon?: Item, ammoItem?: Item): number;
     isDualWielding(): boolean;
     getAttack(attack?: AttackType, weapon?: Item, offHandWeapon?: Item): IAttack;

package/definitions/game/game/entity/action/actions/SetTitle.d.ts

@@ -16,5 +16,5 @@ export declare enum TitleType {
     Milestone = 0,
     Skill = 1
 }
-declare const _default: Action<[[ActionArgument.Undefined, import("../argument/ActionArgumentEnum").default<TitleType, "Skill" | "Milestone">], [arg1: ActionArgument.Undefined, import("../argument/ActionArgumentEnum").default<Milestone, "Abnormalizer" | "Chef" | "Exterminator" | "Crafter" | "Gardener" | "Gatherer" | "Hunter" | "Locksmith" | "ReaperOfSouls" | "Survivor" | "Pitcher" | "Trapsetter" | "TreasureHunter" | "Collector" | "Explorer" | "Grandmaster" | "Prepared" | "Doctor" | "Artificer" | "Returned" | "Navigator" | "DragonSlayer" | "Treasurer" | "Pulchritudinous" | "Friendly" | "Malevolent" | "Benevolent" | "Boundless" | "Talented" | "Weathered" | "Seasoned" | "Pacifier" | "Merchant" | "Notekeeper" | "Operator" | "Huntsman" | "Contender" | "Challenger" | "DestroyerOfMagi" | "Helmsman" | "Multitasker" | "Apocryphal" | "Diverse" | "InternalDiscoveredBoats" | "Traitor" | "MasterOfAll" | "Rouseabout" | "Murderer" | "Retailer" | "Masochist" | "Versatile" | "InternalStatDiscovery" | "Dedicated" | "Hounded" | "Serene" | "InternalRuneOrAltarDiscovery" | "Curator" | "Thaumaturgic" | "Runekeeper" | "InternalDeityDiscovery" | "InternalMerchantsDiscovery" | "InternalCurseSystemDiscovery" | "Invoker" | "InternalDeityInvoked" | "InternalInsulationDiscovery" | "Turbulent" | "Statistician" | "Afflicted" | "Exsanguinated" | "InternalItemDiscovered" | "Cursed" | "Cursebreaker" | "Oblivious">, import("../argument/ActionArgumentEnum").default<SkillType, "None" | "Chemistry" | "Anatomy" | "Marksmanship" | "Blacksmithing" | "Botany" | "Camping" | "Cartography" | "Claythrowing" | "Cooking" | "Fishing" | "Fletching" | "Glassblowing" | "Leatherworking" | "Lockpicking" | "Lumberjacking" | "Mining" | "Mycology" | "Parrying" | "Stonecrafting" | "Swimming" | "Tactics" | "Tailoring" | "Throwing" | "Tinkering" | "Trapping" | "Woodworking" | "Taming" | "Horticulture" | "Bartering" | "Seafaring" | "Thaumaturgy" | "DualWielding" | "Theurgy">]], ActionType.SetTitle, import("../../player/Player").default, void, import("@wayward/game/game/entity/action/IAction").IActionUsable, [(TitleType | undefined)?, (SkillType | Milestone | undefined)?]>;
+declare const _default: Action<[[ActionArgument.Undefined, import("../argument/ActionArgumentEnum").default<TitleType, "Skill" | "Milestone">], [arg1: ActionArgument.Undefined, import("../argument/ActionArgumentEnum").default<Milestone, "Abnormalizer" | "Chef" | "Exterminator" | "Crafter" | "Gardener" | "Gatherer" | "Hunter" | "Locksmith" | "ReaperOfSouls" | "Survivor" | "Pitcher" | "Trapsetter" | "TreasureHunter" | "Collector" | "Explorer" | "Grandmaster" | "Prepared" | "Doctor" | "Artificer" | "Returned" | "Navigator" | "DragonSlayer" | "Treasurer" | "Pulchritudinous" | "Friendly" | "Malevolent" | "Benevolent" | "Boundless" | "Talented" | "Weathered" | "Seasoned" | "Pacifier" | "Merchant" | "Notekeeper" | "Operator" | "Huntsman" | "Contender" | "Challenger" | "DestroyerOfMagi" | "Helmsman" | "Multitasker" | "Apocryphal" | "Diverse" | "InternalDiscoveredBoats" | "Traitor" | "MasterOfAll" | "Rouseabout" | "Murderer" | "Retailer" | "Masochist" | "Versatile" | "InternalStatDiscovery" | "Dedicated" | "Hounded" | "Serene" | "InternalRuneOrAltarDiscovery" | "Curator" | "Thaumaturgic" | "Runekeeper" | "InternalDeityDiscovery" | "InternalMerchantsDiscovery" | "InternalCurseSystemDiscovery" | "Invoker" | "InternalDeityInvoked" | "InternalInsulationDiscovery" | "Turbulent" | "Statistician" | "Afflicted" | "Exsanguinated" | "InternalItemDiscovered" | "Cursed" | "Cursebreaker" | "Oblivious" | "Warded" | "Defiled">, import("../argument/ActionArgumentEnum").default<SkillType, "None" | "Chemistry" | "Anatomy" | "Marksmanship" | "Blacksmithing" | "Botany" | "Camping" | "Cartography" | "Claythrowing" | "Cooking" | "Fishing" | "Fletching" | "Glassblowing" | "Leatherworking" | "Lockpicking" | "Lumberjacking" | "Mining" | "Mycology" | "Parrying" | "Stonecrafting" | "Swimming" | "Tactics" | "Tailoring" | "Throwing" | "Tinkering" | "Trapping" | "Woodworking" | "Taming" | "Horticulture" | "Bartering" | "Seafaring" | "Thaumaturgy" | "DualWielding" | "Theurgy">]], ActionType.SetTitle, import("../../player/Player").default, void, import("@wayward/game/game/entity/action/IAction").IActionUsable, [(TitleType | undefined)?, (SkillType | Milestone | undefined)?]>;
 export default _default;

package/definitions/game/game/entity/creature/CreatureManager.d.ts

@@ -44,12 +44,15 @@ export default class CreatureManager extends EntityManager<Creature, IEntityRemo
     static getName(creature: Creature | CreatureType, aberrant?: boolean, count?: number, article?: Article): TranslationImpl;
     getName(creature: Creature | CreatureType, aberrant?: boolean, count?: number, article?: Article): TranslationImpl;
     calculateHappinessTameTime(human: Human, creature: Creature, bonusTime?: number): number;
+    getAberrantOfferRefusalPenalty(offeringBonus?: number): number;
+    shouldAberrantOfferFail(human: Human, creature: Creature, tamingSkillDivisor: number, offeringBonus?: number): boolean;
     /**
      * Spawns a creature.
      * @param type The type of creature to spawn.
      * @param tile The tile
      */
     spawn(type: CreatureType, tile: Tile, options: ICreatureSpawnOptions): Creature | undefined;
+    spawnAdditionalNearCursedScarecrow(creature: Creature, originTile: Tile, curseEvent?: boolean): Creature[];
     spawnFromZone(tile: Tile, bypassCreatureLimit?: boolean, checkTerrainType?: boolean): Creature | undefined;
     getAberrantChance(tile: Tile): number;
     createFake(type: CreatureType, aberrant: boolean, tile?: Tile, id?: number): Creature;

package/definitions/game/game/inspection/infoProviders/Uses.d.ts

@@ -44,5 +44,6 @@ export default abstract class Uses<T extends IDescribed> extends InfoProvider {
     protected getUseDisplayLevel(action: ActionType, context: InfoProviderContext): InfoDisplayLevel;
     private getDetailsHandlerResolver;
     protected getUse(description: DescribedDescription<T>, action: ActionType): TranslationImpl;
+    protected getActionTier(description: DescribedDescription<T>, action: ActionType): number | undefined;
     private getUseName;
 }

package/definitions/game/game/inspection/infoProviders/doodad/DoodadLightSource.d.ts

@@ -0,0 +1,19 @@
+/*!
+ * Copyright 2011-2025 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+import type Doodad from "@wayward/game/game/doodad/Doodad";
+import { InfoProvider } from "@wayward/game/game/inspection/InfoProvider";
+export default class DoodadLightSource extends InfoProvider {
+    private readonly doodad;
+    static get(doodad: Doodad): DoodadLightSource | undefined;
+    constructor(doodad: Doodad);
+    getClass(): string[];
+    get(): never[] | import("../LabelledValue").default;
+}

package/definitions/game/game/inspection/infoProviders/item/ItemUses.d.ts

@@ -24,6 +24,7 @@ export default class ItemUses extends Uses<Item> {
     protected getUseDisplayLevel(action: ActionType, context: InfoProviderContext): InfoDisplayLevel;
     protected getUseInfoHandlers(): Array<UseInfo<any, any, any, Item>>;
     protected getUse(description: IItemDescription, action: ActionType): TranslationImpl;
+    protected getActionTier(description: Readonly<IItemDescription>, action: ActionType): number | undefined;
 }
 export declare class ItemUseContext extends InfoProviderContext {
     private readonly itemRef?;

package/definitions/game/game/inspection/infoProviders/item/use/ItemBuildInfo.d.ts

@@ -22,8 +22,8 @@ declare const _default: UseInfo<{
     scareRadius: import("../../../../doodad/IDoodad").IScareRadius | undefined;
     entityType: import("../../../../entity/IEntity").EntityType.Item;
     value?: Item | undefined;
-    type: import("../../../../item/IItem").ItemType;
-    description: Readonly<import("../../../../item/IItem").IItemDescription>;
+    type: import("@wayward/game/game/item/IItem").ItemType;
+    description: Readonly<import("@wayward/game/game/item/IItem").IItemDescription>;
     quality: import("../../../../IObject").Quality;
     action: ActionType.Build;
     union: import("@wayward/game/game/inspection/infoProviders/UseInfo").IUseInfoBase<Item, ActionType.Build>;

package/definitions/game/game/inspection/infoProviders/item/use/ItemCraftingIngredientInfo.d.ts

@@ -14,8 +14,8 @@ import type Item from "@wayward/game/game/item/Item";
 declare const _default: UseInfo<{
     entityType: import("../../../../entity/IEntity").EntityType.Item;
     value?: Item | undefined;
-    type: import("../../../../item/IItem").ItemType;
-    description: Readonly<import("../../../../item/IItem").IItemDescription>;
+    type: import("@wayward/game/game/item/IItem").ItemType;
+    description: Readonly<import("@wayward/game/game/item/IItem").IItemDescription>;
     quality: import("../../../../IObject").Quality;
     action: ActionType.CraftingIngredient;
     union: import("@wayward/game/game/inspection/infoProviders/UseInfo").IUseInfoBase<Item, ActionType.CraftingIngredient>;

package/definitions/game/game/inspection/infoProviders/shared/SharedLightSourceInfo.d.ts

@@ -10,28 +10,12 @@
  */
 import type Doodad from "@wayward/game/game/doodad/Doodad";
 import { ActionType } from "@wayward/game/game/entity/action/IAction";
-import { EntityType } from "@wayward/game/game/entity/IEntity";
-import UseInfo from "@wayward/game/game/inspection/infoProviders/UseInfo";
+import LabelledValue from "@wayward/game/game/inspection/infoProviders/LabelledValue";
+import type { InfoUnion } from "@wayward/game/game/inspection/infoProviders/UseInfo";
 import type Item from "@wayward/game/game/item/Item";
-declare const _default: UseInfo<{
-    lightSource: number | undefined;
-    entityType: EntityType.Item;
-    value?: Item | undefined;
-    type: import("@wayward/game/game/item/IItem").ItemType;
-    description: Readonly<import("@wayward/game/game/item/IItem").IItemDescription>;
-    quality: import("../../../IObject").Quality;
-    action: ActionType.StartFire | ActionType.Ignite | ActionType.Equip;
-    union: import("@wayward/game/game/inspection/infoProviders/UseInfo").IUseInfoBase<Item, ActionType.StartFire | ActionType.Ignite | ActionType.Equip>;
-    details: Set<symbol>;
-} | {
+export interface ILightSourceInfoBase {
+    value?: Item | Doodad;
     lightSource: number;
-    entityType: EntityType.Doodad;
-    value?: Doodad | undefined;
-    type: import("../../../doodad/IDoodad").DoodadType;
-    description: Readonly<import("../../../doodad/IDoodad").IDoodadDescription>;
-    quality: import("../../../IObject").Quality;
-    action: ActionType.StartFire | ActionType.Ignite | ActionType.Equip;
-    union: import("@wayward/game/game/inspection/infoProviders/UseInfo").IUseInfoBase<Doodad, ActionType.StartFire | ActionType.Ignite | ActionType.Equip>;
-    details: Set<symbol>;
-}, ActionType.StartFire | ActionType.Ignite | ActionType.Equip, {}, Doodad | Item>;
-export default _default;
+}
+export declare function getLightSource(value: InfoUnion<Item | Doodad, ActionType.StartFire | ActionType.Ignite | ActionType.Equip> | Item | Doodad): number | undefined;
+export default function ({ value, lightSource }: ILightSourceInfoBase): LabelledValue | undefined;

package/definitions/game/game/inspection/infoProviders/shared/SharedLitAndEquipmentUseInfo.d.ts

@@ -0,0 +1,38 @@
+/*!
+ * Copyright 2011-2025 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+import type Doodad from "@wayward/game/game/doodad/Doodad";
+import { ActionType } from "@wayward/game/game/entity/action/IAction";
+import UseInfoBase from "@wayward/game/game/inspection/infoProviders/UseInfo";
+import type Item from "@wayward/game/game/item/Item";
+declare const _default: UseInfoBase<{
+    scareRadius: import("../../../doodad/IDoodad").IScareRadius | undefined;
+    lightSource: number | undefined;
+    entityType: import("../../../entity/IEntity").EntityType.Doodad;
+    value?: Doodad | undefined;
+    type: import("../../../doodad/IDoodad").DoodadType;
+    description: Readonly<import("../../../doodad/IDoodad").IDoodadDescription>;
+    quality: import("../../../IObject").Quality;
+    action: ActionType.StartFire | ActionType.Ignite | ActionType.Equip;
+    union: import("@wayward/game/game/inspection/infoProviders/UseInfo").IUseInfoBase<Doodad, ActionType.StartFire | ActionType.Ignite | ActionType.Equip>;
+    details: Set<symbol>;
+} | {
+    scareRadius: import("../../../doodad/IDoodad").IScareRadius | undefined;
+    lightSource: number | undefined;
+    entityType: import("../../../entity/IEntity").EntityType.Item;
+    value?: Item | undefined;
+    type: import("../../../item/IItem").ItemType;
+    description: Readonly<import("../../../item/IItem").IItemDescription>;
+    quality: import("../../../IObject").Quality;
+    action: ActionType.StartFire | ActionType.Ignite | ActionType.Equip;
+    union: import("@wayward/game/game/inspection/infoProviders/UseInfo").IUseInfoBase<Item, ActionType.StartFire | ActionType.Ignite | ActionType.Equip>;
+    details: Set<symbol>;
+}, ActionType.StartFire | ActionType.Ignite | ActionType.Equip, {}, Doodad | Item>;
+export default _default;

package/definitions/game/game/inspection/infoProviders/shared/SharedScareRadiusInfo.d.ts

@@ -0,0 +1,19 @@
+/*!
+ * Copyright 2011-2025 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+import type Doodad from "@wayward/game/game/doodad/Doodad";
+import type { IScareRadius } from "@wayward/game/game/doodad/IDoodad";
+import LabelledValue from "@wayward/game/game/inspection/infoProviders/LabelledValue";
+import type Item from "@wayward/game/game/item/Item";
+export interface IScareRadiusInfoBase {
+    value?: Item | Doodad;
+    scareRadius: IScareRadius;
+}
+export default function ({ value, scareRadius }: IScareRadiusInfoBase): LabelledValue | undefined;

package/definitions/game/game/inspection/inspections/DoodadInspection.d.ts

@@ -30,5 +30,6 @@ export default class DoodadInspection extends Inspection<Doodad> {
     onUpdateTile(_: any, tile: Tile): void;
     protected onRemove(_: any, doodad: Doodad): void;
     private getDescription;
+    private getNoteDescription;
     private getTier;
 }

package/definitions/game/game/inspection/inspections/ItemInspection.d.ts

@@ -46,6 +46,7 @@ export default class ItemInspection extends Inspection<ItemType | ItemTypeExtra>
     protected onTickEnd(): void;
     private updatePosition;
     private getDescription;
+    private getNoteDescription;
     private getCapacity;
     private getDoodadUses;
     private getMapIsland;

package/definitions/game/game/item/IItem.d.ts

@@ -1948,4 +1948,6 @@ export declare enum ItemMovementResultFlag {
     MovedAndDamaged = 64,
     RemovedItem = 128
 }
+export declare const ITEM_GROUP_HIDE_CONDITIONS: Array<(item: Item, group: ItemTypeGroup) => boolean>;
+export declare function getCraftingAptitudeMultiplier(craftingAptitudeBonus: number | undefined): number;
 export {};

package/definitions/game/game/item/Item.d.ts

@@ -12,7 +12,7 @@ import { TileUpdateType } from "@wayward/game/game/IGame";
 import type { IHasQuality, IObject, IObjectOptions, IQualityEvents } from "@wayward/game/game/IObject";
 import { Quality } from "@wayward/game/game/IObject";
 import type Doodad from "@wayward/game/game/doodad/Doodad";
-import type { IDoodadDescription } from "@wayward/game/game/doodad/IDoodad";
+import type { DoodadType, IDoodadDescription } from "@wayward/game/game/doodad/IDoodad";
 import type Entity from "@wayward/game/game/entity/Entity";
 import type { IEntityMovableEvents } from "@wayward/game/game/entity/EntityMovable";
 import EntityMovable from "@wayward/game/game/entity/EntityMovable";
@@ -54,6 +54,18 @@ import Debug from "@wayward/game/utilities/dev/Debug";
 import type { Direction } from "@wayward/game/utilities/math/Direction";
 import type { IVector3 } from "@wayward/game/utilities/math/IVector";
 import type { IEventEmitter } from "@wayward/utilities/event/EventEmitter";
+export interface IItemAttackContributionBreakdown {
+    baseDamage: number;
+    qualityBonus: number;
+    magicalBonus: number;
+    total: number;
+}
+export interface IItemBaseDefenseContributionBreakdown {
+    baseDefense: number;
+    qualityBonus: number;
+    magicalBonus: number;
+    total: number;
+}
 type ItemMagicEvents = {
     [EVENT in keyof IMagicalPropertyManagerEvents as `magic${Capitalize<EVENT>}`]: IMagicalPropertyManagerEvents[EVENT];
 };
@@ -119,6 +131,7 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
     holderReference?: Reference<ReferenceType.Player | ReferenceType.NPC>;
     magic?: MagicalPropertyManager;
     map?: ItemMapManager;
+    note?: string;
     protected?: boolean;
     quality?: Quality;
     sort?: ContainerSort;
@@ -138,7 +151,8 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
     offsetY?: number;
     [SYMBOL_CONTAINER_CACHED_REFERENCE]?: ContainerReference;
     private _movementOptions?;
-    constructor(itemType?: ItemType | undefined, islandId?: IslandId, quality?: Quality, human?: Human, magicalLootType?: MagicalLootType);
+    constructor(itemType?: ItemType | undefined, islandId?: IslandId, quality?: Quality, human?: Human, magicalLootType?: MagicalLootType, clientSide?: boolean);
+    private setup;
     get asCorpse(): undefined;
     get asCreature(): undefined;
     get asDoodad(): undefined;
@@ -171,7 +185,9 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
     getDisplayItem(): DisplayableItemType;
     isContainer(): this is Item & IContainer;
     isWithin(container?: IContainer): boolean;
+    get builtDoodadType(): DoodadType | undefined;
     get builtDescription(): IDoodadDescription | undefined;
+    get builtAndLitDescription(): IDoodadDescription | undefined;
     get placeDownDescription(): IDoodadDescription | undefined;
     countTradesWith(human?: Human): number;
     /**
@@ -257,9 +273,10 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
      * Note: This is not called by clients joining a mp game.
      */
     verifyAndFixItem(): void;
+    private pipingMagic;
     protected pipeMagicalPropertyManagerEvents(magic: MagicalPropertyManager): void;
     protected onMagicSet(type: MagicalPropertyType, subType?: MagicalSubPropertySubTypes, value?: number, previousValue?: number, curse?: true): void;
-    protected onMagicRemove(type: MagicalPropertyType, subType?: MagicalSubPropertySubTypes, value?: number): void;
+    protected onMagicRemove(type: MagicalPropertyType): void;
     verifyAndFixMagic(): void;
     /**
      * @param source A string representing the reason for this damage. Used for multiplayer debugging. Just put a unique string of characters here
@@ -323,15 +340,22 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
     rerollMagicalProperty(type: MagicalPropertyType, subType?: MagicalSubPropertySubTypes): boolean;
     rerollMagicalPropertyValues(): void;
     initializeMagicalPropertyManager(): MagicalPropertyManager;
-    protected updateDurabilityForPersistence(type: MagicalPropertyType, value?: number): void;
-    protected clampDecayToMax(type: MagicalPropertyType, value?: number): void;
+    protected updateDurabilityForPersistence(type: MagicalPropertyType, value?: number, previousValue?: number, curse?: true): void;
+    protected clampDecayToMax(type: MagicalPropertyType): void;
     protected clampDurabilityToMax(type: MagicalPropertyType): void;
-    addMagicalProperty(type: MagicalPropertyType, subType?: MagicalSubPropertySubTypes, valueType?: "min" | "max"): boolean;
+    /**
+     * Adds a randomised magical property of the given type.
+     * @param valueType If provided, instead of random, either use the "min" or "max" value for the property. (Not the expandable max!)
+     * This param being provided does not stop the seeded generator from being advanced in the normal way.
+     * @param cursed If provided, overrides the random curse chance with a guaranteed state.
+     */
+    addMagicalProperty(type: MagicalPropertyType, subType?: MagicalSubPropertySubTypes, valueType?: "min" | "max", cursed?: boolean): boolean;
     getMagicalPropertyInfo(type: MagicalPropertyType): IMagicalPropertyInfo | undefined;
     acquireNotify(human: Human, context?: ActionContext): void;
     getStokeFireValue(): number | undefined;
     getStokeFireBonusValue(): number;
     getOnUseBonus(): number;
+    getAttackContributionBreakdown(type: "attack" | "ranged"): IItemAttackContributionBreakdown;
     getAttackDamage(type: AttackType.MeleeWeapon | AttackType.RangedWeapon): number;
     /**
      * Gets the worth of an item used for merchant trading. Does not consider bartering or modifiers bonuses; use Item.getTraderSellPrice for that.
@@ -343,10 +367,11 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
      * Checks to see if the item is in a fire/hot thing
      */
     canBurnPlayer(): boolean;
+    getEffectiveBaseDefenseBreakdown(): IItemBaseDefenseContributionBreakdown;
     /**
-     * Get the base defense of an item plus its magical defense stat if applicable
+     * Get the base defense of an item plus its quality and magical defense bonuses.
      */
-    getBaseDefense(): number;
+    getDefense(): number;
     /**
      * Returns the durability of the item based on the max durability to be used as a pseudo "charge"
      */
@@ -495,6 +520,7 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
      * @returns true if bonusDefense/Attack was set.
      */
     setAttackDefenseBonus(): boolean;
+    getBaseAttack(): number;
     /**
      * Gets the attack damage with its bonus value.
      * Note: This does not get the value with any magical properties applied.
@@ -507,10 +533,14 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
      * @returns number The ranged attack value with bonus applied.
      */
     getRangedAttackWithBonus(): number;
+    /**
+     * @returns The base defense value.
+     */
+    getBaseDefense(): number;
     /**
      * Gets the base defense with its bonus value.
      * Note: This does not get the value with any magical properties applied.
-     * @returns number The base defense value.
+     * @returns The base defense value with bonus applied.
      */
     getBaseDefenseWithBonus(): number;
     /**

package/definitions/game/game/item/ItemManager.d.ts

@@ -234,7 +234,11 @@ export default class ItemManager extends EntityManager<Item, IItemRemoveOptions>
     static getDisassemblyComponentsAsItemTypes(description: IItemDescription): Array<ItemType | ItemTypeGroup>;
     getWeightCapacity(container?: IContainer, includeMagic?: boolean): number | undefined;
     create(itemType: ItemType | ItemTypeGroup | Array<ItemType | ItemTypeGroup>, container: IContainer | undefined, quality?: Quality, human?: Human, context?: ActionContext, magicalLootType?: MagicalLootType): Item;
+    /**
+     * Note: NOT UI-safe. Use `createClientside`. This should  be named `createTemplate` probably
+     */
     createFake(itemType: ItemType | ItemTypeGroup | Array<ItemType | ItemTypeGroup>, quality?: Quality, human?: Human, magicalLootType?: MagicalLootType): Item;
+    createClientside(item: ItemType, quality?: Quality, human?: Human, magicalLootType?: MagicalLootType): Item;
     getContainedContainers(container: IContainer): IContainer[];
     computeContainerWeight(container: IContainer): number;
     getMagicalWeightCapacity(container: IContainer): number;
@@ -281,6 +285,7 @@ export default class ItemManager extends EntityManager<Item, IItemRemoveOptions>
     getItemTypeGroupName(itemType: ItemType | ItemTypeGroup, article?: Article, count?: number): Translation;
     getGroupDefault(itemGroup: ItemTypeGroup, weightType?: WeightType, ancestorGroups?: ItemTypeGroup[]): ItemType;
     getGroups(itemType: ItemType): ItemTypeGroup[];
+    getVisibleGroups(item: Item): ItemTypeGroup[];
     getPlayerFromInventoryContainer(containable: IContainable): Player | undefined;
     getRandomQuality(bonusQuality?: number, relicChance?: boolean, tile?: Tile): Quality;
     hasAdditionalRequirements(actionOrHuman: IActionHandlerApi<Human> | Human, craftType: ItemType, actionNotUsableMessage?: Message, isRepairOrDisassembly?: boolean): IRequirementInfo;

package/definitions/game/game/magic/IMagicalProperty.d.ts

@@ -34,6 +34,7 @@ export interface IMagicalSubProperty<T extends number> {
 export type MagicalProperty<T extends MagicalPropertyType> = MagicalPropertyTypeSubTypeMap extends Record<T, any> ? IMagicalSubProperty<MagicalPropertyTypeSubTypeMap[T]> : IMagicalProperty;
 export interface MagicalNormalPropertyEntry {
     type: MagicalNormalPropertyTypes;
+    /** @deprecated This value is raw, unaffected if this is a curse property! */
     value: number;
     curse?: true;
 }
@@ -41,6 +42,7 @@ export type MagicalSubPropertyEntry = {
     [K in MagicalSubPropertyTypes]: {
         type: K;
         subType: MagicalPropertyTypeSubTypeMap[K];
+        /** @deprecated This value is raw, unaffected if this is a curse property! */
         value: number;
         curse?: true;
     };
@@ -53,6 +55,7 @@ export declare namespace MagicalPropertyEntry {
 export interface MagicalPropertyEntryIntersection {
     type: MagicalPropertyType;
     subType?: MagicalSubPropertySubTypes;
+    /** @deprecated This value is raw, unaffected if this is a curse property! */
     value: number;
     curse?: true;
 }