Hats++ - это клиентный мод, расширяющий механику шапок. Он позволяет создавать более сложные анимированные шапки и другую косметику. Также, он полностью совместим с ванилой. То есть, другим игрокам не нужно устанавливать мод, чтобы видеть шапки и другие эффекты.

Вот мод: тык .

• (теперь шапки работают в оффлайне)
  
• Вы можете перезагружать метапиксели и спрайты, не перезапуская игру. По дэфолту это делается на F6, но вы можете перенастроить это с помощью консольной команды srkb. (Напрмер, "srkb F") Конфиг будет создан в папке "Документы"

Шапка состоит из элементов. Каждый элемент должен быть расположен в отдельном .png файле. Все элементы должны быть расположены в одной папке. Название этой папки будет названием шапки. Шапки проверяются во всех папках для шапок + в папках, добавленных хэтпаками.
Вот список всех элементов (мы поговорим о каждом из них подробнее позже):

• ExtraHat
• Hat
• Wings
• FlyingPet
• WalkingPet
• Preview

Если папке нет Hat или Preview элементов, шапка не будет создана.

Чтобы добавить элемент, поместите его в папку вашей шапки и назовите по следующему шаблону:
{название_элемента}_{Ширина}_{Длина}.png.
Ширину и длину необходимо указывать в случае, если вы хотите использовать кастомные метапиксели. Они (ширина и длина) определяют размер области, в которой содержится сама шапка. Всё, что находится за границами этой области, будет считаться метапикселями.

В качестве примера рассмотрим эту шапку:




Это элемент Hat. Тут определено две анимации. Размер области всех кадров составляет 128 на 64 пикселя. На 129 ряду располагаются метапиксели. Таким образом, название этого элемента:

Чтобы понять этот раздел, вам следует ознакомиться с понятием "метапиксель" (если вы не знаете, что это). Вы можете почитать о них тут [duckgame.fandom.com]

Hats++ использует свою собственную систему метапикселей, позволяя манипулировать анимациями и другими вещами. Вот их список:


Имейте ввиду, что если метапиксель относится к определенному элементу, то он будет работать, только если будет помещен в соответствующий элемент.

Перед добавлением анимаций укажите размер кадра с помощью 2 метапикселя. Если размер кадра больше 32 на 32 (максимальный размер: 64 на 64), также поставьте 1 метапиксель.

Анимации создаются с помощью специальной структуры из метапикселей (более подробное описание этих метапикселей есть в таблице):

1. Тип анимации (3)
2. Задержка (4)
3. Зацикленность (5)
4. Кадры (6/7)
5. Изменение анимации при смене уровня (20) (опционально)

Метапиксели анимации читаются сверху вниз. Они должны быть расположены один за другим без пробелов.
Давайте обсудим каждый из них.

Тип анимации определяет, когда анимация будет проиграна. Некоторые типы работают только с определенными элементами.
Все типы анимаций представлены тут:


Задержка определяет, сколько игровых кадров пройдет между сменой кадра анимации. Таким образом, задержка n означает, что кадр анимации будет меняться каждые n игровых кадров.

Зацикленность анимации определяет, будет ли анимация запущена заново после того, как она завершится.

Кадры определяются по их индексам. То есть, у первого кадра будет индекс 0, и так далее. Для определения кадров можно использовать метапиксель кадра (6) и метапиксель периода кадров (7). Однако, вы не можете использовать их одновременно в одной анимации (мб позже это добавлю).
Метапиксель кадра просто добавляет 1 кадр. Вы можете ставить его неограниченное количество раз. Метапиксель периода кадров определяет, соответственно, период. Вы можете использовать его только 1 раз. Например, если этот метапиксель равен (7,0,5), будут добавлены следующие кадры: (0,1,2,3,4,5). Также можно начинать с большего индекса: (7,5,0) - (5,4,3,2,1,0).

Шапка, которая будет добавлена в список шляп в HatSelector. Одев ее, вы оденете модовую шляпу.
Пример:





Она одевается на вас. Её размер не может превышать 32 на 32. Анимации, которые можно связать: {OnPressQuack, OnReleaseQuack}.
Пример:














В этой шапке определены две связанные анимации, + она "пристегнута"

Летающие питомцы следуют за вами по воздуху. Вы можете настроить их скорость (21) и расстояние, до которого они будут долетать (15). Анимации, которые можно связать: {OnPressQuack, OnReleaseQuack}, {OnStatic, OnApproach}.
Пример:













У этого питомца определены анимации onRessurect и OnDuckDeath, + OnRessurect установлена как OnSpawn анимация.

Ходящие питомцы следуют за вами по земле. Вы можете настроить расстояние, до которого они будут вас преследовать (15). Анимации, которые можно связать: {При приближении, статичная>, {на нажатие кряка, на отпускание кряка}.
Пример:

























У этого питомца определены onStatic и OnApproach анимации.

Крылья располагаются за уткой. Они могут проигрывать только некоторые заранее заданные анимации. Вы можете использовать 13-ый метапиксель, чтобы сгенерировать их автоматически или определить их сами. Вы также можете отдельно указать кадры планирования и приземления.
Кадры должны располагаться вериткально, снизу вверх. Предполагается, что в верхнем кадре крылья "закрыты", и далее они раскрываются до самого нижнего кадра.
Чтобы сгенерировать анимации, которые меняются каждый новый уровень, поставьте 20-ый метапиксель и установите в зеленый канал такое значение, сколько у вас измененных текстур (максимально криво звучит, но лучше ничего не придумал :P)
Пример:
















Эти крылья генерируют анимации для 3-х цветов. Каждый раунд цвет меняется.

Существует лимит по размеру шапок: 32 на 32 пикселя. Мне это не понравилось, поэтому я добавил возможность использовать большие шляпы (до 64 на 64). Чтобы указать, что шляпа должна быть большой (это нужно, так как иначе все частицы, плащи и камни становились бы большими шапками), просто поставьте 1-ый метапиксель.
Пример:













У этой шапки определена анимация onApproach, + установлен 1-ый метапиксель. Размер кадра: 64 на 64.

Она содержит дополнительную информацию (плащ, камень, частицы и т.д) для шапки. Дополнительная шапка будет добавлена к каждому кадру шапки. Если вы хотите анимировать доп. шапку (наверное, для изменяющихся частиц, так как плащ и камень нельзя анимировать), как обычно определите ее размер кадра и область, в которой располагается шапка.
Пример:

Если вы хотите создать хэтпак в виде клиентного мода, вот, что вы должны сделать:

• Подготовьте шаблон клиентного мода
  
• Создайте папку в папке "content" и поместите все ваши шапки туда
  
• Откройте код вашего мода в любом редакторе (Я полагаю, что вы знакомы с программированием)
  
• Добавьте ссылку на Hats++ мод (.dll файл расположен в папке мода в steamapps\workshop\content\312530)
  
• Переопределите метод OnPreInitialize и добавьте путь к вашим шапкам с помощью метода AddHatPath

Пример кода: