Интеграция с PlaceholderAPI
ECosmetics имеет полную поддержку плагина PlaceholderAPI, что позволяет вам отображать информацию о косметике игрока в других плагинах, таких как чат, табло или голограммы.
Включение поддержки
Для активации интеграции, убедитесь, что в вашем файле config.yml установлена следующая опция:
# config.yml
# Включить поддержку PlaceholderAPI?
# Требует перезагрузки сервера (не плагина) для регистрации плейсхолдеров.
placeholder-api: trueПосле включения и перезагрузки сервера, вы сможете использовать все перечисленные ниже плейсхолдеры.
Список плейсхолдеров
Общие плейсхолдеры игрока
Эти плейсхолдеры предоставляют общую информацию о состоянии косметики игрока.
| Плейсхолдер | Описание | Пример вывода |
|---|---|---|
%ecosmetics_equipped_count% | Показывает, сколько косметических предметов в данный момент надето на игроке. | 3 |
%ecosmetics_in_zone% | Возвращает true, если игрок находится в гардеробной зоне, и false в противном случае. | true |
%ecosmetics_get_zone% | Показывает ID гардеробной зоны, в которой находится игрок. Если игрок не в зоне, вернет пустое значение. | main_wardrobe |
Проверка наличия косметики
Эти плейсхолдеры позволяют узнать, есть ли у игрока доступ к определенной косметике.
| Плейсхолдер | Описание | Пример вывода |
|---|---|---|
%ecosmetics_get_{id}% | Проверяет, есть ли у игрока косметика с указанным ID. | true |
%ecosmetics_player_available_all% | Показывает общее количество косметических предметов, доступных игроку. | 42 |
%ecosmetics_player_available_hat% | Показывает, сколько шляп доступно игроку. | 15 |
%ecosmetics_player_available_bag% | Показывает, сколько рюкзаков доступно игроку. | 10 |
%ecosmetics_player_available_walking_stick% | Показывает, сколько тростей доступно игроку. | 5 |
%ecosmetics_player_available_balloon% | Показывает, сколько воздушных шаров доступно игроку. | 7 |
%ecosmetics_player_available_spray% | Показывает, сколько спреев доступно игроку. | 5 |
Информация об экипированной косметике
Эти плейсхолдеры предоставляют детальную информацию о предметах, которые надеты на игроке в данный момент. Вместо <type> подставьте нужный тип: hat, bag, walking_stick, balloon, spray.
| Плейсхолдер | Описание | Пример вывода |
|---|---|---|
%ecosmetics_equipped_{type}% | Проверяет, надет ли на игрока косметический предмет указанного типа. | true |
%ecosmetics_equipped_{type}_id% | Возвращает ID надетого предмета указанного типа. | wizard_hat |
%ecosmetics_equipped_{type}_material% | Возвращает материал предмета. | LEATHER_HORSE_ARMOR |
%ecosmetics_equipped_{type}_modeldata% | Возвращает CustomModelData предмета. | 10001 |
%ecosmetics_equipped_{type}_hex% | Возвращает цвет предмета в HEX-формате (если применен). | #FF0000 |
%ecosmetics_equipped_{type}_r% | Возвращает красную (Red) компоненту цвета (0-255). | 255 |
%ecosmetics_equipped_{type}_g% | Возвращает зеленую (Green) компоненту цвета (0-255). | 0 |
%ecosmetics_equipped_{type}_b% | Возвращает синюю (Blue) компоненту цвета (0-255). | 0 |
Примеры
%ecosmetics_equipped_hat_id%вернет ID надетой шляпы.%ecosmetics_equipped_bag_hex%вернет цвет надетого рюкзака.- Плейсхолдер
%ecosmetics_using_{type}%является синонимом для%ecosmetics_equipped_{type}%.
Общая информация о сервере
Эти плейсхолдеры показывают общее количество косметических предметов, доступных на сервере.
| Плейсхолдер | Описание | Пример вывода |
|---|---|---|
%ecosmetics_available_all% | Показывает общее количество косметики, существующей на сервере. | 150 |
%ecosmetics_available_hat% | Показывает общее количество шляп на сервере. | 50 |
%ecosmetics_available_bag% | Показывает общее количество рюкзаков на сервере. | 40 |
%ecosmetics_available_walking_stick% | Показывает общее количество тростей на сервере. | 20 |
%ecosmetics_available_balloon% | Показывает общее количество воздушных шаров на сервере. | 25 |
%ecosmetics_available_spray% | Показывает общее количество спреев на сервере. | 15 |