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
- Search by Item: Hold an item, search through containers
- Smart Matching: Support togglable filters for name/enchantments/Lore
- World-Scanning:
/sc allreads .mca region files to scan all generated chunks in the world - One-Click Teleport: 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.useOP |
/sc all [flags] |
Searches all generated containers in the entire world (reads region files) | searchcontainer.use.allOP |
/sc cancel |
Cancels an ongoing search | searchcontainer.useOP |
/sc reload |
Reloads configuration and language files | searchcontainer.useOP |
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)
# 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 |
|---|---|---|---|
| Radius 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 |
World Mode Detailed Explanation:
- Parses the 4096-byte chunk location table at the header of
r.x.z.mcafiles - 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
- Radius Search: Limited by
max-radius, scans only loaded chunks - World Search: 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-displayappropriately - Must hold an item to search; cannot execute with an empty hand
- Supports all
Containertype containers: Chests, Trapped Chests, Hoppers, Dispensers, Droppers, Shulker Boxes, Furnaces, etc.
bStats
