LetMeSee — Minecraft Folia 只读容器插件

一个轻量级 Minecraft Folia/Paper 插件，允许 OP 通过指令 只读 查看任意坐标上的容器物品，绕过 Lands、QuickShop 等保护插件的限制。

特性

• 只读查看 — 通过 /lms 指令以只读模式打开任何箱子、木桶、潜影盒、熔炉等容器
• 绕过保护 — 直接读取方块数据，无需调用 Lands / QuickShop / WorldGuard 等保护 API
• Folia 兼容 — 使用 Bukkit.getRegionScheduler().run() 在正确的区域线程执行操作
• 中文界面 — 容器名称自动本地化（箱子、熔炉、漏斗等）

适用场景

• 管理员检查玩家容器是否存在违规物品
• 调试和排查容器数据问题
• 绕过地皮/领地保护查看公共设施

指令

指令	权限	说明
/lms	letmesee.use	查看准星正对的容器（最多 10 格）
/lms <世界> <X> <Y> <Z>	letmesee.use	只读打开指定坐标的容器

权限

权限节点	默认	说明
letmesee.use	op	允许使用 /lms 指令

支持容器类型

• 箱子 / 陷阱箱（含双箱）
• 木桶
• 潜影盒（所有 16 色）
• 熔炉 / 高炉 / 烟熏炉
• 漏斗
• 投掷器 / 发射器
• 酿造台

构建

前置要求

• Java 21+
• Gradle 8.10+

编译

./gradlew build

编译产物位于 build/libs/letmesee-1.0.1.jar

GitHub Actions

• 推送代码或创建 Pull Request 时，Build workflow 会自动构建检查
• 手动运行 Create Tag workflow 创建 v* 标签后，Release workflow 会自动构建并发布 GitHub Release
• Release 构建使用 GitHub Actions 提供的 Gradle 8.10，不依赖本地 Gradle Wrapper

手动编译（无需 Gradle）

项目包含 build.ps1 PowerShell 脚本，可自动下载依赖并编译：

.\build.ps1

安装

1. 将 letmesee-1.0.0.jar 放入服务器的 plugins/ 目录
2. 重启服务器或使用 /reload confirm
3. 确保有 folia-supported: true 的服务器（Folia / Leaf / 等分叉核心）

工作原理

1. 玩家输入 /lms 时，插件读取玩家准星正对的方块；也可以继续输入 /lms world x y z
2. 使用 Bukkit.getRegionScheduler().run() 在目标坐标区域线程获取方块状态
3. 将容器内容复制到由 ReadOnlyHolder 标记的虚拟库存中
4. 打开玩家只读视图，InventoryListener 拦截所有点击/拖拽事件

开发

// build.gradle.kts 依赖
dependencies {
    compileOnly("io.papermc.paper:paper-api:1.21.1-R0.1-SNAPSHOT")
}

许可

MIT License