# SearchContainer<\/p>\n
## Introduction<\/p>\n
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.<\/p>\n
—<\/p>\n
## Core Features<\/p>\n
– **Search by Item**: Hold an item, search through containers
\n– **Smart Matching**: Support togglable filters for name\/enchantments\/Lore
\n– **World-Scanning**: `\/sc all` reads .mca region files to scan all generated chunks in the world
\n– **One-Click Teleport**: Click result coordinates to instantly teleport
\n– **Multi-Language**: Built-in Simplified Chinese and American English, extensible<\/p>\n
—<\/p>\n
## Command List<\/p>\n
| Command | Description | Permission | —<\/p>\n ## Filter Flags<\/p>\n | Flag | Effect Description | **Default Mode (no flags)**: Exact match \u2014 item type, custom name, enchantments, Lore, PDC must all be equal.<\/p>\n —<\/p>\n ## Usage Examples<\/p>\n “` # World-scan all generated chunks # World-scan, ignore renamed items # Radius 16, enchantment containment + lore containment # Cancel current search —<\/p>\n ## Configuration (config.yml)<\/p>\n “`yaml # Search cooldown time (seconds) # Maximum number of results displayed per search (excess results are hidden) # Maximum chunk radius allowed in radius mode (does not affect \/sc all) —<\/p>\n ## Operational Mechanism<\/p>\n | Search Mode | Scan Range | Disk Read | Loads New Chunks | **World Mode Detailed Explanation**: —<\/p>\n ## Important Notes<\/p>\n – **Radius Search**: Limited by `max-radius`, scans only loaded chunks —<\/p>\n ### bStats 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.<\/p>\n","protected":false},"featured_media":136713,"template":"","meta":{"_minecraft_slug":"searchcontainer","_minecraft_project_id":"oDCSr6Ez","_minecraft_author":"Kurt5","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":33,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"searchcontainer.zip","_minecraft_size_bytes":54661,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:58:08.293315Z","_minecraft_date_created":"2026-02-16T06:52:53.287423Z","_minecraft_date_modified":"2026-02-13T06:10:38.617731Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/searchcontainer","_minecraft_icon_attachment_id":136713,"_minecraft_imported_at":"2026-06-08T01:51:49+00:00","_minecraft_import_hash":"a80324be1ea001c3ba0607312cd9b586","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,127,128,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-136712","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/sc
\n| `\/sc all [flags]` | Searches all generated containers in the entire world (reads region files) | `searchcontainer.use.all`OP |
\n| `\/sc cancel` | Cancels an ongoing search | `searchcontainer.use`OP |
\n| `\/sc reload` | Reloads configuration and language files | `searchcontainer.use`OP |<\/p>\n
\n|——|——————–|
\n| `-name` | Candidate item name **contains** the display name of the held template (default requires exact match) |
\n| `-enchant` | Candidate item **contains** all enchantments of the held template, with levels \u2265 template levels |
\n| `-lore` | Candidate item Lore **contains** every line of lore from the held template |<\/p>\n
\n# Radius 5 chunks, exact match (scans only loaded chunks)
\n\/sc 5<\/p>\n
\n\/sc all<\/p>\n
\n\/sc all -name<\/p>\n
\n\/sc 16 -enchant -lore<\/p>\n
\n\/sc cancel
\n“`<\/p>\n
\n# zh_CN, en_US
\nlanguage: zh_CN<\/p>\n
\ncooldown-seconds: 3<\/p>\n
\nmax-results-display: 1000<\/p>\n
\nmax-radius: 32
\n“`<\/p>\n
\n|————|————|———–|——————|
\n| **Radius Mode** | N\u00d7N chunks centered on player, scans only loaded chunks | No | No |
\n| **World Mode** | All generated chunks in the world (parses .mca file headers) | Yes | No |<\/p>\n
\n– Parses the 4096-byte chunk location table at the header of `r.x.z.mca` files
\n– Retrieves coordinates of all chunks ever generated in the world
\n– **Scans only currently loaded chunks**, does not actively load unloaded chunks
\n– Avoids server lag or loading chunk entities caused by scanning<\/p>\n
\n– **World Search**: Not limited by `max-radius`, traverses all .mca files in the world but scans only currently loaded chunks
\n– 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
\n– **Must hold an item** to search; cannot execute with an empty hand
\n– Supports all `Container` type containers: Chests, Trapped Chests, Hoppers, Dispensers, Droppers, Shulker Boxes, Furnaces, etc.<\/p>\n
\n<\/p>\n","protected":false},"excerpt":{"rendered":"