Artifactory

Сайт — обязательно загляните на сайт, там есть вся нужная информация.

Конструктор JSON / датапаков — просто настройте предметы, скачайте датапак и закиньте его в папку datapacks. Или используйте его для создания json-файлов и скачивайте их, чтобы добавить в существующие датапаки. Так настраивать конфигурации для мода очень просто.

Привнесите в Minecraft глубокую и настраиваемую систему настройки.

Artifactory добавляет крайне гибкую механику связи с предметами, позволяя игрокам устанавливать мощную связь со своим оружием, бронёй и снаряжением — так называемую Настройку. По мере роста вашей связи с предметами уникальные и интересные бонусы будут расти вместе с ней. Мод бесшовно вписывается в любой модпак и создаёт интересный выбор: на какое снаряжение потратить ограниченные слоты настройки.

Этот мод продлевает эндгейм Minecraft по созданию идеального оружия или брони. Это стоит немного опыта, времени и некоторых редких материалов, но созданные вами предметы будут легендарными.

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

Обзор

• Полностью основанная на данных система настройки, где настраивается почти всё возможное. Подгоните её под нужды своего сервера или модпака.
• Создавайте и развивайте связи с оружием, бронёй и другими предметами, чтобы получать уникальные бонусы вроде Неразрушимости, прибавок к атрибутам и Привязанных к душе предметов, которые остаются с вами после смерти.
• Включён стандартный ванильный датапак (его нужно включить при создании мира), можно установить и играть без каких-либо конфигураций.
• Защитите свои настроенные предметы от исчезновения и уничтожения окружающей средой.
• Использовать предмет может только тот игрок, кто с ним связан, — его верность принадлежит только ему. Если держать предмет, связанный с другим игроком, случится что-то плохое.
• Можно задавать ограничения, например требовать настройки предмета перед любым его использованием.
• Совместимость с Curios.
• Должен быть совместим со всеми другими модами.

Создавайте интересные и мощные предметы, которыми сможете владеть только вы. Ниже — уровни настройки из стандартного датапака для алмазного меча.

Уровень 1: добавляет Неуязвимость (не исчезает и не может быть повреждён эффектами окружающей среды), а также преимущества связи настройки.

Уровень 2: добавляет 25% скорости атаки и Неразрушимость.

Уровень 3: добавляет ещё 40% скорости атаки и делает предмет Привязанным к душе, так что если вы умрёте, он пройдёт с вами через смерть и возродится вместе с вами на вашем теле.

                                                    Уровень 1                            Уровень 2                                Уровень 3

Хотя этот мод для 1.20.1 и функционально завершён, некоторые его возможности только для 1.21.1 и не будут перенесены в ближайшее время

С чего начать

Примечание: информацию о настройке предметов для настройки см. в разделе о датапаках ниже. Все значения в этом руководстве используют стандартный ванильный датапак.

Как только предмет настроен как доступный для настройки, он будет выглядеть так:

Это показывает, что предмет готов к настройке и зарезервирует 2 слота настройки, когда вы это сделаете. Если у предмета есть шанс быть настраиваемым, то будет написано «Attunable (40%)», если шанс успеха 40%. Определить это можно, попытавшись положить предмет в Нексус Настройки, который затем определит, настраиваемый он или нет. Это разовая проверка, и если предмет определён как ненастраиваемый, он будет вести себя как обычный предмет.

Если предмет настроен так, что настройка требуется перед использованием, то будет написано «Attunable (Required)». Это делает предмет непригодным для использования любым способом, пока он не настроен, включая ломание блоков, удары по врагам или использование предмета вроде натягивания лука или забрасывания удочки.

Чтобы начать процесс настройки, давайте построим Нексус Настройки. Стандартный рецепт:

Когда у вас есть Нексус Настройки, вы можете положить настраиваемый предмет в центральный слот. После этого вы увидите полезную информацию.

• Attunement Level: Текущий уровень настройки или «Ещё не настроено»
• Slots Reserved: Количество слотов, которое резервирует этот предмет при настройке.
• Players Attunement Slot information. Наведи курсор для подробностей.
• Level Cost: Количество уровней, расходуемых в процессе настройки.
• Level Threshold: Количество уровней, необходимое для запуска процесса настройки. Они не расходуются.
• Items Required: Предметы, необходимые для настройки
• Red Information Icon: Наведи курсор, чтобы узнать подробнее, почему ты не можешь запустить процесс настройки.

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

Если ты не можешь запустить процесс настройки, наведи курсор на красный значок информации слева от кнопки Attune.

Просмотр / управление настройками

Ты можешь просматривать и управлять своими текущими настройками в экране Manage Attunements. Его можно открыть из Attunement Nexus, нажав на шестерёнку в правом верхнем углу, или нажав назначенную клавишу (по умолчанию 'o').

После настройки до максимального уровня с алмазным мечом выше он будет выглядеть так:

Если хочешь узнать подробности о том, что каждый уровень настройки добавил предмету, наведи курсор на синий значок (i), чтобы получить больше информации:

Разрыв настроек

Чтобы разорвать настройку с предметом, наведи курсор на карточку предмета — справа появится красный X. Нажми на него и подтверди запрос, чтобы разорвать настройку.

Это уберёт все преимущества, полученные предметом при настройке, но сохранит все остальные характеристики предмета, например зачарования или изменения из других модов. Теперь предмет можно настроить на кого-то другого, и ты вернёшь себе слоты настройки, которые предмет резервировал. Это нельзя отменить.

Обзор систем

Система настройки

Artifactory добавляет новый атрибут: слоты настройки. Когда предмет настроен как настраиваемый, ты можешь указать, сколько слотов настройки этот предмет резервирует после настройки. Сюда может входить и резервирование нуля слотов, чтобы предмет можно было свободно настроить без влияния на лимит слотов. Если у тебя нет необходимого количества свободных слотов для настройки предмета, то предмет нельзя настроить, пока не освободятся места — это можно сделать, разорвав настройки с другими предметами или найдя способ увеличить этот атрибут. Процесс настройки также может требовать предметы или уровни опыта, которые расходуются при завершении настройки.

Система улучшений

Настройка предмета даёт весёлые и мощные преимущества. По мере укрепления связи эти преимущества тоже растут. 

Когда ты настраиваешь предмет впервые, он зарезервирует количество слотов настройки, указанное в конфигурации, а ты получишь все преимущества первого уровня настройки этого предмета. Если настроено больше уровней, ты можешь повышать эту связь, чтобы получать преимущества, заданные для этих уровней. Сейчас этими преимуществами могут быть:

Изменения Artifactory:

• Invulnerable: Предмет больше нельзя уничтожить воздействием окружения, например лавой или кактусом. Он также никогда не исчезнет, если его выбросить на землю.
• Unbreakable: Если у предмета есть прочность, он станет неразрушимым.
• Soulbound: Когда ты умрёшь, предмет отправится с тобой сквозь смерть.

Изменения атрибутов:

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

Система ограничений

Настраиваемый предмет можно настроить так, что его ОБЯЗАТЕЛЬНО нужно настроить, прежде чем его можно будет хоть как-то использовать, либо он может использоваться как обычно, а настройка просто даёт дополнительные преимущества. Если предмет обязательно должен быть настроен перед использованием, то он не может наносить урон, ломать блоки или использоваться любым способом, например для натягивания лука, пока не будет настроен на тебя.

Настроенные предметы не могут использоваться другими игроками ни в каком качестве — это лишь показывает принадлежность владельцу. Кроме того, ты можешь добавить эффекты, применяемые к игрокам, когда они держат настроенный предмет, который им не принадлежит. Скажем, замедление 3, отравление 1 и / или иссушение 100 — решать тебе. 

Настройка датапака

Давайте изменим стандартную конфигурацию настройки алмазного меча в датапаке. Сначала создайте новый датапак и новый файл data/minecraft/artifactory/diamond_sword.json и добавьте в него следующее содержимое: 

{
  "slots_used": 4,
  "attunement_levels": [
    {
      "modifications": [
        "invulnerable",
        "unbreakable",
        "attribute/minecraft:generic.attack_damage/addition/5/mainhand"
      ],
      "requirements": {
        "items": ["minecraft:diamond_sword", "minecraft:diamond#10", "minecraft:nether_star"]
      }
    },
    {
      "modifications": [
        "soulbound",
        "attribute/minecraft:generic.attack_speed/multiply_base/.5/mainhand",
        "attribute/minecraft:generic.attack_damage/addition/7/mainhand"
      ],
      "requirements": {
        "xpLevelsConsumed": 45,
        "xpLevelThreshold": 55,
        "items": ["minecraft:dragon_egg"]
      }
    }
  ],
  "use_without_attunement": false,
  "chance": 0.4,
  "replace": true
}

"slots_used"

Полуопционально — по умолчанию -1

Сколько слотов настройки занимает предмет при настройке. В этом примере алмазный меч займёт 4 ваших слота настройки. Если не указать это, то конфигурация настройки для этого предмета будет аннулирована, и предмет больше нельзя будет настроить. Так можно перезаписать и удалить информацию о настройке из другого датапака.

"use_without_attunement"

Опционально — по умолчанию true

Можно ли использовать предмет без предварительной настройки. false означает, что предмет не будет наносить урон, ломать блоки и его нельзя будет использовать, например, натянуть и выстрелить из лука, пока он не настроен. true означает, что предмет по-прежнему можно использовать как обычно, даже если он не настроен. Настройка просто даст дополнительные преимущества.

"chance"

Опционально — по умолчанию 1.0

Настройки, у которых значение не равно 1.0 (по умолчанию), теперь имеют шанс быть доступными для настройки, который определяется при первом помещении предмета в Attunement Nexus. Если вы установите "chance": 0.4, то предмет будет доступен для настройки только с шансом 40%. Когда вы впервые попытаетесь поместить предмет в Attunement Nexus, будет определено, доступен ли он для настройки. Это одноразовая проверка, и если она не пройдёт, этот предмет никогда не будет доступен для настройки.

"apply_to_items"

Опционально — по умолчанию пустой список

Это список строк с предметами, к которым нужно применить конфигурацию настройки. Если этот список существует и содержит предметы, то конфигурация настройки будет применена ко всем этим предметам. Это более быстрый способ добавить конфигурации нескольким предметам. Если в этом списке есть предметы, то имя json-файла игнорируется, и файл можно назвать как угодно. Чтобы использовать это, добавьте его в любой допустимый json конфигурации. Допустим, у нас была конфигурация для железной брони под названием iron_armors.json. В конце конфигурации вы бы добавили это:

"apply_to_items": [
  "minecraft:iron_boots",
  "minecraft:iron_chestplate",
  "minecraft:iron_leggings",
  "minecraft:iron_helmet"
]

Все предметы из этого списка (если они допустимы) получат эту конфигурацию. Убедитесь, что вы задали атрибуты как armor, hand, body или, что менее желательно, any если предметы находятся в разных слотах, иначе атрибуты не будут применяться корректно при их надевании, если у вас несколько типов брони. Впрочем, эти общие типы доступны только в 1.21 и выше, именно тогда Minecraft их добавил. Это ограничит функциональность данной возможности в 1.20.1, обычно вы сможете группировать только однотипные предметы, например шлемы. На данный момент это также не поддерживает теги. Опять же, если вы добавите это, имя json-файла будет игнорироваться, и конфигурации будут добавлены только к предметам из этого списка.

"replace"

Опционально — по умолчанию false

Должна ли текущая конфигурация заменить любые существующие конфигурации. Если вы попытаетесь создать новый json-файл для трезубца, он будет конфликтовать с тем, что я уже создал в своём моде. Чтобы указать, какой из них использовать, вам нужно установить "replace" в "true", чтобы он знал, что нужно использовать этот. Как создатель модпака, вы вполне можете добавить это во все свои конфиги, чтобы убедиться, что используются именно они. Если по какой-то причине вы используете мод, в конфигах которого уже есть "replace": "true", то вам нужно убедиться, что ваш датапак загружается ПОСЛЕ их, будет взят последний просмотренный конфиг с "replace".

"attunement_levels"

Опционально — по умолчанию один уровень настройки. Стоимость и порог уровня опыта для этого уровня настройки используют значения из конфига сервера, а при настройке он даёт 3 базовые модификации: invulnerable, unbreakable и soulbound. Атрибуты по умолчанию не включены. 

Здесь вы определяете, как выглядит каждый уровень настройки. Это делается по порядку, так что первый объект будет применяться для уровня настройки 1, второй для уровня настройки 2 и так далее. Пока что он состоит всего из 2 ключей: "modifications" и "requirements". "requirements" позволяет перезаписать требования из конфига сервера, чтобы вы могли настроить каждый уровень настройки индивидуально, а также добавить требования к предметам. "modifications" — это место, куда вы помещаете все модификации предмета, которые происходят при его настройке.

-"modifications"

Необязательно — по умолчанию применяются invulnerable, unbreakable и soulbound.

Есть 3 базовых модификации: invulnerable, unbreakable и soulbound.

Также есть модификации атрибутов, которые дают предмету атрибуты при достижении указанного уровня настройки. Они имеют формат

"attribute/modid:attributename/operation/value/equipmentslot".

operation может принимать 3 значения: addition, multiply_base, multiply_total.

equipmentslot может принимать одно из 9 значений: mainhand, offhand, hand, feet, legs, chest, head, body, armor, any.

ВНИМАНИЕ: в 1.20.1 нет типов hand, body, armor, any. Они были добавлены в minecraft 1.21.1

Значения operation и equipment slot — это конструкции ванильного minecraft, так что если у вас есть вопросы, лучше изучить их там подробнее. Здесь указывается, как атрибут применяется к существующему атрибуту и в каком слоте должен быть надет предмет, чтобы атрибут сработал. Убедитесь, что слот экипировки совпадает с типом предмета, с которым вы работаете. Если вы настраиваете шлем, обязательно используйте head, иначе атрибуты не применятся, когда вы его наденете.

Стоит отметить, что каждый раз, когда вы кладёте настроенный предмет в attunement nexus, он синхронизирует модификации с предметом, так что если в датапак были внесены изменения, всё, что вам нужно сделать — положить предмет в attunement nexus, и он обновит его с учётом изменений.

В примере JSON выше для первого уровня настройки у нас есть "attribute/minecraft:generic.attack_damage/addition/5/mainhand". Мы указываем модификацию attribute, увеличение атрибута minecraft attack damage на 5 и говорим применять его только когда предмет находится в mainhand. Поскольку мы настраиваем Diamond Sword, это добавит 5 урона, как только вы достигнете 1 уровня настройки с ним и будете использовать его в основной руке. Также видно, что в блоке 2 уровня настройки снова указан тот же атрибут, но со значением 7. Когда вы достигнете 2 уровня настройки, у вас будет в сумме 12 дополнительного урона атаки: 5 от 1 уровня настройки и 7 от 2 уровня. Также на 2 уровне даётся 50% бонус к базовой скорости атаки.

-"requirements"

Необязательно — если оставить пустым, будут использоваться значения из конфига сервера

Это позволяет перезаписать значения конфига для конкретного уровня: сколько уровней требуется, чтобы начать процесс настройки, и сколько расходуется при настройке. 

--"xpLevelsConsumed": сколько уровней расходуется для завершения процесса настройки

--"xpLevelThreshold": сколько уровней требуется, прежде чем процесс можно будет начать.

--"items": какие предметы, если вообще нужны, требуются для настройки. Берутся только первые 3 предмета в массиве. Они имеют формат "modid:item_name#numberOfItems". Количество предметов необязательно и по умолчанию равно 1, если не указано. Так что если вы хотите, чтобы для уровня настройки требовались nether star и 64 алмаза, вы укажете "items": ["minecraft:nether_star", "minecraft:diamond#64"].

Мы видим, что оба уровня настройки требуют предметы, а 2 уровень настройки перезаписывает значения xp из конфига сервера новыми значениями, которые применяются только при попытке настроиться на этот уровень. Это позволяет задавать требования более детально.

В итоге после достижения 2 уровня настройки предмет станет unbreakable, invulnerable, soulbound и даст 6 дополнительного урона атаки, а также будет использоваться только вами и никем больше. Вот как это будет выглядеть на 2 уровне настройки:

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

{ "slots_used": "1", "replace": true }

Если мы вместо этого по умолчанию применим это к алмазному мечу, то он создаст один уровень настройки, для которого требуются уровни опыта и порог опыта из конфигов сервера. Он займёт 1 слот настройки, и его можно использовать как обычный алмазный меч, даже если вы к нему не настроены, так что настройка необязательна. Когда вы настроены на него, вы не получаете никаких характеристик, но получаете преимущества, которые даёт настроенный предмет, например защиту от использования его другими игроками. Однако это всё, на что этот предмет можно настроить, и по умолчанию никакие атрибуты не добавляются. Это можно скомбинировать с use_without_attunement:false, чтобы предмет нужно было настроить для использования, но при этом он не даёт никаких других улучшений, кроме базовой защиты.

В последнем примере мы удалим конфигурацию настройки у предмета из другого датапака. Датапак по умолчанию, предоставляемый этим модом, делает настраиваемыми около 30 предметов, например алмазный меч. Если вы хотите сделать так, чтобы эти предметы нельзя было настроить, вам нужно перезаписать их в своём датапаке (или вообще не включать датапак при создании мира, что и является значением по умолчанию — его нужно добавлять вручную). Чтобы убрать возможность настройки трезубцев, поместите этот json-файл в свой датапак по пути data/minecraft/artifactory/trident.json:

{ "replace": "true }

Параметр replace указывает использовать эту конфигурацию вместо базовой, а отсутствие другой информации отключает эту настройку. Всегда используйте replace, если хотите, чтобы применялась эта конфигурация датапака, а не другая. Если при загрузке данных датапака найдётся больше одного JSON-файла с "replace": true, то будет использован последний загруженный.

Вы можете очень легко создавать настроенную броню или оружие и применять к этим предметам соответствующие атрибуты, например дополнительную броню для частей брони или урон атаки для мечей, или наоборот — решать вам. Если вы используете такую библиотеку, как apothic attributes, которую я настоятельно рекомендую, она даст вам кучу новых забавных атрибутов, которые тоже можно применять к предметам.

Переопределения настройки

Начиная с 1.21.1-2.0.0 (в обозримом будущем это не будут портировать обратно) вы можете задавать настройку для каждого отдельного стака предметов. Это позволяет сделать отдельный стак настраиваемым с собственными уровнями и улучшениями, уникальными только для этого стака. Это также переопределит любые конфигурации датапака для этого типа предметов.

Это делается путём задания дата-компонента при создании предмета — либо через /give, достижения, рецепты, таблицы лута, либо другими модами вроде kubejs. Есть много способов добавить дата-компоненты к предметам. Датапак по умолчанию не содержит конфигураций настройки для нового предмета булавы, так что давайте создадим стак булавы, который можно настроить. Выполните эту команду в игре

/give @p minecraft:mace[artifactory:attunement_override={use_without_attunement:false,chance:0.5, slots_used:5, attunement_levels:[{requirements: {items:["minecraft:diamond#64"]},modifications:[invulnerable, unbreakable, soulbound]}]}]

Эта команда выдаёт булаву с реализованным дата-компонентом attunement_override. После выполнения команды у вас есть булава с 50% шансом быть настраиваемой, занимающая 5 слотов при настройке, требующая 64 алмаза и дающая invulnerable, unbreakable и soulbound после настройки. Этот стак уникален и является единственным, содержащим такую конфигурацию настройки. Если у булавы из minecraft уже были конфигурации настройки, заданные через датапак, это тоже переопределит их, и будет использоваться конфигурация, указанная в команде. Это позволит вам создавать единичные предметы, которые ведут себя иначе, чем другие.

Curios

Если у вас установлен Curios, то добавится новый слот — слот настроенного предмета. Сюда можно помещать только предметы, к которым вы настроены, и никакие атрибуты за помещение в слот не выдаются. Его можно использовать для хранения настроенных предметов, которыми вы не пользуетесь, чтобы быстро их менять. Если предмет Soulbound, он также останется в этом слоте после смерти.

Если вы хотите настроить параметры по умолчанию, вам нужно перезаписать их с помощью датапака. Если вы хотите изменить количество доступных слотов (по умолчанию 1), вам нужно перезаписать файл data/artifactory/curios/slots/attuned_item.json:

{
  "replace": true,
  "order": 1999,
  "size": 1,
  "render_toggle": false,
  "icon": "artifactory:slot/artifactory_slot"
}

Меняйте любые из них, как захотите, но size — тот, который нужно изменить, чтобы добавить больше слотов.

Применение

Вот несколько примеров вариантов использования, для которых я буду применять это в своём модпаке.

• Создать весёлую систему привязки к оружию и развития этой связи с получением крутых, полностью настраиваемых преимуществ!
• Ограничить слишком мощные предметы. Многие моды добавляют предметы, которые очень весёлые, но слишком мощные. Это становится особенно заметно, когда игрок накапливает слишком много таких предметов, и бой, исследование или путешествия в minecraft становятся тривиальными из-за наличия у него эндгейм-предметов из нескольких модов. В этот момент можно просто играть в креативе. Я хотел систему, которая позволяла бы таким эндгейм/желанным предметам существовать, но делала бы их сложнее получить, чтобы игрокам приходилось выбирать, какие из этих предметов они могут использовать в данный момент. Чем мощнее предмет, тем больше слотов настройки он может занимать, заставляя вас выбирать между большим количеством отдельных, но менее мощных предметов или несколькими более мощными. Это отлично сочетается с мифическим оружием из Simply Swords.
• Сделать предметы более старых тиров / менее мощные более желанными. Теперь вместо того, чтобы избавиться от своего железного меча в пользу алмазного, вы можете настроить железный меч и получить особые бонусы по мере укрепления связи с ним. По мере повышения уровней настройки он может получить больше урона и скорости атаки, а также стать неразрушимым и привязанным к душе. Наложите несколько зачарований — и вы сможете создать очень мощный предмет! Алмазные мечи тоже могут быть настраиваемыми, но получать разные бонусы на разных уровнях, либо вообще не быть настраиваемыми. Это создаёт интересную экономику предметов, придаёт ценность разным тирам предметов и даёт больше возможностей для балансировки создателям модпаков.

Возможные будущие расширения

• Больше уникальных модификаций наряду с Soulbound / Invulnerable / Unbreakable.
• Модификации эффектов — при ношении или удержании предмета на игрока будут накладываться указанные эффекты.
• Добавить больше уникальных требований для настройки и усиления настройки предмета. Например, количество убийств при ношении / использовании предмета, убийство определённых боссов, совершение определённых подвигов, наличие предмета при себе в течение определённого времени и т. д.

Оставляйте любые комментарии, вопросы, предложения, если хотите! Если у вас возникли проблемы, я предпочёл бы, чтобы вы создали issue в репозитории на github с как можно большим количеством информации, но вопрос здесь тоже подойдёт. Artifactory Issues

FAQ

В: Вы сделаете это для Fabric?

О: Я не буду портировать на Fabric, но любой желающий может это сделать! Для Forge я пока буду поддерживать только 1.20.1, а в дальнейшем портирую это на NeoForge для 1.21. После этого я останусь на NeoForge, у меня нет времени управлять слишком многими разными версиями этого мода.

В: Вы портируете это на старые версии Minecraft?

О: Если это не вызовет большого интереса, я буду разрабатывать только для 1.20.1 и новее.

В: Могу ли я использовать это на своём сервере или в модпаке?

О: Конечно!

Устаревшие функции