cortico 0.1.0 → 0.1.2

package/src/worlds/minecraft/entity-facts.ts

@@ -1,13 +1,16 @@
 /** 实体元数据字段位置取自 registry.entitiesByName 的 metadataKeys。 */
+import type { Bot } from 'mineflayer';
+import { matchBlockIds } from './travel.ts';
+import { zhName } from './names.ts';
 
-interface NamedStack { name?: string }
+export interface NamedStack { name?: string }
 
-interface FactEntity {
+export interface FactEntity {
   name?: string;
   metadata?: unknown[];
 }
 
-interface FactBot {
+export interface FactBot {
   entity?: { uuid?: string } | null;
   /** 登录时玩家 UUID 优先取 bot.player，其次取实体或协议客户端。 */
   player?: { uuid?: string } | null;
@@ -18,7 +21,7 @@ interface FactBot {
   };
 }
 
-function metaOf(bot: FactBot, entity: FactEntity, key: string): unknown {
+export function metaOf(bot: FactBot, entity: FactEntity, key: string): unknown {
   const name = entity.name;
   if (!name) return undefined;
   const keys = bot.registry?.entitiesByName?.[name]?.metadataKeys ?? [];
@@ -112,7 +115,7 @@ export function readHorseTamed(bot: FactBot, entity: FactEntity): boolean | null
 }
 
 /** 羊毛元数据的低四位是颜色,第五位(0x10)是"剪过了"。 */
-const WOOL_COLORS = [
+export const WOOL_COLORS = [
   'white', 'orange', 'magenta', 'light_blue', 'yellow', 'lime', 'pink', 'gray',
   'light_gray', 'cyan', 'purple', 'blue', 'brown', 'green', 'red', 'black',
 ] as const;
@@ -130,3 +133,26 @@ export function readSheepColor(bot: FactBot, entity: FactEntity): string | null
   if (typeof raw !== 'number') return null;
   return WOOL_COLORS[raw & 0x0f] ?? null;
 }
+/** 可攻击目标名限定为实体类型 ID 或在线玩家名。 */
+/** use.target 只接受活物；无效目标的回执说明可接受类型及改用 at 的方块写法。 */
+export function unknownUseTargetText(bot: Bot, target: string): string {
+  const head = `use 的 target 只认活物(生物、玩家),「${target}」不是活物`;
+  const ids = matchBlockIds(bot, target);
+  if (ids.length === 0) return `${head};要右键一格方块的话写 {"skill":"use","at":[x,y,z]}`;
+  // 现场恰好找得到那一格就把坐标一并给出:她照抄就能用
+  const near = bot.findBlocks({ matching: ids, maxDistance: 16, count: 1 })[0] ?? null;
+  if (!near) {
+    return `${head},它是方块 —— 右键方块写 {"skill":"use","at":[x,y,z]};` +
+      `那一格在哪先用 {"skill":"find","target":"${target}","distance":16} 问一句`;
+  }
+  return `${head},它是方块 —— 右键它写 {"skill":"use","at":[${near.x},${near.y},${near.z}]}` +
+    `(${zhName(target)}就在那一格,16 格内看得见的最近一处)`;
+}
+
+export function isKnownTarget(bot: Bot, name: string): boolean {
+  const n = name.toLowerCase();
+  const entities = (bot.registry as unknown as { entitiesByName?: Record<string, unknown> }).entitiesByName;
+  if (entities?.[n]) return true;
+  return Object.keys(bot.players ?? {}).some((p) => p.toLowerCase() === n);
+}
+