原创 开源 工具 SearchContainer - 容器搜索插件。手持物品作为模板，快速搜索容器，精准定位物品位置（用于寻找泄露的违规物品） 2026-04-03

[MD] # SearchContainer - 容器搜索插件 ## 简介 SearchContainer 是一款 Minecraft 容器搜索插件，支持 Paper 和 Folia 服务端核心。手持物品作为模板，快速搜索容器，精准定位物品位置。 --- ## 核心特性 - **按物品搜索**：手持物品，搜遍容器 - **智能匹配**：支持名称/附魔/Lore 过滤开关 - **全图扫描**：`/sc all` 读取 .mca 区域文件，扫描世界内所有已生成过的区块 - **一键传送**：点击结果坐标直接传送 - **多语言**：内置简体中文、美式英语，可扩展 --- ## 指令列表 | 指令 | 说明 | 权限 | |------|------|------| | `/sc <半径> [标志]` | 搜索以你为中心、指定区块半径内的已加载容器 | `searchcontainer.use`OP | | `/sc all [标志]` | 搜索整个世界所有已生成过的容器（读取 region 文件） | `searchcontainer.use.all`OP | | `/sc cancel` | 取消当前正在进行的搜索 | `searchcontainer.use`OP | | `/sc reload` | 重载配置文件与语言文件 | `searchcontainer.use`OP | --- ## 过滤标志 | 标志 | 效果说明 | |------|------| | `-name` | 候选物品名称**包含**手持模板的名称（默认需完全相等） | | `-enchant` | 候选物品**包含**手持模板的所有附魔，且等级≥模板等级 | | `-lore` | 候选物品 Lore **包含**手持模板的每一行描述 | **默认模式（无标志）**：精准匹配——物品类型、自定义名称、附魔、Lore、PDC 全部相等。 --- ## 使用示例 ``` # 半径 5 区块，精准匹配（仅扫描已加载区块） /sc 5 # 全图搜索所有已生成区块 /sc all # 全图搜索，忽略重命名 /sc all -name # 半径 16，附魔包含 + lore 包含 /sc 16 -enchant -lore # 取消当前搜索 /sc cancel ``` --- ## 配置文件 (config.yml) ```yaml # zh_CN、en_US language: zh_CN # 搜索冷却时间（秒） cooldown-seconds: 3 # 单次搜索最多显示的结果数（超出部分隐藏） max-results-display: 1000 # 半径模式允许的最大区块半径（对 /sc all 无效） max-radius: 32 ``` --- ## 运行机制 | 搜索模式 | 扫描范围 | 是否读盘 | 是否加载新区块 | |---------|---------|---------|----------------| | **半径模式** | 以玩家为中心 N×N 区块，仅扫描已加载区块 | 否 | 否 | | **全图模式** | 世界所有已生成过的区块（遍历 .mca 文件头） | 是 | 否 | **全图模式详解**： - 解析 `r.x.z.mca` 文件头部的 4096 字节区块定位表 - 获取世界所有曾经生成过的区块坐标 - **仅扫描当前已加载的区块**，不会主动加载未加载区块 - 避免因扫描导致服务端卡顿或区块实体加载 --- ## 注意事项 - **半径搜索**：受 `max-radius` 限制，仅扫描已加载区块 - **全图搜索**：不受 `max-radius` 限制，遍历世界所有 .mca 文件，但仅扫描当前已加载的区块 - 全图搜索在大型生存服务器或千日存档中耗时较长，建议合理设置 `max-results-display` - 搜索时必须**手持物品**，空手无法执行 - 支持所有 `Container` 类型容器：箱子、陷阱箱、漏斗、发射器、投掷器、潜影盒、熔炉等 --- ### bStats  [/MD]