Плагин Механика pvp Защита SoulBlast [1.3]

Описание плагина SoulBlast:​

Если ты думаешь что это простой плагин, то ты ошибаешься. Это то, чем ты будешь хвастаться.
SoulBlast — это плагин для Minecraft, который добавляет линейку кастомных динамитов.

Это не кастрированный RE4TNT, и не любой другой говноплагин на CustomTNT, где три радиуса в конфиге. Это линейка разновидных зарядов и кастомизаций динамита — каждый кастомный TNT настраиваешь под свои нужды и исключительно под свой сервер Minecraft, а не «один пресет на всех». В коробке уже есть заряды с разной работой: один разрушает только обсидиан, другой — только воду или лаву, третий заточен под разрушение построек и баз противника.

Есть и «орешник» — так её зовут неофициально; в игре это Последний Разжигатель Пламени. При взрыве шесть боеголовок вылетают и захватывают огромную территорию — самая мощная бомба в наборе. Обычным игрокам не давать, либо нерфить: способна оставить от сервера одни щепки. Взрыв настраивается — что ломать, что оставить, как глубоко копать, лутить или нет, жечь или нет. Тяжёлые заряды размазываются по тикам, а не вываливают кратер одним лагом в лицо.

Особенности плагина SoulBlast:​

• Каждый пук настраивается — радиус, сила, фитиль, что ломать, что оставить, лут, огонь, осечка, recall, цена, пост-эффекты. Отдельный заряд = отдельный конфиг, не «один радиус на всех».
• Взрыв не вываливает сервер в один тик — тяжёлое режется по фазам. Сколько блоков за тик — в конфиге. Большая бомба — долго и красиво, не лаг в лицо.
• Алгоритм под заряд — волна, сфера, EXTREME-объём: у обсидианщика одна логика, у штурмовика другая, у «орешника» свой оркестр.
• Последний Разжигатель Пламени — не один взрыв: боеголовки, осушение кольцом, молнии по фронту, адская маска, обсидиановый медальон в эпицентре.
• Гримуар — магазин в GUI: деньги, опыт, копилка TNT. Hex-цвета, сортировка, автоподжиг — всё в YAML.
• Фитиль с головой — таймер, осечка, ЛКМ вернуть заряд. Игрок видит, что тикает; сервер не страдает.
• Рейд и оборона — урон по ProtectionStones по типам динамита, прочность привата, голограммы. После рейда — Decay и починка песком.
• Лимиты под гриф и под TPS — grief-*, очередь взрывов, потолок блоков, только прогруженные чанки. Крутишь под железо, не под чужой пресет.
• Есть интеграция с CoreProtect, и откатами нашей командой. Автолог для кастомных бомб — админ создаёт заряд в dynamites.yml (радиус, политика блоков, вода, лава, цена) — SoulBlast сам пишет все изменения в CoreProtect. Не нужно прописывать каждый id отдельно. В логе всё под #soulblast, откат одной командой.

Какие есть готовые динамиты​

Это шаблончики под ваши нужды — шесть зарядов из коробки. Админ крутит радиус, лут, огонь, цены в dynamites/dynamites.yml; названия в игре — как захочешь.

Гримуар​

Гримуар — GUI-меню, где игроки покупают и получают динамиты. Открыть: /soulgrimoire (или /soulblast menu).

• Удобная сортировка — по силе, фитилю, имени; переключается в меню
• Всё настраивается — раскладка, иконки, названия, цены, что показывать в каталоге (menu.yml + dynamites.yml)
• Нет дюпов — предметы в GUI декоративные, реальный заряд только после обмена в инвентарь
• Два способа оплаты — опыт или монеты в каталоге (ЛКМ по заряду)
• Копилка через обычный TNT — на некоторые динамиты деньги не катят: игрок закидывает горы ванильного TNT в слот копилки (ПКМ — выбрал заряд, ЛКМ — вносишь из руки, набрал — забрал заряд). Сколько TNT на какой заряд — всё настраивается в dynamites.yml
• Страницы — много зарядов не ломают меню
• Автоподжиг — вкл/выкл в углу меню, на все твои установки
• Hex-цвета в названиях и лоре — &#RRGGBB, как в нормальных плагинах, не только &a

Модуль для ProtectionStones​

Это модуль для плагина ProtectionStones, который добавляет гриф кастомными динамитами SoulBlast по приватам — не вместо PS, а поверх него вместе с WorldGuard. Включён в config.yml по умолчанию; если PS на сервере нет — предупреждение в консоль, protection-stones-integration не выключается сам.

• голограмму над камнем привата — прочность, тип, владелец (%owner_prefix% / %owner_suffix% с LuckPerms, если есть);
• прочность блока привата — бьют только заряды из only-dynamite-types в ps/types/<alias>.yml, урон на каждый динамит свой;
• рейд чужого региона — ставить и поджигать динамит в чужом PS, если для типа привата разрешено;
• сохранение в ps/regions/<мир><x><y>_<z>.yml — после рестарта голограммы на месте (флаг hologram-hidden — игрок может скрыть свою через /psholo);
• файлы типов ps/types/<alias>.yml — alias из PS подтягиваются автоматически; в hologram.display — TextDisplay: view-range, see-through, shadowed, scale, billboard, alignment и др.

Без settings.support-soulblast: true в ps/settings.yml урон по привату не идёт. Нужны ProtectionStones 2.10+ и WorldGuard. Конфиги: plugins/SoulBlast/ps/.

Установка (админ)​

Требования​

• Vault + экономика (EssentialsX или другой провайдер через Vault, опционально) — покупки за монеты в гримуаре; без Vault работают опыт и TNT
• WorldGuard + ProtectionStones 2.10+ (опционально, вместе) — модуль приватов: голограммы над камнем, прочность, гриф по PS; WG — спавн и защищённые зоны. Без PS интеграция в config.yml можно выключить, WG остаётся для регионов
• LuckPerms (опционально) — префикс/суффикс на голограмме привата
• CoreProtect 22+ (опционально) — лог взрывов SoulBlast и откат кратера; без CP плагин стартует как обычно, просто нет /soulblast rollback и записей в базе CP

Как поставить​

1. Останови сервер.
2. Скачай зависимости (см. выше) → plugins/.
3. Скачай SoulBlast.jar → plugins/.
4. Запусти сервер.
5. Не перезагружай через PlugMan / PlugManX — только стоп, замена JAR, старт. Конфиги — /soulblast reload.

---

Команды и права​

Decay — починка стен после рейда:песок в инвентаре → ПКМ/ЛКМ по треснутому блоку (камень/обсидиан для починки не нужны — иначе проще сломать и поставить новый). Право: soulblast.decay.repair. Настройки: decay/general.yml → manual-repair.sand-only: true.

Право меню гримуара: menu.yml → command.permission.
Скрытие голограмм: ps/settings.yml → hologram-hide (enabled, arm-timeout-seconds — сколько секунд ждать удар после команды).

CoreProtect (откат взрывов)​

Мягкая зависимость — в plugin.yml указан softdepend: CoreProtect. CP не обязателен: SoulBlast грузится и без него. Если CoreProtect 22+ на сервере и в config.yml включена интеграция, все изменения блоков от взрывов пишутся в CP под псевдо-игроком #soulblast (не под ником поджигателя).

Автоматически для всех зарядов — и для шести пресетов, и для кастомных бомб админа в dynamites/dynamites.yml. Привязка не по id, а к любому взрыву через общую очередь ExplosionJob: добавил новый заряд — лог и откат работают сами, если интеграция включена.

Что логируется: сломанные и поставленные блоки, осушение воды/лавы, огонь, TNT-блоки, мгновенный break через Decay при взрыве, разрушение PS-блока привата. Не логируется: постепенный Decay по тикам после рейда, ванильный fire spread.

Откат​

Встань в центр кратера и выполни:

/soulblast rollback #soulblast <радиус> <время>
пример: /soulblast rollback #soulblast 500 30m
Право: soulblast.rollback (по умолчанию op). Откат идёт асинхронно через API CoreProtect.

Проверка перед откатом (команды CoreProtect, не SoulBlast):

/co lookup r:50 t:5m u:#soulblast a:block #count
/co lookup r:50 t:5m u:#soulblast a:-block i:water #count

Фильтр a:block — только блоки; без него в выдачу попадёт подбор предметов с твоего ника. Для орешника бери радиус и время с запасом (80–100, 1h).

Настройки: config.yml → core-protect-integration (enabled, log-breaks, log-placements, log-liquid-clear, fallback-user, log-all-as-fallback-user).

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

Основное​

Decay (постепенное разрушение)​

ProtectionStones+​

Прочее​