InvSee++ 查背包插件

InvSee++ 玩家背包查看与编辑

> 一款用于查看、编辑其他玩家背包与末影箱的 Bukkit 插件。支持在线/离线/从未登录过的玩家，覆盖 Minecraft 1.8.8 至 26.2 多个大版本，提供可自定义的旁观界面布局、变更日志与一套简洁而完备的 API。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | InvSee++ |
| 开发者 | Jannyboy11 |
| 最新版本 | v0.31.15（2026-06-17，Release）|
| 许可协议 | LGPL-2.1-only |
| 兼容版本 | Minecraft Java 1.8.8、1.12.2、1.15.2、1.16.5、1.17.1、1.18.2、1.19.4、1.20.1、1.20.4–1.20.6、1.21–1.21.11、26.1.x、26.2 |
| 运行平台 | Bukkit、Paper、Purpur、Spigot 及其分支；兼容 Glowstone；支持 Forge/Bukkit、Fabric/Bukkit 混合端 |
| 运行环境 | Java 11 或以上（部分新版模块建议 Java 17+）|
| 项目地址 | https://modrinth.com/plugin/invsee%2B%2B |
| 官方文档 | https://github.com/Jannyboy11/InvSee-plus-plus/wiki |
简介

InvSee++ 是一款面向 Minecraft 服务端的背包管理插件，核心能力是让管理员（或拥有权限的玩家）查看并直接编辑任意玩家的主背包与末影箱。它不仅覆盖在线玩家，还能作用于已经离线甚至从未登录过服务器的玩家——后者通过用户名/UUID 解析策略补全数据，因此常被用于离线玩家的物品核查、找回与清理。

插件会把目标玩家的库存完整镜像到一个“旁观界面（Spectator Inventory）”中，操作者像打开自己的箱子一样与之交互：包括盔甲栏、副手、合成台/工作台/铁砧/锻造台/切石机/砂轮/织布机/附魔台/商人界面中的临时物品，以及玩家光标上托举的物品，都会被如实呈现。界面支持实时同步，目标玩家重登后旁观库存会自动重载；布局与标题均可自定义，多个管理员还能用不同布局同时旁观同一玩家。

除核心查看/编辑外，InvSee++ 通过独立附属模块提供 give（给予物品） 与 clear（清空物品） 命令，并可选择接入 PerWorldInventory、MultiverseInventories 实现分世界库存感知。它本身只做库存层操作，配置简单，安装后开箱即用。
核心特性
查看与编辑任意库存
通过 /invsee 查看并编辑目标玩家主背包，/endersee 对应末影箱。操作者在镜像界面中的改动会直接写回目标玩家，支持 Shift 批量移动、拖拽等原生交互。
完整镜像：盔甲、副手与界面物品
不仅包含 36 格主库存，还完整呈现盔甲四件套、副手物品，以及玩家正在使用的合成台/工作台/铁砧/锻造台/切石机/砂轮/织布机/附魔台/商人界面的临时物品，连同光标上托举的物品一并展示。
离线玩家支持
即使目标玩家处于离线状态，只要数据可解析即可打开其库存；对于从未登录过服务器的玩家，也可通过用户名/UUID 解析策略构造库存。三项行为分别由配置项 enable-offline-player-support 与 enable-unknown-player-support 控制。
重登自动重载
被旁观的玩家重新登录时，旁观界面会自动刷新以反映最新库存，避免管理员看到过期数据。
可自定义的布局与标题
自 v0.31.15 起，旁观界面的布局（Mirror）可通过配置自由排布：普通容器格、盔甲格、副手、光标、个人界面格、末影箱格各自对应占位符，管理者可按习惯重排。多个管理员可同时以不同布局旁观同一玩家。标题也支持自定义，可包含目标名等动态内容。
占位格可视化
配置项 placeholder-palette 决定可用格以何种方式提示（玻璃板、图标或留空），默认使用玻璃板，让操作者一眼区分“可放物品的格”与“纯展示格”。
变更日志记录
支持将库存的每一次改动按配置粒度记录（从不记录、关闭时汇总、或实时逐次记录），便于审计与回溯，配置通过 LogOptions 完成。
完备的 API
提供 InvseeAPI，支持在线/离线/UUID 已知或未知等多种打开重载方式，返回 CompletableFuture<SpectateResponse>，并通过 CreationOptions 链式定制标题、离线支持、未知玩家支持、豁免绕过、日志与布局。API 对消费者向后兼容。
分世界库存集成
可选接入 PerWorldInventory、MultiverseInventories。启用 PerWorldInventory 时需在其配置中将 load-data-on-join 设为 true；PerWorldInventory + LuckPerms 的兼容性已在 v0.31.13 中修复。
混合端与多服务端支持
兼容 Glowstone、CraftBukkit 及其 Spigot/Paper/Purpur 分支，支持 Forge/Bukkit、Fabric/Bukkit 混合服务器。Folia 暂不支持（因严重 bug，需重新设计，仍在计划中）。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Bukkit、Spigot、Paper、Purpur 等 Spigot 分支；Glowstone；Forge/Bukkit、Fabric/Bukkit 混合端 |
| Java 版本 | Java 11 或以上（新版 Paper 26.x 模块建议使用 Java 17+）|
| 前置依赖 | 可选：Vault（离线玩家权限检查需要）、LuckPerms 等权限插件；PerWorldInventory / MultiverseInventories（分世界集成时需要）|
| 不兼容 | Folia（暂禁用）；CraftBukkit 1.19.1、1.20.2、1.20（旧版模块已逐步移除）|
安装方法
从 Modrinth、Hangar 或 SpigotMC 下载 InvSee++.jar（v0.31.15）
将 jar 放入服务端 plugins/ 目录
重启服务器，插件自动生成默认 config.yml
按需编辑配置（离线支持、未知玩家支持、标题、布局模板、日志、占位格等）
执行 /invseeplusplusreload 重载配置，无需重启

> 升级提醒：从旧版本升级到 v0.31.x 时，建议先备份 plugins/InvSee++/ 目录。v0.31.15 因新增动物盔甲与鞍槽位，主库存槽位编号扩展（41=BODY、42=SADDLE、43=光标），默认 Mirror 已更新；依赖 API 的第三方插件需同步适配 PlayerInventorySlot 枚举变更。InvSee++_Give 在 1.20.5+ 上改用近似原版 /give 的语法（不再使用 NBT 标签），1.20.4 及以下仍沿用旧格式。
命令与权限
命令

| 命令 | 说明 |
| --- | --- |
| /invsee <玩家> | 查看并编辑目标玩家主背包 |
| /invsee PWI{=,...} | 配合 PerWorldInventory，指定 group/world/gamemode |
| /endersee <玩家> | 查看并编辑目标玩家末影箱 |
| /endersee PWI{=,...} | 同上，作用于末影箱 |
| /invseeplusplusreload | 重载插件配置 |

> 占位符 PWI{...} 的参数可为 [group, world, gamemode] 之一，可直接指定分组，或通过世界名让插件自动解析。附属模块另提供 /invgive、/endergive、/invclear、/enderclear 等 give/clear 命令。
基础权限（10 个）

| 权限节点 | 说明 | 默认 |
| --- | --- | --- |
| invseeplusplus.invsee.view | 允许使用 /invsee | 仅 OP |
| invseeplusplus.invsee.edit | 允许编辑目标背包 | 仅 OP |
| invseeplusplus.endersee.view | 允许使用 /endersee | 仅 OP |
| invseeplusplus.endersee.edit | 允许编辑目标末影箱 | 仅 OP |
| invseeplusplus.exempt.invsee | 豁免自己被查看背包 | 无 |
| invseeplusplus.exempt.endersee | 豁免自己被查看末影箱 | 无 |
| invseeplusplus.bypass-exempt.invsee | 绕过目标的背包豁免 | 无 |
| invseeplusplus.bypass-exempt.endersee | 绕过目标的末影箱豁免 | 无 |
| invseeplusplus.tabcomplete | 允许命令补全 | 无 |
| invseeplusplus.reload | 允许重载配置 | 仅 OP |
聚合权限

| 聚合权限 | 包含 |
| --- | --- |
| invseeplusplus.view | invsee.view + endersee.view |
| invseeplusplus.edit | invsee.edit + endersee.edit |
| invseeplusplus.exempt | exempt.invsee + exempt.endersee |
| invseeplusplus.bypass-exempt | bypass-exempt.invsee + bypass-exempt.endersee |
| invseeplusplus. | 全部 10 个基础权限 + give. + clear. |

> 建议通过 LuckPerms 等权限插件将 view / edit 授予管理员以上层级，而非直接依赖 OP；exempt 系列适合给服主/隐身管理组，避免自身库存被旁观。
UUID 解析策略顺序（用于把用户名解析为唯一 ID）
uuid-resolve-strategies:
"online player"
"logged out players cache"
"paper offline player cache"
"permission plugin"
"proxy"
"mojang rest api call"
"player data save files"
用户名解析策略顺序（用于把 UUID 反查为用户名）
username-resolve-strategies:
"online player"
"logged out players cache"
"permission plugin"
"mojang rest api call"
"player data save files"


布局占位符说明

| 占位符 | 含义 |
| --- | --- |
| i_xx | 普通背包容器格（xx 为槽位号 0–35）|
| a_b / a_l / a_c / a_h | 盔甲：靴 / 腿 / 胸 / 头 |
| oh | 副手 |
| c | 光标上托举的物品 |
| p_xx | 个人界面格（合成/铁砧/附魔台等临时物品），实时同步 |
| _ | 未使用的空位 |
| e_xx | 末影箱格（通常 27 格，Purpur 可至 54 格）|
相关链接
SpigotMC 资源页（主发布渠道）：https://www.spigotmc.org/resources/invsee.82342
GitHub 仓库：https://github.com/Jannyboy11/InvSee-plus-plus
官方 Wiki（API 与自定义界面）：https://github.com/Jannyboy11/InvSee-plus-plus/wiki
Modrinth：https://modrinth.com/plugin/invsee%2B%2B