@wayward/types 2.14.3-beta.dev.20241226.1 → 2.14.4-beta

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

@@ -8,6 +8,6 @@
  * 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 { IHasMagic } from "@wayward/game/game/magic/MagicalPropertyManager";
+import type { IHasMagic } from "@wayward/game/game/magic/IMagicalProperty";
 import type TranslationImpl from "@wayward/game/language/impl/TranslationImpl";
 export default function (magicalThingy: IHasMagic): TranslationImpl | undefined;

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

@@ -11,8 +11,9 @@
 import type { SkillType } from "@wayward/game/game/entity/IHuman";
 import { InfoProvider } from "@wayward/game/game/inspection/InfoProvider";
 import type { Quality } from "@wayward/game/game/IObject";
-import type { IHasMagic, MagicalNormalPropertyTypes, MagicalSubPropertyTypes } from "@wayward/game/game/magic/MagicalPropertyManager";
-import { MagicalPropertyIdentity } from "@wayward/game/game/magic/MagicalPropertyManager";
+import type { MagicalNormalPropertyTypes, MagicalSubPropertyTypes } from "@wayward/game/game/magic/IMagicalProperty";
+import type { IHasMagic } from "@wayward/game/game/magic/IMagicalProperty";
+import { MagicalPropertyIdentity } from "@wayward/game/game/magic/IMagicalProperty";
 import type { MagicalPropertyTypeSubTypeMap } from "@wayward/game/game/magic/MagicalPropertyType";
 import Translation from "@wayward/game/language/Translation";
 import type { TranslationGenerator } from "@wayward/game/ui/component/IComponent";

package/definitions/game/game/inspection/infoProviders/creature/CreatureTamedInfo.d.ts

@@ -18,6 +18,7 @@ export default class CreatureTamedInfoProvider extends InfoProvider {
     private readonly mood;
     private readonly tameTime;
     private readonly ai;
+    private readonly noPetting;
     private readonly pet;
     private readonly milk;
     private readonly untamesIn;

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

@@ -0,0 +1,20 @@
+/*!
+ * Copyright 2011-2024 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";
+import LabelledValue from "@wayward/game/game/inspection/infoProviders/LabelledValue";
+export default class DoodadScareRadius extends InfoProvider {
+    private readonly doodad;
+    static get(doodad: Doodad): DoodadScareRadius | undefined;
+    constructor(doodad: Doodad);
+    getClass(): string[];
+    get(): LabelledValue | never[];
+}

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

@@ -10,15 +10,13 @@
  */
 import type Doodad from "@wayward/game/game/doodad/Doodad";
 import { InfoProvider } from "@wayward/game/game/inspection/InfoProvider";
-import type TranslationImpl from "@wayward/game/language/impl/TranslationImpl";
 export default class StillWaterInfoProvider extends InfoProvider {
     private readonly doodad;
     static get(doodad: Doodad): StillWaterInfoProvider | undefined;
-    private message;
+    private readonly waterTopMessage;
+    private readonly waterBottomMessage;
     private constructor();
     getClass(): string[];
     hasContent(): boolean;
-    get(): TranslationImpl;
-    onTickEnd(): void;
-    private getWaterInStill;
+    get(): InfoProvider[];
 }

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

@@ -0,0 +1,20 @@
+/*!
+ * Copyright 2011-2024 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 { InfoProvider } from "@wayward/game/game/inspection/InfoProvider";
+import LabelledValue from "@wayward/game/game/inspection/infoProviders/LabelledValue";
+import type Item from "@wayward/game/game/item/Item";
+export default class ItemInvokeInfoProvider extends InfoProvider {
+    private readonly item;
+    constructor(item: Item);
+    getClass(): string[];
+    get(): LabelledValue | never[];
+    protected onTickEnd(): void;
+}

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

@@ -8,7 +8,8 @@
  * 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 { MagicalNormalPropertyTypes, MagicalPropertyIdentity, MagicalSubPropertyTypes } from "@wayward/game/game/magic/MagicalPropertyManager";
+import type { MagicalNormalPropertyTypes, MagicalPropertyIdentity } from "@wayward/game/game/magic/IMagicalProperty";
+import type { MagicalSubPropertyTypes } from "@wayward/game/game/magic/IMagicalProperty";
 import type { MagicalPropertyTypeSubTypeMap } from "@wayward/game/game/magic/MagicalPropertyType";
 import Translation from "@wayward/game/language/Translation";
 declare function MagicalSourceTooltip(type: MagicalNormalPropertyTypes): Translation;

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

@@ -12,12 +12,13 @@ import { ActionType } from "@wayward/game/game/entity/action/IAction";
 import LabelledValue from "@wayward/game/game/inspection/infoProviders/LabelledValue";
 import UseInfo from "@wayward/game/game/inspection/infoProviders/UseInfo";
 import type Item from "@wayward/game/game/item/Item";
-import { MagicalPropertyEntry } from "@wayward/game/game/magic/MagicalPropertyManager";
+import { MagicalPropertyEntry } from "@wayward/game/game/magic/IMagicalProperty";
 import MagicalPropertyType from "@wayward/game/game/magic/MagicalPropertyType";
 import { TempType } from "@wayward/game/game/temperature/ITemperature";
 declare const _default: UseInfo<{
     doodadContainer: import("../../../../doodad/IDoodad").IDoodadDescription | undefined;
     civilizationScore: number | undefined;
+    scareRadius: number;
     entityType: import("../../../../entity/IEntity").EntityType.Item;
     value?: Item | undefined;
     type: import("../../../../item/IItem").ItemType;
@@ -38,6 +39,8 @@ declare const _default: UseInfo<{
     getPreservationChance: () => LabelledValue | undefined;
 } & {
     getCivilizationScore: () => LabelledValue | undefined;
+} & {
+    scareRadius: () => LabelledValue | undefined;
 } & {
     getMagicalBuildTypes: () => Set<MagicalPropertyType>;
 } & {

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

@@ -9,7 +9,7 @@
  * https://github.com/WaywardGame/types/wiki
  */
 import { ActionType } from "@wayward/game/game/entity/action/IAction";
-import type { Stat } from "@wayward/game/game/entity/IStats";
+import { Stat } from "@wayward/game/game/entity/IStats";
 import UseInfo from "@wayward/game/game/inspection/infoProviders/UseInfo";
 import type Item from "@wayward/game/game/item/Item";
 import type Tooltip from "@wayward/game/ui/tooltip/Tooltip";

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

@@ -11,7 +11,7 @@
 import { ActionType } from "@wayward/game/game/entity/action/IAction";
 import UseInfo from "@wayward/game/game/inspection/infoProviders/UseInfo";
 import type Item from "@wayward/game/game/item/Item";
-import { MagicalPropertyEntry } from "@wayward/game/game/magic/MagicalPropertyManager";
+import { MagicalPropertyEntry } from "@wayward/game/game/magic/IMagicalProperty";
 import MagicalPropertyType from "@wayward/game/game/magic/MagicalPropertyType";
 import { TempType } from "@wayward/game/game/temperature/ITemperature";
 import UiTranslation from "@wayward/game/language/dictionary/UiTranslation";

package/definitions/game/game/inspection/infoProviders/stat/GenericInfo.d.ts

@@ -12,6 +12,7 @@ import { InfoProvider } from "@wayward/game/game/inspection/InfoProvider";
 import { StatInfo } from "@wayward/game/game/inspection/infoProviders/stat/StatInfo";
 export default class GenericInfo extends StatInfo {
     readonly score: InfoProvider.Observer<number>;
+    readonly tier: InfoProvider.Observer<number>;
     readonly totalCivilizationScore: InfoProvider.Observer<number>;
     readonly civilizationScore: InfoProvider.Observer<number>;
     readonly turns: InfoProvider.Observer<number>;

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

@@ -13,8 +13,8 @@ import type { SimpleInfoProvider } from "@wayward/game/game/inspection/InfoProvi
 import { InfoProvider } from "@wayward/game/game/inspection/InfoProvider";
 import type { InfoProviderContext } from "@wayward/game/game/inspection/InfoProviderContext";
 import Inspection from "@wayward/game/game/inspection/Inspection";
-import type { MagicalPropertyIdentityHash } from "@wayward/game/game/magic/MagicalPropertyManager";
-import { MagicalPropertyIdentity } from "@wayward/game/game/magic/MagicalPropertyManager";
+import type { MagicalPropertyIdentityHash } from "@wayward/game/game/magic/IMagicalProperty";
+import { MagicalPropertyIdentity } from "@wayward/game/game/magic/IMagicalProperty";
 import Translation from "@wayward/game/language/Translation";
 import type { TranslationGenerator } from "@wayward/game/ui/component/IComponent";
 export default class MagicInspection extends Inspection<MagicalPropertyIdentityHash> {

package/definitions/game/game/island/Island.d.ts

@@ -43,8 +43,8 @@ import TileEventManager from "@wayward/game/game/tile/TileEventManager";
 import Translation from "@wayward/game/language/Translation";
 import World from "@wayward/game/renderer/world/World";
 import type { IPostSerializeCallback, IPreSerializeCallback, ISerializer } from "@wayward/game/save/serializer/ISerializer";
-import type { IVersionInfo } from "@wayward/game/utilities/Version";
-import Version from "@wayward/game/utilities/Version";
+import type { IVersionInfo } from "@wayward/utilities/Version";
+import Version from "@wayward/utilities/Version";
 import { Direction } from "@wayward/game/utilities/math/Direction";
 import type { IVector2, IVector3 } from "@wayward/game/utilities/math/IVector";
 import Vector2 from "@wayward/game/utilities/math/Vector2";
@@ -96,6 +96,7 @@ export default class Island extends EventEmitter.Host<IIslandEvents> implements
     biomeOptions?: unknown;
     biomeType: BiomeTypes;
     contaminatedWater: IWaterContamination[];
+    lastPlayerGameTimeTicks?: number;
     loadCount: number;
     name?: string;
     position: IVector2;
@@ -137,7 +138,7 @@ export default class Island extends EventEmitter.Host<IIslandEvents> implements
     get isFastForwarding(): boolean;
     constructor(game?: Game, position?: IVector2, seed?: number, mapSize?: number);
     toString(): string;
-    createStaticRandom(seed?: number): Random<PCGSeededGenerator>;
+    createStaticRandom(seed?: number, advance?: number): Random<PCGSeededGenerator>;
     private registerMemoryLeakDetector;
     preSerializeObject(serializer: ISerializer): void;
     postSerializeObject(serializer: ISerializer): void;
@@ -280,6 +281,7 @@ export default class Island extends EventEmitter.Host<IIslandEvents> implements
      * In manual turn mode, it will tick the humans stat timers & the game
      */
     passTurn(human: Human, turnType?: TurnTypeFlag, dueToAction?: boolean): void;
+    private travelTimeFastForward;
     /**
      * Fast forwards an island by running lots of ticks.
      * Defaults to IslandFastForward tick flag with no playing humans.
@@ -330,4 +332,9 @@ export default class Island extends EventEmitter.Host<IIslandEvents> implements
      * Returns the type of liquid that can be gathered from the tile
      */
     getLiquidGatherType(terrainType: TerrainType, terrainDescription: ITerrainDescription): keyof ILiquidGather | undefined;
+    /**
+     * Calculate the maximum travel time (derived currently from the maximum growth time of doodads - we don't need to simulate past that value).
+     * @returns number equal to the maximum travel time.
+     */
+    getMaximumTravelTime(): number;
 }

package/definitions/game/game/island/automation/IAutomation.d.ts

@@ -12,7 +12,9 @@ import type { DoodadType, GrowingStage } from "@wayward/game/game/doodad/IDoodad
 import type { ActionType } from "@wayward/game/game/entity/action/IAction";
 import type { CreatureType } from "@wayward/game/game/entity/creature/ICreature";
 import type Human from "@wayward/game/game/entity/Human";
+import type { MoveType } from "@wayward/game/game/entity/IEntity";
 import type { EquipType } from "@wayward/game/game/entity/IHuman";
+import type { NPCType } from "@wayward/game/game/entity/npc/INPCs";
 import type { StatusType } from "@wayward/game/game/entity/status/IStatus";
 import type { Quality } from "@wayward/game/game/IObject";
 import type { IslandId } from "@wayward/game/game/island/IIsland";
@@ -103,6 +105,14 @@ export interface IAutomationSetupWorld {
         z?: number;
         aberrant?: true;
     }>;
+    npcs?: Array<{
+        type: NPCType;
+        x?: number;
+        y?: number;
+        z?: number;
+        inventory?: IAutomationSetupItemContainer;
+        moveType?: MoveType;
+    }>;
 }
 export interface IAutomationSetupPlayer {
     alwaysPassSkillChecks?: boolean;

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

@@ -30,7 +30,7 @@ import type { IMoveItemOptions } from "@wayward/game/game/item/IItemManager";
 import type Item from "@wayward/game/game/item/Item";
 import type Recipe from "@wayward/game/game/item/recipe/Recipe";
 import type MagicalPropertyManager from "@wayward/game/game/magic/MagicalPropertyManager";
-import type { MagicalSubPropertySubTypes } from "@wayward/game/game/magic/MagicalPropertyManager";
+import type { MagicalSubPropertySubTypes } from "@wayward/game/game/magic/IMagicalProperty";
 import type MagicalPropertyType from "@wayward/game/game/magic/MagicalPropertyType";
 import type { IInsulationDescription, ITemperatureDescription } from "@wayward/game/game/temperature/ITemperature";
 import type { TerrainType } from "@wayward/game/game/tile/ITerrain";
@@ -268,7 +268,7 @@ export interface IItemDescription extends IObjectDescription, IModdable, ITemper
      */
     liquidGather?: ILiquidGather;
     placeDownType?: DoodadType;
-    damageOnUse?: Record<number, any>;
+    damageOnUse?: OptionalDescriptions<ActionType, number>;
     /**
      * How good this item is at being an item of an `ItemTypeGroup`.
      *
@@ -390,6 +390,17 @@ export interface IItemDescription extends IObjectDescription, IModdable, ITemper
      * When set to true, the item will provide no consumption bonuses when used based on its quality
      */
     qualityProvidesNoConsumeBonus?: boolean;
+    /**
+     * When set to true, the item will always be generated with a single magical property from a weighted set of properties.
+     */
+    alwaysGetMagicalProperty?: boolean;
+    /**
+     * If set to true, this item will be able to have all magical properties regardless of the other properties it has.
+     */
+    canHaveAllMagicalProperties?: boolean;
+    canAlter?: false;
+    canTransmogrify?: false;
+    canUpgrade?: false;
 }
 export declare namespace IItemDescription {
     function actionDisabled(description: IItemDescription | undefined, action: ActionType): boolean;
@@ -595,6 +606,7 @@ export interface IMoveToTileOptions {
      * Note: Everything done in afterMovement must be clientside only
      */
     afterMovement?: IMoveToTileAfterMovementOptions;
+    skipWeightChecks?: boolean;
 }
 export interface IMoveToTileBeforeMovementOptions {
     remove?: boolean;
@@ -1684,19 +1696,20 @@ export declare enum ItemType {
     StrippedLeather = 815,
     ChickenEggshells = 816,
     PenguinEggshells = 817,
-    Last = 818
+    MagicalMote = 818,
+    Last = 819
 }
 export declare enum ItemTypeExtra {
-    None = 819,
-    TatteredMap_RolledUp = 820,
-    TatteredMap_Completed = 821,
-    WoodenBookcase_25 = 822,
-    WoodenBookcase_50 = 823,
-    WoodenBookcase_75 = 824,
-    WoodenBookcase_100 = 825,
-    RuneOfEvilSplinters = 826,
-    RuneOfGoodCharred = 827,
-    TallySticks = 828
+    None = 820,
+    TatteredMap_RolledUp = 821,
+    TatteredMap_Completed = 822,
+    WoodenBookcase_25 = 823,
+    WoodenBookcase_50 = 824,
+    WoodenBookcase_75 = 825,
+    WoodenBookcase_100 = 826,
+    RuneOfEvilSplinters = 827,
+    RuneOfGoodCharred = 828,
+    TallySticks = 829
 }
 export type DisplayableItemType = ItemType | ItemTypeExtra;
 export declare enum ItemTag {
@@ -1852,7 +1865,8 @@ export declare enum ItemTypeGroup {
     ExcludedFromRandom = -9856,
     Leaves = -9855,
     Flute = -9854,
-    All = -9853
+    InternalNoDropOnDoodadBreak = -9853,
+    All = -9852
 }
 export type StillContainerBaseItemType = ItemType.Waterskin | ItemType.GlassBottle | ItemType.ClayJug | ItemType.CoconutContainer;
 export interface IItemMovementResult {

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

@@ -12,6 +12,7 @@ import type { Quality } from "@wayward/game/game/IObject";
 import type Doodad from "@wayward/game/game/doodad/Doodad";
 import type DoodadManager from "@wayward/game/game/doodad/DoodadManager";
 import type { DoodadType, DoodadTypeGroup } from "@wayward/game/game/doodad/IDoodad";
+import type { IEntityRemoveOptions } from "@wayward/game/game/entity/EntityManager";
 import type { ActionType, IActionNotUsable } from "@wayward/game/game/entity/action/IAction";
 import type ActionContext from "@wayward/game/game/entity/action/IActionContext";
 import type { DropAllowProtected } from "@wayward/game/game/entity/action/actions/Drop";
@@ -28,7 +29,7 @@ import type { Direction } from "@wayward/game/utilities/math/Direction";
 /**
  * Options when removing an item
  */
-export interface IItemRemoveOptions {
+export interface IItemRemoveOptions extends IEntityRemoveOptions {
     /**
      * Defaults to false
      */
@@ -133,7 +134,6 @@ export interface IMoveItemOptions {
     moveToTileOptions?: IMoveToTileOptions | true;
     dryRun?: true;
     index?: number;
-    updateView?: true;
     isTrading?: boolean;
     revertFromDoodad?: boolean;
     skipDrop?: true;

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

@@ -34,7 +34,10 @@ import { ItemTypeExtra } from "@wayward/game/game/item/IItem";
 import { BookType, ContainerSort, ItemDamageResult, ItemType, ItemTypeGroup, ItemWeightChange, SYMBOL_CONTAINER_CACHED_REFERENCE } from "@wayward/game/game/item/IItem";
 import type { IPlaceOnTileOptions } from "@wayward/game/game/item/IItemManager";
 import ItemMapManager from "@wayward/game/game/item/ItemMapManager";
-import type { IHasMagic, MagicalSubPropertySubTypes } from "@wayward/game/game/magic/MagicalPropertyManager";
+import type { MagicalLootType } from "@wayward/game/game/item/MagicalLoot";
+import type { MagicalSubPropertySubTypes } from "@wayward/game/game/magic/IMagicalProperty";
+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";
@@ -49,7 +52,10 @@ import type { IUnserializedCallback } from "@wayward/game/save/serializer/ISeria
 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 IItemEvents extends IEntityMovableEvents, IQualityEvents {
+type ItemMagicEvents = {
+    [EVENT in keyof IMagicalPropertyManagerEvents as `magic${Capitalize<EVENT>}`]: IMagicalPropertyManagerEvents[EVENT];
+};
+export interface IItemEvents extends IEntityMovableEvents, IQualityEvents, ItemMagicEvents {
     toggleProtected(isProtected: boolean): any;
     containerChange(newContainer: IContainer, oldContainer?: IContainer): any;
     fireUpdate(stage?: FireStage): any;
@@ -128,7 +134,7 @@ 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);
+    constructor(itemType?: ItemType | undefined, islandId?: IslandId, quality?: Quality, human?: Human, magicalLootType?: MagicalLootType);
     get asCorpse(): undefined;
     get asCreature(): undefined;
     get asDoodad(): undefined;
@@ -179,7 +185,7 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
      * @param quantityOverride The number of properties to use instead of generating the quantity randomly
      * @returns True if the item has become magical
      */
-    setMagicalChanceFromQuality(contextualChanceMultiplier?: number, quantityOverride?: number): boolean;
+    setMagicalChanceFromQuality(contextualChanceMultiplier?: number, quantityOverride?: number, magicalLootType?: MagicalLootType): boolean;
     /**
      * @deprecated This method currently shouldn't be used in production code, as it's to do with the new crafting system. Stay tuned.
      */
@@ -200,7 +206,6 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
      */
     getName(article?: Article, options?: Partial<IItemGetNameOptions>): TranslationImpl;
     protected get debug(): any;
-    private getDebug;
     protected get typeEnum(): typeof ItemType;
     protected getDescription(): IItemDescription | undefined;
     get isTransient(): boolean;
@@ -227,7 +232,7 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
      * Returns the maximum decay of an item, or undefined if the item does not have the decayMax or storeDecay property.
      * @returns A number or undefined.
      */
-    canDecay(): 1 | undefined;
+    canDecay(): number | undefined;
     getDecayRate(isClientSide: boolean): number;
     getPreservationDecayMultiplier(): number;
     getTemperatureDecayMultiplier(isClientSide: boolean): number;
@@ -245,6 +250,7 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
      * Note: This is not called by clients joining a mp game.
      */
     verifyAndFixItem(): void;
+    protected pipeMagicalPropertyManagerEvents(magic: MagicalPropertyManager): 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
@@ -303,7 +309,7 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
      * Get acceptable magical types based on item
      */
     getValidMagicalProperties(): MagicalPropertyType[];
-    addMagicalProperties(count: number, source?: string): boolean;
+    addMagicalProperties(count: number, source?: string, magicalLootType?: MagicalLootType): boolean;
     rerollMagicalProperty(type: MagicalPropertyType, subType?: MagicalSubPropertySubTypes): boolean;
     rerollMagicalPropertyValues(): void;
     initializeMagicalPropertyManager(): MagicalPropertyManager;
@@ -446,11 +452,16 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
     willBreakOnDamage(actionType?: ActionType): boolean;
     onUnserialized(): void;
     /**
-     * Gets civilization score based on item's quality and type (if it can be build/set down) but without the magical property values.
+     * Gets civilization score based on item's quality and type (if it can be build/set down) but without the magical property values. This also exists on doodads.
      * @param actionType Either Build or SetDown as they are the only types that can use civilization score.
      * @returns number of score (or 0 if no civilization score is set).
      */
     getCivilizationScore(actionType: ActionType.Build | ActionType.SetDown): number;
+    /**
+     * Gets the scarecrow radius based on doodad's definition and quality.
+     * This also exists on doodads.
+     */
+    getScareRadius(): number;
     getVehicle(): IItemVehicle | undefined;
     addCreature(creature: Creature, remainTamed?: boolean): void;
     /**
@@ -499,3 +510,4 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
     private checkIfItemsMatch;
     private checkIfItemArraysMatch;
 }
+export {};

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

@@ -15,6 +15,7 @@ import type { IGetBestItemsOptions } from "@wayward/game/game/item/IItemManager"
 import type Item from "@wayward/game/game/item/Item";
 import type ItemManager from "@wayward/game/game/item/ItemManager";
 import Observer from "@wayward/game/utilities/Observer";
+import type { IEventSubscriberEvents } from "@wayward/utilities/event/EventEmitter";
 import EventEmitter from "@wayward/utilities/event/EventEmitter";
 export interface IItemFinderOptions extends Partial<IGetBestItemsOptions> {
     /**
@@ -24,7 +25,7 @@ export interface IItemFinderOptions extends Partial<IGetBestItemsOptions> {
     fallback?: ItemFinder;
     postFilter?(item: Item): boolean;
 }
-export interface IItemFinderEvents {
+export interface IItemFinderEvents extends IEventSubscriberEvents {
     track(): any;
     dispose(): any;
 }

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

@@ -23,6 +23,7 @@ import { ContainerType, CraftResult, ItemType, ItemTypeExtra, ItemTypeGroup } fr
 import type { IAddToContainerResult, IContainerSort, IDoodadsUsed, IGetBestItemsOptions, IGetItemOptions, IGetItemsOptions, IItemRemoveOptions, IMoveItemOptions, IRequirementInfo } from "@wayward/game/game/item/IItemManager";
 import { ContainerReferenceSource, CraftStatus, ICraftResultChances, WeightType } from "@wayward/game/game/item/IItemManager";
 import Item from "@wayward/game/game/item/Item";
+import type { MagicalLootType } from "@wayward/game/game/item/MagicalLoot";
 import type { ITileContainer } from "@wayward/game/game/tile/ITerrain";
 import { TerrainType } from "@wayward/game/game/tile/ITerrain";
 import type Tile from "@wayward/game/game/tile/Tile";
@@ -71,6 +72,8 @@ export interface IItemManagerEvents extends Events<EntityManager<Item>> {
     containerUnstack(container: IContainer, type: ItemType): any;
     /** Called at the end of inserting new items into a container, specifically when sorting the container was not necessary. */
     containerItemAddDidNotSort(container: IContainer): any;
+    /** Called when the weight of the container changes. */
+    containerWeightUpdate(container: IContainer): any;
     /**
      * Called when an item is crafted
      * @param human The human object
@@ -222,8 +225,8 @@ export default class ItemManager extends EntityManager<Item, IItemRemoveOptions>
     getDisassemblyComponents(description: IItemDescription, quality: Quality | undefined): Item[];
     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): Item;
-    createFake(itemType: ItemType | ItemTypeGroup | Array<ItemType | ItemTypeGroup>, quality?: Quality, human?: Human): Item;
+    create(itemType: ItemType | ItemTypeGroup | Array<ItemType | ItemTypeGroup>, container: IContainer | undefined, quality?: Quality, human?: Human, context?: ActionContext, magicalLootType?: MagicalLootType): Item;
+    createFake(itemType: ItemType | ItemTypeGroup | Array<ItemType | ItemTypeGroup>, quality?: Quality, human?: Human, magicalLootType?: MagicalLootType): Item;
     getContainedContainers(container: IContainer): IContainer[];
     computeContainerWeight(container: IContainer): number;
     getMagicalWeightCapacity(container: IContainer): number;
@@ -290,11 +293,8 @@ export default class ItemManager extends EntityManager<Item, IItemRemoveOptions>
      * @returns A traslantion for the efficacy or undefined if not enough skill
      */
     getEfficacyTranslation(human: Human, qualityBonus: number, maxQualityBonus: number, recipe: IRecipe, ui?: boolean): TranslationImpl | undefined;
-    updateItems(ticks: number, playerIds: Set<number>, options: {
-        skipHumanItems?: boolean;
-        skipUiUpdates?: boolean;
-    }): boolean;
-    updateItem(ticks: number, item: Item, isInInventory: boolean, skipUiUpdates?: boolean): boolean;
+    updateItems(ticks: number, playerIds: Set<number>, skipHumanItems?: boolean): boolean;
+    updateItem(ticks: number, item: Item, isInInventory: boolean): boolean;
     getPlayerWithItemInInventory(containable: IContainable): Player | undefined;
     getAbsentPlayerWithItemInInventory(containable: IContainable): Player | undefined;
     getNPCWithItemInInventory(containable: IContainable): NPC | undefined;

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

@@ -22,20 +22,20 @@ interface IItemReferenceEvents {
     clear(): void;
 }
 export default class ItemReference extends EventEmitter.Host<IItemReferenceEvents> implements IItemReference, IUnserializedCallback {
-    static get(item?: Item | IItemReference): ItemReference | undefined;
-    static item(item?: Item | IItemReference): Item | undefined;
+    static create(item?: Item | IItemReference): ItemReference | undefined;
     event: IEventEmitter<this, IItemReferenceEvents>;
     private registeredForEvents;
     islandId: IslandId | undefined;
     itemId: number | undefined;
     constructor(item?: Item | IItemReference);
+    dispose(): void;
     raw(): IItemReference;
     onUnserialized(): void;
     get isValid(): boolean;
     get island(): Island | undefined;
     get item(): Item | undefined;
     set(reference?: Item | IItemReference): void;
-    clear(): void;
+    private clear;
     private onItemMovedIsland;
     private onItemRemove;
     onStoppingPlay(): void;

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

@@ -0,0 +1,21 @@
+/*!
+ * Copyright 2011-2024 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 MagicalPropertyType from "@wayward/game/game/magic/MagicalPropertyType";
+export declare enum MagicalLootType {
+    All = 0,
+    High = 1,
+    Low = 2,
+    Medium = 3,
+    VeryHigh = 4,
+    VeryLow = 5
+}
+export declare const magicalLootGroup: Array<Array<[number, MagicalPropertyType | undefined]>>;
+export default magicalLootGroup;