SearchContainer

Managing storage in a sprawling Minecraft world can quickly become a nightmare. Whether you run a bustling survival server or a massive technical build, items get scattered across hundreds of containers. SearchContainer for Minecraft solves this problem elegantly—it’s a powerful server-side add-on that lets you locate any item instantly by simply holding a template and running a command. No more breaking chests one by one or memorizing coordinates.

Why You Need SearchContainer for Minecraft

Vanilla Minecraft offers no way to search inventories globally. You might spend hours hunting for that one shulker box of redstone or a specific enchanted sword. SearchContainer transforms this experience. It works with Paper and Folia server cores, supporting modern Minecraft versions (1.20+), and scans loaded chunks or even the entire world’s generated region files. The result? You find what you need in seconds, with a clickable teleport option to take you right to the container.

How SearchContainer Works

The add-on introduces a simple but ingenious mechanic. Hold any item in your main hand—this becomes your search template. Then execute the /sc command with a radius or the all flag. SearchContainer checks every container in the specified range, comparing the stored items against your template. By default, it demands an exact match: same item type, custom name, enchantments, Lore, and even Persistent Data Container (PDC) tags. But you can relax the rules with filter flags to find similar items, making it incredibly flexible.

Core Features

• Search by Item: Hold an item and instantly scan nearby or world-wide containers.
• Smart Matching: Toggle filters for name, enchantments, and Lore to broaden or narrow results.
• World-Scanning: The /sc all command reads .mca region file headers to cover every generated chunk without loading new ones.
• One-Click Teleport: Click result coordinates in chat to teleport directly to the container.
• Multi-Language Support: Built-in Simplified Chinese and American English, with an extensible language system.
• Performance Conscious: World scans only check already loaded chunks, avoiding server lag or entity loading.

If you manage your server through the foxygame.net launcher, adding SearchContainer is even simpler—just browse the add-on catalog, click install, and the launcher handles version compatibility and auto-updates for you, so you never have to manually download SearchContainer again.

Commands and Filter Flags

Main Commands

• /sc <radius> [flags] – Searches loaded containers within a specified chunk radius centered on you. Requires searchcontainer.use permission (OP by default).
• /sc all [flags] – Searches all generated containers in the entire world by parsing region files. Requires searchcontainer.use.all permission (OP).
• /sc cancel – Cancels an ongoing search. Requires searchcontainer.use permission.
• /sc reload – Reloads configuration and language files. Requires searchcontainer.use permission.

Filter Flags

Flags modify how strictly the template item must match. Combine them for custom searches.

• -name – Candidate item’s display name only needs to contain the template’s display name (instead of exact match).
• -enchant – Candidate item must have all enchantments of the template, with levels equal or higher.
• -lore – Candidate item’s Lore must contain every line of the template’s Lore.
• No flags (default): Exact match on type, name, enchantments, Lore, and PDC tags.

Configuration and Performance

SearchContainer is designed to be server-friendly. The config.yml file lets you fine-tune behavior:

• language: Set to zh_CN or en_US (extensible).
• cooldown-seconds: Prevents command spam (default 3 seconds).
• max-results-display: Caps the number of shown results to avoid chat flooding (default 1000).
• max-radius: Limits the chunk radius for radius mode searches (default 32). World mode ignores this limit.

World mode (/sc all) is particularly clever. It reads the 4096-byte chunk location table from .mca region files to identify all generated chunks, then scans only those currently loaded in memory. This avoids loading new chunks and prevents entity generation or server strain. On large survival servers with thousands of explored chunks, the search may still take time, so adjust max-results-display to keep output manageable.

How to Install SearchContainer

To download SearchContainer, grab the latest .jar file from its official SpigotMC or Modrinth page. Place it in your server’s plugins folder and restart (or run /sc reload if already installed). The add-on automatically generates a default configuration. For Paper servers, ensure you’re running a compatible build; for Folia, the plugin leverages the region file parsing to work seamlessly with the multi-threaded architecture. No client-side mods are needed—everything runs server-side, so players join with vanilla clients.

Practical Usage Examples

Here are a few scenarios to show how SearchContainer streamlines gameplay:

• Exact search nearby: /sc 5 – Scans a 5-chunk radius for containers holding an item identical to the one in your hand.
• World-wide relaxed search: /sc all -name -enchant – Finds any item with a matching name and at least the same enchantments across the entire world.
• Lore-based hunt: /sc 16 -lore – Searches a 16-chunk radius for items sharing the exact Lore text of your held item.
• Cancel a long search: /sc cancel – Stops an in-progress world scan if it’s taking too long.

Conclusion

SearchContainer for Minecraft is an indispensable tool for server admins and players who value efficiency. Its dual search modes, intelligent matching, and teleport integration turn inventory chaos into organized clarity. Whether you’re running a small Paper server or a large Folia network, the add-on’s performance-aware design keeps things smooth. Download SearchContainer today and never lose track of your items again.