PearlDrop

PearlDrop — stasis pearl filler

The deposit counterpart to PearlPlus: instead of pulling a trapped pearl to teleport a player home, PearlDrop throws pearls into stasis chambers to stock them. A chamber is a 1×1 water/bubble column with soul sand at the bottom and a trapdoor on top. The bot walks to the rim, sneak-overhangs the opening, aims at the centre of the soul sand, throws a pearl in, and steps back off the ledge.

Command: .pearldrop (alias .pd). Needs ender pearls in its inventory.

What it does

• Scans loaded chunks for chambers (.pd scan [radius]) and lists them with indices + a ready / occupied verdict.
• Deposits by coordinate (.pd drop <x> <y> <z> [n] — auto-picks an unoccupied chamber near the coords), by scan index (.pd pick 1 3 4), or into every empty chamber from the last scan (.pd all).
• Configurable pearls-per-chamber, throw spacing, aim eye-height, and minimum water depth. Exposes a service API so other automation (e.g. a stash-mover) can drive deposits.

Setup guide

1. Build your stasis chambers (water column at least the minimum depth, soul sand bottom, trapdoor top) and give the bot a supply of ender pearls.
2. Stand near them and .pd scan to list them.
3. .pd all to fill every empty one, or .pd pick <indices> / .pd drop <x> <y> <z> for specific chambers.

Commands

.pearldrop on/off
.pd scan [radius]                 # find chambers in loaded chunks; lists them with indices
.pd list                          # reprint the last scan
.pd drop <x> <y> <z> [n]          # deposit into the chamber near these coords (auto-picks an empty one)
.pd pick <indices>                # deposit into scanned chambers by index (e.g. pick 1 3 4)
.pd all                           # deposit into every empty chamber from the last scan
.pd count <n>                     # pearls to deposit per chamber
.pd stop                          # cancel the current run
.pd depth <n> | radius <n> | yrange <n> | tolerance <n>    # chamber detection / scan range
.pd spacing <ticks> | eyeheight <d> | priority <n>         # throw timing / aim
.pd closetrapdoor on/off          # shut an open trapdoor before depositing