@wayward/types 2.13.0-beta.dev.20230422.1 → 2.13.0-beta.dev.20230424.1

package/definitions/game/audio/Music.d.ts

@@ -9,5 +9,4 @@
  * https://github.com/WaywardGame/types/wiki
  */
 import type { Music } from "audio/IAudio";
-import type { IMusicDescription } from "audio/IMusic";
-export declare const musicDescriptions: OptionalDescriptions<Music, IMusicDescription>;
+export declare const musicDescriptions: Map<Music, import("../mod/ModRegistry").IModdable>;

package/definitions/game/audio/SoundEffects.d.ts

@@ -10,4 +10,4 @@
  */
 import { SfxType } from "audio/IAudio";
 import type { ISoundEffectDescription } from "audio/IMusic";
-export declare const soundEffectDescriptions: OptionalDescriptions<SfxType, ISoundEffectDescription>;
+export declare const soundEffectDescriptions: Map<SfxType, ISoundEffectDescription>;

package/definitions/game/game/Game.d.ts

@@ -119,6 +119,7 @@ export declare class Game extends EventEmitter.Host<IGameEvents> {
      */
     getPlayingHumans(includeGhosts?: boolean, includeConnecting?: boolean, includeDedicatedServer?: boolean, includeAbsent?: boolean): Human[];
     getNonPlayerHumans(): Human[];
+    getPlayingHuman(identifier: string): Human<number> | undefined;
     initializeRenderer(): void;
     /**
      * It's important that this is lowest, so that it happens after modManager's globalSlotReady event

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

@@ -300,7 +300,7 @@ export default class Doodad extends Entity<IDoodadDescription, DoodadType, Dooda
      * @param item The item that is being added to the bookcase.
      * @param add True if adding score, false if you are substracting.
      */
-    updateBookcase(item: Item, add: boolean): void;
+    updateBookcase(items: Item[], add: boolean): void;
     /**
      * Determines which graphic to show based on how full the bookcase is with books/text.
      * @param item set to true if DisplayableItemType is to be returned.

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

@@ -39,9 +39,9 @@ export interface IDoodadManagerEvents {
     remove(doodad: Doodad): any;
 }
 export default class DoodadManager extends ObjectManager<Doodad, IDoodadManagerEvents> {
-    private static cachedBestDoodadForTier;
-    private static cachedGroups;
-    static cachedDoodadSpawns: OptionalDescriptions<BiomeType, OptionalDescriptions<WorldZ, OptionalDescriptions<TerrainType, DoodadType[]>>>;
+    private static readonly cachedBestDoodadForTier;
+    private static readonly cachedDoodadGroups;
+    static readonly cachedDoodadSpawns: Map<BiomeType, Map<WorldZ, Map<TerrainType, Set<DoodadType>>>>;
     private readonly scarecrows;
     static getBestDoodadForTier(doodad: DoodadType | DoodadTypeGroup): DoodadType | undefined;
     static generateLookups(): void;
@@ -55,7 +55,6 @@ export default class DoodadManager extends ObjectManager<Doodad, IDoodadManagerE
      * @returns true or false depending on if the number is a DoodadType or DoodadTypeExtra.
      */
     static isDoodadExtra(type: number): type is DoodadTypeExtra;
-    static getGroupDoodads(doodadGroup: DoodadTypeGroup): Set<DoodadType>;
     static getDoodadTypeGroupName(doodadType: DoodadType | DoodadTypeGroup, article?: Article, count?: number): Translation;
     /**
      * Note: This can be called multiple times in the same game depending on loading/unloading of islands

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

@@ -188,8 +188,8 @@ export interface IDoodadDescription extends IObjectDescription, IModdable, ICaus
      */
     getAssociatedItem?(doodad: Doodad): ItemType | ItemTypeExtra | undefined;
     getVariation?(island: Island, tile: Tile, doodad: Doodad | undefined, existingVariationX: number, existingVariationY: number): [number, number] | undefined;
-    onContainerItemAdd?(container: Doodad & IContainer, item: Item): void;
-    onContainerItemRemove?(container: Doodad & IContainer, item: Item): void;
+    onContainerItemAdd?(container: Doodad & IContainer, items: Item[]): void;
+    onContainerItemRemove?(container: Doodad & IContainer, items: Item[]): void;
     /**
      * Item groups of this type in the container will provide skill bonuses to adjacent players.
      */

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

@@ -18,6 +18,7 @@ import type EntityWithStats from "game/entity/EntityWithStats";
 import type Human from "game/entity/Human";
 import type { IEntityConstructorOptions, IEntityEvents } from "game/entity/IEntity";
 import { EntityType } from "game/entity/IEntity";
+import type { IHumanBound } from "game/entity/IEntityManager";
 import type Creature from "game/entity/creature/Creature";
 import type Corpse from "game/entity/creature/corpse/Corpse";
 import type NPC from "game/entity/npc/NPC";
@@ -41,6 +42,7 @@ export default abstract class Entity<DescriptionType = unknown, TypeType extends
     id: number;
     type: TypeType;
     referenceId?: number;
+    private _humansVisible;
     renamed?: string | ISerializedTranslation;
     x: number;
     y: number;
@@ -93,7 +95,8 @@ export default abstract class Entity<DescriptionType = unknown, TypeType extends
     clearTileCache(): void;
     isNearby(entity: Entity<DescriptionType>): boolean;
     isInFov(): boolean;
-    setInFov(inFov: boolean): void;
+    setInFov(inFov: boolean, humansWithinBound: IHumanBound[]): void;
+    humansVisible(): Human[];
     isOnFire(): FireType;
     queueSoundEffect(type: SfxType, delay?: number, speed?: number): void;
     updateRender(source: RenderSource, flag: UpdateRenderFlag): void;

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

@@ -49,23 +49,23 @@ export interface IHumanEvents extends Events<EntityWithStats>, ISkillEvents {
     restEnd(restData: IRestData): any;
     /**
      * Called when an item is added to the player's inventory
-     * @param item The item object
-     * @param container The container object the item was added to. This container might be inventory or a container within the inventory.
+     * @param item The items
+     * @param container The container object the items were added to. This container might be inventory or a container within the inventory.
      */
-    inventoryItemAdd(item: Item, container: IContainer): any;
+    inventoryItemAdd(items: Item[], container: IContainer): any;
     /**
      * Called when an item is removed from the players inventory
-     * @param item The item object
-     * @param container The container object the item was moved to.
+     * @param item The items
+     * @param container The container object the items were moved to.
      */
-    inventoryItemRemove(item: Item, container: IContainer): any;
+    inventoryItemRemove(items: Item[], container: IContainer): any;
     /**
      * Called when an item is moved from one container to another, while still in the players inventory.
-     * @param item The item object
-     * @param container The container object the item was moved to. This container might be inventory or a container within the inventory.
-     * @param previousContainer The container object the item was moved from. This container might be inventory or a container within the inventory.
+     * @param items The items
+     * @param container The container object the items were moved to. This container might be inventory or a container within the inventory.
+     * @param previousContainer The container object the items were moved from. This container might be inventory or a container within the inventory.
      */
-    inventoryItemUpdate(item: Item, container: IContainer, previousContainer?: IContainer): any;
+    inventoryItemUpdate(items: Item[], container: IContainer, previousContainer?: IContainer): any;
     /**
      * Called when the human equips an item to a slot
      * @param item The item being equipped

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

@@ -12,8 +12,11 @@ import { Action } from "game/entity/action/Action";
 import type { IActionUsable } from "game/entity/action/IAction";
 import { ActionArgument } from "game/entity/action/IAction";
 import type Creature from "game/entity/creature/Creature";
+import type Human from "game/entity/Human";
+import { AiType } from "game/entity/IEntity";
 export interface ISetCreatureAiCanUse extends IActionUsable {
     creature: Creature;
 }
-declare const _default: Action<[ActionArgument.Integer32], import("../../Human").default<number>, void, ISetCreatureAiCanUse, [number]>;
+export declare function hasSkillToSetCreatureAi(human: Human, ai: AiType): boolean;
+declare const _default: Action<[ActionArgument.Integer32], Human<number>, void, ISetCreatureAiCanUse, [number]>;
 export default _default;

package/definitions/game/game/entity/action/usable/IUsableAction.d.ts

@@ -236,7 +236,7 @@ export interface IUsableActionDefinitionSubmenu<REQUIREMENTS extends IUsableActi
 }
 export interface IUsableActionDefinitionExecutable<REQUIREMENTS extends IUsableActionRequirements = IUsableActionRequirements> extends IUsableActionDefinitionBase<REQUIREMENTS> {
     slottable?: boolean;
-    discoveredByDefault?: true;
+    discoveredByDefault?: true | (() => boolean);
     submenu?: undefined;
     forceDisplayWhenEmpty?: undefined;
     execute(player: Player, using: IUsableActionUsing<REQUIREMENTS>, context: IUsableActionExecutionContext): any;

package/definitions/game/game/entity/action/usable/UsableActionType.d.ts

@@ -81,6 +81,7 @@ export declare enum UsableActionTypePlaceholder {
     MoveAllToInventory = 200001,
     MoveAllOfSameQualityToInventory = 200002,
     Paddle = 200003,
-    Operate = 200004
+    Operate = 200004,
+    SwimToIsland = 200005
 }
 export declare const usableActionDescriptions: PartialRecord<UsableActionType | UsableActionTypePlaceholder, IModdable>;

package/definitions/game/game/entity/action/usable/actions/UsableActionsDynamic.d.ts

@@ -12,14 +12,16 @@ import type { ActionDisplayLevel } from "game/entity/action/IAction";
 import { ActionType } from "game/entity/action/IAction";
 import type { IUsableActionPossibleUsing, IUsableActionRequirements, IUsableActionUsing, ReturnableUsableActionUsability, UsableActionIconReference } from "game/entity/action/usable/IUsableAction";
 import { UsableActionGenerator } from "game/entity/action/usable/UsableActionRegistrar";
+import type { UsableActionTranslator } from "game/entity/action/usable/UsableActionTranslator";
 import type Player from "game/entity/player/Player";
 import type Bindable from "ui/input/Bindable";
 export interface IUsableActionDynamicDefinition {
-    icon?: UsableActionIconReference;
+    icon?: SupplierOr<UsableActionIconReference>;
     bindable: Bindable;
     displayLevel?: ActionDisplayLevel;
     priority?: number;
     discoveredByDefault?: true;
+    translate?: (translator: UsableActionTranslator) => UsableActionTranslator;
 }
 export interface IUsableActionsDynamicConfig<DEFINITION extends IUsableActionDynamicDefinition, REQUIREMENTS extends IUsableActionRequirements> {
     id: string;

package/definitions/game/game/entity/npc/npcs/Merchant.d.ts

@@ -24,9 +24,16 @@ export interface IMerchantBuyPrice {
     bonus: number;
     total: number;
 }
+export declare enum MerchantCustomerKnowledgeState {
+    None = 0,
+    KnowsOfNewStock = 1,
+    HasSeenInventory = 2
+}
 export default class MerchantNPC extends NPC {
     credit: Record<string, number>;
+    customerKnowledge: Map<string, MerchantCustomerKnowledgeState>;
     constructor(options?: INPCConstructorOptions);
+    knowsOfUnseenStock(customer: Human): boolean;
     getCustomerCredit(customer: Human): number;
     modifyCustomerCredit(customer: Human, creditChange: number): number;
     getActions(): ActionType[] | undefined;

package/definitions/game/game/entity/player/Customizations.d.ts

@@ -9,11 +9,11 @@
  * https://github.com/WaywardGame/types/wiki
  */
 import type { ICharacter, IColorDescription, ICustomizations, IHairstyleDescription } from "game/entity/IHuman";
-import { HairStyle } from "game/entity/IHuman";
+import { HairColor, HairStyle, SkinColor } from "game/entity/IHuman";
 import type { Random } from "utilities/random/Random";
-export declare const hairstyleDescriptions: OptionalDescriptions<HairStyle, IHairstyleDescription>;
-export declare const hairColorDescriptions: Record<number, IColorDescription | undefined>;
-export declare const skinColorDescriptions: Record<number, IColorDescription | undefined>;
+export declare const hairstyleDescriptions: Map<HairStyle, IHairstyleDescription>;
+export declare const hairColorDescriptions: Map<HairColor, IColorDescription>;
+export declare const skinColorDescriptions: Map<SkinColor, IColorDescription>;
 export declare function generateRandomCustomization(random: Random): ICustomizations;
 export declare function generateRandomCharacter(random: Random): ICharacter;
 export declare enum ColorType {

package/definitions/game/game/entity/player/IMessageManager.d.ts

@@ -11,6 +11,7 @@
 import type Stream from "@wayward/goodstream";
 import type Human from "game/entity/Human";
 import type Island from "game/island/Island";
+import type Dictionary from "language/Dictionary";
 import type { ISerializedTranslation, TranslationArg } from "language/ITranslation";
 import type Translation from "language/Translation";
 import type Message from "language/dictionary/Message";
@@ -127,6 +128,7 @@ export interface IMessageManager {
      * Signal that the message was sent to everyone
      */
     sentToAll(sentToAll?: boolean): this;
+    upgrade(id: `${keyof typeof Dictionary}:${string}`, dictionary: Dictionary, entry: number): this;
 }
 export interface IMessageHistoryItem {
     id: number;

package/definitions/game/game/entity/player/MessageManager.d.ts

@@ -14,6 +14,7 @@ import type { IMessage, IMessageHistoryItem, IMessageManager, IPackedMessage } f
 import { MessageType, Source } from "game/entity/player/IMessageManager";
 import type Player from "game/entity/player/Player";
 import type Island from "game/island/Island";
+import type Dictionary from "language/Dictionary";
 import Message from "language/dictionary/Message";
 import type { TranslationArg } from "language/ITranslation";
 import Translation from "language/Translation";
@@ -33,6 +34,7 @@ export declare class MessageManagerNoOp implements IMessageManager {
     sentToAll(sentToAll?: boolean): this;
     pruneMessageHistory(isLocalPlayer: boolean): boolean;
     addToHistory(messageHistoryItem: IMessageHistoryItem): void;
+    upgrade(): this;
 }
 export interface IMessageManagerOptions {
     shouldDisplayMessage(message: IMessage, id: number): boolean | undefined;
@@ -123,4 +125,5 @@ export default class MessageManager implements IMessageManager {
      */
     sentToAll(sentToAll?: boolean): this;
     private reset;
+    upgrade(id: `${keyof typeof Dictionary}:${string}`, dictionary: Dictionary, entry: number): this;
 }

package/definitions/game/game/entity/player/note/NoteManager.d.ts

@@ -16,7 +16,7 @@ import { HelpArticle } from "ui/screen/screens/menu/menus/help/HelpArticleDescri
 export interface INoteDescription extends IModdable {
     learnMore?: HelpArticle;
 }
-export declare const noteDescriptions: OptionalDescriptions<Note, INoteDescription>;
+export declare const noteDescriptions: Map<Note, INoteDescription>;
 export type Time = PartOfDay | string;
 export interface INote {
     id: keyof typeof Note;

package/definitions/game/game/entity/player/quest/Quests.d.ts

@@ -10,5 +10,4 @@
  */
 import { QuestType } from "game/entity/player/quest/quest/IQuest";
 import type { Quest } from "game/entity/player/quest/quest/Quest";
-declare const quests: OptionalDescriptions<QuestType, Quest>;
-export default quests;
+export declare const questDescriptions: Map<QuestType, Quest>;

package/definitions/game/game/entity/player/quest/quest/Challenge.d.ts

@@ -8,13 +8,14 @@
  * 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 { CreatureType } from "game/entity/creature/ICreature";
 import type { RequirementInstance } from "game/entity/player/quest/quest/Quest";
 import { Quest } from "game/entity/player/quest/quest/Quest";
 import type { QuestInstance } from "game/entity/player/quest/QuestManager";
 import type { IQuestRequirement } from "game/entity/player/quest/requirement/IRequirement";
 import type Island from "game/island/Island";
 export default class Challenge extends Quest {
-    static getCreaturesOfRequirements(): any[];
+    static getCreaturesOfRequirements(): CreatureType[];
     private static readonly possibleRequirements;
     /**
      * These are the only items that can be requested to collect

package/definitions/game/game/entity/player/quest/quest/Quest.d.ts

@@ -46,7 +46,7 @@ export declare class Quest extends EventEmitter.Host<IQuestEvents> {
     getRequirements(host: Player, instance: IQuest): RequirementInstance[];
     getRequirement(host: Player, quest: IQuest, requirement: IQuestRequirement): RequirementInstance | undefined;
     needsManualCompletion(): boolean;
-    protected createRequirements(island: Island): IQuestRequirement<any[], {}>[];
+    protected createRequirements(island: Island): IQuestRequirement[];
     protected createRequirement<R extends QuestRequirementType>(type: R, ...options: RequirementArgs<R>): IQuestRequirement<RequirementArgs<R>>;
 }
 export declare class RequirementInstance extends EventEmitter.Host<IQuestRequirementEvents> {

package/definitions/game/game/inspection/handlers/TilePositionInspection.d.ts

@@ -31,7 +31,7 @@ export default class TilePositionInspection extends InspectionsHandler {
     protected onTileEventMove(tileEvent: TileEvent): void;
     protected onTileEventCreate(_: any, tileEvent: TileEvent): void;
     protected onItemCreate(_: any, item: Item): void;
-    protected onItemMove(_: any, _item: Item, containerFrom: IContainer | undefined, _containerFromTile: Tile | undefined, containerTo: IContainer): void;
+    protected onItemMove(_: any, _items: Item[], containerFrom: IContainer | undefined, _containerFromTile: Tile | undefined, containerTo: IContainer): void;
     protected onCorpseCreate(_: any, corpse: Corpse): void;
     protected onDoodadCreate(_: any, doodad: Doodad): void;
     private updateInspectionsForEntity;

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

@@ -25,6 +25,6 @@ export default class CivilizationInfoProvider extends InfoProvider {
     getDefaultDisplayLevel(): InfoDisplayLevel;
     hasContent(): boolean;
     get(): LabelledValue;
-    protected onItemMove(_: any, item: Item, previousContainer: IContainer | undefined, _previousContainerTile: Tile | undefined, newContainer: IContainer): void;
+    protected onItemMove(_: any, items: Item[], previousContainer: IContainer | undefined, _previousContainerTile: Tile | undefined, newContainer: IContainer): void;
     private getCivilizationScore;
 }

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

@@ -24,5 +24,5 @@ export default class ContainedItemsInfoProvider extends InfoProvider {
     getDefaultDisplayLevel(): InfoDisplayLevel;
     hasContent(): boolean;
     get(): LabelledValue;
-    protected onItemMove(_: any, item: Item, previousContainer: IContainer | undefined, _previousContainerTile: Tile | undefined, newContainer: IContainer): void;
+    protected onItemMove(_: any, items: Item[], previousContainer: IContainer | undefined, _previousContainerTile: Tile | undefined, newContainer: IContainer): void;
 }

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

@@ -25,5 +25,5 @@ export default class DoodadSkillInfoProvider extends InfoProvider {
     getDefaultDisplayLevel(): InfoDisplayLevel;
     hasContent(): boolean;
     get(): LabelledValue;
-    protected onItemMove(_: any, item: Item, previousContainer: IContainer | undefined, _previousContainerTile: Tile | undefined, newContainer: IContainer): void;
+    protected onItemMove(_: any, items: Item[], previousContainer: IContainer | undefined, _previousContainerTile: Tile | undefined, newContainer: IContainer): void;
 }

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

@@ -9,13 +9,13 @@
  * https://github.com/WaywardGame/types/wiki
  */
 import type { BiomeType } from "game/biome/IBiome";
-import type Doodad from "game/doodad/Doodad";
 import type Creature from "game/entity/creature/Creature";
 import type { CreatureType, IDamageOutcome, IDamageOutcomeInput } from "game/entity/creature/ICreature";
 import type Human from "game/entity/Human";
 import type { DamageType, Defense } from "game/entity/IEntity";
 import type NPC from "game/entity/npc/NPC";
 import type { IIslandTemplate, TickFlag, TileUpdateType } from "game/IGame";
+import type Port from "game/island/Port";
 import type { MultiplayerLoadingDescription } from "game/meta/Loading";
 import type { TerrainType } from "game/tile/ITerrain";
 import type Tile from "game/tile/Tile";
@@ -86,9 +86,8 @@ export interface IIslandEvents {
     rename(human: Human, newName?: string, oldName?: string): any;
     /**
      * Emitted when island ports have changed
-     * @param doodad Doodad that caused the change
      */
-    portsChanged(doodad: Doodad): any;
+    portsChanged(addedPort?: Port, removedPort?: Port): any;
     getDefense(defense: Defense | undefined, target: Human | Creature | CreatureType, damageType?: DamageType): Defense | undefined;
     calculateAttackOutcome(damageOutcome: IDamageOutcome, input: IDamageOutcomeInput, attackValue: number, defenseValue: number): IDamageOutcome | undefined;
 }

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

@@ -15,7 +15,6 @@ import { TickFlag, TileUpdateType } from "game/IGame";
 import { Quality } from "game/IObject";
 import type { BiomeTypes } from "game/biome/IBiome";
 import type { ITemplateBiomeOptions } from "game/biome/template/Template";
-import type Doodad from "game/doodad/Doodad";
 import DoodadManager from "game/doodad/DoodadManager";
 import Human from "game/entity/Human";
 import type { SkillType } from "game/entity/IHuman";
@@ -25,8 +24,9 @@ import type { IDamageInfo, IDamageOutcome, IDamageOutcomeInput } from "game/enti
 import CorpseManager from "game/entity/creature/corpse/CorpseManager";
 import FlowFieldManager from "game/entity/flowfield/FlowFieldManager";
 import NPCManager from "game/entity/npc/NPCManager";
-import type { IIslandEvents, IIslandLoadOptions, IIslandPort, IMobCheck, ISeeds, IWaterContamination, IWaterFill, IWell, IslandId } from "game/island/IIsland";
+import type { IIslandEvents, IIslandLoadOptions, IMobCheck, ISeeds, IWaterContamination, IWaterFill, IWell, IslandId } from "game/island/IIsland";
 import { WaterType } from "game/island/IIsland";
+import { PortManager } from "game/island/Port";
 import type { ILiquidGather } from "game/item/IItem";
 import type { IRequirementInfo } from "game/item/IItemManager";
 import ItemManager from "game/item/ItemManager";
@@ -69,9 +69,12 @@ export default class Island extends EventEmitter.Host<IIslandEvents> implements
     readonly flowFieldManager: FlowFieldManager;
     readonly items: ItemManager;
     readonly npcs: NPCManager;
+    readonly ports: PortManager;
     readonly temperature: TemperatureManager;
     readonly tileEvents: TileEventManager;
     readonly time: TimeManager;
+    saveVersion: string;
+    saveBuildTime?: number;
     biomeType: BiomeTypes;
     civilizationScore: number;
     civilizationScoreTiles: Record<number, number>;
@@ -81,11 +84,9 @@ export default class Island extends EventEmitter.Host<IIslandEvents> implements
     name?: string;
     position: IVector2;
     readonly mapSize: number;
-    readonly ports: Map<number, IIslandPort>;
     readonly treasureMaps: DrawnMap[];
     readonly wellData: SaferNumberIndexedObject<IWell>;
     referenceId?: number;
-    saveVersion: string;
     templateBiomeOptions: ITemplateBiomeOptions | undefined;
     tileContainers: ITileContainer[];
     version: string;
@@ -263,6 +264,4 @@ 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;
-    addIslandPort(doodad: Doodad): void;
-    removeIslandPort(doodad: Doodad): boolean;
 }

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

@@ -38,7 +38,7 @@ export default class IslandManager extends Map<IslandId, Island> {
      * Gets an island by id. Try to use "get" instead!
      * @returns Island or undefined if it does not exist
      */
-    getIfExists(islandId: IslandId): Island | undefined;
+    getIfExists(islandId?: IslandId): Island | undefined;
     /**
      * Gets an island by position
      */

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

@@ -0,0 +1,43 @@
+/*!
+ * Copyright 2011-2021 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 "game/doodad/Doodad";
+import type { IslandId } from "game/island/IIsland";
+import type Island from "game/island/Island";
+import type { Reference, ReferenceType } from "game/reference/IReferenceManager";
+import { type ISerializedTranslation } from "language/ITranslation";
+import TranslationImpl from "language/impl/TranslationImpl";
+import { type ISerializer, type IUnserializedCallback } from "save/serializer/ISerializer";
+import type { IVector3 } from "utilities/math/IVector";
+interface IPort {
+    id: number;
+    islandId: IslandId;
+    renamed?: string | ISerializedTranslation;
+    name: ISerializedTranslation;
+    position: IVector3;
+    doodadRef?: Reference<ReferenceType.Doodad>;
+}
+interface Port extends Readonly<IPort> {
+}
+declare class Port {
+    static fromDoodad(doodad: Doodad): Port;
+    constructor(port: IPort);
+    get doodad(): Doodad | undefined;
+    get island(): Island | undefined;
+    getName(): TranslationImpl;
+}
+export default Port;
+export declare class PortManager extends Map<number, Port> implements IUnserializedCallback {
+    private readonly island;
+    constructor(island: Island);
+    onUnserialized(serializer: ISerializer): void;
+    register(doodad: Doodad): void;
+    deregister(doodad: Doodad): boolean;
+}

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

@@ -20,7 +20,7 @@ import type { Stat } from "game/entity/IStats";
 import type { IDecayTemperatureRange } from "game/IGame";
 import type { IObjectDescription, Quality } from "game/IObject";
 import type { IslandId } from "game/island/IIsland";
-import type { IAddToContainerOptions } from "game/item/IItemManager";
+import type { IMoveItemOptions } from "game/item/IItemManager";
 import type Item from "game/item/Item";
 import type Recipe from "game/item/recipe/Recipe";
 import type MagicalPropertyManager from "game/magic/MagicalPropertyManager";
@@ -142,6 +142,11 @@ export interface IItemDescription extends IObjectDescription, IModdable, ITemper
     use?: ActionType[];
     ranged?: IRanged;
     recipe?: IRecipe;
+    /**
+     * A list of groups the item should belong too.
+     * Do not use this during runtime - use itemManager.getGroups instead!
+     */
+    group?: ItemTypeGroup[];
     /**
      * A list of recipes that have this item as an output.
      *
@@ -289,8 +294,8 @@ export interface IItemDescription extends IObjectDescription, IModdable, ITemper
     displayItem?: SupplierOr<DisplayableItemType | undefined, [Item]>;
     onEquip?(item: Item): void;
     onUnequip?(item: Item): void;
-    onContainerItemAdd?(container: Item & IContainer, item: Item): void;
-    onContainerItemRemove?(container: Item & IContainer, item: Item): void;
+    onContainerItemAdd?(container: Item & IContainer, items: Item[]): void;
+    onContainerItemRemove?(container: Item & IContainer, items: Item[]): void;
     onCreate?(item: Item): void;
     onChangeInto?(item: Item, fromItemType: ItemType): void;
 }
@@ -449,7 +454,7 @@ export interface IMoveToTileOptions {
     toTile: Tile;
     toTileApplyPlayerOffset?: boolean;
     toContainer?: IContainer;
-    toContainerOptions?: IAddToContainerOptions;
+    toContainerOptions?: IMoveItemOptions;
     beforeMovement?: IMoveToTileBeforeMovementOptions;
     extinguishTorches?: boolean;
     /**
@@ -554,8 +559,11 @@ export interface IDismantleItemDescription {
     transferDecay?: boolean;
 }
 export interface IItemGroupDescription {
-    types: Array<ItemType | ItemTypeGroup>;
     default: ItemType | ItemTypeGroup;
+    /**
+     * An array of additional Item types / group's that should be added to this one during lookup generation.
+     */
+    types?: Array<ItemType | ItemTypeGroup>;
     /**
      * Whether this group is hidden to the player. Defaults to `false`
      */

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

@@ -89,10 +89,20 @@ export interface IDoodadsUsed {
     doodad: Doodad;
     group: DoodadType | DoodadTypeGroup;
 }
-export interface IAddToContainerOptions {
+export interface IMoveItemOptions {
+    onMoveItem?: (item: Item) => void;
+    filter?: {
+        itemType?: ItemType;
+        itemQuality?: Quality;
+        filterText?: string;
+    };
     skipMessage?: boolean;
-    skipUpdateTables?: boolean;
+    skipSound?: boolean;
     skipTileUpdate?: boolean;
+    skipUpdateTables?: boolean;
+    skipWeightChecks?: boolean;
+    suspendNotifier?: boolean;
+    moveToTileOptions?: IMoveToTileOptions;
 }
 export interface IPlaceOnTileOptions {
     force?: boolean;
@@ -124,3 +134,7 @@ export interface ICraftResultChances {
 export declare namespace ICraftResultChances {
     const NEVER: Readonly<ICraftResultChances>;
 }
+export interface IAddToContainerResult {
+    itemsMoved: Item[];
+    noMoreRoomForItems: Item[];
+}

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

@@ -8,8 +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 { IItemDescription, IItemGroupDescription, IRecipeComponent, ItemTypeGroup } from "game/item/IItem";
-import type { ItemType } from "game/item/IItem";
+import type { IItemDescription, IItemGroupDescription, IRecipeComponent } from "game/item/IItem";
+import type { ItemType, ItemTypeGroup } from "game/item/IItem";
 export declare const itemDescriptions: Descriptions<ItemType, IItemDescription>;
 export declare const itemGroupDescriptions: Descriptions<ItemTypeGroup, IItemGroupDescription>;
 export declare function RecipeComponent(type: ItemType | ItemTypeGroup, requiredAmount: number, consumedAmount: number, disassembleAmount?: number, ignoreWeight?: boolean, tileEventByProduct?: boolean): IRecipeComponent;

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

@@ -39,8 +39,8 @@ export default class ItemFinder extends EventEmitter.Host<IItemFinderEvents> {
     markDirty(): void;
     private compute;
     protected onItemStateChange(item: Item): void;
-    protected onContainerItemAdd(items: ItemManager, itemAdded: Item, containerAddedTo: IContainer): void;
-    protected onContainerItemRemove(items: ItemManager, itemRemoved: Item, containerRemovedFrom?: IContainer): void;
+    protected onContainerItemAdd(items: ItemManager, itemsAdded: Item[], containerAddedTo: IContainer): void;
+    protected onContainerItemRemove(items: ItemManager, itemsRemoved: Item[], containerRemovedFrom?: IContainer): void;
     protected onLoadOnIsland(player: Player): void;
     private trackContainer;
     private untrackContainer;