SlayZer4ik227

Мне нужен плагин, в котором админ пишет команду /abuseadm, и начинается условный админ абьюз, всем игрокам выдаются эффекты (настраиваемые какие эффекты, и время), затем под админом написавший /abusespawn , спавнится мини данж с 1 сундуком , где будет настраиваемый лут, у всех игроков в босс баре появляется отсчет 3 минуты, затем после истечения 3 минут появляются координаты в этом же бос баре. Рядом с этим мини данжом будут спавнится скелеты и зомби в алмазной/железной броней и крутыми луками и мечами, но убив их, лут с них не будет падать. Придумай еще от себя что то

Kodari AI
KodariOct 6 at 6:11 am 2
AbuseDungeonEvent
A Minecraft plugin where an admin triggers a timed PvE event. Running /abuseadm applies configurable potion effects to all players for a set duration. Running /abusespawn creates a mini-dungeon with a loot chest containing configurable rewards. A boss bar displays a 3-minute countdown, then reveals dungeon coordinates. Around the dungeon, armored skeletons and zombies spawn with powerful bows and swords but drop no loot. Additional feature: a final boss mob spawns after the timer expires, dropping exclusive loot, with particle effects and sound cues marking the dungeon entrance.
  1. Создам конфиг эффектов, длительности, таймера и лута.

  2. Добавлю /abuseadm для запуска/остановки события и /abusespawn для данжа.

  3. Реализую босcбар, запертый до конца отсчёта сундук и охрану без дропа.

Создан плагин AbuseEvent.

  • /abuseadm — запускает или останавливает ивент; при запуске игроки получают эффекты из config.yml.

  • /abusespawn — создаёт мини-данж и восемь бронированных скелетов и зомби. Их экипировка не выпадает.

  • На время отсчёта сундук закрыт. После него боссбар показывает координаты, а в сундуке появляется настроенный лут.

  • Настройки эффектов, таймера и наград находятся в src/main/resources/config.yml.

SlayZer4ik227
📎 1 file 12,366 chars
📄
pasted-code-1791268161378.txt
txt 783 lines
▶
Разработай полноценный Minecraft-плагин **AdminAbuse** для Paper/Spigot-сервера.

Главная идея плагина: это простой атмосферный **Admin Abuse Event** для обычного vanilla-like SMP. Никаких RPG-систем, уровней, валют, GUI и мини-игр. Только временные события, мобы, данжи, босс и награды.

## 1. Основные требования

Плагин должен иметь только 2 типа событий:

* `Dungeon Abuse`
* `Boss Abuse`

Также должна быть команда:

```text
/abuseadm random
```

Она случайно выбирает между Dungeon и Boss по весам из config.

Одновременно может существовать **только одно событие**.

Основные команды:

```text
/abuseadm dungeon
/abuseadm boss
/abuseadm random
/abuseadm stop
/abuseadm status
/abuseadm reload

/abusespawn
```

Permission:

```text
adminabuse.admin
```

Все сообщения, BossBar, эффекты, таймеры, координаты, радиусы, мобы, лут и остальные параметры должны настраиваться через `config.yml`.

---

# 2. Совместимость с версиями

Сделай плагин максимально независимым от конкретной версии Minecraft.

Используй в первую очередь стабильный Bukkit/Paper API.

Не используй NMS без крайней необходимости.

Если для разных версий действительно нужны разные реализации, сделай систему адаптеров:

```text
compat/
├── VersionAdapter.java
├── ...
```

Плагин должен определять версию сервера при запуске и выбирать подходящую реализацию.

Основная логика плагина не должна напрямую зависеть от NMS.

---

# 3. Общая логика события

При запуске события:

1. Проверить, нет ли уже активного события.
2. Если событие уже активно — вывести сообщение.
3. Создать временное состояние события.
4. Создать временную защищённую область.
5. Отправить всем игрокам глобальное сообщение.
6. При необходимости выдать игрокам настроенные эффекты.
7. Создать BossBar.
8. Запустить нужную механику события.

После окончания:

* удалить временных мобов;
* удалить BossBar;
* отменить таймеры;
* отключить временную защиту;
* очистить временное состояние;
* вернуть мир в обычное состояние.

Плагин не должен оставлять после себя мусор.

---

# 4. Временная защищённая область

Для каждого активного события автоматически создаётся временная область.

WorldGuard использовать НЕ обязательно.

Реализовать собственный `RegionManager`.

Пример:

```yaml
region:
  enabled: true
  radius: 40
  min-y: -64
  max-y: 320
```

Внутри области игрокам запрещено:

* ломать блоки;
* ставить блоки;
* использовать ведра;
* выливать воду/лаву;
* изменять блоки другими обычными способами.

Возможность запрета взаимодействия с контейнерами должна быть настраиваемой.

Игрок с permission:

```text
adminabuse.admin
```

может обходить защиту.

После окончания события область полностью отключается.

Защита должна работать через Bukkit/Paper events, без постоянного сканирования мира.

---

# 5. Dungeon Abuse

Команда:

```text
/abuseadm dungeon
```

запускает данж.

## Создание данжа

Данж должен быть небольшим и выглядеть как ванильная структура.

Желательно поддержать schematic/структуру.

Пример:

```yaml
dungeon:
  world: world
  location:
    x: 100
    y: 70
    z: -200
```

Создание структуры вынести в `DungeonManager`.

---

# 6. Несколько сундуков

В данже должно быть **несколько сундуков**.

Количество настраивается:

```yaml
dungeon:
  chests:
    amount: 4
```

Поддержать:

1. ручное указание координат;
2. автоматическое определение сундуков из schematic.

Пример:

```yaml
dungeon:
  chests:
    locations:
      - "105,72,-198"
      - "110,72,-203"
      - "98,71,-205"
      - "103,73,-210"
```

Каждый сундук может иметь собственный loot table.

---

# 7. Loot System

Создать отдельный:

```text
LootManager
```

Поддержать:

* Material;
* количество;
* шанс;
* случайное количество;
* enchantments;
* custom name;
* lore;
* несколько предметов;
* разные loot tables.

Пример:

```yaml
loot:
  dungeon:
    chest_1:
      - item: DIAMOND
        amount: 3
        chance: 30

      - item: GOLDEN_APPLE
        amount: 1
        chance: 15

    chest_2:
      - item: DIAMOND_SWORD
        amount: 1
        chance: 10
        enchantments:
          SHARPNESS: 4
```

Использовать обычные Minecraft-предметы.

---

# 8. Мобы возле данжа

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

Основные:

* Zombie;
* Skeleton.

Им можно выдавать:

* железную броню;
* алмазную броню;
* мечи;
* луки;
* эффекты.

Все параметры настраиваются.

Пример:

```yaml
dungeon:
  mobs:
    enabled: true
    radius: 25
    amount: 15

    zombie:
      enabled: true
      armor:
        helmet: IRON_HELMET
        chestplate: IRON_CHESTPLATE
        leggings: IRON_LEGGINGS
        boots: IRON_BOOTS

    skeleton:
      enabled: true
      weapon: BOW
```

У созданных плагином мобов отключить обычный loot drop.

UUID всех созданных мобов сохранять.

После завершения события удалять только этих мобов.

Обычных мобов сервера не трогать.

---

# 9. Таймер координат данжа

После запуска данжа игроки не должны сразу видеть координаты.

Создать BossBar:

```text
⚡ ADMIN ABUSE | Координаты появятся через 03:00
```

Время настраивается.

После окончания:

```text
⚡ DUNGEON | X: 100 Y: 70 Z: -200
```

Также отправить:

```text
⚡ Координаты данжа раскрыты!
```

---

# 10. Разблокировка сундуков

Можно использовать отдельную задержку после раскрытия координат.

Пример:

```yaml
dungeon:
  chest-unlock-delay: 30
```

До разблокировки открыть сундук нельзя.

После:

```text
🔓 Сундуки данжа разблокированы!
```

Сундуки заполняются настроенным лутом.

---

# 11. Boss Abuse

Команда:

```text
/abuseadm boss
```

создаёт усиленного Warden.

Название по умолчанию:

```text
☠ Ancient Warden
```

Все параметры должны настраиваться.

Пример:

```yaml
boss:
  type: WARDEN
  name: "☠ Ancient Warden"

  health: 800
  damage-multiplier: 0.75
  speed: 1.0

  spawn:
    world: world
    x: 500
    y: 70
    z: 500
```

Поддержать настройку:

* здоровья;
* скорости;
* урона;
* эффектов;
* поведения;
* имени;
* звуков;
* частиц;
* других параметров, доступных через API.

---

# 12. Координаты первоначального спавна Warden

При создании Warden обязательно сохранить его первоначальную точку появления:

```text
spawnLocation
```

Эта точка должна сохраняться отдельно от текущей позиции Warden.

Например:

```text
BossAbuse#getSpawnLocation()
```

должен возвращать именно первоначальную точку спавна.

Важно:

**Не брать координаты из текущей позиции Warden.**

Если Warden переместился, координаты спавна всё равно остаются прежними.

Если Warden был возвращён системой leash, координаты также не изменяются.

---

# 13. BossBar босса

Во время боя игроки должны видеть BossBar с:

* названием босса;
* текущим HP;
* максимальным HP;
* процентом здоровья;
* координатами первоначального спавна Warden.

Пример:

```text
☠ ANCIENT WARDEN | 637 / 800 HP | Spawn: X: 500 Y: 70 Z: 500
```

BossBar должен постоянно показывать реальное здоровье босса.

Добавить placeholders:

```text
%boss_health%
%boss_max_health%
%boss_percent%
%boss_name%

%boss_spawn_x%
%boss_spawn_y%
%boss_spawn_z%
%boss_spawn_world%
```

Пример настройки:

```yaml
boss:
  bossbar:
    enabled: true

    title: "☠ ANCIENT WARDEN | %boss_health% / %boss_max_health% HP | Spawn: X: %boss_spawn_x% Y: %boss_spawn_y% Z: %boss_spawn_z%"

    color: RED
    style: SEGMENTED_10
```

BossBar должен обновляться без лишней нагрузки.

Координаты должны всегда показывать **точку первоначального спавна**, а не текущее положение босса.

---

# 14. Ограничение Warden

Warden не должен уходить далеко от точки первоначального спавна.

Настройка:

```yaml
boss:
  leash:
    enabled: true
    radius: 100
```

После создания сохранить:

```text
spawnLocation
```

Если Warden выходит дальше указанного радиуса, он должен возвращаться к первоначальной точке.

Расстояние проверять преимущественно по X/Z.

По умолчанию максимальное расстояние:

**100 блоков.**

Проверять расстояние не каждый тик, а через разумный интервал, например каждые 10–20 тиков.

Если точка возвращения находится внутри блока или в неподходящем месте, найти безопасную ближайшую позицию.

Если Warden находится внутри разрешённого радиуса, не телепортировать его.

---

# 15. Смерть босса

Когда Warden погибает:

1. Сохранить точку смерти.
2. Удалить BossBar.
3. Определить место награды.
4. Поставить настроенный блок.

Например:

```yaml
boss:
  reward:
    block: CRYING_OBSIDIAN
```

После настраиваемой задержки активировать награду.

---

# 16. Loot босса

После активации блока из него должны физически вылетать предметы вокруг блока.

Пример:

```yaml
boss:
  reward:
    radius: 5
    delay: 2

    loot:
      - item: DIAMOND
        amount: 5
        chance: 100

      - item: NETHERITE_SCRAP
        amount: 2
        chance: 30
```

Предметы должны реально появляться в мире с небольшим разбросом и скоростью.

Поддержать:

* шанс;
* количество;
* случайное количество;
* enchantments;
* custom name;
* lore.

---

# 17. Random Abuse

Команда:

```text
/abuseadm random
```

выбирает только:

```text
DUNGEON
BOSS
```

Настройка:

```yaml
random:
  dungeon-weight: 50
  boss-weight: 50
```

Например:

```yaml
random:
  dungeon-weight: 70
  boss-weight: 30
```

**Не добавлять Horde Abuse и Meteor Abuse.**

---

# 18. /abusespawn

Команда:

```text
/abusespawn
```

должна запускать основную стадию события согласно логике плагина.

Не создавать параллельное событие, если другое уже активно.

---

# 19. /abuseadm stop

Команда:

```text
/abuseadm stop
```

полностью останавливает активное событие.

Удалить:

* Warden;
* созданных мобов;
* временные сущности;
* BossBar;
* таймеры;
* защитную область.

Очистить состояние.

Обычные сущности сервера не удалять.

---

# 20. /abuseadm status

Для Dungeon:

```text
AdminAbuse
Статус: ACTIVE
Тип: DUNGEON
Координаты: скрыты
До раскрытия: 01:37
Сундуков: 4
Регион: 40 блоков
```

Для Boss:

```text
AdminAbuse
Статус: ACTIVE
Тип: BOSS
Босс: Ancient Warden
HP: 637 / 800
Spawn: X: 500 Y: 70 Z: 500
Регион: 40 блоков
Leash: 100 блоков
```

Если события нет:

```text
AdminAbuse
Активных событий нет.
```

---

# 21. Эффекты игроков

При старте события можно выдавать игрокам эффекты.

Пример:

```yaml
effects:
  enabled: true

  - type: NIGHT_VISION
    duration: 180
    amplifier: 0

  - type: SPEED
    duration: 180
    amplifier: 0
```

Не ломать эффекты, полученные игроком из других источников.

По завершении желательно удалить только эффекты, добавленные AdminAbuse.

---

# 22. Сообщения

Все сообщения вынести в config:

```yaml
messages:
  dungeon-start: "⚡ Admin Abuse: Данж появился!"
  boss-start: "☠ Admin Abuse: Древний Страж пробудился!"
  coordinates-revealed: "⚡ Координаты события раскрыты!"
  chests-unlocked: "🔓 Сундуки данжа разблокированы!"
  event-stopped: "Admin Abuse остановлен."
  event-already-active: "Сейчас уже активно другое событие."
```

---

# 23. Config

В `config.yml` вынести:

* общие настройки;
* сообщения;
* эффекты;
* BossBar;
* region;
* dungeon;
* chests;
* loot;
* mobs;
* boss;
* Warden leash;
* boss spawn;
* boss reward;
* random weights;
* sounds;
* particles;
* timers.

Не зашивать важные значения непосредственно в код.

---

# 24. Архитектура

Использовать нормальную объектную архитектуру:

```text
AdminAbuse
│
├── AbuseManager
│
├── event/
│   ├── AbuseEvent
│   ├── DungeonAbuse
│   └── BossAbuse
│
├── dungeon/
│   └── DungeonManager
│
├── boss/
│   └── BossManager
│
├── region/
│   └── RegionManager
│
├── loot/
│   └── LootManager
│
├── mob/
│   └── MobManager
│
├── bossbar/
│   └── BossBarManager
│
├── config/
│   └── ConfigManager
│
├── command/
│   └── AbuseCommand
│
├── listener/
│   ├── RegionProtectionListen
```
Kodari AI
KodariOct 6 at 6:36 am 3
  1. Сверю текущую структуру проекта и заменю прежнюю упрощённую механику на основу AdminAbuse.

  2. Реализую данж: несколько сундуков, настраиваемый лут, мобы без дропа, таймер и защита области.

  3. Добавлю босса, BossBar с исходными координатами, leash и награду; свяжу команды, конфиг и очистку события.

Добавлен AdminAbuse с двумя типами событий и настройками в config.yml.

  • /abuseadm dungeon запускает событие, а /abusespawn создаёт данж и запускает отсчёт. После раскрытия координат сундуки разблокируются с настраиваемой задержкой.

  • /abuseadm boss создаёт настроенного босса с BossBar здоровья и исходных координат, leash, эффектами, звуками, частицами и наградой.

  • /abuseadm random выбирает данж или босса с заданными весами. Также доступны stop, status и reload.

  • Настраиваются регион и его защита, эффекты игроков, мобы и их экипировка, сундуки, лут, таймеры и сообщения. Созданные данжом блоки и мобы очищаются при остановке; обычных мобов плагин не удаляет.

Данж создаётся из ванильных блоков без schematic; сундуки можно размещать настройкой координат.

SlayZer4ik227

скинь

Kodari AI
KodariOct 6 at 6:40 am 1

Чтобы скачать .jar: нажми Compile в верхней панели, затем Compile в открывшемся окне. После успешной сборки нажми Download.

SlayZer4ik227
📎 1 file 17,063 chars
📄
pasted-code-1791270454397.txt
txt 1068 lines
▶
# AdminAbuse — техническое задание на разработку Minecraft-плагина

Разработай полноценный Paper-плагин **AdminAbuse** для vanilla-like SMP сервера.

Главная идея плагина — временные массовые ивенты от администратора: **Dungeon Abuse**, **Boss Abuse** или **Random**. Плагин должен быть атмосферным, простым для игроков и не превращать сервер в RPG/minigame.

---

## 1. Основные требования

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

* `Dungeon Abuse`
* `Boss Abuse`

`Random` случайно выбирает один из этих двух типов.

Одновременно может существовать только **одно активное событие**.

Все основные параметры должны быть вынесены в `config.yml`.

Использовать стабильный Paper/Bukkit API. NMS использовать только там, где это действительно необходимо.

---

# 2. Команды

Добавить:

```text
/abuseadm dungeon
/abuseadm boss
/abuseadm random
/abuseadm stop
/abuseadm status
/abuseadm reload
/abuseadm skip
/abuseadm start

/abusespawn

/abuseloot dungeon
/abuseloot boss
/abuseloot dungeon clear
/abuseloot boss clear
/abuseloot dungeon list
/abuseloot boss list
```

Permission:

```text
adminabuse.admin
```

---

# 3. Запуск события

```text
/abuseadm dungeon
```

запускает Dungeon Abuse.

```text
/abuseadm boss
```

запускает Boss Abuse.

```text
/abuseadm random
```

случайно выбирает Dungeon или Boss.

Одновременно может существовать только одно событие.

---

# 4. Позиция события

Dungeon и Boss не должны появляться на hardcoded координатах.

Они должны появляться относительно администратора, запустившего событие.

Использовать:

```java
player.getLocation()
```

и текущий мир администратора.

---

# 5. Эффекты игроков

При фактическом начале события всем онлайн-игрокам выдать:

* Strength I
* Speed II
* Night Vision I
* Regeneration I
* Haste I

Длительность:

```text
900 секунд
```

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

```yaml
effects:
  enabled: true
  duration: 900

  strength:
    enabled: true
    amplifier: 0

  speed:
    enabled: true
    amplifier: 1

  night-vision:
    enabled: true
    amplifier: 0

  regeneration:
    enabled: true
    amplifier: 0

  haste:
    enabled: true
    amplifier: 0
```

Не удалять эффекты, которые были выданы игроку другими плагинами.

Отслеживать эффекты AdminAbuse отдельно.

---

# 6. Dungeon Abuse — пользовательский schematic

Плагин должен поддерживать пользовательские `.schem`.

Папка:

```text
plugins/AdminAbuse/schematics/
```

Пример:

```text
plugins/AdminAbuse/schematics/dungeon.schem
```

Предпочтительно использовать **WorldEdit API как optional dependency** для загрузки и вставки `.schem`.

Если WorldEdit отсутствует:

* AdminAbuse всё равно должен загрузиться;
* Dungeon Abuse должен корректно сообщить об отсутствии зависимости;
* сервер не должен падать.

---

# 7. Dungeon должен спавниться ПОД админом

ОЧЕНЬ ВАЖНО:

Dungeon должен появляться **под администратором**, который запускает:

```text
/abuseadm dungeon
```

Исходная точка:

```java
Location adminLocation = player.getLocation();
```

Позиция Dungeon по умолчанию должна быть примерно **на 10 блоков ниже администратора**.

Например:

```text
Админ:
X 500
Y 80
Z 500

Dungeon:
X 500
Y 70
Z 500
```

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

```yaml
dungeon:
  schematic: "dungeon.schem"

  paste:
    enabled: true
    offset-x: 0
    offset-y: 0
    offset-z: 0
    vertical-offset: -10
```

Фактическая позиция:

```java
Location dungeonLocation = adminLocation.clone().add(
    offsetX,
    verticalOffset + offsetY,
    offsetZ
);
```

Не использовать заранее заданные координаты.

Учитывать origin `.schem`.

Если schematic имеет собственную точку origin, корректно учитывать её при вставке.

---

# 8. Безопасная вставка Dungeon

Перед вставкой schematic:

1. Определить весь его footprint.
2. Сохранить оригинальные блоки.
3. Проверить, что вставка не создаст критических проблем.
4. Вставить Dungeon.

После завершения события восстановить исходные блоки.

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

```yaml
dungeon:
  cleanup:
    restore-original-blocks: true
```

Плагин не должен уничтожать постройки игроков.

---

# 9. Выход из Dungeon

ОЧЕНЬ ВАЖНО:

У Dungeon обязательно должен быть **нормальный выход**, чтобы игроки не оставались заперты внутри под землёй.

Предпочтительный вариант — выход через отдельный тоннель/лестницу, встроенный в пользовательский schematic.

Плагин должен поддерживать специальную точку выхода Dungeon.

Для этого использовать специальный блок/маркер в schematic либо configurable marker.

Предпочтительно сделать marker через специальный блок, например:

```text
LODESTONE
```

или другой configurable блок, который после вставки определяется плагином как:

```text
DUNGEON_EXIT
```

Блок-маркер не должен оставаться видимым как часть механики после запуска.

Например:

```yaml
dungeon:
  exit:
    enabled: true
    auto-detect: true
    marker-block: LODESTONE
```

Если в schematic найден marker:

```text
DUNGEON_EXIT
```

его координаты сохраняются как точка выхода.

---

# 10. Безопасный выход

При выходе игрок должен оказаться:

* на поверхности;
* примерно около места, где находится Dungeon;
* в безопасной позиции;
* не внутри блока;
* не внутри другого объекта.

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

Например:

```text
        SURFACE
────────────────────
          ↑
          │
       лестница
          │
          │
    ┌─────────────┐
    │   DUNGEON   │
    │             │
    │             │
    └─────────────┘
```

Если schematic уже содержит лестницу/коридор наружу, использовать именно его.

---

# 11. Автоматический выход, если схемой он не предусмотрен

Если в schematic нет специального `DUNGEON_EXIT`:

* не оставлять игроков запертыми;
* автоматически создать временный выход рядом с Dungeon;
* сделать вертикальный тоннель/лестницу к поверхности;
* после завершения события удалить его и восстановить оригинальные блоки.

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

```yaml
dungeon:
  exit:
    enabled: true

    auto-detect: true

    marker-block: LODESTONE

    fallback:
      enabled: true
      search-radius: 8
      surface-offset: 2
```

Fallback должен использоваться только если в schematic не найден основной выход.

---

# 12. Выход через команду

Добавить удобную команду:

```text
/abuseexit
```

Она телепортирует игрока к выходу текущего Dungeon Abuse.

Permission для обычных игроков не требуется.

Команда работает только если активен Dungeon Abuse.

Если активного Dungeon нет:

```text
§cСейчас нет активного данжа.
```

Если игрок уже находится вне Dungeon:

```text
§eВы уже находитесь снаружи данжа.
```

Плагин должен определить, находится ли игрок внутри активной области Dungeon.

---

# 13. Автоопределение сундуков

После вставки schematic автоматически найти:

* Chest
* Trapped Chest

и зарегистрировать их как Dungeon loot containers.

Администратору не нужно вручную указывать координаты.

---

# 14. Loot Editor

Команды:

```text
/abuseloot dungeon
/abuseloot boss
```

открывают GUI для настройки loot.

Количество предмета в редакторе означает максимальное количество.

Например:

```text
43 Diamonds
```

означает:

```text
0–43 Diamonds
```

никогда больше 43.

Хранить:

```text
plugins/AdminAbuse/loot/dungeon.yml
plugins/AdminAbuse/loot/boss.yml
```

---

# 15. Dungeon Chest Timer

После раскрытия координат начинается новый countdown:

```text
3 минуты
```

Над каждым сундуком использовать `TextDisplay`:

```text
§eСундук откроется через 02:59
```

После `00:00` сундук становится доступным.

---

# 16. Dungeon Countdown

После появления Dungeon:

```text
⚡ ADMIN ABUSE | Координаты появятся через 03:00
```

Через 3 минуты:

```text
⚡ Координаты данжа раскрыты!
```

После раскрытия:

```text
⚡ DUNGEON | X: 100 Y: 70 Z: -200
```

Координаты должны соответствовать реальному месту Dungeon.

---

# 17. Dungeon Sounds

При старте Dungeon всем игрокам проиграть подходящий Wither spawn/summon sound.

Около Dungeon периодически проигрывать cave ambient sounds.

```yaml
dungeon:
  ambient:
    enabled: true
    radius: 40
    interval: 10
```

---

# 18. Dungeon Mobs

Zombies:

```text
3–10
Strength I
```

Skeletons:

```text
5–10
Strength I
```

Vindicators:

```text
4–8
Regeneration I
без брони
```

Количество случайное в указанных диапазонах.

---

# 19. Dungeon Mob Drops

Все мобы, созданные AdminAbuse, не должны оставлять обычный vanilla loot.

Использовать UUID tracking.

Обычных мобов сервера не удалять и не изменять.

---

# 20. Dungeon Protection

Создать внутренний RegionManager.

```yaml
region:
  enabled: true
  radius: 40
  min-y: -64
  max-y: 320
```

Запретить:

* ломать блоки;
* ставить блоки;
* воду;
* лаву;
* ведра;
* другие изменения мира.

Администратор с `adminabuse.admin` может обходить защиту.

После события защита удаляется.

---

# 21. Boss Abuse

Создавать усиленного:

```text
WARDEN
```

рядом с администратором.

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

```yaml
boss:
  type: WARDEN
  name: "☠ Ancient Warden"
  health: 800
  damage-multiplier: 0.75
  speed: 1.0
```

---

# 22. Скалк под Warden

При появлении Warden:

```text
       WARDEN
          ↓
        SCULK
```

непосредственно под ним создать:

```text
SCULK
```

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

```yaml
boss:
  spawn:
    place-sculk: true
    sculk-block: SCULK
```

Запомнить оригинальный блок.

После завершения Boss Abuse восстановить оригинальный блок, если он был заменён плагином.

---

# 23. Звуки Warden

Звуковая атмосфера должна быть похожа на Deep Dark.

Использовать:

* Warden ambient;
* Warden heartbeat;
* Warden listening;
* Warden attack/roar-like sounds там, где это уместно;
* Sculk Shrieker sounds;
* другие подходящие sculk/deep-dark sounds.

Особенно важно, чтобы при появлении Warden и во время его активности были слышны характерные **крики/звуки Вардена и скалкового крикуна**.

Не спамить звуками по всему серверу.

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

```yaml
boss:
  sounds:
    enabled: true
    radius: 60
    interval: 8

    warden:
      ambient: true
      heartbeat: true
      listening: true

    sculk-shrieker:
      enabled: true
```

Звуки должны быть слышны только игрокам в заданном радиусе.

---

# 24. Warden Spawn Atmosphere

При появлении Warden:

1. Поставить SCULK под ним.
2. Проиграть Warden/sculk sound.
3. Создать sculk particles.
4. Запустить heartbeat.
5. Запустить BossBar.
6. Начать периодические Warden/Sculk Shrieker sounds.

Появление должно ощущаться как появление древнего существа из Deep Dark.

---

# 25. Warden Spawn Location

Сохранить:

```java
Location spawnLocation;
```

Сохранить её один раз при создании Warden.

Никогда не менять её.

BossBar всегда показывает именно первоначальные координаты.

---

# 26. Warden Leash

По умолчанию:

```yaml
boss:
  leash:
    enabled: true
    radius: 100
```

Если Warden удалился более чем на 100 блоков по горизонтали:

* вернуть его к spawnLocation;
* не менять spawnLocation;
* не менять координаты BossBar.

---

# 27. Warden BossBar

Placeholder:

```text
%boss_health%
%boss_max_health%
%boss_percent%
%boss_name%
%boss_spawn_x%
%boss_spawn_y%
%boss_spawn_z%
%boss_spawn_world%
```

Пример:

```text
☠ ANCIENT WARDEN | 637 / 800 HP | Spawn: X: 500 Y: 70 Z: 500
```

Progress BossBar должен соответствовать реальному HP.

---

# 28. Warden Death

После смерти:

* удалить BossBar;
* проиграть мощный Warden death sound;
* создать sculk/soul/smoke/sonic-boom-like particles;
* сохранить позицию смерти;
* поставить reward block.

Например:

```yaml
boss:
  reward:
    block: CRYING_OBSIDIAN
```

---

# 29. Boss Reward Timer

После смерти Warden:

```text
20 секунд
```

BossBar:

```text
☠ Награда появится через 00:20
```

После окончания таймера физически выбросить loot.

---

# 30. Boss Loot

Loot берётся из:

```text
loot/boss.yml
```

Количество каждого предмета — случайное:

```text
0–maximum
```

Предметы физически разлетаются от reward block.

```yaml
reward:
  radius: 5

  velocity:
    horizontal: 0.35
    vertical: 0.45
```

---

# 31. Loot Particles

Пока ItemEntity лежит на земле, создавать частицы над ним.

После pickup/removal ItemEntity прекратить particle task.

Не оставлять scheduler tasks после удаления предмета.

---

# 32. Cleanup

При:

```text
/abuseadm stop
```

или естественном завершении:

* остановить tasks;
* удалить BossBars;
* удалить plugin-created mobs;
* удалить TextDisplays;
* остановить ambient sounds;
* удалить region;
* восстановить оригинальные блоки;
* восстановить временный SCULK;
* удалить временный Dungeon exit;
* очистить UUID tracking;
* очистить ItemEntity tracking.

Не трогать обычных игроков, мобов и постройки.

---

# 33. /abuseadm skip и /abuseadm start

```text
/abuseadm skip
```

пропускает подготовительный countdown.

```text
/abuseadm start
```

немедленно запускает основную фазу.

Не создавать второе событие.

---

# 34. /abusespawn

Запускает основной этап текущего события в соответствии с его состоянием.

Не создавать параллельный event.

---

# 35. /abuseexit

Для Dungeon Abuse:

```text
/abuseexit
```

телепортирует игрока к безопасному выходу Dungeon.

Команда должна:

* работать только во время Dungeon Abuse;
* проверять, что игрок находится внутри Dungeon;
* искать безопасную позицию;
* не телепортировать игрока внутрь блока;
* не телепортировать игрока в опасное место.

---

# 36. Конфигурация

Итоговая конфигурация должна содержать как минимум:

```yaml
effects:
  enabled: true
  duration: 900

spawn:
  offset-x: 0
  offset-y: 0
  offset-z: 5

random:
  dungeon-weight: 50
  boss-weight: 50

region:
  enabled: true
  radius: 40
  min-y: -64
  max-y: 320

dungeon:
  schematic: "dungeon.schem"

  paste:
    enabled: true
    offset-x: 0
    offset-y: 0
    offset-z: 0
    vertical-offset: -10

  chests:
    auto-detect: true

  exit:
    enabled: true
    auto-detect: true
    marker-block: LODESTONE

    fallback:
      enabled: true
      search-radius: 8
      surface-offset: 2

  cleanup:
    restore-original-blocks: true

boss:
  type: WARDEN
  name: "☠ Ancient Warden"
  health: 800
  damage-multiplier: 0.75
  speed: 1.0

  spawn:
    place-sculk: true
    sculk-block: SCULK

  leash:
    enabled: true
    radius: 100

  sounds:
    enabled: true
    radius: 60
    interval: 8

    warden:
      ambient: true
      heartbeat: true
      listening: true

    sculk-shrieker:
      enabled: true

  bossbar:
    enabled: true
    title: "☠ ANCIENT WARDEN | %boss_health% / %boss_max_health% HP | Spawn: X: %boss_spawn_x% Y: %boss_spawn_y% Z: %boss_spawn_z%"
    color: RED
    style: SEGMENTED_10

  reward:
    block: CRYING_OBSIDIAN
    delay: 20
    radius: 5

    velocity:
      horizontal: 0.35
      vertical: 0.45
```

---

# 37. Архитектура

Использовать примерно:

```text
AdminAbuse
│
├── AbuseManager
│
├── event/
│   ├── AbuseEvent
│   ├── DungeonAbuse
│   └── BossAbuse
│
├── dungeon/
│   ├── DungeonManager
│   ├── DungeonSchematicManager
│   ├── DungeonExitManager
│   ├── DungeonGenerator
│   └── ChestManager
│
├── boss/
│   └── BossManager
│
├── loot/
│   ├── LootManager
│   └── LootEditor
│
├── region/
│   └── RegionManager
│
├── mob/
│   └── MobManager
│
├── bossbar/
│   └── BossBarManager
│
├── effects/
│   └── PlayerEffectManager
│
├── command/
│   ├── AbuseCommand
│   └── AbuseLootCommand
│
├── listener/
│   ├── RegionProtectionListener
│   ├── LootEditorListener
│   ├── MobListener
│   └── AbuseListener
│
└── compat/
    └── VersionAdapter
```

---

# 38. Главное

Dungeon должен выглядеть как настоящий небольшой vanilla-style подземный данж.

Он загружается из:

```text
plugins/AdminAbuse/schematics/dungeon.schem
```

и появляется примерно:

```text
10 блоков
↓
под администратором
```

Внутри должны автоматически определяться сундуки и использоваться настроенный loot.

У Dungeon обязательно должен быть выход — предпочтительно встроенный в schematic, либо автоматически созданный fallback-выход.

Boss Abuse создаёт Warden рядом с администратором.

Под Warden появляется временный SCULK.

Warden сопровождается характерными Warden/Sculk Shrieker звуками и Deep Dark атмосферой.

Все временные изменения мира должны корректно откатываться после завершения события.
Kodari AI
KodariOct 6 at 7:25 am 7

План:

  1. Проверю основу проекта и текущие команды/конфигурацию.

  2. Добавлю систему событий Dungeon/Boss с безопасным запуском и остановкой.

  3. Реализую dungeon schematic/выход/сундуки и loot GUI.

  4. Добавлю Warden-ивент, защиту региона, эффекты и cleanup.

Добавлены запуск событий от позиции администратора, /abuseadm start|skip, эффекты из ТЗ, временный скалк и ограниченные радиусом звуки босса. Дальше добавляю опциональную загрузку .schem и безопасный выход.

Добавил AdminAbuse по ТЗ: события запускаются относительно администратора, данж использует .schem с восстановлением блоков, автоопределением сундуков и выходом; добавлены /abuseexit, таймеры сундуков, редактор лута /abuseloot и поддержка эффектов и атмосферы Warden.

Для Dungeon Abuse положи dungeon.schem в plugins/AdminAbuse/schematics/. WorldEdit необязателен для загрузки плагина, но нужен для вставки схематики.

SlayZer4ik227

Внеси изменение в уже существующий плагин AdminAbuse. Не переписывай плагин с нуля и не удаляй уже реализованные функции. Нужно изменить только механику позиционирования и спавна Dungeon Abuse согласно требованиям ниже.

1. Позиция данжа относительно администратора

При выполнении:

text
/abuseadm dungeon

текущая позиция администратора должна использоваться как точка привязки данжа.

Администратор должен стоять непосредственно над центром крыши данжа.

Требования:

* центр крыши .schem должен быть точно под администратором по X; * центр крыши .schem должен быть точно под администратором по Z; * крыша данжа должна находиться прямо под администратором по Y; * никакого смещения на 8 блоков вниз; * НЕ использовать player.getLocation().add(0, -8, 0); * vertical-offset должен быть 0; * учитывать реальный origin, размеры и bounding box .schem, чтобы именно верхняя поверхность схемы совпала с позицией администратора; * нельзя просто считать origin схемы точкой спавна, если origin не совпадает с центром/верхней частью схемы.

Пример:

text
              ADMIN
                ↓
                │
                │
        ┌───────────────┐
        │ КРЫША ДАНЖА   │  ← верхняя поверхность
        ├───────────────┤
        │               │
        │    DUNGEON    │
        │               │
        └───────────────┘

То есть если администратор стоит на координате:

text
X = 100
Y = 80
Z = 200

то центр верхней поверхности крыши данжа должен находиться на:

text
X = 100
Y = 80
Z = 200

Никакого автоматического Y - 8.

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

Использовать:

yaml
dungeon:
  paste:
    anchor: ROOF
    vertical-offset: 0
    center-x-on-admin: true
    center-z-on-admin: true

vertical-offset: 0 означает отсутствие дополнительного вертикального смещения.

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

3. Очистка пространства перед спавном

Перед вставкой .schem необходимо определить полный bounding box схемы с учетом рассчитанной позиции спавна.

Весь этот объём должен быть очищен перед вставкой данжа.

Нужно удалять/заменять абсолютно все мешающие блоки внутри bounding box:

* обычные блоки; * землю; * камень; * деревья; * траву; * воду; * лаву; * другие жидкости; * любые TileEntity/BlockState; * любые другие блоки, которые находятся внутри области схемы.

При этом AIR из схемы также должен реально применяться.

Нельзя использовать логику, эквивалентную:

text
//paste -a

потому что воздух из схемы должен заменять существующие блоки.

4. Обязательный snapshot мира

Перед изменением каждого блока сохранить его исходное состояние.

Сохранять:

* World; * X/Y/Z; * Material; * BlockData; * BlockState; * содержимое контейнеров; * другие необходимые данные TileEntity.

Особенно корректно сохранять:

* Chest; * Barrel; * Shulker Box; * Furnace; * Hopper; * Dispenser; * Dropper; * Brewing Stand; * другие блоки с BlockState/TileEntity.

Создать или использовать существующий менеджер наподобие:

text
DungeonWorldSnapshot

с методами:

text
capture()
restore()
clear()

Snapshot должен быть создан до любого изменения мира.

5. Вставка схемы

После сохранения оригинального состояния:

  1. очистить полный bounding box;
  2. применить .schem;
  3. применить все блоки схемы, включая AIR;
  4. корректно восстановить BlockData и BlockState там, где это необходимо;
  5. убедиться, что никакие старые блоки мира не остаются внутри области данжа.

Нельзя использовать массовое удаление блоков без предварительного snapshot.

6. Удаление данжа после события

Когда Dungeon Abuse заканчивается:

  1. удалить созданные данжем объекты;
  2. удалить мобов, созданных плагином;
  3. удалить TextDisplay;
  4. удалить временные сундуки/награды;
  5. удалить временный выход;
  6. удалить остальные временные объекты данжа;
  7. восстановить каждый сохранённый блок из snapshot;
  8. восстановить AIR;
  9. восстановить воду и лаву;
  10. восстановить BlockData;
  11. восстановить BlockState;
  12. восстановить содержимое контейнеров;
  13. очистить snapshot.

После завершения восстановления должно выглядеть так, будто данжа вообще никогда не существовало.

Все блоки, которые были уничтожены или заменены при создании данжа, должны вернуться ровно в исходное состояние.

7. Важное ограничение области

Плагин не должен изменять блоки за пределами рассчитанного bounding box .schem.

Все операции создания, очистки и восстановления должны работать только внутри этой области.

8. Восстановление после рестарта

Если сервер перезапустился во время активного Dungeon Abuse, snapshot должен сохраняться таким образом, чтобы после перезапуска плагин мог восстановить изменённый участок мира и убрать оставшийся данж.

Не допускать ситуации, когда после рестарта оригинальный ландшафт невозможно восстановить.

9. Главное изменение

Основное требование:

Данж должен спавниться прямо под администратором. Крыша данжа должна быть точно на уровне позиции администратора по Y и точно совпадать с ним по центру X/Z. Никаких 8 блоков вниз.

Не меняй остальные уже реализованные механики AdminAbuse, если это не требуется для корректной работы новой системы позиционирования и восстановления мира.

Kodari AI
KodariOct 6 at 9:05 am 4

План:

  1. Найти текущую механику спавна и завершения Dungeon Abuse, схему и конфигурацию.

  2. Точечно изменить привязку крыши к администратору и добавить полный snapshot/очистку/восстановление, включая сохранение при рестарте.

Kodari can make mistakes. Review important code before using.
Files
src
build.gradle
Code
9 1,847
src/main/java/ru/kodari/abuseevent/AbuseEventPlugin.java
package ru.kodari.abuseevent;

import org.bukkit.command.Command;
import org.bukkit.command.CommandSender;
import org.bukkit.plugin.java.JavaPlugin;

public final class AbuseEventPlugin extends JavaPlugin {
    private AbuseManager abuseManager;

    @Override
    public void onEnable() {
        saveDefaultConfig();
        new java.io.File(getDataFolder(), "schematics").mkdirs();
        new java.io.File(getDataFolder(), "loot").mkdirs();
        abuseManager = new AbuseManager(this);
        getServer().getPluginManager().registerEvents(abuseManager, this);
        getServer().getPluginManager().registerEvents(abuseManager.getLootEditor(), this);
        getServer().getPluginManager().registerEvents(abuseManager.getRegionManager(), this);
    }

    @Override
    public void onDisable() {
        if (abuseManager != null) {
            abuseManager.shutdown();
        }
    }

    @Override
    public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
        return abuseManager.onCommand(sender, command, label, args);
    }
}