CraftHub
SearchContainer

SearchContainer

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.

186 downloads 3 followers

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 all reads .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.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

  • 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-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

bStats

No gallery available for this project.

Version Minecraft Loader Download

SearchContainer 1.0.0

1.0.0

1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
bukkit, folia, paper, purpur, spigot
Download