specprotocol 1.4.0 → 1.4.3

package/dist/block-finder.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Block Finder Utility (Core)
+ *
+ * Provides efficient block searching in loaded chunks.
+ */
+import { World } from './world/world.js';
+import { Vec3 } from './utils/vec3.js';
+export interface FindBlockOptions {
+    /** Block state IDs to search for */
+    matching: number | number[];
+    /** Maximum distance from origin */
+    maxDistance?: number;
+    /** Maximum number of results */
+    count?: number;
+    /** Point to search from (defaults to 0,0,0) */
+    point?: Vec3;
+}
+export interface FoundBlock {
+    position: Vec3;
+    stateId: number;
+    distance: number;
+}
+/**
+ * Find blocks in the loaded world matching criteria.
+ * Returns blocks sorted by distance (nearest first).
+ */
+export declare function findBlocks(world: World, options: FindBlockOptions): FoundBlock[];
+/**
+ * Find the nearest block matching criteria.
+ */
+export declare function findBlock(world: World, options: Omit<FindBlockOptions, 'count'>): FoundBlock | null;
+//# sourceMappingURL=block-finder.d.ts.map

package/dist/block-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-finder.d.ts","sourceRoot":"","sources":["../src/block-finder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC7B,oCAAoC;IACpC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,CAAC,EAAE,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,IAAI,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,GAAG,UAAU,EAAE,CAkDhF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG,UAAU,GAAG,IAAI,CAGnG"}

package/dist/block-finder.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Block Finder Utility (Core)
+ *
+ * Provides efficient block searching in loaded chunks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findBlocks = findBlocks;
+exports.findBlock = findBlock;
+const vec3_js_1 = require("./utils/vec3.js");
+/**
+ * Find blocks in the loaded world matching criteria.
+ * Returns blocks sorted by distance (nearest first).
+ */
+function findBlocks(world, options) {
+    const matching = Array.isArray(options.matching) ? new Set(options.matching) : new Set([options.matching]);
+    const maxDist = options.maxDistance ?? 64;
+    const maxCount = options.count ?? 1;
+    const origin = options.point ?? new vec3_js_1.Vec3(0, 0, 0);
+    const results = [];
+    // Search in a cube around the origin
+    const minX = Math.floor(origin.x - maxDist);
+    const maxX = Math.ceil(origin.x + maxDist);
+    const minY = Math.max(world.minY, Math.floor(origin.y - maxDist));
+    const maxY = Math.min(world.minY + world.worldHeight, Math.ceil(origin.y + maxDist));
+    const minZ = Math.floor(origin.z - maxDist);
+    const maxZ = Math.ceil(origin.z + maxDist);
+    const maxDistSq = maxDist * maxDist;
+    for (let x = minX; x <= maxX; x++) {
+        for (let z = minZ; z <= maxZ; z++) {
+            // Check if chunk is loaded first
+            const chunkX = Math.floor(x / 16);
+            const chunkZ = Math.floor(z / 16);
+            if (!world.isChunkLoaded(chunkX, chunkZ))
+                continue;
+            for (let y = minY; y <= maxY; y++) {
+                const stateId = world.getBlock(x, y, z);
+                if (!matching.has(stateId))
+                    continue;
+                // Check distance
+                const dx = x + 0.5 - origin.x;
+                const dy = y + 0.5 - origin.y;
+                const dz = z + 0.5 - origin.z;
+                const distSq = dx * dx + dy * dy + dz * dz;
+                if (distSq > maxDistSq)
+                    continue;
+                results.push({
+                    position: new vec3_js_1.Vec3(x, y, z),
+                    stateId,
+                    distance: Math.sqrt(distSq),
+                });
+            }
+        }
+    }
+    // Sort by distance
+    results.sort((a, b) => a.distance - b.distance);
+    // Limit results
+    return results.slice(0, maxCount);
+}
+/**
+ * Find the nearest block matching criteria.
+ */
+function findBlock(world, options) {
+    const results = findBlocks(world, { ...options, count: 1 });
+    return results[0] ?? null;
+}
+//# sourceMappingURL=block-finder.js.map

package/dist/block-finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-finder.js","sourceRoot":"","sources":["../src/block-finder.ts"],"names":[],"mappings":"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"}

package/dist/bossbar.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Boss Bar Manager
+ *
+ * Tracks server boss bars (Ender Dragon, Wither, custom).
+ */
+import { TypedEventEmitter } from './utils/events.js';
+export interface BossBar {
+    uuid: string;
+    title: string;
+    health: number;
+    color: BossBarColor;
+    division: BossBarDivision;
+    flags: number;
+}
+export declare enum BossBarColor {
+    PINK = 0,
+    BLUE = 1,
+    RED = 2,
+    GREEN = 3,
+    YELLOW = 4,
+    PURPLE = 5,
+    WHITE = 6
+}
+export declare enum BossBarDivision {
+    NONE = 0,
+    NOTCHES_6 = 1,
+    NOTCHES_10 = 2,
+    NOTCHES_12 = 3,
+    NOTCHES_20 = 4
+}
+export declare enum BossBarAction {
+    ADD = 0,
+    REMOVE = 1,
+    UPDATE_HEALTH = 2,
+    UPDATE_TITLE = 3,
+    UPDATE_STYLE = 4,
+    UPDATE_FLAGS = 5
+}
+export interface BossBarEvents {
+    'bossBarAdd': (bar: BossBar) => void;
+    'bossBarRemove': (uuid: string) => void;
+    'bossBarUpdate': (bar: BossBar) => void;
+}
+export declare class BossBarManager extends TypedEventEmitter<BossBarEvents> {
+    private bars;
+    constructor();
+    /** Get a boss bar by UUID */
+    get(uuid: string): BossBar | undefined;
+    /** Get all active boss bars */
+    getAll(): BossBar[];
+    /** Number of active boss bars */
+    get count(): number;
+    /** Handle boss bar packet */
+    handleBossBar(uuid: string, action: number, data: any): void;
+    /** Clear all boss bars */
+    clear(): void;
+}
+//# sourceMappingURL=bossbar.d.ts.map

package/dist/bossbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bossbar.d.ts","sourceRoot":"","sources":["../src/bossbar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,oBAAY,YAAY;IACpB,IAAI,IAAI;IACR,IAAI,IAAI;IACR,GAAG,IAAI;IACP,KAAK,IAAI;IACT,MAAM,IAAI;IACV,MAAM,IAAI;IACV,KAAK,IAAI;CACZ;AAED,oBAAY,eAAe;IACvB,IAAI,IAAI;IACR,SAAS,IAAI;IACb,UAAU,IAAI;IACd,UAAU,IAAI;IACd,UAAU,IAAI;CACjB;AAED,oBAAY,aAAa;IACrB,GAAG,IAAI;IACP,MAAM,IAAI;IACV,aAAa,IAAI;IACjB,YAAY,IAAI;IAChB,YAAY,IAAI;IAChB,YAAY,IAAI;CACnB;AAED,MAAM,WAAW,aAAa;IAC1B,YAAY,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,eAAe,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3C;AAED,qBAAa,cAAe,SAAQ,iBAAiB,CAAC,aAAa,CAAC;IAChE,OAAO,CAAC,IAAI,CAA8B;;IAM1C,6BAA6B;IAC7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAItC,+BAA+B;IAC/B,MAAM,IAAI,OAAO,EAAE;IAInB,iCAAiC;IACjC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,6BAA6B;IAC7B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAuD5D,0BAA0B;IAC1B,KAAK,IAAI,IAAI;CAGhB"}

package/dist/bossbar.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * Boss Bar Manager
+ *
+ * Tracks server boss bars (Ender Dragon, Wither, custom).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BossBarManager = exports.BossBarAction = exports.BossBarDivision = exports.BossBarColor = void 0;
+const events_js_1 = require("./utils/events.js");
+var BossBarColor;
+(function (BossBarColor) {
+    BossBarColor[BossBarColor["PINK"] = 0] = "PINK";
+    BossBarColor[BossBarColor["BLUE"] = 1] = "BLUE";
+    BossBarColor[BossBarColor["RED"] = 2] = "RED";
+    BossBarColor[BossBarColor["GREEN"] = 3] = "GREEN";
+    BossBarColor[BossBarColor["YELLOW"] = 4] = "YELLOW";
+    BossBarColor[BossBarColor["PURPLE"] = 5] = "PURPLE";
+    BossBarColor[BossBarColor["WHITE"] = 6] = "WHITE";
+})(BossBarColor || (exports.BossBarColor = BossBarColor = {}));
+var BossBarDivision;
+(function (BossBarDivision) {
+    BossBarDivision[BossBarDivision["NONE"] = 0] = "NONE";
+    BossBarDivision[BossBarDivision["NOTCHES_6"] = 1] = "NOTCHES_6";
+    BossBarDivision[BossBarDivision["NOTCHES_10"] = 2] = "NOTCHES_10";
+    BossBarDivision[BossBarDivision["NOTCHES_12"] = 3] = "NOTCHES_12";
+    BossBarDivision[BossBarDivision["NOTCHES_20"] = 4] = "NOTCHES_20";
+})(BossBarDivision || (exports.BossBarDivision = BossBarDivision = {}));
+var BossBarAction;
+(function (BossBarAction) {
+    BossBarAction[BossBarAction["ADD"] = 0] = "ADD";
+    BossBarAction[BossBarAction["REMOVE"] = 1] = "REMOVE";
+    BossBarAction[BossBarAction["UPDATE_HEALTH"] = 2] = "UPDATE_HEALTH";
+    BossBarAction[BossBarAction["UPDATE_TITLE"] = 3] = "UPDATE_TITLE";
+    BossBarAction[BossBarAction["UPDATE_STYLE"] = 4] = "UPDATE_STYLE";
+    BossBarAction[BossBarAction["UPDATE_FLAGS"] = 5] = "UPDATE_FLAGS";
+})(BossBarAction || (exports.BossBarAction = BossBarAction = {}));
+class BossBarManager extends events_js_1.TypedEventEmitter {
+    bars = new Map();
+    constructor() {
+        super();
+    }
+    /** Get a boss bar by UUID */
+    get(uuid) {
+        return this.bars.get(uuid);
+    }
+    /** Get all active boss bars */
+    getAll() {
+        return Array.from(this.bars.values());
+    }
+    /** Number of active boss bars */
+    get count() {
+        return this.bars.size;
+    }
+    /** Handle boss bar packet */
+    handleBossBar(uuid, action, data) {
+        switch (action) {
+            case BossBarAction.ADD: {
+                const bar = {
+                    uuid,
+                    title: data.title ?? '',
+                    health: data.health ?? 1.0,
+                    color: data.color ?? BossBarColor.PINK,
+                    division: data.division ?? BossBarDivision.NONE,
+                    flags: data.flags ?? 0,
+                };
+                this.bars.set(uuid, bar);
+                this.emit('bossBarAdd', bar);
+                break;
+            }
+            case BossBarAction.REMOVE:
+                this.bars.delete(uuid);
+                this.emit('bossBarRemove', uuid);
+                break;
+            case BossBarAction.UPDATE_HEALTH: {
+                const bar = this.bars.get(uuid);
+                if (bar) {
+                    bar.health = data.health ?? bar.health;
+                    this.emit('bossBarUpdate', bar);
+                }
+                break;
+            }
+            case BossBarAction.UPDATE_TITLE: {
+                const bar = this.bars.get(uuid);
+                if (bar) {
+                    bar.title = data.title ?? bar.title;
+                    this.emit('bossBarUpdate', bar);
+                }
+                break;
+            }
+            case BossBarAction.UPDATE_STYLE: {
+                const bar = this.bars.get(uuid);
+                if (bar) {
+                    bar.color = data.color ?? bar.color;
+                    bar.division = data.division ?? bar.division;
+                    this.emit('bossBarUpdate', bar);
+                }
+                break;
+            }
+            case BossBarAction.UPDATE_FLAGS: {
+                const bar = this.bars.get(uuid);
+                if (bar) {
+                    bar.flags = data.flags ?? bar.flags;
+                    this.emit('bossBarUpdate', bar);
+                }
+                break;
+            }
+        }
+    }
+    /** Clear all boss bars */
+    clear() {
+        this.bars.clear();
+    }
+}
+exports.BossBarManager = BossBarManager;
+//# sourceMappingURL=bossbar.js.map

package/dist/bossbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bossbar.js","sourceRoot":"","sources":["../src/bossbar.ts"],"names":[],"mappings":"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"}

package/dist/bot.d.ts

@@ -16,14 +16,23 @@ import { Vec3 } from './utils/vec3.js';
 import { type RawPacket } from './protocol/packet.js';
 import { World } from './world/world.js';
 import { Entity, EntityManager } from './entity/entity.js';
+import { TabList, type TabListPlayer } from './tablist.js';
+import { ChatMessage } from './chat.js';
+import { Inventory, type ItemStack } from './inventory.js';
+import { Scoreboard } from './scoreboard.js';
+import { BossBarManager } from './bossbar.js';
+import { Weather } from './weather.js';
+import { type FindBlockOptions, type FoundBlock } from './block-finder.js';
 import { PluginManager, type Plugin } from './plugins/plugin-manager.js';
 export interface BotEvents {
     /** Login complete, entering play state */
     'login': () => void;
     /** Spawned in the world */
     'spawn': () => void;
-    /** Received a chat message */
+    /** Received a chat message (parsed) */
     'chat': (message: string, isOverlay: boolean) => void;
+    /** Received a chat message (rich) */
+    'chatMessage': (message: ChatMessage, isOverlay: boolean) => void;
     /** Health updated */
     'health': (health: number, food: number, saturation: number) => void;
     /** Bot died */
@@ -56,6 +65,16 @@ export interface BotEvents {
     'title': (text: string) => void;
     /** Subtitle text displayed */
     'subtitle': (text: string) => void;
+    /** Actionbar text displayed */
+    'actionbar': (text: string) => void;
+    /** Player joined (tab list) */
+    'playerJoin': (player: TabListPlayer) => void;
+    /** Player left (tab list) */
+    'playerLeave': (player: TabListPlayer) => void;
+    /** Weather changed */
+    'weatherChange': (weather: 'clear' | 'rain' | 'thunder') => void;
+    /** Inventory slot updated */
+    'inventoryUpdate': (slot: number, item: ItemStack | null) => void;
     /** Raw packet received (for advanced use) */
     'rawPacket': (packet: RawPacket) => void;
     /** Connection error */
@@ -100,12 +119,19 @@ export declare class Bot extends TypedEventEmitter<BotEvents> {
     private _spawnPosition;
     private _actionSequence;
     private physicsInterval;
+    /** Whether the bot is currently connected to the server */
+    get isConnected(): boolean;
     private authMode;
     private accessToken?;
     readonly world: World;
     readonly entities: EntityManager;
     readonly plugins: PluginManager;
     readonly entity: Entity;
+    readonly tabList: TabList;
+    readonly inventory: Inventory;
+    readonly scoreboard: Scoreboard;
+    readonly bossBars: BossBarManager;
+    readonly weather: Weather;
     private readonly options;
     private packetHandlers;
     constructor(options: BotOptions);
@@ -250,6 +276,20 @@ export declare class Bot extends TypedEventEmitter<BotEvents> {
      * Disconnect from the server.
      */
     disconnect(): void;
+    /**
+     * Find blocks matching criteria in loaded chunks.
+     * Returns blocks sorted by distance (nearest first).
+     *
+     * @example
+     * ```ts
+     * const stones = bot.findBlocks({ matching: 1, maxDistance: 32, count: 10 });
+     * ```
+     */
+    findBlocks(options: FindBlockOptions): FoundBlock[];
+    /**
+     * Find the nearest block matching criteria.
+     */
+    findBlock(options: Omit<FindBlockOptions, 'count'>): FoundBlock | null;
 }
 /**
  * Create and connect a bot.

package/dist/bot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"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"}

package/dist/bot.js

@@ -30,6 +30,13 @@ const play_js_1 = require("./protocol/states/play.js");
 // World & Entity
 const world_js_1 = require("./world/world.js");
 const entity_js_1 = require("./entity/entity.js");
+// Core modules
+const tablist_js_1 = require("./tablist.js");
+const inventory_js_1 = require("./inventory.js");
+const scoreboard_js_1 = require("./scoreboard.js");
+const bossbar_js_1 = require("./bossbar.js");
+const weather_js_1 = require("./weather.js");
+const block_finder_js_1 = require("./block-finder.js");
 // Plugins
 const plugin_manager_js_1 = require("./plugins/plugin-manager.js");
 const chat_js_1 = require("./plugins/built-in/chat.js");
@@ -57,6 +64,10 @@ class Bot extends events_js_1.TypedEventEmitter {
     _spawnPosition = new vec3_js_1.Vec3(0, 0, 0);
     _actionSequence = 0;
     physicsInterval = null;
+    /** Whether the bot is currently connected to the server */
+    get isConnected() {
+        return this.connection.connected;
+    }
     // Auth
     authMode;
     accessToken;
@@ -65,6 +76,12 @@ class Bot extends events_js_1.TypedEventEmitter {
     entities;
     plugins;
     entity;
+    // Core modules
+    tabList;
+    inventory;
+    scoreboard;
+    bossBars;
+    weather;
     // Config
     options;
     // Packet handlers for play state
@@ -85,6 +102,16 @@ class Bot extends events_js_1.TypedEventEmitter {
         this.entities = new entity_js_1.EntityManager();
         this.plugins = new plugin_manager_js_1.PluginManager();
         this.entity = new entity_js_1.Entity(0, '', 0);
+        // Initialize core modules
+        this.tabList = new tablist_js_1.TabList();
+        this.inventory = new inventory_js_1.Inventory();
+        this.scoreboard = new scoreboard_js_1.Scoreboard();
+        this.bossBars = new bossbar_js_1.BossBarManager();
+        this.weather = new weather_js_1.Weather();
+        // Forward core module events to bot
+        this.tabList.on('playerJoin', (player) => this.emit('playerJoin', player));
+        this.tabList.on('playerLeave', (player) => this.emit('playerLeave', player));
+        this.weather.on('weatherChange', (state) => this.emit('weatherChange', state));
         // Initialize connection
         this.connection = new connection_js_1.Connection({
             host: this.options.host,
@@ -862,6 +889,31 @@ class Bot extends events_js_1.TypedEventEmitter {
         this.connection.disconnect();
         this.logger.info('Disconnected');
     }
+    // ─── Block Finding ──────────────────────────────────────
+    /**
+     * Find blocks matching criteria in loaded chunks.
+     * Returns blocks sorted by distance (nearest first).
+     *
+     * @example
+     * ```ts
+     * const stones = bot.findBlocks({ matching: 1, maxDistance: 32, count: 10 });
+     * ```
+     */
+    findBlocks(options) {
+        return (0, block_finder_js_1.findBlocks)(this.world, {
+            ...options,
+            point: options.point ?? this.position,
+        });
+    }
+    /**
+     * Find the nearest block matching criteria.
+     */
+    findBlock(options) {
+        return (0, block_finder_js_1.findBlock)(this.world, {
+            ...options,
+            point: options.point ?? this.position,
+        });
+    }
 }
 exports.Bot = Bot;
 // ─── Factory Function ───────────────────────────────────