@elizaos/plugin-minecraft 2.0.0-alpha.1

package/dist/protocol.d.ts

@@ -0,0 +1,21 @@
+export type JsonValue = null | boolean | number | string | {
+    [key: string]: JsonValue;
+} | JsonValue[];
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type MinecraftBridgeRequestType = "health" | "createBot" | "destroyBot" | "chat" | "control" | "look" | "goto" | "stop" | "dig" | "place" | "equip" | "useItem" | "attack" | "getState" | "getInventory" | "scan";
+export interface MinecraftBridgeRequest {
+    type: MinecraftBridgeRequestType;
+    requestId: string;
+    botId?: string;
+    data?: JsonObject;
+}
+export interface MinecraftBridgeResponse {
+    type: string;
+    requestId: string;
+    success: boolean;
+    data?: JsonObject;
+    error?: string;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC5B,SAAS,EAAE,CAAC;AAEhB,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,0BAA0B,GAClC,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,MAAM,GACN,SAAS,GACT,MAAM,GACN,MAAM,GACN,MAAM,GACN,KAAK,GACL,OAAO,GACP,OAAO,GACP,SAAS,GACT,QAAQ,GACR,UAAU,GACV,cAAc,GACd,MAAM,CAAC;AAEX,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,0BAA0B,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/providers/index.d.ts

@@ -0,0 +1,4 @@
+export { minecraftVisionProvider } from "./vision.js";
+export { minecraftWaypointsProvider } from "./waypoints.js";
+export { minecraftWorldStateProvider } from "./world-state.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/providers/vision.d.ts

@@ -0,0 +1,3 @@
+import type { Provider } from "@elizaos/core";
+export declare const minecraftVisionProvider: Provider;
+//# sourceMappingURL=vision.d.ts.map

package/dist/providers/vision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.d.ts","sourceRoot":"","sources":["../../src/providers/vision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,QAAQ,EAGT,MAAM,eAAe,CAAC;AAMvB,eAAO,MAAM,uBAAuB,EAAE,QA8GrC,CAAC"}

package/dist/providers/waypoints.d.ts

@@ -0,0 +1,3 @@
+import type { Provider } from "@elizaos/core";
+export declare const minecraftWaypointsProvider: Provider;
+//# sourceMappingURL=waypoints.d.ts.map

package/dist/providers/waypoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waypoints.d.ts","sourceRoot":"","sources":["../../src/providers/waypoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,QAAQ,EAGT,MAAM,eAAe,CAAC;AAMvB,eAAO,MAAM,0BAA0B,EAAE,QAwCxC,CAAC"}

package/dist/providers/world-state.d.ts

@@ -0,0 +1,3 @@
+import type { Provider } from "@elizaos/core";
+export declare const minecraftWorldStateProvider: Provider;
+//# sourceMappingURL=world-state.d.ts.map

package/dist/providers/world-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-state.d.ts","sourceRoot":"","sources":["../../src/providers/world-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,QAAQ,EAGT,MAAM,eAAe,CAAC;AAOvB,eAAO,MAAM,2BAA2B,EAAE,QAgEzC,CAAC"}

package/dist/services/minecraft-service.d.ts

@@ -0,0 +1,32 @@
+import { type IAgentRuntime, Service } from "@elizaos/core";
+import type { JsonObject, MinecraftBridgeRequestType } from "../protocol.js";
+import { type MinecraftSession, type MinecraftWorldState } from "../types.js";
+import { MinecraftWebSocketClient } from "./websocket-client.js";
+export declare const MINECRAFT_SERVICE_TYPE: "minecraft";
+export declare class Session implements MinecraftSession {
+    botId: string;
+    createdAt: Date;
+    constructor(botId: string, createdAt?: Date);
+}
+export declare class MinecraftService extends Service {
+    static serviceType: "minecraft";
+    capabilityDescription: string;
+    private session;
+    private processManager;
+    private client;
+    private isInitialized;
+    constructor(runtime?: IAgentRuntime);
+    static start(runtime: IAgentRuntime): Promise<MinecraftService>;
+    initialize(): Promise<void>;
+    stop(): Promise<void>;
+    getClient(): MinecraftWebSocketClient;
+    getCurrentSession(): Session | null;
+    createBot(overrides?: JsonObject): Promise<Session>;
+    destroyBot(botId: string): Promise<void>;
+    ensureBot(): Promise<Session>;
+    chat(message: string): Promise<void>;
+    request(type: MinecraftBridgeRequestType, data: JsonObject): Promise<JsonObject>;
+    getWorldState(): Promise<MinecraftWorldState>;
+    private waitForReady;
+}
+//# sourceMappingURL=minecraft-service.d.ts.map

package/dist/services/minecraft-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minecraft-service.d.ts","sourceRoot":"","sources":["../../src/services/minecraft-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EAEzB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,eAAO,MAAM,sBAAsB,EAAG,WAAoB,CAAC;AAE3D,qBAAa,OAAQ,YAAW,gBAAgB;IAErC,KAAK,EAAE,MAAM;IACb,SAAS,EAAE,IAAI;gBADf,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,IAAiB;CAEtC;AAED,qBAAa,gBAAiB,SAAQ,OAAO;IAC3C,MAAM,CAAC,WAAW,cAA0B;IAC5C,qBAAqB,SAAsD;IAE3E,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,CAAC,EAAE,aAAa;WAgBtB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY/D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,SAAS,IAAI,wBAAwB;IAOrC,iBAAiB,IAAI,OAAO,GAAG,IAAI;IAI7B,SAAS,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBnD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAK7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpC,OAAO,CACX,IAAI,EAAE,0BAA0B,EAChC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,UAAU,CAAC;IAMhB,aAAa,IAAI,OAAO,CAAC,mBAAmB,CAAC;YAYrC,YAAY;CAY3B"}

package/dist/services/process-manager.d.ts

@@ -0,0 +1,13 @@
+export declare class MinecraftProcessManager {
+    private serverPort;
+    private process;
+    private isRunning;
+    private entryPath;
+    constructor(serverPort: number);
+    private findEntry;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isServerRunning(): boolean;
+    getServerUrl(): string;
+}
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/services/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../src/services/process-manager.ts"],"names":[],"mappings":"AAOA,qBAAa,uBAAuB;IAKtB,OAAO,CAAC,UAAU;IAJ9B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAuB;gBAEpB,UAAU,EAAE,MAAM;IAItC,OAAO,CAAC,SAAS;IAwBX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4DtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,eAAe,IAAI,OAAO;IAI1B,YAAY,IAAI,MAAM;CAGvB"}

package/dist/services/waypoints-service.d.ts

@@ -0,0 +1,29 @@
+import type { IAgentRuntime, UUID } from "@elizaos/core";
+import { Service } from "@elizaos/core";
+export declare const WAYPOINTS_SERVICE_TYPE: "minecraft_waypoints";
+export type Waypoint = {
+    id: UUID;
+    name: string;
+    x: number;
+    y: number;
+    z: number;
+    createdAt: Date;
+};
+export declare class WaypointsService extends Service {
+    static serviceType: "minecraft_waypoints";
+    capabilityDescription: string;
+    private waypoints;
+    private waypointsRoomId;
+    private waypointsWorldId;
+    constructor(runtime?: IAgentRuntime);
+    static start(runtime: IAgentRuntime): Promise<WaypointsService>;
+    stop(): Promise<void>;
+    private initialize;
+    private waypointIdForKey;
+    private buildWaypointMemory;
+    setWaypoint(name: string, x: number, y: number, z: number): Promise<Waypoint>;
+    deleteWaypoint(name: string): Promise<boolean>;
+    getWaypoint(name: string): Waypoint | null;
+    listWaypoints(): Waypoint[];
+}
+//# sourceMappingURL=waypoints-service.d.ts.map

package/dist/services/waypoints-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waypoints-service.d.ts","sourceRoot":"","sources":["../../src/services/waypoints-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,aAAa,EAGb,IAAI,EACL,MAAM,eAAe,CAAC;AACvB,OAAO,EAA2B,OAAO,EAAgB,MAAM,eAAe,CAAC;AAE/E,eAAO,MAAM,sBAAsB,EAAG,qBAA8B,CAAC;AAErE,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAUF,qBAAa,gBAAiB,SAAQ,OAAO;IAC3C,MAAM,CAAC,WAAW,wBAA0B;IAC5C,qBAAqB,SAAuD;IAE5E,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,eAAe,CAAO;IAC9B,OAAO,CAAC,gBAAgB,CAAO;gBAEnB,OAAO,CAAC,EAAE,aAAa;WAgBtB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAM/D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAIb,UAAU;IAsExB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,mBAAmB;IA+BrB,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,OAAO,CAAC,QAAQ,CAAC;IAgCd,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUpD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAK1C,aAAa,IAAI,QAAQ,EAAE;CAK5B"}

package/dist/services/websocket-client.d.ts

@@ -0,0 +1,13 @@
+import type { JsonObject, MinecraftBridgeRequestType, MinecraftBridgeResponse } from "../protocol.js";
+export declare class MinecraftWebSocketClient {
+    private serverUrl;
+    private ws;
+    private pending;
+    constructor(serverUrl: string);
+    connect(): Promise<void>;
+    disconnect(): void;
+    health(): Promise<boolean>;
+    sendMessage(type: MinecraftBridgeRequestType, botId: string | undefined, data: JsonObject, timeoutMs?: number): Promise<MinecraftBridgeResponse>;
+    private onMessage;
+}
+//# sourceMappingURL=websocket-client.d.ts.map

package/dist/services/websocket-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-client.d.ts","sourceRoot":"","sources":["../../src/services/websocket-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EAGV,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AA8BxB,qBAAa,wBAAwB;IAIvB,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAmC;gBAE9B,SAAS,EAAE,MAAM;IAE/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB9B,UAAU,IAAI,IAAI;IAKZ,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAK1B,WAAW,CACf,IAAI,EAAE,0BAA0B,EAChC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,UAAU,EAChB,SAAS,GAAE,MAAe,GACzB,OAAO,CAAC,uBAAuB,CAAC;IAwCnC,OAAO,CAAC,SAAS;CAiBlB"}

package/dist/types.d.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import type { JsonObject } from "./protocol.js";
+export interface MinecraftSession {
+    botId: string;
+    createdAt: Date;
+}
+export interface MinecraftActionResult {
+    success: boolean;
+    data?: JsonObject;
+    error?: string;
+}
+export declare const minecraftWorldStateSchema: z.ZodObject<{
+    connected: z.ZodBoolean;
+    username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    health: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    food: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    experience: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    position: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>>>;
+    yaw: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    pitch: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    time: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    isRaining: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    inventory: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        count: z.ZodNumber;
+        slot: z.ZodNumber;
+    }, z.core.$strip>>>;
+    nearbyEntities: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        type: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        username: z.ZodNullable<z.ZodString>;
+        kind: z.ZodNullable<z.ZodString>;
+        position: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            z: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>>;
+}, z.core.$loose>;
+export type MinecraftWorldState = z.infer<typeof minecraftWorldStateSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuCtB,CAAC;AAEjB,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@elizaos/plugin-minecraft",
+  "description": "Minecraft automation plugin for ElizaOS (Mineflayer bridge)",
+  "version": "2.0.0-alpha.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "packageType": "plugin",
+  "platform": "node",
+  "license": "MIT",
+  "keywords": [
+    "plugin",
+    "elizaos",
+    "minecraft",
+    "mineflayer"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elizaos/eliza"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "dependencies": {
+    "ws": "^8.18.0",
+    "zod": "^4.3.5"
+  },
+  "peerDependencies": {
+    "@elizaos/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.10",
+    "typescript": "^5.9.3",
+    "@biomejs/biome": "^2.3.11"
+  },
+  "scripts": {
+    "dev": "bun --hot build.ts",
+    "test": "vitest run || echo 'TypeScript tests skipped - no tests found'",
+    "lint": "bunx @biomejs/biome check --write --unsafe .",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo",
+    "lint:check": "bunx @biomejs/biome check .",
+    "build": "bun run build.ts",
+    "build:ts": "bun run build.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}