@hylithiumjs.com/core 1.4.3 → 1.4.5

package/dist/index.d.ts

@@ -31,13 +31,14 @@ export declare const ReputationGroup: any;
 export declare const ReputationRequirement: any;
 export declare const ReputationDataResource: any;
 export declare const BlockModule: any;
-import type { ChunkUtilStatic as ChunkUtilStaticType, SimpleItemContainerConstructor, ItemContainerState as ItemContainerStateType, ChestHelper as ChestHelperType, PlayerHelper as PlayerHelperType } from "./types";
+import type { ChunkUtilStatic as ChunkUtilStaticType, SimpleItemContainerConstructor, ItemContainerState as ItemContainerStateType, ChestHelper as ChestHelperType, PlayerHelper as PlayerHelperType, NPCHelper as NPCHelperType } from "./types";
 export declare const ChunkUtil: ChunkUtilStaticType;
 export declare const SimpleItemContainer: SimpleItemContainerConstructor;
 export declare const ItemContainerState: ItemContainerStateType;
 export declare const chestHelper: ChestHelperType;
 export declare const playerHelper: PlayerHelperType;
-export type { ChestHelper, PlayerHelper, PlayerGameMode } from "./types";
+export declare const npcHelper: NPCHelperType;
+export type { ChestHelper, PlayerHelper, NPCHelper, PlayerGameMode } from "./types";
 export declare const handlers: EventHandler[];
 export declare function EventListener(eventType: EventType): (target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,cAAc,IAAI,kBAAkB,EACpC,YAAY,IAAI,gBAAgB,EAChC,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAGjB,eAAO,MAAM,cAAc,EAAyC,kBAAkB,CAAC;AAGvF,eAAO,MAAM,KAAK,EAAuC,gBAAgB,CAAC;AAC1E,eAAO,MAAM,YAAY,EAAuC,uBAAuB,CAAC;AAGxF,OAAO,EAAE,gBAAgB,EAAE,cAAc,IAAI,kBAAkB,EAAE,eAAe,IAAI,mBAAmB,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC;AACjM,eAAO,MAAM,SAAS,EAAoC,gBAAgB,CAAC;AAC3E,eAAO,MAAM,cAAc,EAAyC,kBAAkB,CAAC;AAGvF,eAAO,MAAM,eAAe,EAA0C;IAAE,GAAG,IAAI,mBAAmB,CAAA;CAAE,CAAC;AACrG,eAAO,MAAM,gBAAgB,EAA2C;IAAE,GAAG,IAAI,oBAAoB,CAAA;CAAE,CAAC;AACxG,eAAO,MAAM,UAAU,EAAqC;IAAE,GAAG,IAAI,cAAc,CAAA;CAAE,CAAC;AAGtF,eAAO,MAAM,mBAAmB,KAA0C,CAAC;AAC3E,eAAO,MAAM,mBAAmB,KAA0C,CAAC;AAC3E,eAAO,MAAM,aAAa,KAAoC,CAAC;AAC/D,eAAO,MAAM,mBAAmB,KAA0C,CAAC;AAC3E,eAAO,MAAM,yBAAyB,KAAgD,CAAC;AACvF,eAAO,MAAM,oBAAoB,KAA2C,CAAC;AAG7E,eAAO,MAAM,SAAS,KAAgC,CAAC;AACvD,eAAO,MAAM,eAAe,KAAsC,CAAC;AACnE,eAAO,MAAM,eAAe,KAAsC,CAAC;AAGnE,eAAO,MAAM,iBAAiB,KAAwC,CAAC;AACvE,eAAO,MAAM,cAAc,KAAqC,CAAC;AACjE,eAAO,MAAM,eAAe,KAAsC,CAAC;AACnE,eAAO,MAAM,qBAAqB,KAA4C,CAAC;AAC/E,eAAO,MAAM,sBAAsB,KAA6C,CAAC;AAGjF,eAAO,MAAM,WAAW,KAAkC,CAAC;AAG3D,OAAO,KAAK,EACV,eAAe,IAAI,mBAAmB,EACtC,8BAA8B,EAC9B,kBAAkB,IAAI,sBAAsB,EAC5C,WAAW,IAAI,eAAe,EAC9B,YAAY,IAAI,gBAAgB,EACjC,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,SAAS,EAAoC,mBAAmB,CAAC;AAC9E,eAAO,MAAM,mBAAmB,EAA8C,8BAA8B,CAAC;AAC7G,eAAO,MAAM,kBAAkB,EAA6C,sBAAsB,CAAC;AAGnG,eAAO,MAAM,WAAW,EAAsC,eAAe,CAAC;AAG9E,eAAO,MAAM,YAAY,EAAuC,gBAAgB,CAAC;AAGjF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzE,eAAO,MAAM,QAAQ,EAAE,YAAY,EAAwE,CAAC;AAE5G,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,IAC/B,QAAQ,OAAO,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAOtF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,cAAc,IAAI,kBAAkB,EACpC,YAAY,IAAI,gBAAgB,EAChC,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAGjB,eAAO,MAAM,cAAc,EAAyC,kBAAkB,CAAC;AAGvF,eAAO,MAAM,KAAK,EAAuC,gBAAgB,CAAC;AAC1E,eAAO,MAAM,YAAY,EAAuC,uBAAuB,CAAC;AAGxF,OAAO,EAAE,gBAAgB,EAAE,cAAc,IAAI,kBAAkB,EAAE,eAAe,IAAI,mBAAmB,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC;AACjM,eAAO,MAAM,SAAS,EAAoC,gBAAgB,CAAC;AAC3E,eAAO,MAAM,cAAc,EAAyC,kBAAkB,CAAC;AAGvF,eAAO,MAAM,eAAe,EAA0C;IAAE,GAAG,IAAI,mBAAmB,CAAA;CAAE,CAAC;AACrG,eAAO,MAAM,gBAAgB,EAA2C;IAAE,GAAG,IAAI,oBAAoB,CAAA;CAAE,CAAC;AACxG,eAAO,MAAM,UAAU,EAAqC;IAAE,GAAG,IAAI,cAAc,CAAA;CAAE,CAAC;AAGtF,eAAO,MAAM,mBAAmB,KAA0C,CAAC;AAC3E,eAAO,MAAM,mBAAmB,KAA0C,CAAC;AAC3E,eAAO,MAAM,aAAa,KAAoC,CAAC;AAC/D,eAAO,MAAM,mBAAmB,KAA0C,CAAC;AAC3E,eAAO,MAAM,yBAAyB,KAAgD,CAAC;AACvF,eAAO,MAAM,oBAAoB,KAA2C,CAAC;AAG7E,eAAO,MAAM,SAAS,KAAgC,CAAC;AACvD,eAAO,MAAM,eAAe,KAAsC,CAAC;AACnE,eAAO,MAAM,eAAe,KAAsC,CAAC;AAGnE,eAAO,MAAM,iBAAiB,KAAwC,CAAC;AACvE,eAAO,MAAM,cAAc,KAAqC,CAAC;AACjE,eAAO,MAAM,eAAe,KAAsC,CAAC;AACnE,eAAO,MAAM,qBAAqB,KAA4C,CAAC;AAC/E,eAAO,MAAM,sBAAsB,KAA6C,CAAC;AAGjF,eAAO,MAAM,WAAW,KAAkC,CAAC;AAG3D,OAAO,KAAK,EACV,eAAe,IAAI,mBAAmB,EACtC,8BAA8B,EAC9B,kBAAkB,IAAI,sBAAsB,EAC5C,WAAW,IAAI,eAAe,EAC9B,YAAY,IAAI,gBAAgB,EAChC,SAAS,IAAI,aAAa,EAC3B,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,SAAS,EAAoC,mBAAmB,CAAC;AAC9E,eAAO,MAAM,mBAAmB,EAA8C,8BAA8B,CAAC;AAC7G,eAAO,MAAM,kBAAkB,EAA6C,sBAAsB,CAAC;AAGnG,eAAO,MAAM,WAAW,EAAsC,eAAe,CAAC;AAG9E,eAAO,MAAM,YAAY,EAAuC,gBAAgB,CAAC;AAGjF,eAAO,MAAM,SAAS,EAAoC,aAAa,CAAC;AAGxE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGpF,eAAO,MAAM,QAAQ,EAAE,YAAY,EAAwE,CAAC;AAE5G,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,IAC/B,QAAQ,OAAO,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAOtF"}

package/dist/index.js

@@ -37,6 +37,8 @@ export const ItemContainerState = globalThis.ItemContainerState;
 export const chestHelper = globalThis.chestHelper;
 // PlayerHelper - Exposed by HyLithiumJS Java plugin
 export const playerHelper = globalThis.playerHelper;
+// NPCHelper - Exposed by HyLithiumJS Java plugin
+export const npcHelper = globalThis.npcHelper;
 // Usar array global existente ou criar novo (evita sobrescrever handlers de outros plugins)
 export const handlers = globalThis.handlers || (globalThis.handlers = []);
 export function EventListener(eventType) {

package/dist/types.d.ts

@@ -670,6 +670,27 @@ export interface PlayerHelper {
      */
     clearInventory(player: Player): boolean;
 }
+/**
+ * Helper class for NPC management operations.
+ * Exposed by HyLithiumJS Java plugin.
+ */
+export interface NPCHelper {
+    /**
+     * Cleans all NPCs from a world.
+     * Replicates the logic of `/npc clean --confirm`.
+     * Must be called from the world's thread (inside world.execute()).
+     * @param world The world to clean NPCs from
+     * @returns The number of NPCs removed
+     */
+    cleanAllNPCs(world: World): number;
+    /**
+     * Counts the number of NPCs in a world.
+     * Must be called from the world's thread (inside world.execute()).
+     * @param world The world to count NPCs in
+     * @returns The number of NPCs
+     */
+    countNPCs(world: World): number;
+}
 /**
  * Player death event data.
  * Dispatched when a player dies.
@@ -1528,7 +1549,25 @@ export interface DefaultAssetMap {
 export interface AssetStore {
     getAssetMap(): DefaultAssetMap;
 }
-export type EventType = "BootEvent" | "ShutdownEvent" | "PrepareUniverseEvent" | "PlayerConnectEvent" | "PlayerDisconnectEvent" | "PlayerChatEvent" | "PlayerReadyEvent" | "PlayerInteractEvent" | "PlayerCraftEvent" | "PlayerMouseButtonEvent" | "PlayerMouseMotionEvent" | "PlayerSetupConnectEvent" | "PlayerSetupDisconnectEvent" | "AddPlayerToWorldEvent" | "DrainPlayerFromWorldEvent" | "PlayerRefEvent" | "PlayerEvent" | "EntityEvent" | "EntityRemoveEvent" | "LivingEntityInventoryChangeEvent" | "LivingEntityUseBlockEvent" | "BreakBlockEvent" | "PlaceBlockEvent" | "DamageBlockEvent" | "UseBlockEvent" | "DropItemEvent" | "InteractivelyPickupItemEvent" | "ChangeGameModeEvent" | "CraftRecipeEvent" | "DiscoverZoneEvent" | "SwitchActiveSlotEvent" | "PlayerPermissionChangeEvent" | "GroupPermissionChangeEvent" | "PlayerGroupEvent" | "NPCSpawnEvent" | "NPCDespawnEvent" | "NPCRoleChangeEvent" | "NPCDamageEvent" | "NPCDeathEvent" | "PlayerDeathEvent";
+export type EventType = "BootEvent" | "ShutdownEvent" | "PrepareUniverseEvent" | "PlayerConnectEvent" | "PlayerDisconnectEvent" | "PlayerChatEvent" | "PlayerReadyEvent" | "PlayerInteractEvent" | "PlayerCraftEvent" | "PlayerMouseButtonEvent" | "PlayerMouseMotionEvent" | "PlayerSetupConnectEvent" | "PlayerSetupDisconnectEvent" | "AddPlayerToWorldEvent" | "DrainPlayerFromWorldEvent" | "PlayerRefEvent" | "PlayerEvent" | "EntityEvent" | "EntityRemoveEvent" | "LivingEntityInventoryChangeEvent" | "LivingEntityUseBlockEvent" | "BreakBlockEvent" | "PlaceBlockEvent" | "DamageBlockEvent" | "UseBlockEvent" | "DropItemEvent" | "InteractivelyPickupItemEvent" | "ChangeGameModeEvent" | "CraftRecipeEvent" | "DiscoverZoneEvent" | "SwitchActiveSlotEvent" | "PlayerPermissionChangeEvent" | "GroupPermissionChangeEvent" | "PlayerGroupEvent" | "NPCSpawnEvent" | "NPCDespawnEvent" | "NPCRoleChangeEvent" | "NPCDamageEvent" | "NPCDeathEvent" | "PlayerDeathEvent" | "NPCInteractEvent";
+/**
+ * Event dispatched when a player interacts with an NPC using the F key.
+ * This event is generated by HyLithiumJS's ScriptableUseNPCInteraction.
+ */
+export interface NPCInteractEvent {
+    /** Gets the player who initiated the interaction */
+    getPlayer(): Player;
+    /** Gets the NPC role name (e.g., "Kweebec_Elder") */
+    getNPCRole(): string;
+    /** Gets the reference to the NPC entity */
+    getNPCRef(): Ref<EntityStore>;
+    /** Gets the interaction type */
+    getInteractionType(): unknown;
+    /** Cancels the default NPC interaction behavior */
+    setCancelled(cancelled: boolean): void;
+    /** Returns whether the event was cancelled */
+    isCancelled(): boolean;
+}
 export type HexColor = `#${string}`;
 export declare const Colors: {
     readonly RED: HexColor;