Власні обладунки 1.21.11

Навчіться створювати власні обладунки.

WARNING

Ця сторінка написана для версії 1.21.11. Документація для старіших версій може бути неповною.

Обладунки забезпечує гравцеві підвищений захист від атак мобів та інших гравців.

Створення класу матеріалів обладунків

Технічно вам не потрібен спеціальний клас для вашого матеріалу обладунку, але це все одно хороша практика з кількістю статичних полів, які вам знадобляться.

Для цього прикладу ми створимо клас GuiditeArmorMaterial для зберігання наших статичних полів.

Основна міцність

Ця константа буде використовуватися в методі Item.Properties#maxDamage(int damageValue) під час створення наших предметів обладунків, вона також потрібна як параметр у конструкторі ArmorMaterial, коли ми створимо наш об’єкт ArmorMaterial пізніше.

public static final int BASE_DURABILITY = 15;

Якщо вам важко визначити збалансовану базову міцність, ви можете звернутися до екземплярів матеріалу обладунків усталеного кольору, знайденого в інтерфейсі ArmorMaterials.

Ключ реєстру активів обладнання

Попри те, що нам не потрібно реєструвати наш ArmorMaterial в жодних реєстрах, загалом добре зберігати будь-які ключі реєстру як константи, оскільки гра використовуватиме це для пошуку відповідних текстур для наших обладунків.

public static final ResourceKey<EquipmentAsset> GUIDITE_ARMOR_MATERIAL_KEY = ResourceKey.create(EquipmentAssets.ROOT_ID, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "guidite"));

Пізніше ми передамо це конструктору ArmorMaterial.

Екземпляр ArmorMaterial

Щоб створити наш матеріал, нам потрібно створити новий екземпляр запису ArmorMaterial, тут використовуватимуться базова міцність і константи ключа реєстру матеріалів.

public static final ArmorMaterial INSTANCE = new ArmorMaterial(
		BASE_DURABILITY,
		Map.of(
				ArmorType.HELMET, 3,
				ArmorType.CHESTPLATE, 8,
				ArmorType.LEGGINGS, 6,
				ArmorType.BOOTS, 3
		),
		5,
		SoundEvents.ARMOR_EQUIP_IRON,
		0.0F,
		0.0F,
		REPAIRS_GUIDITE_ARMOR,
		GUIDITE_ARMOR_MATERIAL_KEY
);

Конструктор ArmorMaterial приймає такі параметри в такому конкретному порядку:

Параметр	Опис
durability	Базова міцність усіх частин обладунків, вона використовується при розрахунку загальної міцності кожної окремої частини обладунків, для якої використовується цей матеріал. Це має бути базова константа міцності, яку ви створили раніше.
defense	Мапування EquipmentType (переліку, що представляє кожен слот для обладунків) на ціле значення, яке вказує на захисну цінність матеріалу при використанні у відповідному слоті для обладунків.
enchantmentValue	«Зачаровуваність» предмета обладунків, які використовують цей матеріал.
equipSound	Запис у реєстрі звукової події, яка відтворюється, коли ви одягаєте частину обладунків, яка використовує цей матеріал. Щоб дізнатися більше про звуки, перегляньте сторінку власних звуків.
toughness	Рухоме значення, яке представляє атрибут «міцности обладунків» матеріалу обладунків — по суті, наскільки добре обладунки поглинають шкоду.
knockbackResistance	Рухоме значення, яке представляє ступінь стійкості до відкидання, який матеріал обладунків надає власнику.
repairIngredient	Теґ предмета, який представляє всі предмети, які можна використовувати для лагодження предметів обладунків з цього матеріалу в ковадлі.
assetId	Ключ реєстру EquipmentAsset, це має бути константа ключа реєстру активів обладнання, яку ви створили раніше.

Ми визначаємо посилання на теґ компонента лагодження таким чином:

public static final TagKey<Item> REPAIRS_GUIDITE_ARMOR = TagKey.create(BuiltInRegistries.ITEM.key(), Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "repairs_guidite_armor"));

Якщо вам важко визначити значення для будь-якого з параметрів, ви можете проконсультуватися з екземплярами ArmorMaterial, які можна знайти в інтерфейсі ArmorMaterials.

Створення предмету обладунків

Тепер, коли ви зареєстрували матеріал, ви можете створювати предмети обладунків у своєму класі ModItems:

Очевидно, що комплект обладунків не потребує кожного типу, щоб бути задоволеним, ви можете мати комплект із лише чоботами, наголінниками тощо. Панцир черепахи (шолом) є гарним прикладом комплекту обладунків з відсутніми слотами.

На відміну від ToolMaterial, ArmorMaterial не зберігає жодної інформації про міцність предметів. З цієї причини базову міцність потрібно вручну додати до Item.Properties елементів обладунків під час їх реєстрації.

Це досягається шляхом передачі створеної нами раніше константи BASE_DURABILITY в метод maxDamage у класі Item.Properties.

public static final Item GUIDITE_HELMET = register(
		"guidite_helmet",
		Item::new,
		new Item.Properties().humanoidArmor(GuiditeArmorMaterial.INSTANCE, ArmorType.HELMET)
				.durability(ArmorType.HELMET.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);
public static final Item GUIDITE_CHESTPLATE = register("guidite_chestplate",
		Item::new,
		new Item.Properties().humanoidArmor(GuiditeArmorMaterial.INSTANCE, ArmorType.CHESTPLATE)
				.durability(ArmorType.CHESTPLATE.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);

public static final Item GUIDITE_LEGGINGS = register(
		"guidite_leggings",
		Item::new,
		new Item.Properties().humanoidArmor(GuiditeArmorMaterial.INSTANCE, ArmorType.LEGGINGS)
				.durability(ArmorType.LEGGINGS.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);

public static final Item GUIDITE_BOOTS = register(
		"guidite_boots",
		Item::new,
		new Item.Properties().humanoidArmor(GuiditeArmorMaterial.INSTANCE, ArmorType.BOOTS)
				.durability(ArmorType.BOOTS.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);

Вам також потрібно буде додати предмети до вкладок творчості, якщо ви хочете, щоб вони були доступні з інвентарю.

Як і для всіх предметів, для них також слід створити ключі перекладу.

Текстура і модель

Вам потрібно буде створити набір текстур для предметів і набір текстур для фактичних обладунків, коли її носить «гуманоїдна» сутність (гравці, зомбі, скелети тощо).

Модель і текстура предмета

Ці текстури нічим не відрізняються від інших предметів — ви повинні створити текстури та створити загальну згенеровану модель предмета, про що йдеться в створення вашого першого предмета.

Для прикладу ви можете використовувати наведені нижче текстури та модель JSON як еталон.

Завантажити Текстура предмета

INFO

Вам знадобляться файли моделі JSON для всіх предметів, а не лише для шолома, це той самий принцип, що й інші моделі предметів.

{
  "parent": "minecraft:item/generated",
  "textures": {
    "layer0": "example-mod:item/guidite_helmet"
  }
}

Як бачите, в грі предмети обладунків повинні мати відповідні моделі:

Текстура обладунків

Коли сутність носить ваші обладунки, нічого не буде показано. Це тому, що вам не вистачає текстур і визначень моделі обладнання.

Є два шари для текстури обладунків, обидва повинні бути присутніми.

Раніше ми створили константу ResourceKey<EquipmentAsset> під назвою GUIDITE_ARMOR_MATERIAL_KEY, яку ми передали в наш конструктор ArmorMaterial. Рекомендується так само назвати текстуру, тому в нашому випадку це guidite.png

• assets/example-mod/textures/entity/equipment/humanoid/guidite.png — містить текстури верхньої частини тіла та чоботів.
• assets/example-mod/textures/entity/equipment/humanoid_leggings/guidite.png — містить текстури наголінників.

Завантажити Текстури моделі обладунків Guidite

TIP

Якщо ви оновлюєте старішу версію гри до 1.21.11, у теці humanoid буде ваша текстура обладунків layer0.png, а в теці humanoid_leggings — ваша текстура обладунків layer1.png.

Далі вам потрібно буде створити пов’язане визначення моделі обладнання. Вони знаходяться в теці /assets/example-mod/equipment/.

Константа ResourceKey<EquipmentAsset>, яку ми створили раніше, визначатиме назву файлу JSON. У цьому випадку це буде guidite.json.

Оскільки ми плануємо додати лише «гуманоїдні» (шолом, нагрудник, наголінники, чоботи тощо) обладунків, наше визначення моделі обладнання виглядатиме так:

{
  "layers": {
    "humanoid": [
      {
        "texture": "example-mod:guidite"
      }
    ],
    "humanoid_leggings": [
      {
        "texture": "example-mod:guidite"
      }
    ]
  }
}

З наявністю текстур і визначення моделі спорядження ви зможете бачити свої обладунки на сутностях, які її носять: