@wayward/types 2.15.5-beta.dev.20260505.1 → 2.15.5-beta.dev.20260512.1

package/definitions/game/game/entity/action/ActionExecutor.d.ts

@@ -26,7 +26,6 @@ import type Translation from "@wayward/game/language/Translation";
 import ActionPacket from "@wayward/game/multiplayer/packets/shared/ActionPacket";
 import type { Direction } from "@wayward/game/utilities/math/Direction";
 import type { IVector3 } from "@wayward/game/utilities/math/IVector";
-import type { IRGB } from "@wayward/utilities/Color";
 import EventEmitter from "@wayward/utilities/event/EventEmitter";
 export default class ActionExecutor<A extends ActionArguments, E extends Entity, R, CU extends IActionUsable, AV extends any[]> extends EventEmitter.Host<ActionExecutorEvents> implements IActionApi<E, CU>, IActionConfirmerApi<E, CU> {
     /**
@@ -123,8 +122,6 @@ export default class ActionExecutor<A extends ActionArguments, E extends Entity,
     setMilestone(milestone: Milestone, data?: number): this;
     setSoundEffect(soundEffect: IActionSoundEffect): this;
     setSoundEffect(type: SfxType, inFront?: boolean): this;
-    setParticle(color: IRGB, inFront?: boolean): this;
-    setParticle(color: IRGB, count?: number, inFront?: boolean): this;
     setParticle(particle: IActionParticle): this;
     addItems(...addItems: Array<Item | undefined>): this;
     canProtectedItemBeUsed(items: IProtectedItems): true | IActionNotUsable;

package/definitions/game/game/entity/action/IAction.d.ts

@@ -42,6 +42,7 @@ import type { TranslationArg } from "@wayward/game/language/ITranslation";
 import type Translation from "@wayward/game/language/Translation";
 import type Message from "@wayward/game/language/dictionary/Message";
 import type { IModdable } from "@wayward/game/mod/ModRegistry";
+import type { ParticlePhysics } from "@wayward/game/renderer/particle/IParticle";
 import type { Direction } from "@wayward/game/utilities/math/Direction";
 import type { IVector2, IVector3 } from "@wayward/game/utilities/math/IVector";
 import type { IRGB } from "@wayward/utilities/Color";
@@ -345,8 +346,6 @@ export interface IActionApi<E extends Entity = Entity, CU extends IActionUsable
      */
     setRuneChance(alignment: ArrayOr<Deity> | undefined, chance: number): this;
     setMilestone(milestone: Milestone, data?: number): this;
-    setParticle(color: IRGB, count?: number, inFront?: boolean): this;
-    setParticle(color: IRGB, inFront?: boolean): this;
     setParticle(particle: IActionParticle): this;
     /**
      * The items passed to this method will be registered as items potentially to be damaged when the action completes.
@@ -423,6 +422,7 @@ export interface IActionParticle {
     color: IRGB;
     tile?: Tile;
     count?: number;
+    physics?: ParticlePhysics;
     inFront?: boolean;
 }
 export interface IActionTargetAdjacent {

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

@@ -429,7 +429,7 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
      */
     resetDecayTime(overrideDefault?: number): void;
     /**
-     * Gets the item's max decay value based on quality. The max number can be modified slightly due to overrideDefault (crafting) and adding fuel which goes over this max.
+     * Gets the item's base max decay value based on quality. The max number can be modified slightly due to overrideDefault (crafting) and adding fuel which goes over this max.
      * @param overrideDefault Override the item's decayMax definition with something else.
      * @param withRandomization True if you want to return a randomized value (useful when setting the value on an item).
      * @returns A number equal to the maximum item decay or `undefined` if the item should not have decay at all.

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

@@ -221,10 +221,7 @@ export default class ItemManager extends EntityManager<Item, IItemRemoveOptions>
     getItemInsertIndexInContainer(container: IContainer, item: Item, sorter?: ISorter<Item | undefined>): number | undefined;
     removeContainerItems(container: IContainer, options?: IItemRemoveOptions): void;
     remove(item: Item, options?: IItemRemoveOptions): void;
-    /**
-     * No need to run special logic when loading items
-     */
-    protected loadEntity: undefined;
+    protected loadEntity(item: Item): void;
     /**
      * For entity manager compat
      */

package/definitions/game/game/tile/Tile.d.ts

@@ -37,6 +37,7 @@ import type { IRendererOrigin } from "@wayward/game/renderer/context/RendererOri
 import { FieldOfView } from "@wayward/game/renderer/fieldOfView/FieldOfView";
 import type { IFieldOfViewOrigin } from "@wayward/game/renderer/fieldOfView/IFieldOfView";
 import { CanASeeBType } from "@wayward/game/renderer/fieldOfView/IFieldOfView";
+import { ParticlePhysics } from "@wayward/game/renderer/particle/IParticle";
 import Debug from "@wayward/game/utilities/dev/Debug";
 import { Direction } from "@wayward/game/utilities/math/Direction";
 import type { IVector2, IVector3 } from "@wayward/game/utilities/math/IVector";
@@ -365,7 +366,7 @@ export default class Tile implements IVector4, Partial<ITileContainer>, IFieldOf
      */
     private canSwitchCave;
     queueSoundEffect(type: SfxType, delay?: number, speed?: number): void;
-    createParticles(particle: IRGB | undefined, count?: number, intensity?: number): void;
+    createParticles(particle: IRGB | undefined, physics?: ParticlePhysics, count?: number, intensity?: number): void;
     /**
      * Finds either lava or water ajacent to either lava or water, and cools the lava down based its findings.
      */

package/definitions/game/renderer/Renderers.d.ts

@@ -13,6 +13,7 @@ import type Island from "@wayward/game/game/island/Island";
 import type { IOverlayInfo } from "@wayward/game/game/tile/ITerrain";
 import type Tile from "@wayward/game/game/tile/Tile";
 import type { RenderSource, UpdateRenderFlag } from "@wayward/game/renderer/IRenderer";
+import { ParticlePhysics } from "@wayward/game/renderer/particle/IParticle";
 import type { Renderer } from "@wayward/game/renderer/Renderer";
 import { RenderersNotifiers } from "@wayward/game/renderer/RenderersNotifiers";
 import type { IVector4 } from "@wayward/game/utilities/math/Vector4";
@@ -24,7 +25,7 @@ export default class Renderers {
     readonly renderers: Set<Renderer>;
     readonly notifier: RenderersNotifiers;
     readonly particle: {
-        create: (tile: Tile, particle: IRGB, count?: number, intensity?: number) => void;
+        create: (tile: Tile, particle: IRGB, count?: number, intensity?: number, physics?: ParticlePhysics) => void;
     };
     getRenderersForObject(object: IVector4): Renderer[];
     getRenderersForIslandId(islandId?: IslandId): Renderer[];

package/definitions/game/renderer/particle/IParticle.d.ts

@@ -10,5 +10,12 @@
  */
 export declare enum ParticleType {
     Fire = 0,
-    Blood = 1
+    Blood = 1,
+    Smoke = 2
+}
+export declare enum ParticlePhysics {
+    Fall = 0,
+    Ember = 1,
+    Explode = 2,
+    Rustle = 3
 }

package/definitions/game/renderer/particle/ParticleSystem.d.ts

@@ -8,6 +8,7 @@
  * 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 { ParticlePhysics } from "@wayward/game/renderer/particle/IParticle";
 import type { WorldRenderer } from "@wayward/game/renderer/world/WorldRenderer";
 import type { IRGB } from "@wayward/utilities/Color";
 import type Tile from "@wayward/game/game/tile/Tile";
@@ -17,7 +18,7 @@ export declare class ParticleSystem {
     private readonly worldRenderer;
     private readonly maxParticles;
     readonly particles: Float32Array;
-    readonly dataPerParticle = 10;
+    readonly dataPerParticle = 12;
     private readonly positionSizeData;
     private readonly colorData;
     private count;
@@ -26,7 +27,7 @@ export declare class ParticleSystem {
     private readonly renderer;
     constructor(context: IRendererContext, worldRenderer: WorldRenderer, maxParticles?: number);
     delete(): void;
-    create(tile: Tile, particle: IRGB, count?: number, intensity?: number): number[] | undefined;
+    create(tile: Tile, particle: IRGB, count?: number, intensity?: number, physics?: ParticlePhysics): number[] | undefined;
     clear(): void;
     /**
      * Updates particles (ticks their life)
@@ -34,6 +35,16 @@ export declare class ParticleSystem {
      */
     private update;
     render(timeStamp: number, x: number, y: number): boolean;
+    private updateParticlePhysics;
+    private updateFallParticle;
+    private updateEmberParticle;
+    private updateExplodeParticle;
     private findUnusedParticle;
+    private getPixelAlignedPosition;
+    private getParticleLifetime;
+    private getParticleFloorY;
+    private getParticleSize;
+    private getParticleVelocityX;
+    private getParticleVelocityY;
     private spawn;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@wayward/types",
 	"description": "TypeScript declarations for Wayward, used for modding.",
-	"version": "2.15.5-beta.dev.20260505.1",
+	"version": "2.15.5-beta.dev.20260512.1",
 	"license": "MIT",
 	"repository": {
 		"type": "git",