WhatIsThis - Identify the block or entity being looked at - WhatIsThis - 目标识别

💡简介

WhatIsThis 是一款轻量级实用插件，旨在无需打开任何界面即可为玩家直接提供方块与实体的信息。只需右键点击方块或使用命令，即可显示目标方块或实体的类型及其掉落物。它还能配置为自动显示你正在观察的目标，非常适合在生存模式中识别未知方块，或在创造模式中了解他人建筑、使用 Slimefun4 等自定义方块插件时使用。

🎮核心功能

• 即时识别：快速获取你正在观察的方块或实体的名称。
• 掉落物信息：显示方块被破坏时会掉落的物品及其数量范围。
• 多种显示方式：信息可通过动作栏、Boss 血条、记分板或聊天栏显示。
• 自动显示模式：启用后，仅需注视不同方块，信息便会自动更新。
• 多语言支持：自动匹配玩家客户端的语言显示方块与物品名称。
• 广泛兼容：支持识别众多主流自定义物品/实体插件的内容。
• 高度可配置：可忽略特定方块/实体，调整显示距离、颜色等。

🔧使用说明

基本操作

• 使用命令 /wt 来识别你正在观察的方块或实体。
• 默认情况下，手持木棍右键点击方块也可触发识别。
• 识别最大距离默认为 10 格，你需要有清晰的视线。

显示模式

• 动作栏显示：最简洁美观，仅显示名称。
• Boss 血条显示：显示名称，针对实体还会显示其生命值。
• 记分板/聊天栏显示：可同时显示名称与详细的掉落物信息。

配置要点

• 自动显示：在配置文件中启用 auto_display 选项可实现注视即显示。请注意： 此功能可能影响服务器性能，且启用后需重启服务器才能生效。
• 忽略列表：可配置忽略如空气、水、草方块等常见方块，或指定忽略的实体。
• 右键物品：可通过 /wt toggleclick 命令开关右键功能，或在配置中将其更改为其他物品（包括空手）。

✨命令与权限

命令列表

• /wt - 识别正在观察的方块或实体。
• /wt info - 显示插件信息。
• /wt reload - 重载配置文件（需要 whatisthis.admin 权限）。
• /wt toggleclick - 切换右键点击识别功能的开关（需要 whatisthis.admin 权限）。

权限节点

• whatisthis.use - 默认所有玩家均拥有，允许使用基础识别功能。
• whatisthis.admin - 默认仅 OP 拥有，允许使用重载和切换命令。

⭐依赖与兼容性

服务器要求

• 最新版 (5.7+) 要求：

- Java 21

- Minecraft/Spigot 1.21.3+

• 历史版本：

- 版本 5.7：适用于 Minecraft/Spigot 1.21.1。

- 版本 5.6：适用于 Minecraft/Spigot 1.20.6。

- 版本 5.5：适用于 Minecraft/Spigot 1.17.1 - 1.20.4 (需 Java 17)。

- 更早版本支持至 1.13.2。

支持的插件

最新版本支持以下插件的自定义方块与实体

• Nexo 1.8.0+
• Slimefun4 RC-37+
• Nova 0.19+
• ItemsAdder 4.0.10+
• Citizens 2.0.39+
• MythicMobs 5.9.5+
• Oraxen 1.164.0+

❓配置详解

以下是配置文件 config.yml 的关键部分说明：

# 检查插件更新
check_for_update: true

# 右键点击设置
use_right_click:
  enabled: true
  item: STICK # 可设置为 AIR 或 NONE 来使用空手

# 多语言设置，可指定只加载特定语言以节省资源
LoadLanguage:
  - all # 加载全部语言，可替换为如 [en_us, zh_cn]

# 显示方式设置
Display:
  auto_display: false # 启用自动显示
  prefix_custom_blocks: # 为自定义方块/实体添加来源插件前缀
    enabled: true
    prefix: '&7[&f{PREFIX}&7] '

  # 动作栏显示
  actionbar:
    enabled: false
    textcolor: WHITE

  # 记分板显示（可显示掉落物）
  scoreboard:
    enabled: true
    timeout: 60 # 显示时长（刻）

  # Boss血条显示
  bossbar:
    enabled: false
    barcolor: GREEN

  # 聊天栏显示
  chat:
    enabled: false
    show_drops: true

# 忽略列表
IgnoreBlocks:
  - AIR
  - WATER
  - GRASS_BLOCK
IgnoreEntities:
  - COW
  - PIG

🔧PlaceholderAPI 占位符

若安装 PlaceholderAPI，可使用以下占位符：

• %whatisthis_blockname% - 目标方块名称
• %whatisthis_entityname% - 目标实体名称
• %whatisthis_resourcename% - 提供该方块的资源（插件）名称
• %whatisthis_locationX%, %whatisthis_locationY%, %whatisthis_locationZ% - 目标坐标
• %whatisthis_version% - 插件版本号

⭐安装与数据统计

安装步骤

• 下载 WhatIsThis.jar。
• 将其放入服务器的 plugins 文件夹。
• 重启服务器。

数据统计 (bStats)

本插件使用 bStats 收集匿名使用数据（如服务器数量、插件版本），以帮助开发者改进。数据每30分钟异步提交一次，您可以在配置中禁用此功能，但我们希望您能保持开启以支持开发。

统计数据可在此查看：https://bstats.org/plugin/bukkit/WhatIsThis

❓问题与支持

• Discord：加入我们的 Discord 服务器以便讨论问题和分享信息。
• GitHub Issues：在 GitHub 仓库的 Issues 页面提交问题或建议。
• Spigot 讨论区：在 Spigot 插件页面的讨论区发帖。

请注意：请不要在插件评论区请求帮助或功能，请使用上述渠道并提供尽可能详细的信息。