specprotocol 1.0.0

package/dist/entity/entity.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Entity representation in the Minecraft world.
+ */
+import { Vec3 } from '../utils/vec3.js';
+export declare enum EntityType {
+    PLAYER = "player",
+    MOB = "mob",
+    OBJECT = "object",
+    UNKNOWN = "unknown"
+}
+export interface EntityMetadata {
+    [key: number]: unknown;
+}
+export declare class Entity {
+    id: number;
+    uuid: string;
+    type: number;
+    entityType: EntityType;
+    position: Vec3;
+    velocity: Vec3;
+    yaw: number;
+    pitch: number;
+    headYaw: number;
+    onGround: boolean;
+    metadata: EntityMetadata;
+    name?: string;
+    constructor(id: number, uuid: string, type: number, position?: Vec3);
+    /**
+     * Distance to another entity.
+     */
+    distanceTo(other: Entity): number;
+    /**
+     * Distance to a position.
+     */
+    distanceToPosition(pos: Vec3): number;
+}
+/**
+ * Player entity with additional player-specific data.
+ */
+export declare class PlayerEntity extends Entity {
+    username: string;
+    gameMode: number;
+    ping: number;
+    displayName?: string;
+    constructor(id: number, uuid: string, username: string, position?: Vec3);
+}
+/**
+ * Entity Manager — tracks all entities in the world.
+ */
+export declare class EntityManager {
+    private entities;
+    private playersByUUID;
+    add(entity: Entity): void;
+    get(id: number): Entity | undefined;
+    getByUUID(uuid: string): Entity | undefined;
+    getPlayer(uuid: string): PlayerEntity | undefined;
+    remove(id: number): void;
+    removeMultiple(ids: number[]): void;
+    getAll(): Entity[];
+    getAllPlayers(): PlayerEntity[];
+    /**
+     * Get nearest entity to a position.
+     */
+    getNearestTo(pos: Vec3, filter?: (entity: Entity) => boolean): Entity | undefined;
+    /**
+     * Get all entities within a radius.
+     */
+    getEntitiesInRadius(pos: Vec3, radius: number, filter?: (entity: Entity) => boolean): Entity[];
+    clear(): void;
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/entity/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/entity/entity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,oBAAY,UAAU;IAClB,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,OAAO,YAAY;CACtB;AAED,MAAM,WAAW,cAAc;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,qBAAa,MAAM;IACR,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,IAAI,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAGjB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,IAAkB;IAehC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIjC;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM;CAGxC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,MAAM;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;gBAEhB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,IAAkB;CAOvF;AAED;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,aAAa,CAAmC;IAExD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOzB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAInC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAO3C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAUxB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAMnC,MAAM,IAAI,MAAM,EAAE;IAIlB,aAAa,IAAI,YAAY,EAAE;IAI/B;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,GAAG,SAAS;IAgBjF;;OAEG;IACH,mBAAmB,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,EAAE;IAgB9F,KAAK,IAAI,IAAI;CAIhB"}

package/dist/entity/entity.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * Entity representation in the Minecraft world.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityManager = exports.PlayerEntity = exports.Entity = exports.EntityType = void 0;
+const vec3_js_1 = require("../utils/vec3.js");
+var EntityType;
+(function (EntityType) {
+    EntityType["PLAYER"] = "player";
+    EntityType["MOB"] = "mob";
+    EntityType["OBJECT"] = "object";
+    EntityType["UNKNOWN"] = "unknown";
+})(EntityType || (exports.EntityType = EntityType = {}));
+class Entity {
+    id;
+    uuid;
+    type;
+    entityType;
+    position;
+    velocity;
+    yaw;
+    pitch;
+    headYaw;
+    onGround;
+    metadata;
+    name;
+    constructor(id, uuid, type, position = vec3_js_1.Vec3.zero()) {
+        this.id = id;
+        this.uuid = uuid;
+        this.type = type;
+        this.entityType = EntityType.UNKNOWN;
+        this.position = position;
+        this.velocity = vec3_js_1.Vec3.zero();
+        this.yaw = 0;
+        this.pitch = 0;
+        this.headYaw = 0;
+        this.onGround = true;
+        this.metadata = {};
+    }
+    /**
+     * Distance to another entity.
+     */
+    distanceTo(other) {
+        return this.position.distanceTo(other.position);
+    }
+    /**
+     * Distance to a position.
+     */
+    distanceToPosition(pos) {
+        return this.position.distanceTo(pos);
+    }
+}
+exports.Entity = Entity;
+/**
+ * Player entity with additional player-specific data.
+ */
+class PlayerEntity extends Entity {
+    username;
+    gameMode;
+    ping;
+    displayName;
+    constructor(id, uuid, username, position = vec3_js_1.Vec3.zero()) {
+        super(id, uuid, 0, position);
+        this.entityType = EntityType.PLAYER;
+        this.username = username;
+        this.gameMode = 0;
+        this.ping = 0;
+    }
+}
+exports.PlayerEntity = PlayerEntity;
+/**
+ * Entity Manager — tracks all entities in the world.
+ */
+class EntityManager {
+    entities = new Map();
+    playersByUUID = new Map();
+    add(entity) {
+        this.entities.set(entity.id, entity);
+        if (entity instanceof PlayerEntity) {
+            this.playersByUUID.set(entity.uuid, entity);
+        }
+    }
+    get(id) {
+        return this.entities.get(id);
+    }
+    getByUUID(uuid) {
+        for (const entity of this.entities.values()) {
+            if (entity.uuid === uuid)
+                return entity;
+        }
+        return undefined;
+    }
+    getPlayer(uuid) {
+        return this.playersByUUID.get(uuid);
+    }
+    remove(id) {
+        const entity = this.entities.get(id);
+        if (entity) {
+            if (entity instanceof PlayerEntity) {
+                this.playersByUUID.delete(entity.uuid);
+            }
+            this.entities.delete(id);
+        }
+    }
+    removeMultiple(ids) {
+        for (const id of ids) {
+            this.remove(id);
+        }
+    }
+    getAll() {
+        return Array.from(this.entities.values());
+    }
+    getAllPlayers() {
+        return Array.from(this.playersByUUID.values());
+    }
+    /**
+     * Get nearest entity to a position.
+     */
+    getNearestTo(pos, filter) {
+        let nearest;
+        let minDist = Infinity;
+        for (const entity of this.entities.values()) {
+            if (filter && !filter(entity))
+                continue;
+            const dist = entity.position.distanceTo(pos);
+            if (dist < minDist) {
+                minDist = dist;
+                nearest = entity;
+            }
+        }
+        return nearest;
+    }
+    /**
+     * Get all entities within a radius.
+     */
+    getEntitiesInRadius(pos, radius, filter) {
+        const result = [];
+        const radiusSq = radius * radius;
+        for (const entity of this.entities.values()) {
+            if (filter && !filter(entity))
+                continue;
+            const diff = entity.position.subtract(pos);
+            const distSq = diff.x * diff.x + diff.y * diff.y + diff.z * diff.z;
+            if (distSq <= radiusSq) {
+                result.push(entity);
+            }
+        }
+        return result;
+    }
+    clear() {
+        this.entities.clear();
+        this.playersByUUID.clear();
+    }
+}
+exports.EntityManager = EntityManager;
+//# sourceMappingURL=entity.js.map

package/dist/entity/entity.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * MCBot — A Mineflayer alternative built from scratch in TypeScript.
+ *
+ * @example
+ * ```ts
+ * import { createBot } from 'mcbot';
+ *
+ * const bot = await createBot({
+ *   host: 'localhost',
+ *   port: 25565,
+ *   username: 'MyBot',
+ *   auth: 'offline',
+ * });
+ *
+ * bot.on('spawn', () => {
+ *   bot.chat('Hello from MCBot!');
+ * });
+ * ```
+ */
+export { Bot, createBot, type BotOptions, type BotEvents } from './bot.js';
+export { Vec3 } from './utils/vec3.js';
+export { Logger, LogLevel } from './utils/logger.js';
+export { TypedEventEmitter } from './utils/events.js';
+export { Connection, type ConnectionOptions } from './protocol/connection.js';
+export { BufferReader, BufferWriter } from './protocol/types.js';
+export { ProtocolState, PacketDirection, PacketRegistry, type RawPacket, type PacketDefinition, } from './protocol/packet.js';
+export { PROTOCOL_VERSION } from './protocol/states/handshake.js';
+export { World } from './world/world.js';
+export { ChunkColumn, ChunkSection, type Block } from './world/block.js';
+export { Entity, PlayerEntity, EntityManager, EntityType } from './entity/entity.js';
+export { PluginManager, type Plugin } from './plugins/plugin-manager.js';
+export { ChatPlugin } from './plugins/built-in/chat.js';
+export { CombatPlugin } from './plugins/built-in/combat.js';
+export { createOfflineProfile, offlineUUID } from './auth/offline.js';
+export { authenticateMicrosoft, joinServer } from './auth/microsoft.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAG3E,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACH,aAAa,EACb,eAAe,EACf,cAAc,EACd,KAAK,SAAS,EACd,KAAK,gBAAgB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrF,OAAO,EAAE,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG5D,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * MCBot — A Mineflayer alternative built from scratch in TypeScript.
+ *
+ * @example
+ * ```ts
+ * import { createBot } from 'mcbot';
+ *
+ * const bot = await createBot({
+ *   host: 'localhost',
+ *   port: 25565,
+ *   username: 'MyBot',
+ *   auth: 'offline',
+ * });
+ *
+ * bot.on('spawn', () => {
+ *   bot.chat('Hello from MCBot!');
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinServer = exports.authenticateMicrosoft = exports.offlineUUID = exports.createOfflineProfile = exports.CombatPlugin = exports.ChatPlugin = exports.PluginManager = exports.EntityType = exports.EntityManager = exports.PlayerEntity = exports.Entity = exports.ChunkSection = exports.ChunkColumn = exports.World = exports.PROTOCOL_VERSION = exports.PacketRegistry = exports.PacketDirection = exports.ProtocolState = exports.BufferWriter = exports.BufferReader = exports.Connection = exports.TypedEventEmitter = exports.LogLevel = exports.Logger = exports.Vec3 = exports.createBot = exports.Bot = void 0;
+// Main Bot
+var bot_js_1 = require("./bot.js");
+Object.defineProperty(exports, "Bot", { enumerable: true, get: function () { return bot_js_1.Bot; } });
+Object.defineProperty(exports, "createBot", { enumerable: true, get: function () { return bot_js_1.createBot; } });
+// Utils
+var vec3_js_1 = require("./utils/vec3.js");
+Object.defineProperty(exports, "Vec3", { enumerable: true, get: function () { return vec3_js_1.Vec3; } });
+var logger_js_1 = require("./utils/logger.js");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_js_1.Logger; } });
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_js_1.LogLevel; } });
+var events_js_1 = require("./utils/events.js");
+Object.defineProperty(exports, "TypedEventEmitter", { enumerable: true, get: function () { return events_js_1.TypedEventEmitter; } });
+// Protocol
+var connection_js_1 = require("./protocol/connection.js");
+Object.defineProperty(exports, "Connection", { enumerable: true, get: function () { return connection_js_1.Connection; } });
+var types_js_1 = require("./protocol/types.js");
+Object.defineProperty(exports, "BufferReader", { enumerable: true, get: function () { return types_js_1.BufferReader; } });
+Object.defineProperty(exports, "BufferWriter", { enumerable: true, get: function () { return types_js_1.BufferWriter; } });
+var packet_js_1 = require("./protocol/packet.js");
+Object.defineProperty(exports, "ProtocolState", { enumerable: true, get: function () { return packet_js_1.ProtocolState; } });
+Object.defineProperty(exports, "PacketDirection", { enumerable: true, get: function () { return packet_js_1.PacketDirection; } });
+Object.defineProperty(exports, "PacketRegistry", { enumerable: true, get: function () { return packet_js_1.PacketRegistry; } });
+var handshake_js_1 = require("./protocol/states/handshake.js");
+Object.defineProperty(exports, "PROTOCOL_VERSION", { enumerable: true, get: function () { return handshake_js_1.PROTOCOL_VERSION; } });
+// World
+var world_js_1 = require("./world/world.js");
+Object.defineProperty(exports, "World", { enumerable: true, get: function () { return world_js_1.World; } });
+var block_js_1 = require("./world/block.js");
+Object.defineProperty(exports, "ChunkColumn", { enumerable: true, get: function () { return block_js_1.ChunkColumn; } });
+Object.defineProperty(exports, "ChunkSection", { enumerable: true, get: function () { return block_js_1.ChunkSection; } });
+// Entity
+var entity_js_1 = require("./entity/entity.js");
+Object.defineProperty(exports, "Entity", { enumerable: true, get: function () { return entity_js_1.Entity; } });
+Object.defineProperty(exports, "PlayerEntity", { enumerable: true, get: function () { return entity_js_1.PlayerEntity; } });
+Object.defineProperty(exports, "EntityManager", { enumerable: true, get: function () { return entity_js_1.EntityManager; } });
+Object.defineProperty(exports, "EntityType", { enumerable: true, get: function () { return entity_js_1.EntityType; } });
+// Plugins
+var plugin_manager_js_1 = require("./plugins/plugin-manager.js");
+Object.defineProperty(exports, "PluginManager", { enumerable: true, get: function () { return plugin_manager_js_1.PluginManager; } });
+var chat_js_1 = require("./plugins/built-in/chat.js");
+Object.defineProperty(exports, "ChatPlugin", { enumerable: true, get: function () { return chat_js_1.ChatPlugin; } });
+var combat_js_1 = require("./plugins/built-in/combat.js");
+Object.defineProperty(exports, "CombatPlugin", { enumerable: true, get: function () { return combat_js_1.CombatPlugin; } });
+// Auth
+var offline_js_1 = require("./auth/offline.js");
+Object.defineProperty(exports, "createOfflineProfile", { enumerable: true, get: function () { return offline_js_1.createOfflineProfile; } });
+Object.defineProperty(exports, "offlineUUID", { enumerable: true, get: function () { return offline_js_1.offlineUUID; } });
+var microsoft_js_1 = require("./auth/microsoft.js");
+Object.defineProperty(exports, "authenticateMicrosoft", { enumerable: true, get: function () { return microsoft_js_1.authenticateMicrosoft; } });
+Object.defineProperty(exports, "joinServer", { enumerable: true, get: function () { return microsoft_js_1.joinServer; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,WAAW;AACX,mCAA2E;AAAlE,6FAAA,GAAG,OAAA;AAAE,mGAAA,SAAS,OAAA;AAEvB,QAAQ;AACR,2CAAuC;AAA9B,+FAAA,IAAI,OAAA;AACb,+CAAqD;AAA5C,mGAAA,MAAM,OAAA;AAAE,qGAAA,QAAQ,OAAA;AACzB,+CAAsD;AAA7C,8GAAA,iBAAiB,OAAA;AAE1B,WAAW;AACX,0DAA8E;AAArE,2GAAA,UAAU,OAAA;AACnB,gDAAiE;AAAxD,wGAAA,YAAY,OAAA;AAAE,wGAAA,YAAY,OAAA;AACnC,kDAM8B;AAL1B,0GAAA,aAAa,OAAA;AACb,4GAAA,eAAe,OAAA;AACf,2GAAA,cAAc,OAAA;AAIlB,+DAAkE;AAAzD,gHAAA,gBAAgB,OAAA;AAEzB,QAAQ;AACR,6CAAyC;AAAhC,iGAAA,KAAK,OAAA;AACd,6CAAyE;AAAhE,uGAAA,WAAW,OAAA;AAAE,wGAAA,YAAY,OAAA;AAElC,SAAS;AACT,gDAAqF;AAA5E,mGAAA,MAAM,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,0GAAA,aAAa,OAAA;AAAE,uGAAA,UAAU,OAAA;AAExD,UAAU;AACV,iEAAyE;AAAhE,kHAAA,aAAa,OAAA;AACtB,sDAAwD;AAA/C,qGAAA,UAAU,OAAA;AACnB,0DAA4D;AAAnD,yGAAA,YAAY,OAAA;AAErB,OAAO;AACP,gDAAsE;AAA7D,kHAAA,oBAAoB,OAAA;AAAE,yGAAA,WAAW,OAAA;AAC1C,oDAAwE;AAA/D,qHAAA,qBAAqB,OAAA;AAAE,0GAAA,UAAU,OAAA"}

package/dist/plugins/built-in/chat.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Chat Plugin — handles chat message sending and receiving.
+ */
+import type { BotAPI } from '../../types.js';
+import type { Plugin } from '../plugin-manager.js';
+export declare class ChatPlugin implements Plugin {
+    name: string;
+    private bot;
+    initialize(bot: BotAPI): void;
+    /**
+     * Send a chat message.
+     */
+    chat(message: string): void;
+    /**
+     * Extract plain text from a Minecraft JSON chat component.
+     */
+    private extractText;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/plugins/built-in/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/plugins/built-in/chat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAQnD,qBAAa,UAAW,YAAW,MAAM;IACrC,IAAI,SAAU;IACd,OAAO,CAAC,GAAG,CAAU;IAErB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAoB7B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO3B;;OAEG;IACH,OAAO,CAAC,WAAW;CAwBtB"}

package/dist/plugins/built-in/chat.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Chat Plugin — handles chat message sending and receiving.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatPlugin = void 0;
+const play_js_1 = require("../../protocol/states/play.js");
+class ChatPlugin {
+    name = 'chat';
+    bot;
+    initialize(bot) {
+        this.bot = bot;
+        // Listen for system chat messages
+        bot.onPacket(play_js_1.PlayClientboundPackets.SYSTEM_CHAT, (data) => {
+            const packet = (0, play_js_1.parseSystemChat)(data);
+            // Try to parse JSON chat component
+            let message;
+            try {
+                const parsed = JSON.parse(packet.content);
+                message = this.extractText(parsed);
+            }
+            catch {
+                message = packet.content;
+            }
+            bot.emit('chat', message, packet.isOverlay);
+        });
+    }
+    /**
+     * Send a chat message.
+     */
+    chat(message) {
+        this.bot.sendPacket(play_js_1.PlayServerboundPackets.CHAT_MESSAGE, (0, play_js_1.buildChatMessagePacket)(message));
+    }
+    /**
+     * Extract plain text from a Minecraft JSON chat component.
+     */
+    extractText(component) {
+        if (typeof component === 'string')
+            return component;
+        if (typeof component !== 'object' || component === null)
+            return '';
+        const obj = component;
+        let text = '';
+        if (typeof obj.text === 'string')
+            text += obj.text;
+        if (typeof obj.translate === 'string')
+            text += obj.translate;
+        if (Array.isArray(obj.extra)) {
+            for (const extra of obj.extra) {
+                text += this.extractText(extra);
+            }
+        }
+        if (Array.isArray(obj.with)) {
+            for (const w of obj.with) {
+                text += this.extractText(w);
+            }
+        }
+        return text;
+    }
+}
+exports.ChatPlugin = ChatPlugin;
+//# sourceMappingURL=chat.js.map

package/dist/plugins/built-in/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/plugins/built-in/chat.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH,2DAKuC;AAEvC,MAAa,UAAU;IACnB,IAAI,GAAG,MAAM,CAAC;IACN,GAAG,CAAU;IAErB,UAAU,CAAC,GAAW;QAClB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QAEf,kCAAkC;QAClC,GAAG,CAAC,QAAQ,CAAC,gCAAsB,CAAC,WAAW,EAAE,CAAC,IAAY,EAAE,EAAE;YAC9D,MAAM,MAAM,GAAG,IAAA,yBAAe,EAAC,IAAI,CAAC,CAAC;YAErC,mCAAmC;YACnC,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC1C,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YAC7B,CAAC;YAED,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe;QAChB,IAAI,CAAC,GAAG,CAAC,UAAU,CACf,gCAAsB,CAAC,YAAY,EACnC,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAClC,CAAC;IACN,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,SAAkB;QAClC,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACpD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QAEnE,MAAM,GAAG,GAAG,SAAoC,CAAC;QACjD,IAAI,IAAI,GAAG,EAAE,CAAC;QAEd,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;QACnD,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;YAAE,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC;QAE7D,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC5B,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;QACL,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;gBACvB,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AA7DD,gCA6DC"}

package/dist/plugins/built-in/combat.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Combat Plugin — handles attacking entities.
+ */
+import type { BotAPI } from '../../types.js';
+import type { Plugin } from '../plugin-manager.js';
+import type { Entity } from '../../entity/entity.js';
+export declare class CombatPlugin implements Plugin {
+    name: string;
+    private bot;
+    initialize(bot: BotAPI): void;
+    /**
+     * Attack an entity.
+     */
+    attack(entity: Entity): void;
+    /**
+     * Use item in hand.
+     */
+    useItem(hand?: number): void;
+}
+//# sourceMappingURL=combat.d.ts.map

package/dist/plugins/built-in/combat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combat.d.ts","sourceRoot":"","sources":["../../../src/plugins/built-in/combat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAOrD,qBAAa,YAAa,YAAW,MAAM;IACvC,IAAI,SAAY;IAChB,OAAO,CAAC,GAAG,CAAU;IAErB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAgB5B;;OAEG;IACH,OAAO,CAAC,IAAI,GAAE,MAAU,GAAG,IAAI;CASlC"}

package/dist/plugins/built-in/combat.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Combat Plugin — handles attacking entities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CombatPlugin = void 0;
+const play_js_1 = require("../../protocol/states/play.js");
+const types_js_1 = require("../../protocol/types.js");
+class CombatPlugin {
+    name = 'combat';
+    bot;
+    initialize(bot) {
+        this.bot = bot;
+    }
+    /**
+     * Attack an entity.
+     */
+    attack(entity) {
+        // Send Interact packet (attack)
+        const writer = new types_js_1.BufferWriter();
+        writer.writeVarInt(entity.id); // Entity ID
+        writer.writeVarInt(1); // Type: Attack
+        writer.writeBool(false); // Sneaking
+        this.bot.sendPacket(play_js_1.PlayServerboundPackets.INTERACT, writer.toBuffer());
+        // Swing arm
+        this.bot.sendPacket(play_js_1.PlayServerboundPackets.SWING_ARM, (0, play_js_1.buildSwingArmPacket)(0) // Main hand
+        );
+    }
+    /**
+     * Use item in hand.
+     */
+    useItem(hand = 0) {
+        const writer = new types_js_1.BufferWriter();
+        writer.writeVarInt(hand);
+        writer.writeVarInt(0); // Sequence
+        writer.writeFloat(this.bot.entity.yaw);
+        writer.writeFloat(this.bot.entity.pitch);
+        this.bot.sendPacket(play_js_1.PlayServerboundPackets.USE_ITEM, writer.toBuffer());
+    }
+}
+exports.CombatPlugin = CombatPlugin;
+//# sourceMappingURL=combat.js.map

package/dist/plugins/built-in/combat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combat.js","sourceRoot":"","sources":["../../../src/plugins/built-in/combat.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,2DAGuC;AACvC,sDAAuD;AAEvD,MAAa,YAAY;IACrB,IAAI,GAAG,QAAQ,CAAC;IACR,GAAG,CAAU;IAErB,UAAU,CAAC,GAAW;QAClB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc;QACjB,gCAAgC;QAChC,MAAM,MAAM,GAAG,IAAI,uBAAY,EAAE,CAAC;QAClC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAS,YAAY;QACnD,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAkB,eAAe;QACvD,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAgB,WAAW;QAEnD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,gCAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAExE,YAAY;QACZ,IAAI,CAAC,GAAG,CAAC,UAAU,CACf,gCAAsB,CAAC,SAAS,EAChC,IAAA,6BAAmB,EAAC,CAAC,CAAC,CAAC,YAAY;SACtC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,OAAe,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,uBAAY,EAAE,CAAC;QAClC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW;QAClC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEzC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,gCAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5E,CAAC;CACJ;AAvCD,oCAuCC"}

package/dist/plugins/plugin-manager.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Plugin System — extensible architecture for bot functionality.
+ */
+import type { BotAPI } from '../types.js';
+export interface Plugin {
+    /** Unique plugin name */
+    name: string;
+    /** Initialize the plugin with the bot instance */
+    initialize(bot: BotAPI): void;
+    /** Clean up when plugin is unloaded */
+    destroy?(): void;
+}
+/**
+ * Plugin Manager — handles plugin registration and lifecycle.
+ */
+export declare class PluginManager {
+    private plugins;
+    private bot;
+    setBotInstance(bot: BotAPI): void;
+    /**
+     * Register and initialize a plugin.
+     */
+    register(plugin: Plugin): void;
+    /**
+     * Initialize all registered plugins (called when bot is ready).
+     */
+    initializeAll(bot: BotAPI): void;
+    /**
+     * Unregister and destroy a plugin.
+     */
+    unregister(name: string): void;
+    /**
+     * Get a plugin by name.
+     */
+    get<T extends Plugin>(name: string): T | undefined;
+    /**
+     * Check if a plugin is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered plugin names.
+     */
+    getAll(): string[];
+    /**
+     * Destroy all plugins.
+     */
+    destroyAll(): void;
+}
+//# sourceMappingURL=plugin-manager.d.ts.map

package/dist/plugins/plugin-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../src/plugins/plugin-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,MAAM;IACnB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IAEb,kDAAkD;IAClD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,uCAAuC;IACvC,OAAO,CAAC,IAAI,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,GAAG,CAAuB;IAElC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAW9B;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOhC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ9B;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIlD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,MAAM,IAAI,MAAM,EAAE;IAIlB;;OAEG;IACH,UAAU,IAAI,IAAI;CAMrB"}

package/dist/plugins/plugin-manager.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * Plugin System — extensible architecture for bot functionality.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginManager = void 0;
+/**
+ * Plugin Manager — handles plugin registration and lifecycle.
+ */
+class PluginManager {
+    plugins = new Map();
+    bot = null;
+    setBotInstance(bot) {
+        this.bot = bot;
+    }
+    /**
+     * Register and initialize a plugin.
+     */
+    register(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            throw new Error(`Plugin "${plugin.name}" is already registered`);
+        }
+        if (this.bot) {
+            plugin.initialize(this.bot);
+        }
+        this.plugins.set(plugin.name, plugin);
+    }
+    /**
+     * Initialize all registered plugins (called when bot is ready).
+     */
+    initializeAll(bot) {
+        this.bot = bot;
+        for (const plugin of this.plugins.values()) {
+            plugin.initialize(bot);
+        }
+    }
+    /**
+     * Unregister and destroy a plugin.
+     */
+    unregister(name) {
+        const plugin = this.plugins.get(name);
+        if (plugin) {
+            plugin.destroy?.();
+            this.plugins.delete(name);
+        }
+    }
+    /**
+     * Get a plugin by name.
+     */
+    get(name) {
+        return this.plugins.get(name);
+    }
+    /**
+     * Check if a plugin is registered.
+     */
+    has(name) {
+        return this.plugins.has(name);
+    }
+    /**
+     * Get all registered plugin names.
+     */
+    getAll() {
+        return Array.from(this.plugins.keys());
+    }
+    /**
+     * Destroy all plugins.
+     */
+    destroyAll() {
+        for (const plugin of this.plugins.values()) {
+            plugin.destroy?.();
+        }
+        this.plugins.clear();
+    }
+}
+exports.PluginManager = PluginManager;
+//# sourceMappingURL=plugin-manager.js.map

package/dist/plugins/plugin-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manager.js","sourceRoot":"","sources":["../../src/plugins/plugin-manager.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAeH;;GAEG;AACH,MAAa,aAAa;IACd,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,GAAG,GAAkB,IAAI,CAAC;IAElC,cAAc,CAAC,GAAW;QACtB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAc;QACnB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,yBAAyB,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,GAAW;QACrB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACL,CAAC;IAED;;OAEG;IACH,GAAG,CAAmB,IAAY;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAkB,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,MAAM;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,UAAU;QACN,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACJ;AAzED,sCAyEC"}