TimedMMOItems

TimedMMOItems — плагин для создания предметов с сроком годности

TimedMMOItems — это серверное расширение для премиум-плагина MMOItems, добавляющее возможность создавать предметы с истекающим сроком действия. Плагин вводит две новые статистики: «Период истечения» (относительное время в секундах) и «Абсолютная дата истечения» (миллисекунды с Unix-эпохи). Автоматическая проверка истечения происходит в фоновом режиме, и предметы могут удаляться, заменяться другими или становиться неактивными. Для отображения информации в описании предмета требуется настройка шаблона в конфиге MMOItems.

📦 Новые статистики предметов

Плагин TimedMMOItems добавляет в функционал MMOItems две новые статистики для создания предметов с ограниченным сроком действия.

1. Expiry Period (Период истечения): Длительность, в течение которой предмет остаётся активным, измеряется в секундах. Этот срок считается относительно момента, когда игрок впервые получил предмет. Например, для 30 дней нужно вычислить: 30 * 24 * 60 * 60 = 2 592 000 секунд.

1. Expiry Date (Абсолютная дата истечения): Конкретная дата, когда предмет истечёт, измеряется в миллисекундах с начала Unix-эпохи.

Плагин рекомендует использовать первую статистику («Expiry Period»), так как она автоматически конвертируется во вторую. Предметы проверяются автоматически, и если дата истечения наступила, предмет обрабатывается согласно настройкам.

🗑️ Обработка истёкших предметов

При наступлении срока действия предмета плагин применяет одну из трёх действий по умолчанию:

1. Удаление предмета: Предмет полностью удаляется из инвентаря игрока.
2. Замена предмета: Предмет заменяется на один или несколько других предметов. Замена может быть конкретной для определённого предмета или категории предметов.
3. Отключение удаления: Предмет остаётся в инвентаре, но становится неактивным и не может быть использован.

Эти настройки можно изменить в конфигурации плагина.

⚙️ Настройка отображения в описании

Чтобы отображать информацию о сроке действия предмета в его описании (lore), необходимо добавить соответствующие ключи в файл language/lore-format.yml в папке конфигурации MMOItems. Доступные ключи:

• #expiry-period# — отображает период истечения.
• #expiry-date# — отображает абсолютную дату истечения.

Дополнительную информацию о форматах описания можно найти в документации MMOItems. Также в конфигурации можно изменить формат отображения даты и текста статистики.

🛠️ Команды плагина

Основная команда для управления плагин: `/ti`.

**Алиасы:**
- `/tmi`
- `/timeditems`
- `/timedmmoitems`

**Дополнительные команды:**
- `/ti reload` — перезагрузка конфигурации плагина без остановки сервера.

Эти команды позволяют администраторам проверять и управлять предметами с истёкшим сроком действия.

⚠️ Частые вопросы и устранение неполадок

1. Предмет не истёк

Возможные причины:

• У игрока есть право доступа timeditems.bypass, которое отключает проверку для этого предмета.
• Предмет ещё не был проверен системой. Попробуйте перезагрузить конфигурацию командой /ti reload.

2. Как отследить активность плагина?

Увеличьте уровень отладки в конфигурации с 0 до 3 (0 = отключено). Это поможет увидеть, какие предметы проверяются и как обрабатываются.

3. Как работает плагин?

• Если установлена «Expiry Date», плагин проверяет, наступил ли срок, и удаляет или заменяет предмет.
• Если установлена «Expiry Period», плагин конвертирует её в абсолютную дату на основе текущего времени.

4. Нет информации о сроке в описании предмета?

Вы не изменили шаблон описания в конфиге. Добавьте ключи #expiry-period# или #expiry-date# в файл lore-format.yml.

5. Как изменить формат даты?

В конфигурации можно изменить формат отображения даты и текста. Для проверки формата используйте онлайн-тестер: http://www.sdfonlinetester.info/

6. Влияние на производительность?

Проверка выполняется с фиксированным интервалом, задаваемым опцией item-check-interval. Рекомендуется увеличить этот интервал, чтобы избежать нагрузки на сервер. Обновление инвентаря происходит только при изменении предмета.

7. Отключение проверки в определённых мирах?

Используется поддержка контекстных прав LuckPerms. Можно предоставить право timeditems.bypass для определённого мира, предварительно включив это в конфигурации плагина.

📞 Поддержка и контакты

Плагин разрабатывается автором anhcraft. Поддержка предоставляется через Discord-сервер автора. Вопросы, связанные с основным плагин MMOItems, следует решать напрямую с разработчиком MMOItems, так как TimedMMOItems является его расширением. Автор также рекомендует оставлять положительные отзывы, если плагин оказался полезным.

Автор: anhcraft · Лицензия: GPL-3.0-only