🧲 VacuumHopper

Turn an ordinary hopper into a powerful vacuum hopper that instantly collects nearby dropped items.

✨ Features

• Instantly collects dropped items
• Configurable horizontal radius from 1 to 8 blocks
• Configurable collection height from 1 to 8 blocks
• Configurable collection depth from 0 to 8 blocks
• Adjustable output speed from 2 to 40 ticks
• Optional item extraction from other inventories
• Configurable particle outline of the collection area
• Fully customizable placement hint
• Redstone signal disables the vacuum hopper
• Ordinary hoppers remain unchanged
• The upgraded hopper keeps its properties when broken

👁️ How to create one

1. Place an ordinary hopper.
2. Right-click it with an Eye of Ender.
3. The hopper becomes a Vacuum Hopper.

When a player places an ordinary hopper, the plugin displays a configurable upgrade hint. A cooldown prevents chat spam.

📐 Default collection area

The default area is 3×3×2 above the hopper.

Collection depth is 0 by default, so items below the hopper are not collected unless enabled in the configuration.

⚙️ Configuration

hint-enabled: true
hint-cooldown-seconds: 600

collection-period-ticks: 1
collection-horizontal-radius: 1
collection-height: 2
collection-depth: 0

output-transfer-interval-ticks: 8
pull-items-from-inventories: false

radius-particles-enabled: true
radius-particle-type: PORTAL
radius-particle-duration-seconds: 5
radius-particle-interval-ticks: 10

The hint supports color codes using & and the following placeholders:

• %zone%
• %horizontal-radius%
• %height%
• %depth%

⌨️ Commands

Command	Description
/vacuumhopper info	Shows information about the vacuum hopper
/vacuumhopper give [player]	Gives a vacuum hopper
/vacuumhopper reload	Reloads the configuration
/vh	Short command alias

🔐 Permissions

Permission	Description	Default
vacuumhopper.use	Allows players to upgrade and use vacuum hoppers	Everyone
vacuumhopper.admin	Allows item distribution and configuration reload	OP

🧩 Compatibility

• Minecraft 1.20–26.3
• Paper
• Purpur
• Spigot
• Bukkit
• Java 17+

Folia, Sponge, BungeeCord, Velocity, and Waterfall are not supported.

⚠️ VacuumHopper is currently in beta. Create a backup before installing updates on a production server.

📥 Installation

1. Download the JAR file.
2. Place it in the server’s plugins folder.
3. Restart the server.
4. Edit plugins/VacuumHopper/config.yml if necessary.
5. Use /vh reload after changing the configuration.

---

🧲 Вакуумная Воронка

Превращает обычную воронку в улучшенную вакуумную воронку, которая мгновенно собирает выпавшие предметы поблизости.

✨ Возможности

• Мгновенный сбор выпавших предметов
• Горизонтальный радиус от 1 до 8 блоков
• Высота сбора от 1 до 8 блоков
• Глубина сбора от 0 до 8 блоков
• Настраиваемая скорость выдачи от 2 до 40 тиков
• Возможность забирать предметы из других инвентарей
• Отображение границ зоны сбора частицами
• Полностью настраиваемая подсказка
• Отключение вакуумной воронки сигналом редстоуна
• Обычные воронки работают без изменений
• После разрушения улучшение воронки сохраняется

👁️ Как получить

1. Поставьте обычную воронку.
2. Нажмите по ней ПКМ, держа Око Эндера.
3. Воронка превратится в Вакуумную Воронку.

При установке обычной воронки игрок получает настраиваемую подсказку об улучшении. Задержка между сообщениями защищает чат от спама.

📐 Стандартная зона сбора

По умолчанию зона сбора составляет 3×3×2 над воронкой.

Глубина установлена на 0, поэтому предметы под воронкой не собираются, пока эта возможность не будет включена в конфигурации.

⚙️ Конфигурация

hint-enabled: true
hint-cooldown-seconds: 600

collection-period-ticks: 1
collection-horizontal-radius: 1
collection-height: 2
collection-depth: 0

output-transfer-interval-ticks: 8
pull-items-from-inventories: false

radius-particles-enabled: true
radius-particle-type: PORTAL
radius-particle-duration-seconds: 5
radius-particle-interval-ticks: 10

Подсказка поддерживает цветовые коды через & и переменные:

• %zone%
• %horizontal-radius%
• %height%
• %depth%

⌨️ Команды

Команда	Описание
/vacuumhopper info	Показывает информацию о вакуумной воронке
/vacuumhopper give [игрок]	Выдаёт вакуумную воронку
/vacuumhopper reload	Перезагружает конфигурацию
/vh	Короткий вариант команды

🔐 Права

Право	Описание	По умолчанию
vacuumhopper.use	Улучшение и использование вакуумных воронок	Все игроки
vacuumhopper.admin	Выдача воронок и перезагрузка настроек	OP

🧩 Совместимость

• Minecraft 1.20–26.3
• Paper
• Purpur
• Spigot
• Bukkit
• Java 17+

Folia, Sponge, BungeeCord, Velocity и Waterfall не поддерживаются.

⚠️ VacuumHopper пока находится в стадии beta. Перед установкой обновлений на рабочий сервер рекомендуется сделать резервную копию.

📥 Установка

1. Скачайте JAR-файл.
2. Поместите его в папку plugins.
3. Перезапустите сервер.
4. При необходимости измените plugins/VacuumHopper/config.yml.
5. После изменения настроек выполните /vh reload.

---

Author: AmazonFix

Поддержать меня на Boosty - boosty.to/amazonfix