SkillFusion — Описание плагина

SkillFusion добавляет на сервер Minecraft развитие персонажа в стиле RPG, сохраняя привычную простоту игры. Система подойдёт для Survival, SMP, RPG, Factions и похожих режимов.
Игроки выбирают группы навыков, открывают способности и улучшают отдельные навыки за опыт, который зарабатывают в Minecraft.

С каждым уровнем навык становится эффективнее.

• 7 групп навыков – Warrior, Miner, Healer, Assassin, Fisherman, Farmer и Alchemist.
  
• 35 разных навыков – В каждой группе 5 уникальных способностей.
  
• Активные и пассивные способности – Одни навыки работают автоматически, другие активируются командами.
  
• Основной + дополнительный классы – Игроки объединяют две разные группы в собственный билд.
  
• Развитие за настоящий опыт – Опыт Minecraft становится полезной валютой развития.
  
• Отдельные уровни навыков – У каждой способности свой независимый уровень.
  
• Масштабируемые способности – Урон, лечение, перезарядка, дальность, шанс, длительность и другие эффекты улучшаются с уровнем.
  
• Полностью настраиваемое развитие – Меняйте цены, максимумы, иконки, описания и масштаб улучшений.
  
• Понятное GUI – Игроки управляют всем билдом без запоминания сложных команд.
  
• Права по группам – Точно определяйте доступные классы для игрока или группы прав.
  
• Spigot, Paper & Folia – Один JAR поддерживает все три платформы.
  
• Без обязательных зависимостей – SkillFusion работает как самостоятельная система развития.
  

⭐ СОЗДАЙТЕ СВОЙ КЛАСС
Игроки могут развивать персонажа, не ограничиваясь одной заданной ролью.
SkillFusion позволяет каждому выбрать:

• 1 основную группу навыков
  
• 1 дополнительную группу навыков
  

Комбинируйте группы, чтобы собрать персонажа под свой стиль игры.
Игрок может объединить:

• Warrior + Healer – стойкая поддержка на передовой
  
• Assassin + Warrior – агрессивный билд ближнего боя
  
• Miner + Farmer – эффективное развитие в Survival
  
• Fisherman + Alchemist – упор на полезность
  
• Healer + Alchemist – сильный билд поддержки
  

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

РАЗВИТИЕ НА ОСНОВЕ ОПЫТА
Улучшения навыков покупаются за обычный опыт Minecraft.
Отдельная валюта и сторонний экономический плагин не нужны.
У каждого навыка есть:

• Текущий уровень
  
• Максимальный уровень
  
• Базовая цена опыта
  
• Множитель цены улучшения
  
• Собственная иконка
  
• Отображаемое имя
  
• Описание использования
  
• Описание работы
  

Стоимость улучшений растёт в соответствии с заданной базовой ценой и множителем.
Например:



Первые улучшения доступны без больших затрат, а для высоких уровней постепенно требуется больше опыта.
Опыт рассчитывается по реальному общему опыту игрока в Minecraft, включая текущий уровень и прогресс полосы опыта.
SkillFusion списывает ровно нужное количество опыта, сохраняя остаток у игрока.

️ПОЛНОЦЕННАЯ СИСТЕМА GUI
Игроки управляют всем через /skills.


Главное GUI показывает каждую доступную группу вместе с:

• Всеми навыками группы
  
• Текущими уровнями навыков
  
• Статусом основной группы
  
• Статусом дополнительной группы
  
• Статусом выбора
  

Левая кнопка выбирает или снимает группу навыков.
Правая кнопка открывает навыки этой группы.
В меню игроки сразу видят:

• Название навыка
  
• Текущий уровень
  
• Максимальный уровень
  
• Цену следующего улучшения
  
• Как работает навык
  
• Как его активировать
  

Нажмите на навык, чтобы купить следующий уровень, если опыта достаточно.
Меню сразу обновляется: видны новый уровень и цена следующего улучшения.

⚔ WARRIOR
Боевая специализация на силе ближнего боя, выживании и поддержке ближайших союзников.

WARRIOR – 5 НАВЫКОВ

⚔ Brutal Strength

Пассивный навык, который постоянно увеличивает урон в ближнем бою.

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

• Пассивная способность
  
• +10% урона атаки за уровень навыка
  
• Автоматически работает с активной группой Warrior
  

Battle Fury

Убийство врага может вызвать временную боевую ярость.

• Срабатывает после убийства сущности
  
• Повышает скорость атаки
  
• +5% скорости атаки за уровень
  
• До +50% скорости атаки
  
• Длится 10 секунд
  
• Перед повторным срабатыванием требуется перезарядка
  
• Перезарядка улучшается с уровнем навыка
  

Shield Wall

Щит в руках делает воина значительно сложнее убить.

• Пассивная способность
  
• Работает с экипированным щитом
  
• Снижает входящий урон от сущностей
  
• 5% снижения урона за уровень
  
• Максимальное снижение ограничено для сохранения баланса
  

War Cry

Активная командная способность, повышающая боевую силу ближайших игроков.

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

/s warcry

• Действует на применившего и ближайших игроков
  
• Область активации: 10 блоков
  
• Повышает урон атаки
  
• +5% урона за уровень навыка
  
• До +50%
  
• Эффект длится 10 секунд
  
• Перезарядка зависит от уровня
  

❤️ Last Stand

Экстренный защитный навык для спасения воина в опасном бою.

• Пассивная экстренная способность
  
• Срабатывает, если входящий урон оставит 20% здоровья или меньше
  
• Снижает входящий урон
  
• 5% снижения за уровень
  
• До 50%
  
• Остаётся активной 10 секунд
  
• Использует перезарядку по уровню
  

⛏ MINER
Для игроков, собирающих ресурсы под землёй и исследующих пещеры.

MINER – 5 НАВЫКОВ

⛏ Efficient Mining

Автоматически ускоряет добычу.

• Пассивная способность
  
• Использует эффект Спешки
  
• Сила растёт с уровнем навыка
  
• Автоматически включается с Miner
  

Lucky Find

Добыча руд может давать дополнительный дроп.

• Пассивная способность
  
• 2% шанса дополнительного дропа за уровень
  
• Работает с поддерживаемыми рудами
  
• Дополнительный дроп использует текущий инструмент
  

Vein Miner

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

• Присядьте при разрушении руды для активации
  
• Ищет связанные блоки той же руды
  
• Поддерживает обычные и глубинные руды, руды Незера, древние обломки и медь
  
• Максимум 64 связанных блока за активацию
  
• Перезарядка уменьшается с уровнем навыка
  
• Автоматически соблюдает отменённые BlockBreakEvents
  

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

Stone Skin

Шахтёры лучше выдерживают взрывы.

• Пассивная защитная способность
  
• Снижает урон взрывов
  
• 5% снижения урона за уровень
  
• Снижение ограничено для сохранения баланса
  

Geologist

Сканируйте окружение на ценные руды.

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

/s geologist

• Ищет ценные руды поблизости
  
• Дальность обнаружения растёт с уровнем
  
• Показывает названия и координаты руд
  
• Высокие уровни сокращают перезарядку
  
• Сканирование остаётся в текущем чанке
  

❤ HEALER
Полная специализация поддержки для сохранения жизни других игроков и усиления команды.

HEALER – 5 НАВЫКОВ

❤ Heal

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

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

/s heal <player>

• Восстанавливает 2 очка здоровья за уровень навыка
  
• Не превышает максимум здоровья цели
  
• На высоких уровнях перезарядка короче
  

✨ Regeneration

Даёт применившему временную регенерацию.

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

/s regeneration

или:

/s regen

• Способность самолечения
  
• Базовая длительность: 10 секунд
  
• +2 секунды за уровень навыка
  
• Перезарядка сокращается с улучшением навыка
  

Purify

Удалите негативные эффекты зелий с другого игрока.

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

/s purify <player>

• Определяет вредные эффекты
  
• Удаляет до одного вредного эффекта за уровень навыка
  
• Высокие уровни удаляют больше эффектов сразу
  
• Перезарядка сокращается с развитием
  

☠ Resurrection

Верните павшего игрока в бой.

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

/s resurrection <player>

или:

/s resurrect <player>

• Работает с мёртвым игроком онлайн
  
• Возрождает цель
  
• Возвращает примерно половину максимального здоровья и дополнительное здоровье по уровню
  
• Долгая стратегическая перезарядка
  
• На высоких уровнях навыка перезарядка короче
  

Blessing

Временно усиливает защиту ближайших союзников.

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

/s blessing

• Действует на применившего и ближайших игроков
  
• Область 10 блоков
  
• Повышает броню
  
• 5% масштабирования защиты за уровень
  
• До 50% бонуса
  
• Длительность растёт с уровнем
  
• Перезарядка уменьшается с уровнем
  

ASSASSIN
Рискованная боевая специализация на позиции, критических ударах, яде и мобильности.

ASSASSIN – 5 НАВЫКОВ

Backstab

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

• Пассивная способность
  
• Автоматически проверяет направление взгляда цели
  
• +10% урона со спины за уровень
  
• Бонус ограничен для сохранения баланса
  

Critical Strike

Обычные атаки могут стать мощными критическими ударами.

• Пассивная способность
  
• 2.5% шанса срабатывания за уровень
  
• Критический шанс ограничен для баланса
  
• Базовый критический множитель начинается с 1.5x
  
• Критический урон также растёт с уровнем
  

☠ Poison Blade

Мечи и топоры могут отравить врага.

• Работает с мечами и топорами
  
• 3% шанса срабатывания за уровень
  
• Длительность яда растёт с уровнем
  
• Высокие уровни могут также усилить яд
  

Stealth

Исчезните из виду и смените позицию перед атакой.

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

/s stealth

• Даёт невидимость
  
• Также даёт краткое усиление Скорости
  
• Базовая невидимость: 10 секунд
  
• +2 секунды за уровень навыка
  
• На высоких уровнях перезарядка короче
  
• Атака прекращает Stealth
  
• Получение урона тоже прекращает Stealth
  

Shadow Step

Мгновенно окажитесь за ближайшей целью.

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

/s shadowstep

• Ищет цель по направлению взгляда
  
• Максимальная дистанция: 12 блоков
  
• Телепортирует за выбранную цель
  
• Проверяет безопасность места перед телепортацией
  
• Пробует другие безопасные позиции, если идеальная заблокирована
  
• Даёт краткую Невидимость и Скорость после телепортации
  
• Перезарядка уменьшается с уровнем навыка
  

FISHERMAN
Превращает обычную рыбалку Minecraft в более полезный путь развития.

FISHERMAN – 5 НАВЫКОВ

Quick Catch

Меньше ждите поклёвки.

• Пассивная способность
  
• Сокращает минимальное и максимальное ожидание рыбы
  
• 5% снижения за уровень
  
• Безопасное масштабирование минимума предотвращает крайние значения
  

Treasure Hunter

Обычный улов может заменяться ценным рыболовным сокровищем Minecraft.

• Пассивная способность
  
• 2% шанса сокровищ за уровень
  
• Использует обычную таблицу рыболовных сокровищ Minecraft
  

Net Fishing

Получайте несколько бросков рыболовной добычи сразу.

Забросьте удочку и используйте:

/s netfish

или:

/s netfishing

• Требуется заброшенная удочка
  
• Создаёт несколько бросков рыболовной добычи
  
• Число бросков растёт с уровнем навыка
  
• Уровень 1 начинается с 2 бросков
  
• Использует стратегическую перезарядку
  

Deep Sea Angler

Рыбалка в глубоком океане получает шанс особой ценной добычи.

• Пассивная способность
  
• Работает в вариантах глубокого океана
  
• 5% шанса срабатывания за уровень
  
• До 50%
  
• Использует рыболовные сокровища Minecraft
  

Lucky Catch

Иногда удваивает только что пойманный предмет.

• Пассивная способность
  
• 4% шанса за уровень навыка
  
• Создаёт дополнительную копию пойманного предмета
  

FARMER
Полная фермерская специализация для растений, животных и производства ресурсов.

FARMER – 5 НАВЫКОВ

Green Thumb

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

• Пассивная способность
  
• Запоминает посадившего игрока
  
• Добавляет стадии роста по уровню навыка
  
• Поддерживает пшеницу, морковь, картофель, свёклу, нарост Незера, какао, сладкие ягоды, стебли арбуза и тыквы
  

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

Bountiful Harvest

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

• Пассивная способность
  
• 5% шанса дополнительного урожая за уровень
  
• Работает с несколькими обычными культурами
  
• Использует обычный дроп блоков Minecraft
  

Animal Breeder

Новорождённые животные взрослеют быстрее.

• Пассивная способность
  
• Срабатывает при разведении животных
  
• Детёныши получают 30 секунд ускорения роста за уровень навыка
  

Rancher

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

• Пассивная способность
  
• 5% дополнительного дропа животных за уровень
  
• Дробные бонусы случайно округляются для плавного развития
  

Fertilizer

Превратите костную муку в намного более сильный инструмент фермерства.

• Нажмите правой кнопкой на поддерживаемую культуру с костной мукой
  
• Добавляет стадию роста за уровень навыка
  
• Не превышает максимальный возраст растения
  
• Обычно расходует муку вне Creative
  

⚗ ALCHEMIST
Специализация зелий, превращающая стандартное зельеварение Minecraft в собственное развитие.

ALCHEMIST – 5 НАВЫКОВ

Splash Expert

Позволяет взрывным зельям действовать на намного большую область.

• Пассивная способность
  
• Превращает взрыв в управляемое облако эффектов
  
• Базовый радиус: 3 блока
  
• +5% радиуса за уровень навыка
  
• Длительность также растёт с уровнем
  
• Сохраняет эффекты брошенного зелья
  

Efficient Brewing

Стойки Alchemist заканчивают варку быстрее.

• Пассивная способность
  
• Запоминает использующего стойку игрока
  
• 6% сокращения варки за уровень
  
• Сокращение ограничено 60%
  

Reagent Saver

Варка может сохранить ингредиент вместо расходования.

• Пассивная способность
  
• 2% шанса за уровень навыка
  
• Успешная активация возвращает ингредиент
  

✨ Potion Mastery

Выпитые Alchemist зелья значительно усиливаются.

• Пассивная способность
  
• Повышает усилитель эффектов зелий
  
• Бонус силы растёт с уровнем навыка
  
• Ограничение предотвращает крайние значения
  
• Работает с базовыми и собственными эффектами
  

⏳ Duration Extender

Улучшите зелье непосредственно перед использованием.

Держите зелье в основной руке и используйте:

/s extendduration

или:

/s durationextender

• Продлевает каждый эффект в зелье
  
• +10% длительности за уровень
  
• Поддерживает базовые и собственные эффекты
  
• Мягкий предел предотвращает слишком долгие эффекты
  
• 5 минут перезарядки
  

⚙️ ПОЛНАЯ КОНФИГУРАЦИЯ НАВЫКОВ
Вся система развития управляется через skills.yml.

Настройте стандартный баланс под свой сервер.
Для каждого навыка настраиваются:

• DisplayName – Имя в GUI
  
• Material – Предмет Minecraft для иконки
  
• MaxLevel – Максимальный уровень улучшения
  
• BasePrice – Начальная цена опыта
  
• MultiplyByLevel – Масштабирование стоимости
  
• HowToUse – Инструкция непосредственно в GUI
  
• HowItWorks – Описание механики навыка
  

Пример:



Выберите темп развития для своего сервера: от небольшого сообщества Survival до долгосрочной RPG-экономики.

НАСТРАИВАЕМОЕ GUI
Внешний вид интерфейса меняется через config.yml.

Вы можете настроить:

• Заголовок GUI групп
  
• Заголовок GUI отдельных навыков
  
• Формат отображаемого имени
  
• Описание навыка
  
• Отображение уровня
  
• Отображение максимального уровня
  
• Цену следующего улучшения
  
• Раздел работы навыка
  
• Раздел использования
  
• Список навыков группы
  
• Текст выбрано / не выбрано
  
• Статусом основной группы
  
• Статусом дополнительной группы
  
• Текст действия левой кнопки
  
• Текст действия правой кнопки
  
• Кнопку возврата
  

Полезные переменные:

• %groupName%
  
• %group.displayName%
  
• %skill.name%
  
• %skillName%
  
• %skillLevel%
  
• %level%
  
• %maxLevel%
  
• %nextCost%
  
• %howItWorks%
  
• %howToUse%
  

СОБСТВЕННЫЕ СООБЩЕНИЯ
SkillFusion содержит отдельный файл messages.yml с сообщениями для отдельных механик навыков.

Он включает сообщения для:

• Активаций навыков
  
• Перезарядок
  
• Бонусов урона
  
• Лечения
  
• Очищения
  
• Resurrection
  
• Добычи
  
• Рыбалки
  
• Фермерства
  
• Зельеварения
  
• Изменения зелий
  
• Особых действий навыков
  

Сообщения поддерживают обычные коды цветов Minecraft & и переменные навыков, например:

• %player%
  
• %target%
  
• %level%
  
• %duration%
  
• %time%
  
• %count%
  
• %reduction%
  
• %healAmount%
  

АВТОМАТИЧЕСКИЕ ОБНОВЛЕНИЯ КОНФИГУРАЦИИ
Плагин дополняет конфигурацию при обновлении, поэтому каждый раз пересоздавать файлы вручную не нужно.

Когда новая версия вводит недостающие настройки:

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

Это относится к:

• config.yml
  
• messages.yml
  
• skills.yml
  

БЕЗОПАСНЫЕ ДАННЫЕ РАЗВИТИЯ
Прогресс каждого игрока сохраняется отдельно.

SkillFusion запоминает:

• UUID игрока
  
• Последнее известное имя
  
• Основную группу навыков
  
• Дополнительную группу навыков
  
• Уровень каждого навыка
  

Данные хранятся в:
plugins/SkillFusion/playerdata/
Обычные сохранения вынесены за пределы обработки игровых событий, чтобы не записывать данные на диск прямо во время их обработки.

• Асинхронная запись данных – Снимки игрока передаются отдельному фоновому обработчику записи.
  
• Упорядоченные сохранения – Записи данных выполняются в предсказуемом порядке.
  
• Атомарная замена файлов – Данные сначала пишутся во временный файл, затем перемещаются на место, снижая риск частично записанного файла игрока.
  
• Сохранение при выключении – Загруженный прогресс сохраняется при отключении плагина.
  
• Параллельный реестр игроков – Прогресс в памяти использует потокобезопасные коллекции.
  
• Защита перечитывания – Ожидающие записи завершаются перед перечитыванием данных.
  

Это не просто флаг folia-supported: true.
Отдельный слой поддержки платформ определяет сервер и передаёт задачи подходящему планировщику.

• Глобальный планировщик – Для задач всего сервера.
  
• Планировщик сущностей – Операции игроков и сущностей следуют за своей сущностью.
  
• Региональный планировщик – Действия с местом выполняются в правильном регионе.
  
• Резервный режим Spigot – На Spigot автоматически используется стандартное планирование Bukkit.
  
• Асинхронные телепорты Paper/Folia – Shadow Step использует асинхронный телепорт там, где доступно.
  
• Безопасность нескольких игроков – War Cry и Blessing планируют изменения отдельно для каждого затронутого игрока.
  
• Регионально безопасная добыча жил – Vein Miner остаётся в текущем чанке, не затрагивая чужие регионы.
  
• Потокобезопасные перезарядки – Параллельные коллекции защищают активные способности и состояние перезарядок.
  
• Без жёсткой зависимости от Paper – Функции Paper доступны через небольшой мост выполнения, позволяющий одному JAR работать и на Spigot.
  

ИНСТРУМЕНТЫ АДМИНИСТРАЦИИ
При необходимости администрация может напрямую изменять прогресс игроков.

• Настройка уровней – Задайте навыку любой допустимый уровень.
  
• Управление другими игроками – Задайте уровень навыка загруженного игрока административной командой.
  
• Сброс конфигурации навыков – Восстановите исходный файл skills.yml.
  
• Сброс данных навыков игроков – Удалите прогресс защищённой командой с подтверждением.
  
• Полное перечитывание – Перечитайте настройки, зарегистрированные навыки и данные без перезапуска сервера.
  
• Дополнение команд – Административные и активные команды дают полезные подсказки.
  
• Уведомления об обновлениях – Уполномоченные администраторы получают информацию о новых версиях SkillFusion.
  
• bStats Metrics – Анонимная статистика помогает отслеживать использование плагина.
  

ИДЕАЛЬНО ДЛЯ

• Серверов Survival
  
• Серверов SMP
  
• Серверов RPG
  
• Factions
  
• Приключенческих серверов
  
• Серверов с долгосрочным развитием
  
• Серверов с билдами персонажей без замены стандартной игры
  

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