Полная документация VHealth




Установка

1. Скачайте файл VHealth.jar и поместите его в папку plugins/.
   
   
2. Обязательно установите PlaceholderAPI. Плагин не будет работать без него.
   
   
3. Для корректной работы с NPC, пожалуйста, установите плагин Citizens.
   
   
4. Перезапустите сервер, чтобы плагин запустился.
   

Команды


Команда Описание Права
/vhealth Открывает графический интерфейс для настройки плагина. vhealth.settings
/vhealth reload Перезагружает config.yml и применяет новые настройки. vhealth.reload


Права доступа (Permissions)

• vhealth.settings — доступ к GUI-меню /vhealth.
  
  
• vhealth.reload — возможность перезагружать конфиг.
  

Конфигурация (config.yml)


Плагин автоматически создаст этот файл при первом запуске.

YAML
# ================================================ #
# #
# Настройки VHealth #
# #
# ================================================ #

# ----- ОБЩИЕ НАСТРОЙКИ ЗДОРОВЬЯ -----

# Включить умножение здоровья. Если у игрока 10 сердец и множитель 2.0,
# будет отображаться 20 символов.
multiply-health:
enabled: true
multiplier: 2.0

# Символ для отображения здоровья. Можно использовать эмодзи и спецсимволы.
symbol: "❤"

# Добавлять ли пробел перед символом. Например: "10❤" или "10 ❤".
space-before-symbol: true

# Отображать ли абсорбционное здоровье (золотые сердца) отдельно.
# Если true, абсорбция не будет влиять на плейсхолдер.
separate-absorption: false


# ----- ЦВЕТОВЫЕ НАСТРОЙКИ -----

# Вы можете использовать &-коды или HEX-цвета (#FF0000).
# HEX-цвета работают только на серверах 1.16+.
colors:
normal: "&c" # Цвет обычного здоровья
absorption: "&e" # Цвет абсорбции
low-health: "&6" # Цвет при низком здоровье


# ----- ЭФФЕКТ НИЗКОГО ЗДОРОВЬЯ -----

# Включить эффект, когда у игрока мало здоровья.
low-health-effect:
enabled: true

# Порог (в сердцах), при котором срабатывает эффект.
threshold: 5.0

# Включить мигание цвета при низком здоровье.
# Если false, цвет будет просто статичным.
blinking-enabled: true


# ----- ФОРМАТИРОВАНИЕ -----

# Шаблон для плейсхолдера %health_hearts%.
# Доступные переменные:
# {color} - Текущий цвет (normal, absorption или low-health)
# {hearts} - Количество сердец (с учетом множителя)
# {base_hearts} - Базовое количество сердец игрока (обычно 10)
# {space} - Пробел, если включен
# {symbol} - Выбранный символ
format: "{color}{hearts}{space}{symbol}"



PlaceholderAPI

• %health_hearts% — показывает текущее количество сердец с форматированием.
  
  
• %health_base_hearts% — показывает базовое количество сердец игрока (стандартно 10).
  

Пример использования:

YAML
# Отображение на Scoreboard или в чате
lines:
- "&fЗдоровье: &c%health_hearts%"