yeow-api 0.4.1 → 0.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "yeow-api",
-    "version": "0.4.1",
+    "version": "0.4.2",
     "description": "Yeow API",
     "type": "module",
     "main": "./src/index.ts",

package/src/player.ts

@@ -2,6 +2,7 @@ import { call, post } from './task.js';
 import type { TaskOptions } from './task.js';
 import { Location, LocationData } from './location.js';
 import type { ItemStack } from './item.js';
+import { Block } from './block.js';
 import type { Message } from './message.js';
 import type { Permission } from './permission.js';
 import { Inventory } from './inventory.js';
@@ -170,6 +171,27 @@ export class Player {
   }
   teleport(loc: Location, options?: TaskOptions): Promise<void> { return post('player.teleport', { uuid: this.uuid, ...loc.toObject() }, options); }
   teleportSync(loc: Location, options?: TaskOptions): void { call('player.teleport', { uuid: this.uuid, ...loc.toObject() }, options); }
+  /** 向玩家发送假方块变化（仅客户端视觉，不改变真实世界）。block 为 Block 对象或字符串（同 world.setBlock，字符串无状态）。 */
+  sendBlockChange(location: Location, block: Block | string, options?: TaskOptions): Promise<void> {
+    const p: Record<string, unknown> = { uuid: this.uuid, ...location.toObject() };
+    if (typeof block === 'string') {
+      p.blockType = block;
+    } else {
+      p.blockType = block.type;
+      if (block.state && Object.keys(block.state).length > 0) p.state = block.state;
+    }
+    return post('player.sendBlockChange', p, options);
+  }
+  sendBlockChangeSync(location: Location, block: Block | string, options?: TaskOptions): void {
+    const p: Record<string, unknown> = { uuid: this.uuid, ...location.toObject() };
+    if (typeof block === 'string') {
+      p.blockType = block;
+    } else {
+      p.blockType = block.type;
+      if (block.state && Object.keys(block.state).length > 0) p.state = block.state;
+    }
+    call('player.sendBlockChange', p, options);
+  }
   sendActionBar(message: string | Message, options?: TaskOptions): Promise<void> { return post('player.sendActionBar', { uuid: this.uuid, message }, options); }
   sendActionBarSync(message: string | Message, options?: TaskOptions): void { call('player.sendActionBar', { uuid: this.uuid, message }, options); }
   sendResourcePack(url: string, hash?: string, prompt?: string | Message, force?: boolean, options?: TaskOptions): Promise<void> {