Overview

SearchingUltra is a configurable loot-search framework for Spigot/Paper servers.

Players interact with virtual searchable loot nodes placed in the world. Each node can use its own loot table, GUI size, refresh policy, hologram and reveal timing.

Unlike normal chest plugins, multiple players can search the same node with independent reveal progress, making it suitable for extraction gameplay, dungeon servers, survival treasure routes and RPG maps.

License / Free / Pro

SearchingUltra uses a license-key system.

With a valid license-key, you can unlock PRO mode and access advanced features.

In your current setup, this is typically done by:

• putting your valid key in searching.yml
• setting searching.edition: pro

Without a valid key, the plugin will still run in Free mode with safe feature degradation.

Free Features

• searchable loot nodes with virtual inventories
• independent per-player search progress
• node types, loot tables, pools, items and rarity tiers
• basic cooldown refresh
• template-based node deployment
• corpse loot system
• basic hologram support
• admin commands and loot table testing
• public API and custom events

PRO Features

• Placeholder/stat placeholders PRO
• In-game visual editor PRO
• Random loot chest spawning PRO
• Airdrop system PRO
• Dynamic expressions PRO
• Advanced loot modifiers PRO
• Cron-based refresh policies PRO
• Advanced context-aware loot conditions PRO

Commands

Permission:

• Code (Text):

  /su reload
• Code (Text):

  /su debug <on|off|toggle>
• Code (Text):

  /su node create <nodeTypeId>
• Code (Text):

  /su node remove
• Code (Text):

  /su node list [world]
• Code (Text):

  /su node clear <world>
• Code (Text):

  /su corpse spawn <player> [ttl]
• Code (Text):

  /su corpse clear <world>
• Code (Text):

  /su corpse list [world]
• Code (Text):

  /su airdrop spawn <nodeTypeId> [height]
  PRO
• Code (Text):

  /su tool <nodeTypeId>
• Code (Text):

  /su instance apply <world> <templateKey>
• Code (Text):

  /su test roll <tableId> [player]
• Code (Text):

  /su editor
  PRO

Placeholder Examples

Identifier: These placeholders are PRO-only.

• Code (Text):

  %searching_level%
• Code (Text):

  %searching_exp%
• Code (Text):

  %searching_exp_need%
• Code (Text):

  %searching_exp_total%
• Code (Text):

  %searching_daily_total_open_chest%
• Code (Text):

  %searching_total_open_chest_food_box%
• Code (Text):

  %searching_daily_search_rare%
• Code (Text):

  %searching_total_search_legendary%

Notes

• Loot nodes use virtual inventories, not vanilla chest inventories
• Airdrop visuals require Minecraft 1.19+
• Current hologram adapter targets DecentHolograms
• Main node storage is currently SQLite-based; stats storage supports SQLite / MySQL / YAML
• Free mode remains usable even without a license-key