Splatoon — режим "закрась мир"

Мини-игра для сервера ITMOcraft miniGAMES: игроки делятся на команды и закрашивают арену своим цветом. Режим интегрирован с MiniGames API (очередь/подбор команд/результаты).

---

Возможности

• Автозапуск матчей через MiniGames API
• Клонирование арен под каждый матч через Multiverse-Core
• Покраска блоков выстрелами из пушки и бомбами (снежками)
• Ускорение/невидимость на “своей” краске (механика “squid”)
• Сайдбар справа:
  • только участвующие команды
  • счёт команды: (абсолют + проценты)
  • информация о команде игрока
  • вклад игроков команды в результат
• BossBar сверху — таймер до конца матча
• Автоочистка клон-миров при запуске/выключении плагина
• Очищение инвентарей при входе в игровое лобби

---

Требования

• Paper / Purpur 1.21.x
• Multiverse-Core
• MiniGames API (внутренняя библиотека)

---

Установка

1. Положите Splatoon.jar в plugins/
2. Установите зависимости:
   • Multiverse-Core
   • MiniGames API
3. Запустите сервер — создастся plugins/Splatoon/config.yml

---

Конфигурация (config.yml)

Пример:

map_name: "game"
lobby_name: "lobby"

boost_locations:
  - [0.5, 64.0, 0.5]
  - [10.5, 64.0, -5.5]

arenas:
  - id: "splatoon-2x3"
    world: "game"
    teamCount: 2
    playersPerTeam: 3

  - id: "splatoon-4x2"
    world: "game"
    teamCount: 4
    playersPerTeam: 2

Поля

• map_name — дефолтный шаблонный мир арены (если не указан в arenas)
• lobby_name — мир лобби
• boost_locations — точки спавна “бомб” (используются в матче)
• arenas — список конфигов инстансов для MiniGames API

---

Использование

Очередь и запуск матча

Очередь и команды берутся из MiniGames API (например /ready, /unready).

После того как нужное количество игроков собрано, Splatoon:

1. Клонирует мир арены в новый мир вида template_1, template_2, …
2. Телепортирует игроков на арену
3. Запускает countdown и матч
4. По завершению — телепортирует в лобби и удаляет клон-арену

---

Геймплей

Оружие

• В начале матча игрок получает “Сплат-пушку” (GOLDEN_SHOVEL)
• Выстрел создаёт снежок, который красит блоки в цвет команды

Бомбы

• В ходе матча периодически появляются/выдаются бомбочки, которые выстреливают тоже как снежки

---

Миры и очистка (Multiverse-Core)

• Арена берётся из шаблонного мира (world из arenas или map_name)
• На матч создаётся клон: template_1, template_2, …
• Перед созданием клона слот очищается, чтобы не оставались хвосты после крашей/рестартов
• В конце матча клон выгружается и папка мира удаляется

---

Разработка и сборка

./gradlew clean build

Готовый jar: build/libs/*.jar

---