사용자 지정 갑옷

갑옷은 몹과 다른 플레이어의 공격으로부터 플레이어에게 추가적인 방어력을 제공합니다.

갑옷 재료 클래스 만들기

기술적으로, 갑옷 재료를 위해 새로운 클래스를 필수적으로 만들어야 하는 것은 아니지만, 필요한 정적 필드를 고려했을 때 좋은 습관이라고 할 수 있습니다.

예제에서는, GuiditeArmorMaterial 클래스에 정적 필드를 저장합니다.

기본 내구도

이 상수 값은 갑옷 아이템을 추가할 때 Item.Properties#maxDamage(int damageValue) 메소드에 사용됩니다. 이후 ArmorMaterial 객체를 생성할 때 생성자의 매개 변수에도 입력해야 합니다.

public static final int BASE_DURABILITY = 15;

균형 잡힌 내구성을 결정하는 것이 어렵다면, ArmorMaterials 인터페이스를 통해 찾을 수 있는 바닐라 갑옷 재료 인스턴스를 참고해 보아도 됩니다.

장비 어셋 레지스트리 키

굳이 ArmorMaterial을 다른 레지스트리에 등록할 필요까진 없지만, 레지스트리 키를 상수 필드로 가지는 것은 좋은 습관입니다. 게임이 갑옷에 맞는 텍스처를 찾을 때 사용할 수 있기 때문입니다.

public static final ResourceKey<EquipmentAsset> GUIDITE_ARMOR_MATERIAL_KEY = ResourceKey.create(EquipmentAssets.ROOT_ID, ResourceLocation.fromNamespaceAndPath(FabricDocsReference.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	레지스트리 키는 나중에 ArmorMaterial 생성자에 입력할 것입니다.

매개 변수의 값을 결정하는 것이 어렵다면, 위에서 언급한 것 처럼 ArmorMaterials 인터페이스에 있는 바닐라 ArmorMaterial 인스턴스를 참고할 수 있습니다.

갑옷 아이템 추가하기

이제 재료를 등록했으니, ModItems 클래스에 갑옷 아이템을 추가할 수 있습니다:

물론, 모든 종류의 갑옷을 만들 필요는 없습니다. 부츠나 레깅스만 있어도 되죠. 거북 등딱지는 투구만 있기 때문에, 이러한 상황의 좋은 예시라고 할 수 있습니다.

ToolMaterial과는 다르게, ArmorMaterial은 아이템의 내구도에 대한 정보는 저장되지 않습니다. 때문에 갑옷 아이템을 등록할 때 Item.Properties에 직접 기본 내구도를 입력해야 합니다.

이전에 생성해 두었던 BASE_DURABILITY 상수 필드를 Item.Properties#maxDamage에 입력하여 내구도를 설정할 수 있습니다.

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

public static final Item GUIDITE_LEGGINGS = register(
		"guidite_leggings",
		settings -> new ArmorItem(GuiditeArmorMaterial.INSTANCE, ArmorType.LEGGINGS, settings),
		new Item.Properties().durability(ArmorType.LEGGINGS.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);

public static final Item GUIDITE_BOOTS = register(
		"guidite_boots",
		settings -> new ArmorItem(GuiditeArmorMaterial.INSTANCE, ArmorType.BOOTS, settings),
		new Item.Properties().durability(ArmorType.BOOTS.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);

추가한 갑옷을 크리에이티브 보관함에서 찾으려면 아이템을 아이템 그룹에 추가해야 합니다.

모든 아이템이 그렇듯, 번역 키도 추가해야 합니다.

텍스처와 모델

아이템에 사용할 텍스쳐와 더불어, "인간형" 개체(플레이어, 좀비, 스켈레톤 등)가 갑옷을 착용했을 때 보여질 실제 텍스쳐도 추가해야 합니다.

아이템 텍스처와 모델

이 텍스처는 다른 아이템과 마찬가지로, 첫 번째 아이템 만들기에서 설명한 것 처럼 텍스처를 만들고, 기본 아이템 모델을 만들어야 합니다.

예제에서는, 아래 텍스처와 JSON 모델을 사용하겠습니다.

아이템 텍스처 다운로드

INFO

헬멧 뿐만 아니라, 모든 아이템에 대한 JSON 모델 파일을 만들어야 합니다. 다른 아이템 모델에도 똑같이 적용됩니다.

{
  "parent": "minecraft:item/generated",
  "textures": {
    "layer0": "fabric-docs-reference:item/guidite_helmet"
  }
}

보시다시피, 인게임에서 방어구 아이템은 적절한 모델을 가져야 합니다.

갑옷 텍스처

개체가 갑옷을 착용하더라도, 아무것도 보이지 않을 것입니다. 착용 모델 정의와 텍스처가 없기 때문입니다.

갑옷 텍스처는 두 가지 레이어로 이루어지며, 두 레이어 모두 존재해야 합니다.

위에서 ArmorMaterial 생성자에 입력했던 ResourceKey<EquipmentAsset> 필드 GUIDITE_ARMOR_MATERIAL_KEY를 사용할 때입니다. 재료와 비슷한 이름으로 설정하는 것이 좋기 때문에, 예제에서는 guidite.png로 설정합니다.

• assets/mod_id/textures/entity/equipment/humanoid/guidite.png - 상의와 부츠 텍스처가 저장됩니다.
• assets/mod_id/textures/entity/equipment/humanoid_leggings/guidite.png - 레깅스의 텍스처가 저장됩니다.

Guidite 갑옷 모델 텍스처 다운로드

TIP

모드를 1.21.4로 업데이트하고 있다면, humanoid 폴더는 layer0.png 갑옷 텍스처, humanoid_leggings 폴더는 layer1.png 갑옷 텍스처가 저장된다고 할 수 있습니다.

이제, 착용 모델 정의를 만들 차례입니다. assets/mod_id/equipment 폴더에 추가할 것입니다.

위에서 생성했던 ResourceKey<EquipmentAsset> 상수가 JSON 파일의 이름을 결정하게 됩니다. 예제에서는, guidite.json입니다.

예제에서는 "인간형" 갑옷(헬멧, 흉갑, 레깅스, 부츠 등)만 추가했기 때문에, 모델 정의는 다음과 같은 형태로 이루어집니다:

{
  "layers": {
    "humanoid": [
      {
        "texture": "fabric-docs-reference:guidite"
      }
    ],
    "humanoid_leggings": [
      {
        "texture": "fabric-docs-reference:guidite"
      }
    ]
  }
}

텍스처와 착용 모델 정의를 모두 추가했다면, 개체가 갑옷을 착용하면 다음과 같이 보일 것입니다: