原创 【XMNearbyInfo·周围物品播报】 1.0.1

插件简介​

主要功能​

掉落物品扫描​

• 按下按键（配置设置键位）扫描周围掉落物品，无视线要求自动检测半径
• 显示物品名称和数量
• 支持重命名物品识别
• 自动合并相同物品的数量

实体瞄准检测​

• 用准星瞄准实体按下按键
• 识别瞄准的实体类型
• 支持 100 米射线距离
• 实体汉化名称：
  • 推荐：安装XMPlayerAdmin·玩家管理调用实体中文名称，支持游戏内几乎所有实体
  • 未安装，不支持实体翻译，需要手动配置文件设置预制名和对应显示名称（未配置的实体无法发出消息）
  • 摆放物品无需添加配置，自动识别

npc名称自识别​

• 三种方式识别 NPC 名称：
  • entity.name（实体自定义名称）
  • npcPlayer.displayName（NPC 显示名）
  • combatEntity.name（战斗实体名称）
• 如果是玩家，会显示玩家名称
  • 如果安装XMSanity·San值，还会显示对方的san值（以便远离san值低的玩家）

玩家位置纪念碑扫描​

• 安装DWMonumentTP - 传送点系统
• 判断玩家所在纪念碑位置
• 播报：我在xxx

优先级说明​

• 如果配置所有扫描都开启
• 高优先级组（可同时播报）：
  • 1·掉落物品（范围检测）
  • 2·视线实体（射线检测，需开启）
  • 3·范围NPC（范围检测，需开启
• 低优先级组（可同时播报）：
  • 1·纪念碑（需DWMonumentTP，需开启）
  • 2·范围玩家（范围检测，需开启）
• 播报逻辑：
  • 如果检测到高优先级组的任意内容，只播报高优先级组，不播报玩家和纪念碑
  • 如果高优先级组都没有，才检测并播报低优先级组
  • 同组内的内容可以同时播报在一条消息中（换行分隔）
• 具体场景示例：
  
  场景1：地上有木头 + 附近有玩家
  → 只播报
  "我附近有250个木头"（不播报玩家）
  
  场景2：没有掉落物/实体/NPC + 在加油站 + 附近有玩家
  → 播报
  "我在加油站
  我附近有1玩家 熊猫君（san值：75/100）"
  
  场景3：没有掉落物/实体/NPC + 在加油站 + 没有玩家
  → 只播报
  "我在加油站"
  
  场景4：没有掉落物/实体/NPC + 不在纪念碑 + 附近有玩家
  → 只播报
  "我附近有1玩家 熊猫君（san值：75/100）"

使用方法​

扫描掉落物品​

1. 按下按键
2. 范围内有掉落物品
3. 查看聊天消息

检测实体（需开启实体播报）​

1. "启用实体播报": true,
2. 用准心瞄准实体
3. 按下按键
4. 显示实体名称

检测npc​

1. "启用NPC检测": true,
2. 范围内存在npc
3. 按下按键
4. 显示npc名和血量状态（如果BOSS插件支持）

检测玩家​

1. "启用玩家检测": true,
2. 范围内存在玩家
3. 按下按键
4. 显示玩家名称 如安装san值插件额外显示对方san值

检测纪念碑​

1. "启用纪念碑检测": true,
2. 玩家在纪念碑附近
3. 按下按键
4. “我在XXX”

权限​

指令​

配置​

{
  "按键模式(1=Shift+R 2=Ctrl+R 3=鼠标左键 4=鼠标右键 5=鼠标滚轮)": 4,
  "检测半径": 10.0,
  "聊天冷却": 3.0,
  "聊天格式": "我附近有{0}个{1}.",
  "启用实体播报": true,
  "启用玩家检测": true,
  "启用NPC检测": true,
  "启用纪念碑检测": true,
  "实体名称设置": [
    {
      "实体预制名": "assets/bundled/prefabs/autospawn/resource/ores_sand/stone-ore.prefab",
      "显示名": "石头矿石"
    },
    {
      "实体预制名": "assets/bundled/prefabs/autospawn/resource/ores_sand/sulfur-ore.prefab",
      "显示名": "硫磺矿石"
    },
    {
      "实体预制名": "assets/bundled/prefabs/autospawn/resource/ores_sand/metal-ore.prefab",
      "显示名": "金属矿石"
    }
  ]
}

配置说明​

• 模式1：Shift + R
• 模式2：Ctrl + R
• 模式3：鼠标左键 - 空手时触发（检查 GetActiveItem() == null）
• 模式4：鼠标右键 - 空手时触发（检查 GetActiveItem() == null）
• 模式5：鼠标滚轮 - 中键点击

• 仅用于扫描掉落物品、npc、玩家
• 实体检测不受此限制，使用射线瞄准

• 两次检测之间的冷却时间
• 防止刷屏

• {0} = 数量
• {1} = 名称
• 示例："我附近有{0}个{1}."

• false：只扫描掉落物品
• true：可以检测启用的类型，半径内有掉落物品优先播报物品，没有会检测其他开启的类型

• 自定义特定实体的显示名称
• 支持完整预制路径
• 未安装XMPlayerAdmin也仅支持配置设置的实体才能播报