Searching

Searching
Searching is a high-performance loot container and searchable chest plugin designed for RPG, survival, extraction-style, and exploration-based Minecraft servers.

The plugin has gone through multiple major refactors, and the current 1.4.2 version is the most stable and optimized release so far.

Older versions are still usable but are no longer maintained.

Searching is now completely free — there is no premium edition anymore.

Features
High Performance Runtime Design
Searching preloads node types, loot tables, pools, items, tiers, refresh policies, and related configurations into memory caches.
The runtime system uses:

• coordinate cache lookup
• expiration-based refresh checks
• inventory diff synchronization
• batched statistics persistence

This design allows servers to place a very large number of searchable containers without heavy continuous overhead.
Internal stress test results:

• Checking 10,000 non-expired searchable nodes resulted in 0 actual refresh operations, taking approximately 28ms
  
  
• Synchronizing inventory diffs for 100 players simultaneously opening search UIs took approximately 16ms

Idle nodes produce almost no runtime cost, and interaction processing only handles necessary state changes.
(Actual performance may still depend on server hardware, database setup, item plugins, and hologram plugins.)

Flexible Loot Pool System
Searching uses a layered reward structure:
Node Type → Loot Table → Loot Pool → Item
Nested loot pools are fully supported.
This allows server owners to create advanced reward systems such as:

• common loot pools
• rare loot pools
• epic reward chains
• special event rewards
• extraction shooter style loot progression

Example:

• a small chance to enter a rare pool
• then another small chance to enter a mythic pool

Items support:

• amount ranges
• weighted probability
• rarity tiers
• reveal/search duration
• EXP rewards
• custom values

The structure is reusable and easy to maintain across multiple searchable node types.

Built-in In-Game UI Editor
Searching includes a visual in-game editor.

You can manage:

• searchable node types
• loot tables
• loot pools
• reward items
• rarity tiers
• refresh policies
• hologram templates

directly inside the server without constantly editing YAML files manually.
The editor supports:

• create
• edit
• delete
• pagination
• configuration validation

This makes balancing and live server maintenance significantly easier.

Commands
Command Description
/searching reload Reload plugin configuration
/searching node type [type] View or select searchable node types
/searching node create [type] Create searchable nodes
/searching node remove Remove searchable nodes
/searching node list [type] Open node management UI
/searching node clear [type] Clear searchable nodes
/searching node open Open a node directly
/searching editor [section] Open the built-in UI editor
PlaceholderAPI Support
%searching_daily_open_chest_<node_type>%

• Number of searchable nodes of a specific type opened by the player today
  Example:
  %searching_daily_open_chest_MiningChest%

%searching_daily_total_open_chest%

• Total number of searchable nodes opened by the player today
  Example:
  %searching_daily_total_open_chest%

%searching_daily_search_%

• Number of items of a specific tier found by the player today
  Example:
  %searching_daily_search_Rare%

%searching_total_open_chest_<node_type>%

• Total number of searchable nodes of a specific type opened by the player
  Example:
  %searching_total_open_chest_BossRewardChest%

%searching_total_total_open_chest%

• Total number of all searchable nodes opened by the player
  Example:
  %searching_total_total_open_chest%

%searching_total_search_%

• Total number of items of a specific tier found by the player
  Example:
  %searching_total_search_Mythic%

%searching_level%

• Player's current searching level
  Example:
  %searching_level%

%searching_exp%

• Player's current searching EXP
  Example:
  %searching_exp%

%searching_exp_total%

• Total EXP required to reach the next level
  Example:
  %searching_exp_total%

%searching_exp_need%

• Remaining EXP required to reach the next level
  Example:
  %searching_exp_need%

Example Use Cases
Searching works well for:

• RPG servers
• survival servers
• extraction shooter gameplay
• dungeon systems
• exploration gameplay
• airdrop systems
• searchable world props
• loot progression systems

Hologram Support
Currently supports:

• DecentHolograms

Storage Support
Supports:

• SQLite
• MySQL

Version Support
Designed for Bukkit-based servers including:

• Spigot
• Paper
• Purpur
• other Bukkit-compatible forks

Support
If you encounter bugs or need help configuring the plugin:
QQ: 2962271068
QQ Group: 724504184
Discord: Click to join