- Поддерживаемые версии
- 1.16
- 1.17
- 1.18
- 1.19
- 1.20
- 1.21
- Ядра и Прокси
- Bukkit
- Spigot
- Paper
- Минимальная версия Java
- 17
hPool
AFK-озёра с наградами, регионами, таймерами и сохранением прогресса
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
AFK-озёра с наградами, регионами, таймерами и сохранением прогресса
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
hPool — это плагин для создания AFK-озёр на Minecraft сервере.
Плагин позволяет настроить специальные зоны, в которых игрок должен просто находиться определённое время, после чего он автоматически получает награду.
hPool работает через регионы WorldGuard, поддерживает проверку материала, actionbar, title, bossbar, частицы, настраиваемые действия, PlaceholderAPI, SQLite и MySQL.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Основные возможности
• AFK-озёра с наградами
• Работа через регионы WorldGuard
• Несколько отдельных файлов озёр
• Ограничение по мирам
• Проверка материала под игроком
• Настраиваемое время до награды
• Отображение таймера в actionbar
• Title при входе, выходе и получении награды
• Bossbar с оставшимся временем
• Настраиваемые частицы
• Гибкие действия при выдаче награды
• SQLite и MySQL
• Сохранение прогресса после рестарта
• Настраиваемый интервал сохранения
• Поддержка PlaceholderAPI
• Поддержка HEX-цветов
• Команда перезагрузки конфига
• Команда тестовой выдачи награды
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Как работает плагин
Вы создаёте регион через WorldGuard и указываете его в конфиге озера.
Когда игрок заходит в этот регион, hPool начинает отсчёт времени до награды.
Если игрок остаётся в озере до конца таймера, плагин выполняет настроенные действия награды.
Например, можно выдать валюту, предмет, ключ, эффект, отправить сообщение или выполнить любую консольную команду.
────────────────────────────────────────
Регионы озёр
Каждое озеро работает через отдельный регион WorldGuard.
Пример настройки:
Код:
settings:
region: pool
worlds:
- spawn
В этом примере озеро будет работать только в регионе pool в мире spawn.
Файлы озёр находятся здесь:
Код:
plugins/hPool/pools/
Можно создать несколько разных озёр, и у каждого будет свой регион, миры, таймер, сообщения, bossbar, частицы и награды.
────────────────────────────────────────
Проверка материала
Плагин умеет проверять материал, в котором находится игрок.
Пример:
Код:
material:
enable: true
types:
- WATER
Это полезно, если нужно, чтобы награда работала только тогда, когда игрок действительно находится в воде, а не просто стоит внутри региона.
Если такая проверка не нужна, её можно отключить.
────────────────────────────────────────
Таймер награды
Время до награды настраивается отдельно для каждого озера.
Пример:
Код:
rewardTimeSeconds: 1800
В этом примере игрок должен находиться в озере 30 минут.
Оставшееся время можно показывать через actionbar, bossbar, title и PlaceholderAPI.
────────────────────────────────────────
Actionbar
Плагин может показывать оставшееся время в actionbar.
Пример:
Код:
actionBar:
enable: true
text: '&fДо награды #FDBE00{time} &7(/free)'
Доступный плейсхолдер внутри сообщений озера:
Код:
{time}
────────────────────────────────────────
Title
hPool поддерживает title-сообщения для разных событий.
Доступные события:
• вход в озеро
• выход из озера
• получение награды
Пример:
Код:
title:
enable: true
enter:
text: '#FDBE00&lАФК ОЗЕРО && &fДо награды #FDBE00{time}'
fadeInTicks: 30
stayTicks: 60
fadeOutTicks: 30
Разделитель:
Код:
&&
Он используется для разделения title и subtitle.
────────────────────────────────────────
Bossbar
hPool может показывать оставшееся время через bossbar.
Пример:
Код:
bossBar:
enable: true
text: '&fДо награды #FDBE00{time} &7(/free)'
color: YELLOW
style: SOLID
Так игрок всегда видит, сколько времени осталось до награды.
────────────────────────────────────────
Частицы
Для озера можно включить частицы.
Пример:
Код:
particles:
enable: false
type: VILLAGER_HAPPY
count: 1
step: 1.5
heightOffset: 0.15
sendIntervalSeconds: 5
Это можно использовать, чтобы визуально выделить зону озера.
────────────────────────────────────────
Действия награды
Награды полностью настраиваются через actions.
Пример:
Код:
actions:
rewardActions:
- "[MESSAGE] {prefix} Вы получили награду"
- "[CONSOLE] give {player} diamond 1"
Через действия можно выдавать предметы, валюту, ключи, эффекты, отправлять сообщения и выполнять команды.
Поддерживаемые типы действий:
Код:
[MESSAGE]
[CONSOLE]
[PLAYER]
[BROADCAST]
[SOUND]
[TITLE]
[ACTIONBAR]
[BOSSBAR]
[PARTICLE]
[EFFECT]
[VAULT]
[FIREWORK]
[CLOSE]
Также поддерживается кликабельный и hover-текст в сообщениях.
────────────────────────────────────────
База данных
hPool поддерживает SQLite и MySQL.
Настройка базы данных находится в:
Код:
plugins/hPool/config.yml
Пример:
Код:
database:
type: sqlite
mysql:
host: localhost
port: 3306
database: database
username: root
password:
ssl: false
Для каждого озера можно включить сохранение прогресса.
Пример:
Код:
database:
enable: true
saveIntervalSeconds: 1200
Это нужно, чтобы прогресс игрока в озере не терялся после рестарта сервера.
────────────────────────────────────────
PlaceholderAPI
Плагин добавляет PlaceholderAPI-плейсхолдеры.
Доступные плейсхолдеры:
Код:
%hpool_time_left%
%hpool_storage_time_left%
%hpool_rewards%
Их можно использовать в скорбордах, меню, голограммах и других плагинах с поддержкой PlaceholderAPI.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Установка
- Установите WorldEdit, WorldGuard и PlaceholderAPI.
- Поместите hPool.jar в папку plugins.
- Запустите или перезапустите сервер.
- Создайте регион для озера через WorldGuard.
- Настройте файл озера в папке plugins/hPool/pools/.
- Настройте награды и отображение таймера.
- После изменений используйте /hpool reload.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Файлы конфигурации
Код:
plugins/hPool/config.yml
plugins/hPool/pools/default.yml
Дополнительные озёра можно создавать в папке:
Код:
plugins/hPool/pools/
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Что нужно для работы
WorldEdit
WorldGuard
PlaceholderAPI
- Зависимости
- Vault (Опционально), PlaceholderAPI, WorldGuard, WorldEdit (Обязательно)
- Команды и права
- Команды
Перезагрузить конфигурацию плагина.Код:/hpool reload
Тестово выдать награду указанного озера игроку.Код:/hpool testreward <озеро>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Права
Доступ к команде /hpool reload.Код:hpool.reload
Доступ к команде /hpool testreward <озеро>.Код:hpool.testreward
Админское право, включает hpool.reload и hpool.testreward.Код:hpool.admin
Полный доступ к правам плагина.Код:hpool.*