转载 开源 工具 OBX Insight 1.0.1

[MD]
# OBX Insight

## 现代化物品检查与调试工具

通过简洁的 GUI 检查任意 Minecraft 物品，清楚了解其中存储的全部数据。

与传统的物品检查工具不同，OBX Insight 不只是展示物品数据，还会对其进行解读。检查结果会按清晰的类别整理，无需翻阅原始元数据或使用开发者工具，即可轻松了解物品的构成。


### 核心功能

- 只读物品检查
- 分类式背包 GUI
- 支持现代 Paper 数据组件
- Persistent Data Container（持久化数据容器）浏览器
- 易于理解的检查结果
- 按版本适配的导出功能
- 无需数据库

## 为什么选择 OBX Insight？

Minecraft 中的物品正变得愈发复杂。

自定义名称、Lore、附魔、属性、数据组件、Persistent Data Container 以及插件专属元数据等内容，都可能让排查物品行为异常的原因变得困难。

OBX Insight 会将这些信息归纳至明确的检查分类中，既适合服务器管理，也适合插件开发。

## 检查分类

| 分类 | 说明 |
| --- | --- |
| **概览** | 物品的基本标识、材质、稀有度、耐久度及分类信息。 |
| **外观** | 显示名称、Lore、文本格式、模型与工具提示信息。 |
| **附魔** | 已生效与已储存的附魔、冲突情况及不安全等级。 |
| **属性** | 属性修饰符、运算方式、装备槽位与数值。 |
| **组件** | 现代 Paper 数据组件及显式覆盖项。 |
| **持久化数据** | 存储在物品中的、带命名空间的插件数据。 |
| **专用元数据** | 书、药水、旗帜、玩家头颅、烟花、地图等物品专属信息。 |
| **原始数据** | 面向开发者的序列化物品数据。 |
| **诊断结果** | 警告、异常数值、不受支持的数据及诊断建议。 |

## 导出功能

可直接在检查菜单中生成诊断报告。

- JSON 检查报告
- MiniMessage 文本导出
- 按版本适配的 Give Command 生成 `/give`
- 原始物品数据（仅在支持时提供）

导出功能旨在用于故障排查、技术支持请求与开发工作，并不用于跨版本复刻物品。

## 命令

| 命令 | 说明 |
| --- | --- |
| `/inspect` | 启用临时背包选择模式。 |
| `/inspect hand` | 检查主手物品。 |
| `/inspect offhand` | 检查副手物品。 |
| `/inspect reopen` | 重新打开上一次的检查界面。 |
| `/inspect export` | 打开导出菜单。 |
| `/inspect reload` | 重载配置与消息文件。 |

别名：`/insight`

## 运行要求

- **Minecraft：** Paper 1.21.4+
- **Java：** 21

## 安装方法

1. 下载最新版本。
2. 将插件放入服务器的 `plugins/` 文件夹。
3. 启动或重启服务器。
4. 在游戏内执行 `/inspect`。

## 支持与反馈

需要帮助或有功能建议？

- [Documentation](https://github.com/zcripted/OBX-Insight)
- [Discord](https://discord.zcripted.dev)
- [Issue Tracker](https://github.com/zcripted/OBX-Insight/issues)

## 开发计划

后续版本计划加入：

- 物品对比
- 自定义物品集成
- 高级检查目标
- 检查历史记录
- 开发者 API

## 许可证

OBX Insight 采用 **MIT License** 发布。
[/MD]