Scythe - плагин для авто-пересадки и сбора урожая правым кликом

Scythe - это плагин для серверов Minecraft, который решает надоедливую проблему фермерства: после сбора урожая нужно каждый раз пересаживать культуры вручную. С Scythe всё происходит автоматически - достаточно просто сломать созревшее растение, и на его месте сразу появится новое. Более того, можно собирать урожай правым кликом мыши, не ломая блок, что значительно ускоряет процесс. Для серверов с фермерскими механиками это просто must-have.

Возможности

• Автоматическая пересадка культур после сбора
• Сбор урожая правым кликом (созревшие растения)
• Приседание (Shift) позволяет ломать культуры без пересадки, чтобы убрать их
• Гибкая настройка через конфиг: можно включить/выключить функции, задать инструменты, звуки, частицы и т.д.

Команды

• /scythe toggle - включает/выключает автоматическую пересадку и сбор правым кликом для себя. Требуется permission scythe.toggle.
• /scythe reload - перезагружает конфиг плагина. Требуется permission scythe.reload.

Разрешения (Permissions)

• scythe.use - базовое разрешение для использования функционала Scythe.
• scythe.use.harvest - разрешение на сбор урожая (правый клик).
• scythe.use.replant - разрешение на авто-пересадку.
• scythe.toggle - разрешение на команду /scythe toggle.
• scythe.reload - разрешение на команду /scythe reload.

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

Конфиг находится в файле config.yml. Вот пример с пояснениями:

# Scythe
auto-replant:
  enabled: true # Автоматически пересаживать культуры?
  require-seeds: false # Требовать семена в инвентаре? (будут тратиться)
  require-tool: false # Требовать определённый инструмент?
  delay-ticks: 1 # Задержка в тиках перед пересадкой (20 тиков = 1 секунда)
right-click-harvest:
  enabled: true # Разрешить сбор правым кликом?
  require-tool: false # Требовать инструмент?
# Применяется, если require-tool включён
tools:
  enabled-tools:
    - "minecraft:wooden_hoe"
    - "minecraft:stone_hoe"
    - "minecraft:iron_hoe"
    - "minecraft:golden_hoe"
    - "minecraft:diamond_hoe"
    - "minecraft:netherite_hoe"
  required-item-models: [ ]
  durability:
    harvest-uses-durability: false # Тратить прочность при сборе правым кликом?
    replant-uses-durability: false # Тратить прочность при авто-пересадке?
    prevent-tool-break: true # Не давать сломать инструмент?
    minimum-durability: 10 # Минимальная прочность для работы
sounds:
  enabled: true
  break-sound: BLOCK_CROP_BREAK
  plant-sound: ITEM_CROP_PLANT
  volume: 1.0
  pitch: 1.0
particles:
  harvest:
    enabled: true
    particle: BLOCK
    count: 40
    spread: 0.5
  replant:
    enabled: true
    particle: HAPPY_VILLAGER
    count: 2
    spread: 0.5
allowed-crops:
  - BEETROOTS
  - CARROTS
  - COCOA
  - NETHER_WART
  - POTATOES
  - WHEAT
  # - PUMPKIN_STEM
  # - MELON_STEM

API для разработчиков

Плагин предоставляет два события, которые можно отменять:

HarvestEvent - отменяемое

Метод	Возвращает	Описание
getPlayer()	Player	Игрок, который собрал урожай
getBlock()	Block	Блок культуры, который собирают
isCancelled()	boolean	Проверить, отменено ли событие
setPlayer(Player)	void	Изменить игрока
setBlock(Block)	void	Изменить блок
setCancelled(boolean)	void	Отменить или разрешить событие
getHandlers()	HandlerList	Bukkit handler
getHandlerList()	HandlerList	Bukkit static handler

ReplantEvent - отменяемое

Метод	Возвращает	Описание
getPlayer()	Player	Игрок, инициировавший пересадку
getBlock()	Block	Блок, который будет пересажен
getBlockData()	BlockData	BlockData для нового растения
isCancelled()	boolean	Проверить отмену
setPlayer(Player)	void	Изменить игрока
setBlock(Block)	void	Изменить блок
setBlockData(BlockData)	void	Изменить BlockData
setCancelled(boolean)	void	Отменить
getHandlers()	HandlerList	Bukkit handler
getHandlerList()	HandlerList	Bukkit static handler

Подключение через Maven

<repository>
    <id>modrinth-repo</id>
    <url>https://api.modrinth.com/maven/</url>
</repository>

<dependency>
    <groupId>maven.modrinth</groupId>
    <artifactId>scythe</artifactId>
    <version>4.0</version>
    <scope>provided</scope>
</dependency>

Gradle

exclusiveContent {
    forRepository { maven { url = "https://api.modrinth.com/maven" } }
    filter { includeGroup "maven.modrinth" }
}

dependencies {
    compileOnly 'maven.modrinth:scythe:4.0'
}

Важно знать

• Плагин работает с культурами, которые имеют блок данных Ageable. По умолчанию поддерживаются: свёкла, морковь, какао, адский нарост, картофель, пшеница. Можно добавить другие, но не все работают корректно.
• Если включено require-seeds, то при пересадке будут тратиться семена из инвентаря.
• Можно настроить звуки и частицы для более приятного опыта.
• Для работы требуется Paper или его форк (Spigot, Purpur), так как используются API Paper.

Если вы администрируете сервер с фермерством, Scythe сэкономит кучу времени игрокам. Скачайте плагин Scythe и забудьте про рутину пересадки!