Logo
SearchContainer
PluginGPL-3.0-only

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.

3
Downloads
1
Followers
2 months ago
Updated
📦
1
Versions
managementbukkitfoliapaperpurpurspigot
Download Latestv1.0.0View on Modrinth

📖About 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

  • 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