ContainerPreview 容器预览插件介绍

功能#

• 准星看向容器时，在动作栏显示其中的物品与数量。
• 空手潜行并右键容器，可打开不可修改的原生物品栏预览。
• 手持物品潜行右键时保留原版交互，可正常贴着容器放置方块。
• 熔炉、高炉和烟熏炉按”原料 / 燃料 / 产物”分类显示。
• 酿造台按”药水 / 原料 / 燃料”分类显示。
• 支持普通箱子、双箱、木桶、潜影盒、漏斗、发射器、投掷器等方块容器。
• 支持箱子矿车和漏斗矿车。
• 支持末影箱，并且只显示当前玩家自己的末影箱内容。
• 支持装备箱子的驴、骡和羊驼背包。
• 在只读预览中右键潜影盒物品，可继续查看潜影盒内部内容。
• 默认向所有玩家开放，不仅限于管理员。
• 可选兼容 EasyLand 2.x 和 BlockLocker 1.14.x。

环境要求#

• Minecraft / Paper：26.2
• Java：25
• 客户端：无需安装任何内容

目前仅对 Paper 26.2 做过完整启动和功能测试。请勿仅修改 api-version 后宣称兼容旧版本。

安装#

1. 下载 Release 中的 ContainerPreview-1.0.0.jar。
2. 将 JAR 放入 Paper 服务器的 plugins 文件夹。
3. 完整重启服务器。

EasyLand 和 BlockLocker 都不是必需前置：

• 均未安装：预览功能正常使用，不进行这两种保护检查。
• 只安装 EasyLand：检查领地交互权限。
• 只安装 BlockLocker：检查锁箱授权。
• 两者都安装：玩家需要同时通过两边的权限检查。

使用方法#

• 看向距离 6 格以内的容器：显示物品摘要。
• 空手 + 潜行 + 右键：打开只读预览。
• 在只读预览中右键潜影盒：查看其内部内容。
• 普通右键：正常打开真实容器。

权限#

配置#

首次启动后生成 plugins/ContainerPreview/config.yml：

1
max-distance: 6
2
refresh-ticks: 10
3
summary-items: 4
4
enable-full-preview: true

构建#

需要 JDK 25 与 Gradle 9：

1
gradle clean build

构建产物位于 build/libs/ContainerPreview-1.0.0.jar。

已知限制#

• 纯服务端无法像客户端模组一样直接在 HUD 上绘制完整物品格面板，目前使用动作栏摘要与原生只读 GUI。
• 目前只对 EasyLand 与 BlockLocker 做了权限适配，其他保护插件不会自动接入。
• EasyLand 与 BlockLocker 的实体保护能力有限；方块容器会执行对应的完整权限检查。
• 不支持运行时热重载，请完整重启服务器更新插件。

许可证#

本项目使用 MIT License。

项目源码#

https://github.com/tsymq-7331/ContainerPreview