KastExpControl docs

KastExpControl Контроль опыта, XP-предметов, PvP-наград и обмена уровней KastExpControl — плагин для серверов, где опыт становится полноценной игровой системой, а не просто стандартной полоской над хотбаром. Игроки могут передавать уровни друг другу, создавать бутылочки опыта через меню, использовать специальные XP-предметы для починки, а в PvP забирать опыт с помощью артефактов и оружия. Администрация получает удобные команды, YAML-настройки, управление предметами, топами, PlaceholderAPI и гибкую настройку всех основных механик. --- Что умеет плагин Передача уровней между игроками с лимитами, кулдауном и подтверждением операции. Создание бутылочек опыта из собственных уровней через меню /xpbottle . Поддержка кастомных бутылочек: по уровням или по точному количеству XP. Специальные предметы для починки предмета в левой руке или всей надетой брони. PvP-артефакт и PvP-меч, которые забирают процент уровней у жертвы после убийства. Настраиваемое выпадение опыта при обычной смерти игрока. Топы игроков по полученному опыту и уровням с хранением в SQLite. PlaceholderAPI для уровней, XP, топов и статусов меню обмена. Главная идея: сделать опыт удобной валютой, наградой, ресурсом для прогрессии и отдельной PvP-механикой. --- Система предметов Все кастомные предметы вынесены в отдельные YAML-файлы в папке items. Через конфиги можно менять: Параметр Что настраивается Материал Материал предмета Название Отображаемое имя Описание Lore предмета CustomModelData Кастомная модель для ресурспака Свечение Визуальный glow-эффект Тип Механика предмета Количество Число уровней или XP Логика Поведение артефактов и оружия Для ресурспаков: каждому предмету можно назначить свой CustomModelData, чтобы сделать отдельную модель или текстуру. --- Бутылочки опыта Плагин поддерживает бутылочки, которые выдают игроку уровни опыта. Готовые варианты Бутылочка Количество 15 уровней 15 30 уровней 30 50 уровней 50 100 уровней 100 250 уровней 250 500 уровней 500 1000 уровней 1000 Игрок может создать такую бутылочку через меню обмена, потратив свои уровни и пустую бутылочку. Пример: Бутылек 15 уровня 📷 Скрин: Бутылек 15 уровня Бутылек 15 уровня Свойство Значение Тип levels Количество 15 уровней Эффект При использовании выдаёт игроку 15 уровней опыта По такому же принципу настраиваются остальные бутылочки. Меняется только значение amount, название, описание и внешний вид предмета. --- Бутылочки сырого XP Кроме уровней, плагин поддерживает предметы, которые выдают точное количество опыта. Примеры 315 XP 1395 XP 5345 XP любое другое значение, указанное в YAML-файле предмета. Где это полезно: экономика, квесты, награды, магазины, ивенты и кастомная прокачка. --- Предметы для починки Пузырь опыта 📷 Скрин: Пузырь опыта Пузырь опыта полностью чинит предмет в левой руке; работает только с предметами, на которых есть зачарование Починка; если чинить нечего, предмет не тратится. Опытный бронник 📷 Скрин: Опытный бронник Опытный бронник полностью чинит надетую броню; работает только с бронёй, на которой есть зачарование Починка; если повреждённой брони нет, предмет не тратится. --- PvP-предметы Охотник опыта — артефакт 📷 Скрин: Охотник опыта — артефакт Охотник опыта — артефакт работает из инвентаря убийцы; после убийства забирает у жертвы настроенный процент уровней; по умолчанию забирает 50% уровней; процент можно изменить в настройках предмета. Охотник опыта — меч 📷 Скрин: Охотник опыта — меч Охотник опыта — меч срабатывает при убийстве игрока этим оружием; забирает у жертвы настроенный процент уровней; можно настроить, должен ли смертельный удар быть нанесён именно этим предметом. PvP-смысл: опыт становится ценной добычей, а убийства получают дополнительную награду. --- Меню обмена Команда /xpbottle открывает меню, где игрок создаёт бутылочки опыта из собственных уровней. Для обмена нужны пустая бутылочка; нужное количество уровней; свободное место в инвентаре. В меню можно настроить название меню; размер меню; декоративные предметы; кнопки обмена; стоимость обмена; предмет-награду; сообщения; звуки; команды после клика. Для игрока: всё делается через понятное GUI-меню, без ручных расчётов и длинных команд. --- config.yml ⚙️ config.yml с описанием ключей experience: droponplayer_death: # Включает выпадение опыта при обычной смерти игрока. # Если смерть обработал артефакт или специальный меч, # опыт сферами не выпадает. enabled: true custom_percent: # Если true, вместо ванильного лимита Minecraft # выпадет процент общего XP игрока. enabled: true # Процент общего XP, который выпадет сферами # при обычной смерти. percent: 35 death_steal: # Процент уровней, который забирается у жертвы, # если артефакт или оружие не указали свой steal_percent. default_percent: 50 # Если true, украденные уровни снимаются у жертвы. removeexpfrom_victim: true transfer: Включает или выключает передачу уровней между игроками. enabled: true limits: # Если true, команда передачи проверяет # минимум, максимум и задержку. enabled: true # Минимальное количество уровней за одну передачу. min_levels: 1 # Максимальное количество уровней за одну передачу. max_levels: 100 # Задержка между передачами в секундах. cooldown_seconds: 60 Основная команда передачи уровней. command: payexp Дополнительные алиасы команды передачи. aliases: - payxp - xppay confirmation: # Если true, игрок должен повторить команду # для подтверждения перевода. enabled: true # Сколько секунд действует ожидание подтверждения. timeout_seconds: 30 bottle_mending: Если true, кастомная бутылочка сначала чинит предмет с Починкой в левой руке, а остаток опыта уже начисляет игроку. enabled: true admin: Основная админ-команда. command: ExpControl Алиасы админ-команды. aliases: - expc --- Пример YAML-предмета 🔑 Открыть пример предмета Внутренний ID предмета. По нему плагин узнаёт свой предмет. id: bottle15levels Тип предмета: levels, rawxp, repairoffhand, repair_armor, artifact или weapon. type: levels Количество уровней или XP, которое выдаст предмет. amount: 15 Материал предмета Minecraft. material: EXPERIENCE_BOTTLE CustomModelData для ресурспака. 0 — без модели. custommodeldata: 0 Название предмета с поддержкой цветов. display_name: '&aБутылек с 15 ур. опыта' Описание предмета. lore: '&7Используй, чтобы получить опыт.' Включает визуальное свечение. glow: false --- Настройки артефактов и оружия Для артефактов и оружия дополнительно используется блок settings. Параметр Назначение steal_percent Сколько процентов уровней забрать у жертвы requireskillerinventory Артефакт работает из инвентаря или только из рук requireskillwiththisitem Меч должен нанести смертельный удар или достаточно держать его в руке removeexpfrom_victim Снимать ли украденные уровни у жертвы giveexpdirectly Выдавать ли опыт убийце напрямую cancelvanillaexp_drop Отменять ли обычное выпадение опыта при такой смерти --- Команды Команды для игроков Команда Описание /payexp Передать уровни опыта другому игроку /payxp Алиас команды передачи опыта /xppay Алиас команды передачи опыта /xpbottle Открыть меню создания бутылочек опыта /xpbot Алиас меню обмена /bottletrade Алиас меню обмена /xptradebottle Алиас меню обмена Команды для администрации Команда Описание /ExpControl reload Перезагрузить конфиги и предметы /expc reload Короткий вариант перезагрузки /expc give exp levels Выдать бутылочку уровней /expc give exp raw_xp Выдать бутылочку точного XP /expc give exp special Выдать специальный XP-предмет /expc give artifact Выдать артефакт /expc give weapon Выдать оружие /expc top remove Удалить игрока из топов опыта /expc top clearall Полностью очистить топы опыта --- Права Право Назначение kastexpcontrol.admin Полный доступ к админ-функциям kastexpcontrol.command.admin Доступ к админ-команде kastexpcontrol.reload Доступ к перезагрузке конфигов kastexpcontrol.give Доступ к выдаче кастомных предметов kastexpcontrol.top Доступ к управлению топами kastexpcontrol.payexp Доступ к передаче опыта. По умолчанию доступно игрокам kastexpcontrol.xpbottle Доступ к меню обмена. По умолчанию доступно игрокам --- PlaceholderAPI Уровень и опыт игрока Плейсхолдер Значение %kastexpcontrol_level% Текущий уровень игрока %kastexpcontrol_levels% Текущий уровень игрока %kastexpcontrol_xp% Общий XP игрока %kastexpcontrollevelformatted% Уровень в красивом формате %kastexpcontrolxpformatted% XP в красивом формате Топы Плейсхолдер Значение %kastexpcontroltopall1name% Имя игрока на 1 месте за всё время %kastexpcontroltopall1levels% Уровни игрока на 1 месте за всё время %kastexpcontroltop1d1line_xp% Строка топа за 1 день по XP %kastexpcontrolrankall_levels% Место текущего игрока в общем топе уровней Меню обмена Плейсхолдер Значение %xpbottlehasemptybottle% Есть ли у игрока пустая бутылочка %xpbottlehaslevel15% Хватает ли игроку 15 уровней. Число можно заменить на своё Периоды топов: all, 10m, 1h, 1d, 7d. Можно писать свои, например 1m или 30d. Режимы топов: levels или xp.