SearchContainer

SearchContainer

Introduction

SearchContainer is a Minecraft container search plugin that supports Paper and Folia server cores. Hold an item as a template to quickly search containers and precisely locate item positions.

---

Core Features

- Multi-Language: Hold an item, search through containers - Multi-Language: Support togglable filters for name/enchantments/Lore - Multi-Language: `/sc all` reads .mca region files to scan all generated chunks in the world - Multi-Language: Click result coordinates to instantly teleport - Multi-Language: Built-in Simplified Chinese and American English, extensible

---

Command List

| Command | Description | Permission | |---------|-------------|------------| | `/sc <radius> [flags]` | Searches loaded containers within a specified chunk radius centered on you | `searchcontainer.use`OP | | `/sc all [flags]` | Searches all generated containers in the entire world (reads region files) | `searchcontainer.use.all`OP | | `/sc cancel` | Cancels an ongoing search | `searchcontainer.use`OP | | `/sc reload` | Reloads configuration and language files | `searchcontainer.use`OP |

---

Filter Flags

| Flag | Effect Description | |------|--------------------| | `-name` | Candidate item name contains the display name of the held template (default requires exact match) | | `-enchant` | Candidate item contains all enchantments of the held template, with levels ≥ template levels | | `-lore` | Candidate item Lore contains every line of lore from the held template |

Default Mode (no flags): Exact match — item type, custom name, enchantments, Lore, PDC must all be equal.

---

Usage Examples

```

Radius 5 chunks, exact match (scans only loaded chunks)

/sc 5

World-scan all generated chunks

/sc all

World-scan, ignore renamed items

/sc all -name

Radius 16, enchantment containment + lore containment

/sc 16 -enchant -lore

Cancel current search

/sc cancel ```

---

Configuration (config.yml)

```yaml

zh_CN, en_US

language: zh_CN

Search cooldown time (seconds)

cooldown-seconds: 3

Maximum number of results displayed per search (excess results are hidden)

max-results-display: 1000

Maximum chunk radius allowed in radius mode (does not affect /sc all)

max-radius: 32 ```

---

Operational Mechanism

| Search Mode | Scan Range | Disk Read | Loads New Chunks | |------------|------------|-----------|------------------| | World Mode | N×N chunks centered on player, scans only loaded chunks | No | No | | World Mode | All generated chunks in the world (parses .mca file headers) | Yes | No |

Scans only currently loaded chunks: - Parses the 4096-byte chunk location table at the header of `r.x.z.mca` files - Retrieves coordinates of all chunks ever generated in the world - Scans only currently loaded chunks, does not actively load unloaded chunks - Avoids server lag or loading chunk entities caused by scanning

---

Important Notes

- Must hold an item: Limited by `max-radius`, scans only loaded chunks - Must hold an item: Not limited by `max-radius`, traverses all .mca files in the world but scans only currently loaded chunks - World search may take considerable time on large survival servers or archives with thousands of days; it is recommended to set `max-results-display` appropriately - Must hold an item to search; cannot execute with an empty hand - Supports all `Container` type containers: Chests, Trapped Chests, Hoppers, Dispensers, Droppers, Shulker Boxes, Furnaces, etc.

---

bStats