Документация плагина DelDropItems
Обзор
Плагин DelDropItems предназначен для серверов Minecraft, чтобы управлять поведением выброшенных предметов. Он позволяет администраторам серверов устанавливать правила, определяющие, как долго предметы остаются в мире после того, как их выбрасывают игроки, транслировать сообщения всем игрокам и настраивать пользовательские сообщения для различных событий.
Функции
- Автоматическое удаление предметов: плагин автоматически удаляет выпавшие предметы по истечении указанного времени, помогая поддерживать чистоту игровой среды.
- Настраиваемые сообщения о выпадении предметов: игроки получают настраиваемые сообщения, когда выбрасывают предметы, что улучшает игровой процесс.
- Перезагрузка конфигурации: параметры конфигурации можно перезагрузить без необходимости перезапуска сервера, что упрощает внесение изменений.
- Рассылка сообщений: плагин может отправлять сообщения всем игрокам через определенные промежутки времени, информируя всех.
- Регистрация удалений предметов: все удаленные предметы регистрируются с указанием имени игрока и типа предмета, что позволяет легко отслеживать их.
Конфигурация
Файл конфигурации config.yml включает в себя несколько параметров:
- item-removal-time: Это целочисленное значение указывает время (в секундах) до того, как выброшенные предметы будут удалены из мира. Значение по умолчанию — 60 секунд.
- drop-message-allow: Этот логический параметр определяет, будут ли отправляться сообщения при сбросе элемента. Значение по умолчанию — true.
- broadcast-interval: Целое число, указывающее, как часто (в секундах) сообщения транслируются всем игрокам. Значение по умолчанию — 60 секунд.
- broadband-message-allow: Логическое значение, которое контролирует, разрешена ли широковещательная рассылка сообщений. Значение по умолчанию — true.
- reload-message-allow: Этот логический параметр определяет, будет ли отправлено сообщение при перезагрузке конфигурации. Значение по умолчанию — true.
- language: Указывает язык, на котором будут отображаться сообщения. Доступные значения: en или ru. Значение по умолчанию — en.
Сообщения изменяются в файлах messages_ru и messages_en в соответствии с выбранным языком.
- drop-message: строковое сообщение, отправляемое игроку, когда он бросает предмет. Сообщение может включать %item_name%, которое будет заменено на имя предмета. Сообщение по умолчанию — [§aDelDropItems§f] §eВы бросили: %item_name%!
- reload-message: Сообщение, отправляемое игроку при перезагрузке конфигурации. Значение по умолчанию — [§aDelDropItems§f] §eКонфигурация плагина успешно перезагружена!.
- broadcast-message: Строковое сообщение, отправляемое всем игрокам с указанным интервалом трансляции. Сообщение по умолчанию — [§aDelDropItems§f] §cУдаление предмета произойдет через §l5 минут§r!
Изменение языка влияет только на сообщения, отправляемые плагином, и не меняет язык интерфейса Minecraft.
После перезагрузки сервера языковые настройки сохраняются, и будет использоваться последний установленный язык.
Команды
Плагин поддерживает следующие команды:
- /ddi reload: эта команда перезагружает конфигурацию плагина.
- /ddi help: эта команда отображает список доступных команд.
Разрешения
Для управления доступом к командам доступны следующие разрешения:
- delDropItems.reload: Предоставляет разрешение на перезагрузку конфигурации.
- delDropItems.help: Предоставляет разрешение на доступ к справочной информации.
Установка
Чтобы установить плагин DelDropItems, выполните следующие действия:
- Загрузите JAR-файл плагина.
- Поместите JAR-файл в каталог плагинов вашего сервера Minecraft.
- Запустите или перезапустите сервер, чтобы создать файл конфигурации по умолчанию.
- Отредактируйте файл config.yml, чтобы настроить параметры по своему усмотрению.
- Используйте команду /ddi reload, чтобы применить любые изменения без необходимости перезапуска сервера.
Поиск неисправностей
Если у вас возникли проблемы с плагином, проверьте консоль сервера на наличие сообщений об ошибках. Убедитесь, что значения конфигурации верны и у вас есть необходимые разрешения для использования команд. Кроме того, если вы не видите ожидаемых сообщений или поведения, проверьте, что плагин загружен правильно и что все зависимости удовлетворены.