Промт: AsteriaLives – система жизней с отображением в скорборде Общая информация Платформа: Paper 1.21.11
Java: 21
Название: AsteriaLives
Версия: 1.0.0
Файл: AsteriaLives-1.0.0.jar
Сборка: Maven
Зависимости: Paper API (обязательно), AsteriaCivCore / AsteriaCivExtras (опционально, для интеграции с цивилизациями)
Язык сообщений: Русский
Назначение: Управление жизнями игроков, отображение текущего количества жизней в скорборде, настройка лимитов в зависимости от цивилизации.
Основная функциональность
- Система жизней
У каждого игрока есть количество жизней (целое число).
При смерти игрок теряет одну жизнь.
Если жизни заканчиваются (0), игрок получает бан или отправляется в специальный мир (настраивается) – но можно просто запретить вход до восстановления.
Жизни можно восстановить:
Автоматически по таймеру (например, +1 жизнь каждые 24 часа реального времени).
За внутриигровую валюту (если есть экономика).
За выполнение заданий (не в этом промте).
Максимальное количество жизней ограничено (настраивается в конфиге).
Администратор может выдавать/забирать жизни через команды.
- Отображение в скорборде
Плагин автоматически добавляет строку в скорборд, показывающую количество жизней.
Если используется AsteriaCivExtras, то строка интегрируется в существующий скорборд (например, добавляется отдельная строка: §7Жизни: §c❤ %lives%).
Если AsteriaCivExtras отсутствует, плагин создаёт свой собственный скорборд (или просто добавляет строку в существующий, если возможно).
Обновление строки происходит при изменении количества жизней.
- Интеграция с цивилизациями (опционально)
Если на сервере установлен AsteriaCivCore (или AsteriaCivExtras), плагин определяет цивилизацию игрока.
Для каждой цивилизации можно задать максимальное количество жизней (например, у Зимней – 5 жизней, у Лесной – 3 и т.д.).
По умолчанию (если цивилизация не задана или интеграция отключена) – используется стандартный лимит.
- Команды
/lives – показать текущее количество жизней (в чате).
/lives give <игрок> [количество] – выдать жизни (право asterialives.admin).
/lives take <игрок> [количество] – забрать жизни (право asterialives.admin).
/lives set <игрок> <количество> – установить точное количество жизней (право asterialives.admin).
/lives reload – перезагрузить конфиг (право asterialives.admin).
- События и обновление
При смерти игрока (событие PlayerDeathEvent) – уменьшить жизни на 1 (если включено).
При входе игрока – обновить скорборд.
При изменении жизней – обновить скорборд.
- Хранение данных
Данные хранятся в YAML-файле lives.yml.
Структура:
yaml players:
UUID-игрока: lives: 5 max-lives: 10 last-update: 1234567890 (timestamp для авто-восстановления) Также можно использовать общий players.yml из AsteriaCiv, добавляя туда секцию lives.
- Конфигурация (config.yml)
yaml
Включить/отключить систему жизней
enabled: true
Максимальное количество жизней по умолчанию (если цивилизация не задана)
default-max-lives: 3
Настройка максимальных жизней для цивилизаций (если интеграция включена)
civilization-limits: winter: 5 forest: 3 desert: 4 jungle: 3
Восстановление жизней
regen: enabled: true # +1 жизнь каждые X минут (0 – отключить) interval-minutes: 1440 # 24 часа # Максимум до какого количества восстанавливать (если 0 – до max-lives) cap-at-max: true
Отображение в скорборде (если используется отдельно от AsteriaCivExtras)
scoreboard: enabled: true title: "§d§lAsteria" lines: - "" - "§7Жизни:" - "§c❤ %lives%"
Сообщения (русские)
messages: lives-amount: "§aУ вас %lives% жизней." lives-given: "§aИгроку %player% выдано %amount% жизней." lives-taken: "§aУ игрока %player% забрали %amount% жизней." lives-set: "§aИгроку %player% установлено %amount% жизней." no-permission: "§cУ вас недостаточно прав." player-not-found: "§cИгрок не найден." invalid-amount: "§cВведите положительное число." death-lost: "§cВы потеряли жизнь. Осталось: %lives%." reloaded: "§aКонфигурация перезагружена." Интеграция с AsteriaCivExtras Если AsteriaCivExtras установлен, плагин не создаёт свой скорборд, а добавляет строку %lives% в существующий скорборд. Для этого он регистрирует плейсхолдер (через PlaceholderAPI, если есть) или просто модифицирует строки в scoreboard.yml (но это уже на усмотрение администратора).
Лучше всего: плагин регистрирует плейсхолдер %asterialives_lives%, который можно использовать в любом скорборде, чате, TAB и т.д. через PlaceholderAPI.
Если PlaceholderAPI не установлен, плагин может сам обновлять строку в скорборде, если знает, где именно (но это сложнее). Поэтому рекомендуется использовать PlaceholderAPI.
Права asterialives.admin – доступ к административным командам.
asterialives.bypass.death – игрок не теряет жизни при смерти.
Сборка (Maven) groupId: com.asterialives
artifactId: AsteriaLives
version: 1.0.0
packaging: jar
dependencies:
paper-api:1.21.11-R0.1-SNAPSHOT (compileOnly)
PlaceholderAPI:2.11.6 (provided) – для регистрации плейсхолдера
AsteriaCivCore / AsteriaCivExtras (provided) – опционально
Java: 21
Примечания Плагин должен корректно работать как с интеграцией, так и без неё.
Все изменения жизней логируются в консоль (опционально).
Плагин должен быть производительным – минимум операций ввода/вывода, кэширование данных.
Этот промт описывает полностью готовую систему жизней с отображением в скорборде и интеграцией с цивилизациями. Может быть реализован как отдельный плагин или как часть экосистемы AsteriaCiv.