- Minecraft Server 1.18+
- Spigot/Paper или совместимый форк
- Java 16+
---
## Установка
### Шаг 1: Загрузка плагина
1. Скачайте файл
DCboses-1.1.jar2. Поместите его в папку
plugins/ вашего сервера### Шаг 2: Первый запуск
1. Запустите сервер
2. Плагин создаст файл конфигурации
plugins/DCboses/config.yml3. Остановите сервер для настройки
### Шаг 3: Базовая настройка
1. Откройте
config.yml2. Настройте основные параметры (см. раздел [Конфигурация](#конфигурация))
3. Запустите сервер
---
## Первоначальная настройка
### 1. Установка точки спавна боссов
Зайдите на сервер и выполните:
/boss setbosslocationЭта команда сохранит вашу текущую позицию как точку спавна всех боссов.
### 2. Проверка работы
Заспавните тестового босса:
/boss spawnЕсли босс появился - плагин работает корректно!
### 3. Телепортация к боссу
Чтобы телепортироваться к активному боссу:
/boss tp---
## Конфигурация
### Структура config.yml
yaml
settings:
location: # Координаты спавна боссов
spawn: # Интервал спавна в секундах
bossbar: # Настройки boss bar
bosses: # Список боссов
boss1: ...
boss2: ...
message: # Сообщения плагина### Секция settings
#### location - Точка спавна
yaml
settings:
location:
world: world # Название мира
x: 0.0 # Координата X
y: 64.0 # Координата Y
z: 0.0 # Координата ZРекомендация: Используйте команду
/boss setbosslocation вместо ручного редактирования.#### spawn - Интервал автоспавна
yaml
settings:
spawn: 7200 # 7200 секунд = 2 часаПримеры:
- 1 час =
3600- 30 минут =
1800- 4 часа =
14400#### bossbar - Настройки boss bar
yaml
settings:
bossbar:
enable: true # Включить/выключить boss bar
string: "&fБосс %bossname% &fздоровье: &c%health% ❤" # Текст boss bar
color: GREEN # Цвет: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
style: SOLID # Стиль: SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20Плейсхолдеры:
-
%bossname% - имя босса-
%health% - текущее здоровье босса---
## Команды
### Основная команда: /boss
| Команда | Описание | Пример |
|---------|----------|---------|
|
/boss spawn | Заспавнить случайного босса | /boss spawn ||
/boss setbosslocation | Установить точку спавна на вашу позицию | /boss setbosslocation ||
/boss kill | Убить текущего босса | /boss kill ||
/boss tp | Телепортироваться к боссу | /boss tp ||
/boss reload | Перезагрузить конфигурацию | /boss reload ||
/boss | Показать помощь | /boss |Примечание: Все команды требуют право
customboss.admin---
## Права доступа
### customboss.admin
По умолчанию: Только операторы сервера
Дает доступ к:
- Всем командам
/boss- Управлению боссами
- Настройке точки спавна
### Настройка прав
#### Для плагинов управления правами (LuckPerms, PermissionsEx):
/lp group admin permission set customboss.admin true#### Для конкретного игрока:
/lp user Notch permission set customboss.admin true---
## Настройка боссов
### Структура босса
yaml
bosses:
boss_id: # Уникальный ID босса
name: "&c&lИМЯ" # Отображаемое имя (с цветами)
type: ZOMBIE # Тип моба
health: 1000 # Количество здоровья
damage: 10 # Урон босса
reward: # Команды награды
- "команда1"
- "команда2"
potion: # Эффекты зелий
- "EFFECT;уровень"### Параметры босса
#### name - Имя босса
Поддерживает цветовые коды Minecraft:
yaml
name: "&c&lКРАСНЫЙ БОСС"
name: "&6&lЗОЛОТОЙ &e&lДРАКОН"
name: "&x&F&F&0&0&0&0RGB БОСС" # HEX цветаКоды цветов:
-
&0 - черный-
&1 - темно-синий-
&2 - темно-зеленый-
&3 - темно-голубой-
&4 - темно-красный-
&5 - фиолетовый-
&6 - золотой-
&7 - серый-
&8 - темно-серый-
&9 - синий-
&a - зеленый-
&b - голубой-
&c - красный-
&d - розовый-
&e - желтый-
&f - белый-
&l - жирный-
&o - курсив-
&n - подчеркнутый-
&k - магический#### type - Тип моба
Любой враждебный моб Minecraft:
Популярные типы:
-
ZOMBIE - зомби-
SKELETON - скелет-
WITHER_SKELETON - иссушитель-скелет-
SPIDER - паук-
CAVE_SPIDER - пещерный паук-
CREEPER - крипер-
BLAZE - ифрит-
ENDERMAN - эндермен-
ZOMBIE_PIGMAN - зомби-свиночеловек-
WITHER - иссушитель-
ENDER_DRAGON - дракон края-
GIANT - гигант-
IRON_GOLEM - железный голем-
RAVAGER - разоритель-
POLAR_BEAR - белый медведьПолный список: [Minecraft Entity Types](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html)
#### health - Здоровье
yaml
health: 750 # 750 HP = 375 сердец1 HP = 0.5 сердца
Примеры:
- 100 HP = 50 сердец
- 500 HP = 250 сердец
- 2000 HP = 1000 сердец
#### damage - Урон
yaml
damage: 10 # 10 урона = 5 сердец уронаРекомендации:
- Легкий босс: 5-10
- Средний босс: 10-20
- Сложный босс: 20-40
- Экстремальный: 40+
#### reward - Награды
Список команд, выполняемых от имени консоли при убийстве босса.
Плейсхолдер:
%player% - имя убийцыПримеры:
yaml
reward:
# Выдать деньги (Vault/EssentialsX)
- "eco give %player% 10000"
# Выдать предмет
- "give %player% diamond 64"
# Выдать очки опыта
- "xp add %player% 100 levels"
# Выполнить кастомную команду
- "p give %player% 250"
# Отправить сообщение
- "tell %player% Поздравляем с победой!"
# Дать право
- "lp user %player% permission set boss.killer true"#### potion - Эффекты зелий
Формат:
ТИП_ЭФФЕКТА;уровеньПримеры:
yaml
potion:
- "SPEED;2" # Скорость II
- "FIRE_RESISTANCE;1" # Огнестойкость I
- "STRENGTH;3" # Сила III
- "REGENERATION;2" # Регенерация II
- "INVISIBILITY;1" # Невидимость IПопулярные эффекты:
-
SPEED - скорость-
SLOWNESS - медлительность-
STRENGTH - сила-
REGENERATION - регенерация-
FIRE_RESISTANCE - огнестойкость-
WATER_BREATHING - подводное дыхание-
INVISIBILITY - невидимость-
RESISTANCE - сопротивление-
ABSORPTION - поглощениеПолный список: [Potion Effect Types](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html)
### Примеры настройки боссов
#### Легкий босс (новички)
yaml
bosses:
easy_zombie:
name: "&a&lМЛАДШИЙ ЗОМБИ"
type: ZOMBIE
health: 200
damage: 3
reward:
- "eco give %player% 1000"
- "give %player% golden_apple 1"
potion:
- "SPEED;1"#### Средний босс
yaml
bosses:
medium_skeleton:
name: "&e&lЛУЧНИК"
type: SKELETON
health: 800
damage: 8
reward:
- "eco give %player% 5000"
- "give %player% diamond 5"
potion:
- "SPEED;2"
- "FIRE_RESISTANCE;1"#### Сложный босс
yaml
bosses:
hard_wither:
name: "&c&lТЕМНЫЙ ПОВЕЛИТЕЛЬ"
type: WITHER_SKELETON
health: 2000
damage: 15
reward:
- "eco give %player% 25000"
- "give %player% diamond 32"
- "xp add %player% 50 levels"
potion:
- "SPEED;3"
- "FIRE_RESISTANCE;1"
- "STRENGTH;2"
- "REGENERATION;1"#### Босс-гигант (рейдовый)
yaml
bosses:
raid_giant:
name: "&4&lГИГАНТСКИЙ ТИТАН"
type: GIANT
health: 10000
damage: 25
reward:
- "eco give %player% 100000"
- "give %player% netherite_ingot 16"
- "xp add %player% 100 levels"
- "lp user %player% permission set boss.legend true"
potion:
- "SPEED;2"
- "FIRE_RESISTANCE;1"
- "STRENGTH;3"
- "REGENERATION;2"
- "RESISTANCE;2"---
## Сообщения и локализация
### Структура сообщений
yaml
message:
prefix: "PREFIX" # Префикс плагина
perms: "..." # Нет прав
reload: "..." # Конфиг перезагружен
save-location: "..." # Локация сохранена
no-location: "..." # Локация не установлена
boss-is-death: "..." # Босс мертв
boss-is-spawn: "..." # Босс уже живой
boss-teleport: "..." # Телепортация к боссу
boss-kill: "..." # Босс убит командой
help: [...] # Справка
boss-spawn: [...] # Сообщения при спавне
boss-death: [...] # Сообщения при смерти### Плейсхолдеры в сообщениях
| Плейсхолдер | Описание |
|-------------|----------|
|
%prefix% | Префикс плагина ||
%bossname% | Имя босса ||
%health% | Здоровье босса ||
%player% | Имя игрока |### Настройка префикса
Префикс с RGB градиентом:
yaml
message:
prefix: "§x§1§8§6§C§B§C§lʙ§x§1§0§9§D§D§2§lᴏ§x§0§8§C§E§E§9§lꜱ§x§0§0§F§F§F§F§lꜱ"Простой префикс:
yaml
message:
prefix: "&8[&cBOSS&8]"### Многострочные сообщения
yaml
message:
boss-spawn:
- ""
- " %prefix%"
- ""
- " &fПоявился босс: %bossname%"
- " &fЗдоровье: &c%health% ❤"
- " &fТелепорт: &a/boss tp"
- ""### Примеры локализации
#### Английский язык
yaml
message:
prefix: "&8[&cBOSS&8]"
boss-is-spawn: "%prefix% &fBoss is already alive: %bossname%"
boss-kill: "%prefix% &fBoss &a%bossname% &fhas been killed!"
boss-spawn:
- ""
- " %prefix%"
- ""
- " &fBoss spawned: %bossname%"
- " &fHealth: &c%health% ❤"
- " &fTeleport: &a/boss tp"
- ""
boss-death:
- ""
- " %prefix%"
- ""
- " &fBoss %bossname% defeated!"
- " &fKiller: &a%player%"
- " &fNext boss in &a2 &fhours"
- ""---
## Механика работы
### Система автоспавна
1. Таймер запускается при старте сервера
2. Каждые X секунд (настраивается в
settings.spawn) выбирается случайный босс3. Босс спавнится в заданной точке
4. RGB анимация имени начинается автоматически
5. BossBar отображается всем игрокам онлайн
### Система урона и наград
1. Отслеживание урона: Плагин записывает весь урон от каждого игрока
2. Определение убийцы: После смерти босса определяется игрок с максимальным уроном
3. Выдача наград: Команды из секции
reward выполняются для убийцы4. Объявление: Всем игрокам отправляется сообщение о смерти босса
### RGB анимация
- Обновляется каждые 5 тиков (0.25 секунды)
- Использует синусоидальный алгоритм для плавного перехода цветов
- Применяется к имени босса автоматически
- Независимо от цвета, указанного в
name### BossBar
- Обновляется каждую секунду (20 тиков)
- Автоматически добавляет новых игроков
- Отображает актуальное здоровье босса
- Скрывается при смерти босса
---
## Примеры использования
### Пример 1: Еженедельный босс
Задача: Босс спавнится раз в неделю с огромной наградой
yaml
settings:
spawn: 604800 # 7 дней в секундах
bosses:
weekly_dragon:
name: "&5&lЛЕГЕНДАРНЫЙ ДРАКОН"
type: ENDER_DRAGON
health: 20000
damage: 30
reward:
- "eco give %player% 500000"
- "give %player% netherite_ingot 64"
- "xp add %player% 200 levels"
- "broadcast &6%player% победил Легендарного Дракона!"
potion:
- "SPEED;3"
- "FIRE_RESISTANCE;1"
- "STRENGTH;4"
- "REGENERATION;3"### Пример 2: Ежечасные мини-боссы
Задача: Слабые боссы каждый час для активности
yaml
settings:
spawn: 3600 # 1 час
bosses:
mini1:
name: "&7Скелет-Воин"
type: SKELETON
health: 150
damage: 4
reward:
- "eco give %player% 500"
potion:
- "SPEED;1"
mini2:
name: "&2Зомби-Берсерк"
type: ZOMBIE
health: 200
damage: 5
reward:
- "eco give %player% 750"
potion:
- "STRENGTH;1"### Пример 3: Прогрессивная система боссов
Задача: Разные боссы для разных уровней игроков
yaml
bosses:
# Новички
beginner_boss:
name: "&aНачинающий Босс"
type: ZOMBIE
health: 100
damage: 2
reward:
- "eco give %player% 500"
# Средний уровень
intermediate_boss:
name: "&eОпытный Босс"
type: SKELETON
health: 500
damage: 8
reward:
- "eco give %player% 2500"
# Продвинутый
advanced_boss:
name: "&cСильный Босс"
type: WITHER_SKELETON
health: 1500
damage: 15
reward:
- "eco give %player% 10000"
# Мастер
master_boss:
name: "&4Мастер Босс"
type: IRON_GOLEM
health: 5000
damage: 25
reward:
- "eco give %player% 50000"### Пример 4: Тематический босс на Хэллоуин
yaml
bosses:
halloween_boss:
name: "&6&lТЫКВЕННЫЙ &c&lКОРОЛЬ"
type: ZOMBIE
health: 666
damage: 13
reward:
- "eco give %player% 6666"
- "give %player% pumpkin 64"
- "give %player% candy 32" # кастомный предмет
potion:
- "SPEED;2"
- "FIRE_RESISTANCE;1"
- "INVISIBILITY;1"### Пример 5: Интеграция с кланами
yaml
bosses:
clan_raid_boss:
name: "&4&lРЕЙДОВЫЙ БОСС"
type: GIANT
health: 50000
damage: 40
reward:
# Награда лидеру клана
- "eco give %player% 100000"
# Награда всему клану (если есть плагин кланов)
- "clan addmoney %player% 50000"
# Очки клана
- "clan addpoints %player% 100"
potion:
- "SPEED;2"
- "FIRE_RESISTANCE;1"
- "STRENGTH;3"
- "REGENERATION;2"
- "RESISTANCE;3"---
## Устранение неполадок
### Босс не спавнится
Проблема: Босс не появляется автоматически
Решения:
1. Проверьте, установлена ли точка спавна:
/boss setbosslocation2. Убедитесь, что в мире разрешен спавн мобов
3. Проверьте консоль на ошибки
4. Убедитесь, что интервал спавна корректный в
config.yml### Босс спавнится, но сразу умирает
Проблема: Босс появляется и мгновенно исчезает
Решения:
1. Проверьте, не заспавнен ли босс в лаве/воде
2. Убедитесь, что координата Y не слишком высокая/низкая
3. Проверьте, что тип моба существует в вашей версии Minecraft
### Награды не выдаются
Проблема: Игрок убил босса, но не получил награду
Решения:
1. Проверьте формат команд в секции
reward2. Убедитесь, что используете правильный плейсхолдер
%player%3. Проверьте, установлен ли плагин экономики (для команды
eco)4. Посмотрите консоль на ошибки выполнения команд
### BossBar не отображается
Проблема: Полоса босса не видна игрокам
Решения:
1. Проверьте
settings.bossbar.enable: true2. Убедитесь, что версия сервера 1.9+
3. Проверьте, что цвет и стиль указаны корректно
### RGB анимация не работает
Проблема: Имя босса не переливается цветами
Решения:
1. Это нормально - RGB может быть не видна из-за настроек клиента
2. Попробуйте использовать обычные цветовые коды
3. Убедитесь, что версия сервера поддерживает HEX цвета (1.16+)
### Ошибка "Unknown entity type"
Проблема:
Unknown entity type: НАЗВАНИЕ_МОБАРешения:
1. Проверьте правильность написания типа моба (заглавные буквы)
2. Убедитесь, что моб существует в вашей версии Minecraft
3. Используйте список из документации
### Конфиг не перезагружается
Проблема: Изменения в config.yml не применяются
Решения:
1. Используйте
/boss reload вместо перезагрузки сервера2. Проверьте синтаксис YAML (отступы, двоеточия)
3. Убедитесь, что нет кириллицы в технических полях (только в сообщениях)
### Несколько боссов спавнятся одновременно
Проблема: Система спавнит больше одного босса
Решения:
1. Это защита от повторного спавна работает некорректно
2. Используйте
/boss kill чтобы убить лишних3. Перезагрузите плагин:
/boss reload---
## Дополнительные советы
### Оптимизация производительности
1. Не ставьте слишком маленький интервал автоспавна (минимум 1800 секунд)
2. Ограничьте количество боссов (оптимально 4-8)
3. Не давайте боссам слишком много эффектов (максимум 4-5)
### Балансировка
1. Здоровье: Умножайте на количество средних игроков онлайн × 100
2. Урон: Не более 25% здоровья игрока за удар
3. Награды: ~1000 монет за каждые 100 HP босса