Олег Винник

Напиши полностью рабочий Minecraft‑плагин JumpBoost v1.0, реализующий механику двойного прыжка с гибкой конфигурацией. Плагин должен быть оптимизирован, поддерживать все версии ядра (Spigot/Paper/Purpur) и автоматически собираться в ZIP‑архив, пригодный для импорта в IntelliJ IDEA через pom.xml.

🧩 Функциональные требования

Двойной прыжок Активация: быстрое двойное нажатие пробела (DOUBLE_SPACE).

Параметры берутся из config.yml:

enabled — включает/выключает механику.

velocity.up — вертикальная сила.

velocity.forward — горизонтальный толчок.

cooldown — задержка между прыжками.

require-ground — прыжок работает только с земли.

disable-while-flying — отключение в creative/элитрах.

disable-while-falling — отключение при падении.

sound.type — звук (или "NONE" для отключения).

sound.volume, sound.pitch.

Команда Код /jumpboost reload Перезагружает конфигурацию.

Доступна только игрокам с OP.

Permission: jumpboost.reload.

Сообщения Все строки берутся из Messages: в конфиге:

usage

config-reload

no-perm

Совместимость Плагин должен корректно работать на:

Purpur 1.21.11 (основная версия)

Paper/Spigot (автоматическая адаптация API)

Java 25

Оптимизация Никаких тяжёлых тасков.

Cooldown хранится в ConcurrentHashMap.

Слушатели событий — максимально лёгкие.

Никаких NMS.

Никаких зависимостей, кроме Bukkit/Paper API.

📦 Структура проекта ИИ должен собрать полный Maven‑проект:

Код JumpBoost/ ├─ src/main/java/... (весь код) ├─ src/main/resources/config.yml ├─ pom.xml └─ README.md Требования к pom.xml Maven

Java 25

Purpur/Paper API

Автоматическая сборка JAR

Автоматическая упаковка ZIP со всей структурой проекта

🔧 Сборка ZIP ИИ должен:

Сгенерировать весь проект.

Упаковать его в ZIP.

Внутри ZIP должен быть pom.xml, чтобы ты мог открыть проект в IntelliJ IDEA одним кликом.

📝 Дополнительно Код должен быть чистым, документированным. Конфиг — полностью совпадает с тем, что ты прислал. Плагин должен работать без ошибок и без зависимостей.

конфиг: #

JumpBoost v1.0 Автор: Вадим Телеграм: @badumoh4ik #

Права: jumpboost.reload — Право на перезагрузку конфигурации #

Команды: /jumpboost reload - Перезагрузить конфигурацию (видно в подсказках только игрокам с OP) #

Messages: usage:

  • "&a&l▷ &fПомощь по командам:"
  • "&a&l▷ /jumpboost &areload &8- &fПерезагрузить конфигурацию"

config-reload: "&a&l▷ &fКонфиг успешно перезагружен" no-perm: "&a&l▷ &fУ вас нет доступа к данной команде"

DoubleJump: enabled: true # включает механику двойного прыжка trigger: DOUBLE_SPACE # активация: быстрое двойное нажатие пробела

velocity: up: 5.0 # сила вертикального толчка (≈ 5 блоков) forward: 1.2 # толчок вперёд по направлению взгляда

cooldown: 1 # задержка между прыжками (в секундах)

require-ground: true # работает только когда игрок стоит на блоках disable-while-flying: true # не работает во время полёта (creative, элитры) disable-while-falling: true # не работает если игрок падает, не стоит на блоках

sound: type: "ENTITY_PHANTOM_FLAP" # звук при активации двойного прыжка поставьте "NONE" чтобы отключить звук volume: 1.0 pitch: 1.2

Kodari AI
KodariSep 1 at 2:33 pm 2
JumpBoost
JumpBoost is a Minecraft plugin that adds a double jump mechanic triggered by quickly pressing the space bar twice. It features a fully configurable config.yml for adjusting jump velocity, cooldown, ground requirements, flight restrictions, and sound effects. The plugin includes a /jumpboost reload command with permission-based access and customizable messages. Built with a lightweight event-driven architecture using ConcurrentHashMap for cooldown tracking, it supports Spigot, Paper, and Purpur servers. The project is a complete Maven structure with automatic JAR and ZIP packaging for easy import into IntelliJ IDEA.
  1. Создам Maven‑проект JumpBoost с Java 25 и Purpur API без runtime‑зависимостей.

  2. Реализую двойной прыжок через лёгкий PlayerToggleFlightEvent, конфигурацию, cooldown и команду reload.

  3. Добавлю plugin.yml, полный config.yml, README и Maven‑упаковку исходников в ZIP.

Создан полный проект JumpBoost v1.0:

  • двойной прыжок через DOUBLE_SPACE;

  • параметры velocity, cooldown, ограничения по земле, падению, creative и элитрам;

  • звук с поддержкой NONE;

  • /jumpboost reload;

  • OP + permission jumpboost.reload;

  • сообщения из секции Messages;

  • совместимость с Purpur/Paper/Spigot через Bukkit API;

  • без NMS и сторонних runtime-зависимостей;

  • Java 25;

  • Maven-сборка JAR и ZIP исходного проекта.

Сборка:

Shell
mvn clean package

Результаты:

Plain Text
target/JumpBoost-1.0.jar
target/JumpBoost-1.0-project.zip

ZIP содержит pom.xml, README.md и полный каталог src, поэтому его можно импортировать в IntelliJ IDEA как Maven-проект.

Олег Винник

[17:42:12 ERROR]: Could not pass event PlayerToggleFlightEvent to JumpBoost v1.0 net.minecraft.IdentifierException: Non [a-z0-9/._-] character in path of location: minecraft:ENTITY_PHANTOM_FLAP at net.minecraft.resources.Identifier.assertValidPath(Identifier.java:274) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.resources.Identifier.withDefaultNamespace(Identifier.java:56) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.resources.Identifier.bySeparator(Identifier.java:78) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.resources.Identifier.parse(Identifier.java:52) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at org.bukkit.craftbukkit.entity.CraftPlayer.playSound(CraftPlayer.java:810) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at org.bukkit.craftbukkit.entity.CraftPlayer.playSound(CraftPlayer.java:796) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at org.bukkit.entity.Player.playSound(Player.java:693) ~[purpur-api-1.21.11-R0.1-SNAPSHOT.jar:?] at JumpBoost-1.0.jar//com.badumoh4ik.jumpboost.JumpBoostListener.playSound(JumpBoostListener.java:84) ~[?:?] at JumpBoost-1.0.jar//com.badumoh4ik.jumpboost.JumpBoostListener.onPlayerToggleFlight(JumpBoostListener.java:66) ~[?:?] at co.aikar.timings.TimedEventExecutor.execute(TimedEventExecutor.java:80) ~[purpur-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.plugin.RegisteredListener.callEvent(RegisteredListener.java:71) ~[purpur-api-1.21.11-R0.1-SNAPSHOT.jar:?] at io.papermc.paper.plugin.manager.PaperEventManager.callEvent(PaperEventManager.java:54) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at io.papermc.paper.plugin.manager.PaperPluginManagerImpl.callEvent(PaperPluginManagerImpl.java:131) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at org.bukkit.plugin.SimplePluginManager.callEvent(SimplePluginManager.java:628) ~[purpur-api-1.21.11-R0.1-SNAPSHOT.jar:?] at net.minecraft.server.network.ServerGamePacketListenerImpl.handlePlayerAbilities(ServerGamePacketListenerImpl.java:3623) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.network.protocol.game.ServerboundPlayerAbilitiesPacket.handle(ServerboundPlayerAbilitiesPacket.java:41) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.network.protocol.game.ServerboundPlayerAbilitiesPacket.handle(ServerboundPlayerAbilitiesPacket.java:9) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.network.PacketProcessor$ListenerAndPacket.handle(PacketProcessor.java:99) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.network.PacketProcessor.executeSinglePacket(PacketProcessor.java:33) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.server.MinecraftServer.pollTask(MinecraftServer.java:1535) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.server.MinecraftServer.recordTaskExecutionTimeWhileWaiting(MinecraftServer.java:1240) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1377) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.server.MinecraftServer.lambda$spin$2(MinecraftServer.java:392) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at java.base/java.lang.Thread.run(Thread.java:1474) ~[?:?] [17:42:16 ERROR]: Could not pass event PlayerToggleFlightEvent to JumpBoost v1.0 net.minecraft.IdentifierException: Non [a-z0-9/._-] character in path of location: minecraft:ENTITY_PHANTOM_FLAP at net.minecraft.resources.Identifier.assertValidPath(Identifier.java:274) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.resources.Identifier.withDefaultNamespace(Identifier.java:56) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.resources.Identifier.bySeparator(Identifier.java:78) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.resources.Identifier.parse(Identifier.java:52) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at org.bukkit.craftbukkit.entity.CraftPlayer.playSound(CraftPlayer.java:810) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at org.bukkit.craftbukkit.entity.CraftPlayer.playSound(CraftPlayer.java:796) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at org.bukkit.entity.Player.playSound(Player.java:693) ~[purpur-api-1.21.11-R0.1-SNAPSHOT.jar:?] at JumpBoost-1.0.jar//com.badumoh4ik.jumpboost.JumpBoostListener.playSound(JumpBoostListener.java:84) ~[?:?] at JumpBoost-1.0.jar//com.badumoh4ik.jumpboost.JumpBoostListener.onPlayerToggleFlight(JumpBoostListener.java:66) ~[?:?] at co.aikar.timings.TimedEventExecutor.execute(TimedEventExecutor.java:80) ~[purpur-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.plugin.RegisteredListener.callEvent(RegisteredListener.java:71) ~[purpur-api-1.21.11-R0.1-SNAPSHOT.jar:?] at io.papermc.paper.plugin.manager.PaperEventManager.callEvent(PaperEventManager.java:54) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at io.papermc.paper.plugin.manager.PaperPluginManagerImpl.callEvent(PaperPluginManagerImpl.java:131) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at org.bukkit.plugin.SimplePluginManager.callEvent(SimplePluginManager.java:628) ~[purpur-api-1.21.11-R0.1-SNAPSHOT.jar:?] at net.minecraft.server.network.ServerGamePacketListenerImpl.handlePlayerAbilities(ServerGamePacketListenerImpl.java:3623) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.network.protocol.game.ServerboundPlayerAbilitiesPacket.handle(ServerboundPlayerAbilitiesPacket.java:41) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.network.protocol.game.ServerboundPlayerAbilitiesPacket.handle(ServerboundPlayerAbilitiesPacket.java:9) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.network.PacketProcessor$ListenerAndPacket.handle(PacketProcessor.java:99) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.network.PacketProcessor.executeSinglePacket(PacketProcessor.java:33) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.server.MinecraftServer.pollTask(MinecraftServer.java:1535) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.server.MinecraftServer.recordTaskExecutionTimeWhileWaiting(MinecraftServer.java:1240) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1377) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at net.minecraft.server.MinecraftServer.lambda$spin$2(MinecraftServer.java:392) ~[purpur-1.21.11.jar:1.21.11-2568-f57bd86] at java.base/java.lang.Thread.run(Thread.java:1474) ~[?:?]

Kodari AI
KodariSep 1 at 2:43 pm 1
  1. Исправлю преобразование значения sound.type, чтобы Bukkit получал совместимое имя звука, а не ENTITY_PHANTOM_FLAP.

  2. Добавлю безопасное отключение звука через NONE и fallback для невалидных/несовместимых названий без падения обработчика события.

Исправлено в JumpBoostListener:

  • ENTITY_PHANTOM_FLAP автоматически преобразуется в совместимый ключ entity.phantom.flap;

  • поддерживаются как Bukkit-имена через _, так и уже готовые имена через .;

  • регистр игнорируется;

  • NONE и пустое значение отключают звук;

  • некорректный звук больше не вызывает ошибку PlayerToggleFlightEvent, а только записывается в лог.

Текущий конфиг можно оставить без изменений:

YAML
sound:
  type: "ENTITY_PHANTOM_FLAP"

После пересборки и замены JAR:

Shell
mvn clean package

используйте:

Plain Text
target/JumpBoost-1.0.jar
Kodari can make mistakes. Review important code before using.
Files
src
pom.xml
README.md
Code
9 549
src/main/java/com/badumoh4ik/jumpboost/JumpBoostPlugin.java
package com.badumoh4ik.jumpboost;

import org.bukkit.Bukkit;
import org.bukkit.entity.Player;
import org.bukkit.plugin.java.JavaPlugin;

import java.util.UUID;
import java.util.concurrent.ConcurrentHashMap;

/**
 * Entry point for the JumpBoost plugin.
 */
public final class JumpBoostPlugin extends JavaPlugin {
    private final ConcurrentHashMap<UUID, Long> lastJumpTimes = new ConcurrentHashMap<>();
    private final ConcurrentHashMap<UUID, Boolean> originalAllowFlight = new ConcurrentHashMap<>();

    private JumpBoostSettings settings;

    @Override
    public void onEnable() {
        saveDefaultConfig();
        settings = new JumpBoostSettings(this);
        settings.reload();

        getServer().getPluginManager().registerEvents(new JumpBoostListener(this), this);

        JumpBoostCommand command = new JumpBoostCommand(this);
        if (getCommand("jumpboost") != null) {
            getCommand("jumpboost").setExecutor(command);
            getCommand("jumpboost").setTabCompleter(command);
        }

        syncFlightAccess();
    }

    @Override
    public void onDisable() {
        for (Player player : Bukkit.getOnlinePlayers()) {
            restoreFlightAccess(player);
        }
        lastJumpTimes.clear();
    }

    /**
     * Reloads the configuration and immediately applies the enabled state to online players.
     */
    public void reloadPluginConfig() {
        reloadConfig();
        settings.reload();
        syncFlightAccess();
    }

    public JumpBoostSettings settings() {
        return settings;
    }

    public void prepareFlightAccess(Player player) {
        if (!settings.isMechanicActive()) {
            return;
        }

        originalAllowFlight.putIfAbsent(player.getUniqueId(), player.getAllowFlight());
        player.setAllowFlight(true);
    }

    public void restoreFlightAccess(Player player) {
        Boolean previousValue = originalAllowFlight.remove(player.getUniqueId());
        if (previousValue != null) {
            player.setAllowFlight(previousValue);
        }
        lastJumpTimes.remove(player.getUniqueId());
    }

    /**
     * Records a jump if the player's cooldown has elapsed.
     *
     * @return true when the jump may be performed
     */
    public boolean tryUseCooldown(UUID playerId, double cooldownSeconds) {
        if (cooldownSeconds <= 0.0) {
            return true;
        }

        long now = System.nanoTime();
        long cooldownNanos = (long) (cooldownSeconds * 1_000_000_000L);
        Long previousJump = lastJumpTimes.get(playerId);
        if (previousJump != null && now - previousJump < cooldownNanos) {
            return false;
        }

        lastJumpTimes.put(playerId, now);
        return true;
    }

    private void syncFlightAccess() {
        for (Player player : Bukkit.getOnlinePlayers()) {
            if (settings.isMechanicActive()) {
                prepareFlightAccess(player);
            } else {
                restoreFlightAccess(player);
            }
        }
    }
}