Платно Плагин KastExpControl | Полный контроль опыта 1.0.0

KastExpControl — плагин для серверов, где опыт становится полноценной игровой системой, а не просто стандартной полоской над хотбаром.

Игроки могут передавать уровни друг другу, создавать бутылочки опыта через меню, использовать специальные XP-предметы для починки, а в PvP забирать опыт с помощью артефактов и оружия.

Администрация получает удобные команды, YAML-настройки, управление предметами, топами, PlaceholderAPI и гибкую настройку всех основных механик.

Нажмите для раскрытия…

Что умеет плагин

• Передача уровней между игроками с лимитами, кулдауном и подтверждением операции.
• Создание бутылочек опыта из собственных уровней через меню /xpbottle.
• Поддержка кастомных бутылочек: по уровням или по точному количеству XP.
• Специальные предметы для починки предмета в левой руке или всей надетой брони.
• PvP-артефакт и PvP-меч, которые забирают процент уровней у жертвы после убийства.
• Настраиваемое выпадение опыта при обычной смерти игрока.
• Топы игроков по полученному опыту и уровням с хранением в SQLite.
• PlaceholderAPI для уровней, XP, топов и статусов меню обмена.

Главная идея: сделать опыт удобной валютой, наградой, ресурсом для прогрессии и отдельной PvP-механикой.

Нажмите для раскрытия…

Система предметов

• материал предмета;
• название;
• описание;
• CustomModelData;
• свечение;
• тип предмета;
• количество уровней или XP;
• логику работы артефактов и оружия.

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

Нажмите для раскрытия…

Бутылочки опыта

• 15 уровней
• 30 уровней
• 50 уровней
• 100 уровней
• 250 уровней
• 500 уровней
• 1000 уровней

Спойлер: Скрин: Бутылек 15 уровня

• Тип: levels
• Количество: 15 уровней
• Эффект: при использовании выдаёт игроку 15 уровней опыта

Бутылочки сырого XP

• 315 XP
• 1395 XP
• 5345 XP
• любое другое значение, указанное в YAML-файле предмета.

Где это полезно: экономика, квесты, награды, магазины, ивенты и кастомная прокачка.

Нажмите для раскрытия…

Предметы для починки

Спойлер: Скрин: Пузырь опыта

• Полностью чинит предмет в левой руке.
• Работает только с предметами, на которых есть зачарование Починка.
• Если чинить нечего, предмет не тратится.

Спойлер: Скрин: Опытный бронник

• Полностью чинит надетую броню.
• Работает только с бронёй, на которой есть зачарование Починка.
• Если повреждённой брони нет, предмет не тратится.

PvP-предметы

Спойлер: Скрин: Охотник опыта — артефакт

• Работает из инвентаря убийцы.
• После убийства забирает у жертвы настроенный процент уровней.
• По умолчанию забирает 50% уровней.
• Процент можно изменить в настройках предмета.

Спойлер: Скрин: Охотник опыта — меч

• Срабатывает при убийстве игрока этим оружием.
• Забирает у жертвы настроенный процент уровней.
• Можно настроить, должен ли смертельный удар быть нанесён именно этим предметом.

PvP-смысл: опыт становится ценной добычей, а убийства получают дополнительную награду.

Нажмите для раскрытия…

Меню обмена

• пустая бутылочка;
• нужное количество уровней;
• свободное место в инвентаре.

• название меню;
• размер меню;
• декоративные предметы;
• кнопки обмена;
• стоимость обмена;
• предмет-награду;
• сообщения;
• звуки;
• команды после клика.

Для игрока: всё делается через понятное GUI-меню, без ручных расчётов и длинных команд.

Нажмите для раскрытия…

config.yml

experience:
drop_on_player_death:
# Включает выпадение опыта при обычной смерти игрока.
# Если смерть обработал артефакт или специальный меч, опыт сферами не выпадает.
enabled: true
custom_percent:
# Если true, вместо ванильного лимита Minecraft выпадет процент общего XP игрока.
enabled: true
# Процент общего XP, который выпадет сферами при обычной смерти.
percent: 35

death_steal:
# Процент уровней, который забирается у жертвы,
# если артефакт или оружие не указали свой steal_percent.
default_percent: 50
# Если true, украденные уровни снимаются у жертвы.
remove_exp_from_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: bottle_15_levels

# Тип предмета: levels, raw_xp, repair_offhand, repair_armor, artifact или weapon.
type: levels

# Количество уровней или XP, которое выдаст предмет.
amount: 15

# Материал предмета Minecraft.
material: EXPERIENCE_BOTTLE

# CustomModelData для ресурспака. 0 — без модели.
custom_model_data: 0

# Название предмета с поддержкой цветов.
display_name: '&aБутылек с 15 ур. опыта'

# Описание предмета.
lore:
- '&7Используй, чтобы получить опыт.'

# Включает визуальное свечение.
glow: false

Настройки артефактов и оружия

• steal_percent — сколько процентов уровней забрать у жертвы.
• requires_killer_inventory — артефакт работает из инвентаря или только из рук.
• requires_kill_with_this_item — меч должен нанести смертельный удар или достаточно держать его в руке.
• remove_exp_from_victim — снимать ли украденные уровни у жертвы.
• give_exp_directly — выдавать ли опыт убийце напрямую.
• cancel_vanilla_exp_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 игрока.
• %kastexpcontrol_level_formatted% — уровень в красивом формате.
• %kastexpcontrol_xp_formatted% — XP в красивом формате.

• %kastexpcontrol_top_all_1_name% — имя игрока на 1 месте за всё время.
• %kastexpcontrol_top_all_1_levels% — уровни игрока на 1 месте за всё время.
• %kastexpcontrol_top_1d_1_line_xp% — строка топа за 1 день по XP.
• %kastexpcontrol_rank_all_levels% — место текущего игрока в общем топе уровней.

• %xp_bottle_has_empty_bottle% — есть ли у игрока пустая бутылочка.
• %xp_bottle_has_level_15% — хватает ли игроку 15 уровней. Число можно заменить на своё.

Периоды топов: all, 10m, 1h, 1d, 7d. (можно писать свои типо 1m 30d и т.д)

Режимы топов: levels или xp.

Нажмите для раскрытия…