- Поддерживаемые версии
- 1.16
- 1.17
- 1.18
- 1.19
- 1.20
- 1.21
Полное руководство по плагину KatsuAvatars
Глава 1: Логика работы и архитектура плагина
Как это работает:
1. Плагин берет скин игрока.
2. На лету сжимает его до сетки пикселей (обычно 8x8 или 16x16).
3. Превращает каждый пиксель в специальный Unicode-символ со своим цветом, используя возможности форматирования MiniMessage или HEX-цвет в связке с кастомным провайдером шрифтов в ресурс-паке.
4. Выдает готовый плейсхолдер, который можно вставить в TAB, DeluxeMenus или EssentialsX Chat.
Глава 2: Разбор главного файла конфигурации (config.yml)
Если вы используете какой нибуди плагин на генерацию Ресурспака например Oraxen, ItemAdder, Nexo то отключите
иначе при перезагрузке KatsuAvatars и ваш плагин будут конфликтовать
настраиваем если очень надо:
config.yml
Глава 3: Настройка интеграции с Ресурс-паками
ОБЯЗАТЕЛЬНО СОХРАНИТЕ ВАШ РЕСУРСПАК ЕСЛИ ИСПОЛЬЗУЕТЕ Oraxen, ItemAdder, Nexo и т.п. потому что KatsuAvatars удалит весь ваш пак и вставит свой
Нам нужно положить файлы KatsuAvatars по этому пути: assets/minecraft/font/
из plugins\KatsuAvatars\resourcepack\assets\minecraft\font
если у вас уже настроен default.json то вставляем этот кусочек:
Глава 4: Использование плейсхолдеров (PlaceholderAPI)
%katsu_avatar_size% SMALL, MEDIUM, NORMAL, LARGE, GIANT
%katsu_player_name%
Глава 5: Список команд
Список команд:
Важное предупреждение при работе со скинами:
Скин отображается правильно только если у игрока лицензия майнкрафта
Глава 1: Логика работы и архитектура плагина
Как это работает:
1. Плагин берет скин игрока.
2. На лету сжимает его до сетки пикселей (обычно 8x8 или 16x16).
3. Превращает каждый пиксель в специальный Unicode-символ со своим цветом, используя возможности форматирования MiniMessage или HEX-цвет в связке с кастомным провайдером шрифтов в ресурс-паке.
4. Выдает готовый плейсхолдер, который можно вставить в TAB, DeluxeMenus или EssentialsX Chat.
Глава 2: Разбор главного файла конфигурации (config.yml)
Если вы используете какой нибуди плагин на генерацию Ресурспака например Oraxen, ItemAdder, Nexo то отключите
YAML:
texture-pack:
enable: falseиначе при перезагрузке KatsuAvatars и ваш плагин будут конфликтовать
настраиваем если очень надо:
YAML:
database:
enable: false
host: localhost
port: 3306
database: minecraft
username: username
password: password
YAML:
# Download it here: https://black-minecraft.com/resources/5865/
# ################################################################################################
# _ __ _ _ _ #
# | |/ / __ _ | |_ ___ _ _ / \ __ __ __ _ | |_ __ _ _ __ ___ #
# | ' / / _` | | __| / __| | | | | / _ \ \ \ / / / _` | | __| / _` | | '__| / __| #
# | . \ | (_| | | |_ \__ \ | |_| | / ___ \ \ V / | (_| | | |_ | (_| | | | \__ \ #
# |_|\_\ \__,_| \__| |___/ \__,_| /_/ \_\ \_/ \__,_| \__| \__,_| |_| |___/ #
# #
# ################################################################################################
# - *\ Created by Katsutori Studio © /* -#
# ################################################################################################
config:
# Use your own MySQL database, by activating the option below,
# the default database is SQLite.
database:
enable: false
host: localhost
port: 3306
database: minecraft
username: username
password: password
# The texture pack that will be sent to the player when they join the server.
# The texture pack must be in a .zip format and uploaded to a file-hosting service.
texture-pack:
enable: false
# The URL of the texture pack.
link: https://download.mc-packs.net/pack/05c280a381787f7de68cef626ab1ba28dc24fa64.zip
messages:
prefix: ' &a&l✔ &8| #db3c3c&lK#de3d3d&la#e23e3e<#e53f3f&ls#e84040&lu#eb4141&lA#ef4141&lv#f24242&la#f54343<#f84444&la#fc4545&lr#ff4646&ls
&8: &f'
no-args: '&lUsage: &e/ka <reload/download/avatar> &fto use command.'
no-args-download: '&lUsage: &e/ka download <player> &fto use command.'
no-args-avatar: '&lUsage: &e/ka avatar <size> <player> &fto use command.'
no-avatar-found: '&cNo avatar found for the player, please use /ka download <player>
to download the player''s head.'
avatar-size: '&cThe size of the avatar must be SMALL, MEDIUM, NORMAL or LARGE.'
reload: '&fThe plugin has been reloaded.'
download: '&fThe player''s &e%player% &fhead has been downloaded.'
download-head-error: '&cAn error occurred while downloading the player''s head.'
no-permission: '&cYou do not have permission to use this command.'Глава 3: Настройка интеграции с Ресурс-паками
ОБЯЗАТЕЛЬНО СОХРАНИТЕ ВАШ РЕСУРСПАК ЕСЛИ ИСПОЛЬЗУЕТЕ Oraxen, ItemAdder, Nexo и т.п. потому что KatsuAvatars удалит весь ваш пак и вставит свой
Нам нужно положить файлы KatsuAvatars по этому пути: assets/minecraft/font/
из plugins\KatsuAvatars\resourcepack\assets\minecraft\font
если у вас уже настроен default.json то вставляем этот кусочек:
JSON:
{
"type": "ttf",
"file": "minecraft:katsuavatars.ttf",
"shift": [0, 0],
"size": 12.0,
"oversample": 40.0,
"skip": ""
}Глава 4: Использование плейсхолдеров (PlaceholderAPI)
%katsu_avatar_size% SMALL, MEDIUM, NORMAL, LARGE, GIANT
%katsu_player_name%
Глава 5: Список команд
Список команд:
- /katsuavatar reload - Перезагрузка конфигурации плагина
- /katsuavatar avatar SMALL, MEDIUM, NORMAL, LARGE - выбор размера иконки
Важное предупреждение при работе со скинами:
Скин отображается правильно только если у игрока лицензия майнкрафта
