🐚 ShulkerNest: Living Vacuum Nests & Smart Storage
ShulkerNest turns ordinary shulker boxes into living vacuum nests. An enchanted shulker (the Nesting enchant) pulls dropped items around it directly into its inventory, displays a hologram with its level and radius, and protects its contents from explosions, pistons and hoppers.
Instead of standing over your loot forever, place a nest and let it farm for you.
🎯 Why Your Server Needs This Plugin
Set-and-forget storage. Dropped blocks, mob loot, TNT — everything inside the radius flies into the nest. No more running around picking up drops.
Progression built in. 5 enchantment tiers (I–V) with radii from 5 to 25 blocks. Players upgrade nests through books found in the world — progression without admin intervention.
Protected by design. Nests resist explosions, pistons and hopper extraction. Break the nest and you get your shulker back intact, with all contents.
Performance-first. Adaptive tick interval: if the server TPS drops, the vacuum politely slows down. Dupe-safe single-claim logic and per-tick limits keep it safe under load.
Localized. Every player sees texts in their own language (EN / RU) — lore, holograms, commands. English clients see English, Russian see Russian.
💡 How It Works
- Get the Nesting book (see "How to obtain" below).
- Enchant a shulker on an anvil: shulker + book → the shulker gains the Nesting enchant and starts vacuuming.
- Place the shulker — a hologram appears: «✦ Shulker Nest ✦ / Lv. V • 25 blocks / owner».
- The vacuum works: items spawning inside the radius are immediately absorbed (even before you can pick them up yourself), plus a periodic sweep every 20 ticks.
- Upgrade: put a shulker already on Nesting into the anvil with another book — equal levels merge (III + III → IV), different levels take the max. Same for book + book.
Enchant levels & radii
| Level |
Radius |
Notes |
| I |
5 blocks |
Start |
| II |
10 blocks |
|
| III |
15 blocks |
|
| IV |
20 blocks |
|
| V |
25 blocks |
Max |
Levels/radii per level are fully configurable (radii.1–radii.5).
📖 How to Obtain Nesting
| Source |
Chance |
Details |
| Enchanting table |
35% |
Put a plain book in the table → Nesting appears in the 30-level slot (levels III–V); the middle slot can offer levels I–II (chance 20%). Cost 30 / 15 XP levels. |
| Anvil |
— |
Book → shulker, book → book (merge). |
| Chest loot |
3% |
Books appear in generated chest loot (loot.chance). |
| Fishing |
0.5% |
A catch can be replaced by a book (Luck of the Sea adds +0.5% per level). |
| Admin |
— |
/nest give <player> <1-5> (enchanted shulker), /nest givebook <player> <1-5> (book). |
⌨️ Commands (permission: shulkernest.admin)
/nest reload — reload config & holograms
/nest list — list all nests
/nest remove <world> <x> <y> <z> — remove a nest (drops its contents)
/nest give <player> <1-5> — give an enchanted shulker
/nest givebook <player> <1-5> — give a Nesting book
/nest hologram respawn <world> <x> <y> <z> — recreate a hologram
Aliases: shulkernest, nests. The permission defaults to operators.
⚙️ Technical Advantages for Administrators
Full configuration: vacuum interval & per-tick limits, per-level radii, hologram text/style (colors, billboard, background, view range, owner line), all source chances (loot/fishing/enchanting), max-nests-per-world, protection toggles, adaptive TPS thresholds, and a global language fallback.
Performance: merged timer + instant ItemSpawnEvent intake, adaptive interval doubling under lag, claim-map dupe protection, never touches unloaded chunks.
Safety: explosions are filtered around nests, pistons cannot push them, hoppers cannot extract; breaking a nest returns the shulker with contents intact. Nests persist across restarts (nests.yml) and orphan holograms are auto-repaired.
Localization: EN/RU per player (client locale), separate EN/RU hologram entities, books/shulkers carry lore in the owner's language.
Compatibility: Paper 26.3 (Java 25), pure Paper API, no NMS, no external dependencies. Reload config live with /nest reload.
📦 Perfect For
- Survival and SMP servers that want a light, rewarding storage progression.
- RPG projects that need long-term item sink mechanics (nests as farm automation).
- Any server where players hate cleanup after farms/fights.
Install ShulkerNest and let your shulkers do the vacuuming!
Chat, requests to add versions, bugs, creating mods for your needs discord
Support the author: Donate
