@hylithiumjs.com/core 1.3.5 → 1.3.6

package/dist/index.d.ts

@@ -31,6 +31,12 @@ 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 } from "./types";
+export declare const ChunkUtil: ChunkUtilStaticType;
+export declare const SimpleItemContainer: SimpleItemContainerConstructor;
+export declare const ItemContainerState: ItemContainerStateType;
+export declare const chestHelper: ChestHelperType;
+export type { ChestHelper } 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,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,EAC/B,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,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C,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

@@ -30,6 +30,11 @@ export const ReputationRequirement = globalThis.ReputationRequirement;
 export const ReputationDataResource = globalThis.ReputationDataResource;
 // Block & World Globals
 export const BlockModule = globalThis.BlockModule;
+export const ChunkUtil = globalThis.ChunkUtil;
+export const SimpleItemContainer = globalThis.SimpleItemContainer;
+export const ItemContainerState = globalThis.ItemContainerState;
+// ChestHelper - Exposed by HyLithiumJS Java plugin
+export const chestHelper = globalThis.chestHelper;
 // 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

@@ -296,6 +296,340 @@ export interface TableBuilder {
 export interface TableBuilderConstructor {
     new (tableName: string): TableBuilder;
 }
+/**
+ * Base interface for item containers (chests, inventories, etc.)
+ * Corresponds to com.hypixel.hytale.server.core.inventory.container.ItemContainer
+ */
+export interface ItemContainer {
+    /**
+     * Gets the capacity (number of slots) of this container.
+     */
+    getCapacity(): number;
+    /**
+     * Gets the item stack at the specified slot.
+     * @param slot Slot index (0-based)
+     * @returns ItemStack at slot or null if empty
+     */
+    getItemStack(slot: number): ItemStack | null;
+    /**
+     * Sets an item stack at the specified slot.
+     * @param slot Slot index (0-based)
+     * @param itemStack Item to place in slot
+     */
+    setItemStackForSlot(slot: number, itemStack: ItemStack): void;
+    /**
+     * Adds an item stack to the first available slot.
+     * @param itemStack Item to add
+     * @returns Transaction result
+     */
+    addItemStack(itemStack: ItemStack): ItemStackTransaction;
+    /**
+     * Removes an item stack from a slot.
+     * @param slot Slot index
+     * @returns The removed item or null
+     */
+    removeItemStack(slot: number): ItemStack | null;
+    /**
+     * Clears all items from the container.
+     * @returns ClearTransaction with info about cleared items
+     */
+    clear(): ClearTransaction;
+    /**
+     * Checks if the container is empty.
+     */
+    isEmpty(): boolean;
+    /**
+     * Moves all items to another container.
+     * @param target Target container
+     */
+    moveAllItemStacksTo(target: ItemContainer): void;
+}
+/**
+ * Simple implementation of ItemContainer.
+ * Corresponds to com.hypixel.hytale.server.core.inventory.container.SimpleItemContainer
+ */
+export interface SimpleItemContainer extends ItemContainer {
+    /**
+     * Creates a clone of this container.
+     */
+    clone(): SimpleItemContainer;
+    /**
+     * Sets a global filter for the container.
+     */
+    setGlobalFilter(filterType: FilterType): void;
+    /**
+     * Sets a filter for a specific slot.
+     */
+    setSlotFilter(actionType: FilterActionType, slot: number, filter: SlotFilter | null): void;
+}
+/**
+ * Constructor for SimpleItemContainer
+ */
+export interface SimpleItemContainerConstructor {
+    new (capacity: number): SimpleItemContainer;
+}
+/**
+ * Filter type for container operations.
+ */
+export type FilterType = 'ALLOW_ALL' | 'DENY_INPUT' | 'DENY_OUTPUT' | 'DENY_ALL';
+/**
+ * Filter action type for slot-specific filters.
+ */
+export type FilterActionType = 'ADD' | 'REMOVE' | 'DROP';
+/**
+ * Slot filter interface for custom filtering logic.
+ */
+export interface SlotFilter {
+    test(actionType: FilterActionType, container: ItemContainer, slot: number, itemStack: ItemStack | null): boolean;
+}
+/**
+ * Transaction result from item stack operations.
+ */
+export interface ItemStackTransaction {
+    getRemainder(): ItemStack | null;
+    isSuccess(): boolean;
+}
+/**
+ * Transaction result from clear operations.
+ */
+export interface ClearTransaction {
+    isSuccess(): boolean;
+    getClearedItems(): ItemStack[];
+}
+/**
+ * Block state attached to blocks with special behavior.
+ * Corresponds to com.hypixel.hytale.server.core.universe.world.meta.BlockState
+ */
+export interface BlockState {
+    /**
+     * Gets the position of this block state.
+     */
+    getPosition(): Vector3i;
+    /**
+     * Sets the position for this block state.
+     */
+    setPosition(chunk: WorldChunk, position: Vector3i): void;
+    /**
+     * Converts this state to a holder for storage.
+     */
+    toHolder(): Holder;
+}
+/**
+ * Block state for containers (chests, barrels, etc.)
+ * Corresponds to com.hypixel.hytale.server.core.universe.world.meta.state.ItemContainerState
+ */
+export interface ItemContainerState extends BlockState {
+    /**
+     * Gets the item container for this block.
+     */
+    getItemContainer(): ItemContainer;
+    /**
+     * Sets a new item container for this block.
+     * @param container The new container (usually SimpleItemContainer)
+     */
+    setItemContainer(container: SimpleItemContainer): void;
+    /**
+     * Initializes the container with specified capacity and type.
+     */
+    initializeContainer(capacity: number, itemContainerType: string): void;
+}
+/**
+ * Chunk in the world containing blocks and entities.
+ * Corresponds to com.hypixel.hytale.server.core.universe.world.chunk.WorldChunk
+ */
+export interface WorldChunk {
+    /**
+     * Gets the X coordinate of this chunk.
+     */
+    getX(): number;
+    /**
+     * Gets the Z coordinate of this chunk.
+     */
+    getZ(): number;
+    /**
+     * Gets the chunk index.
+     */
+    getIndex(): number;
+    /**
+     * Gets the block ID at the specified local coordinates.
+     */
+    getBlock(x: number, y: number, z: number): number;
+    /**
+     * Sets a block at the specified local coordinates.
+     */
+    setBlock(x: number, y: number, z: number, id: number, blockType: BlockType, rotation: number, filler: number, settings: number): boolean;
+    /**
+     * Gets the block state at the specified local coordinates.
+     * @returns BlockState or null if no state exists
+     */
+    getState(x: number, y: number, z: number): BlockState | null;
+    /**
+     * Sets the block state at the specified local coordinates.
+     */
+    setState(x: number, y: number, z: number, state: BlockState | null, notify: boolean): void;
+    /**
+     * Gets the world this chunk belongs to.
+     */
+    getWorld(): World;
+    /**
+     * Gets the block component chunk.
+     */
+    getBlockComponentChunk(): BlockComponentChunk | null;
+    /**
+     * Gets the entity chunk.
+     */
+    getEntityChunk(): EntityChunk | null;
+}
+/**
+ * Interface for block component storage in chunks.
+ */
+export interface BlockComponentChunk {
+    getNeedsSaving(): boolean;
+    consumeNeedsSaving(): boolean;
+}
+/**
+ * Interface for entity storage in chunks.
+ */
+export interface EntityChunk {
+    getNeedsSaving(): boolean;
+    consumeNeedsSaving(): boolean;
+}
+/**
+ * World interface with chunk and block access.
+ * Corresponds to com.hypixel.hytale.server.core.universe.world.World
+ */
+export interface World {
+    /**
+     * Gets the world name/identifier.
+     */
+    getName(): string;
+    /**
+     * Gets a chunk by its index (may not be ticking).
+     */
+    getNonTickingChunk(chunkIndex: number): WorldChunk | null;
+    /**
+     * Gets a ticking chunk by its index.
+     */
+    getTickingChunk(chunkIndex: number): WorldChunk | null;
+    /**
+     * Gets the chunk store.
+     */
+    getChunkStore(): ChunkStore;
+    /**
+     * Gets the entity store.
+     */
+    getEntityStore(): EntityStore;
+    /**
+     * Sets a block at world coordinates.
+     * @param x World X coordinate
+     * @param y World Y coordinate
+     * @param z World Z coordinate
+     * @param blockId Block type ID string
+     */
+    setBlock(x: number, y: number, z: number, blockId: string): void;
+    /**
+     * Gets the block type at world coordinates.
+     */
+    getBlockType(x: number, y: number, z: number): BlockType;
+    /**
+     * Breaks a block at world coordinates.
+     */
+    breakBlock(x: number, y: number, z: number, settings: number): void;
+    /**
+     * Checks if the current thread is the world's ticking thread.
+     */
+    isInThread(): boolean;
+    /**
+     * Executes a runnable on the world's ticking thread.
+     */
+    execute(runnable: () => void): void;
+}
+/**
+ * Chunk store for managing world chunks.
+ */
+export interface ChunkStore {
+    getStore(): Store<ChunkStore>;
+}
+/**
+ * Utility class for chunk coordinate calculations.
+ * Corresponds to com.hypixel.hytale.math.util.ChunkUtil
+ */
+export interface ChunkUtilStatic {
+    /**
+     * Calculates chunk index from block coordinates.
+     * @param blockX Block X coordinate
+     * @param blockZ Block Z coordinate
+     * @returns Chunk index as a long number
+     */
+    indexChunkFromBlock(blockX: number, blockZ: number): number;
+    /**
+     * Gets the chunk coordinate from a block coordinate.
+     * @param blockCoord Block coordinate
+     * @returns Chunk coordinate
+     */
+    chunkCoordinate(blockCoord: number): number;
+    /**
+     * Calculates the index of a block within a column.
+     */
+    indexBlockInColumn(x: number, y: number, z: number): number;
+    /**
+     * Checks if two block positions are in the same chunk.
+     */
+    isSameChunk(x1: number, z1: number, x2: number, z2: number): boolean;
+}
+/**
+ * Helper class for chest/container operations.
+ * Exposed by HyLithiumJS Java plugin.
+ */
+export interface ChestHelper {
+    /**
+     * Fills a chest/container with items at random slots.
+     * @param world The world object
+     * @param x X coordinate of the chest block
+     * @param y Y coordinate of the chest block
+     * @param z Z coordinate of the chest block
+     * @param items Array of ItemStacks to add
+     * @returns Number of items successfully added
+     */
+    fillChestWithItems(world: World, x: number, y: number, z: number, items: ItemStack[]): number;
+    /**
+     * Gets the ItemContainer from a chest/container block.
+     * @param world The world object
+     * @param x X coordinate of the chest block
+     * @param y Y coordinate of the chest block
+     * @param z Z coordinate of the chest block
+     * @returns ItemContainer or null if not found
+     */
+    getBlockContainer(world: World, x: number, y: number, z: number): ItemContainer | null;
+    /**
+     * Clears all items from a chest/container.
+     * @param world The world object
+     * @param x X coordinate of the chest block
+     * @param y Y coordinate of the chest block
+     * @param z Z coordinate of the chest block
+     * @returns true if successful
+     */
+    clearChest(world: World, x: number, y: number, z: number): boolean;
+    /**
+     * Sets the capacity (number of slots) for a chest.
+     * @param world The world object
+     * @param x X coordinate of the chest block
+     * @param y Y coordinate of the chest block
+     * @param z Z coordinate of the chest block
+     * @param capacity New capacity (number of slots)
+     * @returns true if successful
+     */
+    setChestCapacity(world: World, x: number, y: number, z: number, capacity: number): boolean;
+    /**
+     * Gets all contents of a chest/container.
+     * @param world The world object
+     * @param x X coordinate of the chest block
+     * @param y Y coordinate of the chest block
+     * @param z Z coordinate of the chest block
+     * @returns Array of ItemStacks or null if not found
+     */
+    getChestContents(world: World, x: number, y: number, z: number): ItemStack[] | null;
+}
 export interface BootEvent {
     toString(): string;
 }