For Witcher 3 - v1.31/1.32


(Русскоязычное описание ниже )


ENG:

Expanding the possibilities of equipping items for Accessory Slot Mod.

This mod was originally part of another major mod that is currently in development.
But I decided to make it standalone so that other mods/modmakers could use this mechanics.


The mod changes the mechanics of equipping items for accessory slots, and provides the ability to create restrictions on
equipping items.


1) Сhanges the mechanics of equipping items with the «AHW» tag ( for example, cloaks from Hoods mod ).
When you trying to put on a cloak (when there is already another cloak in the slot), ASM gives an error, not allowing you to equip it.
Equipper changes this mechanic - if you try to put on a different cloak, it simply replaces it with a new one.

2) Provides restrictions for equipping the identical items (for example, hats).
It will no longer be possible to wear two hats at the same time. When you try to put on the 2nd, it will replace the equipped one.
Except «Masks» (they can be configured separately) and «Usable» items (such as «Lamp» or «Torch»).
You can disable this feature by setting «Limit items - Only Unique» (except «Hoods» items).
So it will only work on items with the «Unique» tag.

3) Hides all items («Accessory» and «Pocket» slots) during fistfights (mini-game) and cutscenes (when Geralt is naked).
Edited -  Now ASM has its own item hiding system, so «Equipper» hides only pochet slots now.

4) Allows mod authors to restrict equipping an item (for «ASM» and «Pocket» slots) if the character does not have some equipment.
For example, the author can forbid his item to be equipped while the character is not wearing armor.
Let's say this item should be visually displayed on the character's armor (as in the "example" mod, see below).
Or the author needs to be restrict from using the item without the set armor / for another reason that the author needs.
If the player removes the armor, then this item also will be automatically removed.
The mod can define the (usual / any witcher / specific school) of equipment.

5) The author can make the subject «Unique». Such an item can only be worn in a single copy from it`s category.
Similar to how it works in paragraph 2, but ignores disabling it.
The difference is that it works not only by category, but also by tag.
That makes it possible to create an infinite number of unique sets of items that do not overlap with each other.

6) Added support community sets (Sezon Burz Witcher's Gear and Book Inspired set Cos Wiecej).
If you need others - write to me.


Example:
I made a small mod ( Baron`s Knife ) at the request of a friend. This mod already uses the basic Equipper mechanics.
There are 8 items in the mod and 3 places of their display on the character.
With the Equipper, I limited the number of knives to one for each location.
This way they will not overlap graphically.
There are also restrictions on equipment. You can not wear the item that is displayed on the thigh if you are not wearing pants, and so on.


For mod authors and translators:
In the download section you will find an archive with instructions for creating "restrictions" and translating.
If you need to add an additional restriction or a settings menu, write to me.


Installation:
1)Install the Accessory Slot Mod.
2)Open the archive and extract the «Mods» folder to the root folder of the game.
3)Open the «Menu» folder and select the type of menu (Vanilla or Menu Strings mod) and copy the «Bin» folder to the root folder of the game.
4)Use the Witcher Script Merger, the process should be automatic.
The mod does not change the ASM code and minimally interferes with the game files, which makes it very easy to merge.

If you still have problems (unlikely, but still) let me know, please.


Credits:
Special thanks to eNoodles for his tips in code writing.
LoganRiviiskiy for motivation and moral support :-D
fjorgar for testing.







RUS:

Расширение возможностей экипирования предметов для Accessory Slot Mod.

Изначально этот мод был частью другого моего крупного мода, находящегося сейчас разработке.
Но я решил сделать его самостоятельным, чтобы можно было использовать его механики другими модами/модмейкерами.


Мод изменяет механику экипирования предметов для слотов аксессуаров, и предоставляет возможность создавать ограничения на
экипирование предметов.


1) Меняет механику экипирования предметов с «AHW» тагом (например плащи из Hoods mod ).
В оригинальном моде при попытке надеть плащ (когда в слоте уже есть другой плащ)
ASM выдает ошибку, не позволяя экипировать его.
Equipper» изменяет эту механику, и при попытке надеть другой плащ просто заменяет его на новый.

2) Вводит ограничения на экипирование одинаковых вещей (например шапки).
Теперь нельзя будет надеть две шапки одновременно. При попытке надеть 2ю она заменит экипированную.
Кроме «Масок» (их можно настроить отдельно) и «Используемых» предметов (например «Лампа» или «Факел»).
Вы можете отключить эту функцию, выставив «Ограничить предметы - Только Уникальные» (кроме «Hoods» предметов).
Таким образом, он будет работать только с предметами с тегом «Уникальный».

3) Прячет все предметы («Аксессуары» и «Быстрые» слоты) во время кулачных боев (мини игра) и катсцен (когда Геральт голый).
Изменено — теперь у «ASM» есть собственная система скрытия предметов, поэтому теперь «Equiper» скрывает только быстрые слоты.

4) Позволяет авторам модов запретить экипирование предмета («ASM» и «Быстрых» слотов) если на персонаже нет какой-либо экипировки.
Например, автор может запретить своему предмету экипироваться, пока на персонаже нет брони.
Допустим этот предмет должен визуально отображаться на броне персонажа(как в моде "примере" см. ниже).
Или автору нужно запретить использование предмета без сэтовой брони / по другой причине которая нужна автору.
Если же игрок снимет броню, то этот предмет также будет автоматически снят.
Мод может определять обычную/любую ведьмачью/конкретную школу экипировки.

5) Автор может сделать предмет «Уникальным». Такой предмет можно надеть только в единственном экземпляре из своей категории.
Похоже на то как это работает в пункте 2, но игнорирует его отключение.
Отличие в том что это работает не только по категории, но и по тэгу.
Что дает возможность создавать бесконечное количество уникальных наборов предметов, не пересекающихся друг с другом.

6) Добавлена поддержка сторонних сэтов (Sezon Burz Witcher's Gear и Book Inspired set Cos Wiecej).
Если нужны другие - напишите мне.


Пример:
Я сделал небольшой мод ( Baron`s Knife ) по просьбе знакомого. Этот мод уже использует базовые механики Equipper.
В моде 8 предметов и 3 места их отображения на персонаже.
С помощью Equipper я ограничил количество надеваемых ножей до одного на каждое такое место.
Таким образом они не будут графически накладываться друг на друге.
Так же есть ограничения по экипировке. Нельзя надеть предмет, который отображается на бедре если не надеты штаны, и тд.


Авторам модов и переводчикам:
В секции скачивания вы найдете архив с инструкциями по созданию "ограничений" и переводу.
Если вам нужно добавить дополнительное ограничение или меню настроек, напишите мне.


Установка:
1) Установите Accessory Slot Mod.
2)Откройте архив и распакуйте папку «Mods» в корневую папку игры.
3)Откройте папку «Menu» и выберите тип меню (Vanilla меню или для мода Menu Strings) и скопируйте папку «Bin» в корневую папку игры.
4) Используйте Witcher Script Merger, процесс должен быть автоматическим.
Мод не изменяет код Accessory Slot Mod и минимально вмешивается в файлы игры, что позволяет легко делать слияние.

Если у вас остались проблемы с установкой (маловероятно, но все же) дайте мне знать, пожалуйста.




Благодарности:
Особая благодарность eNoodles за его советы по написанию кода.
LoganRiviiskiy за мотивацию и моральную поддержку :-D
fjorgar за тестирование.