Типи шкоди

Типи шкоди визначають яку шкоду, яку можуть отримати сутності. Починаючи з Minecraft 1.19.4, з'явилося створення нових типів шкоди стають керованими даними, тобто вони створюються за допомогою файлів JSON.

Створення типу шкоди

Створімо спеціальний тип шкоди під назвою Tater. Почнімо з того, що створимо JSON файл для вашого типу шкоди. Цей файл буде розміщено в каталозі data вашого мода, у підкаталозі з назвою damage_type.

resources/data/example-mod/damage_type/tater.json

Він має таку структуру:

{
  "exhaustion": 0.1,
  "message_id": "tater",
  "scaling": "when_caused_by_living_non_player"
}

Цей спеціальний тип шкоди збільшує 0,1 виснаження від голоду кожного разу, коли гравець отримує шкоду від живого джерела, проте не є гравцем (наприклад, блоком). Крім того, сума завданої шкоди буде збільшуватися зі складністю у світі

INFO

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

Доступ до типів шкоди за допомогою коду

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

ResourceKey можна отримати таким чином:

public static final ResourceKey<DamageType> TATER_DAMAGE = ResourceKey.create(Registries.DAMAGE_TYPE, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "tater"));

Використання типів шкоди

Щоб продемонструвати використання власних типів шкоди, ми використаємо власний блок, нехай це буде Tater Block. Зробімо так, що коли жива сутність наступає на Tater Block, вона отримує тип шкоди Tater.

Ви можете перевизначити stepOn, щоб завдати цієї шкоди.

Ми починаємо зі створення DamageSource нашого спеціального типу шкоди.

DamageSource damageSource = new DamageSource(
		level.registryAccess()
				.lookupOrThrow(Registries.DAMAGE_TYPE)
				.get(ExampleModDamageTypes.TATER_DAMAGE.identifier()).get()
);

Потім ми викликаємо entity.damage() з нашим DamageSource і сумою.

entity.hurtServer(serverLevel, damageSource, 5.0f);

Повна реалізація блока:

public class TaterBlock extends Block {
	public TaterBlock(Properties settings) {
		super(settings);
	}

	@Override
	public void stepOn(Level level, BlockPos pos, BlockState state, Entity entity) {
		if (entity instanceof LivingEntity && level instanceof ServerLevel serverLevel) {
			DamageSource damageSource = new DamageSource(
					level.registryAccess()
							.lookupOrThrow(Registries.DAMAGE_TYPE)
							.get(ExampleModDamageTypes.TATER_DAMAGE.identifier()).get()
			);
			entity.hurtServer(serverLevel, damageSource, 5.0f);
		}
	}
}

Тепер щоразу, коли жива істота наступає на наш спеціальний блок, вона отримує 5 шкоди (2,5 серця), нашим типом шкоди.

Власне повідомлення про смерть

Ви можете визначити повідомлення про смерть для типу шкоди у форматі death.attack.message_id у нашому файл en_us.json (це англійська, для української створіть uk_ua.json) мода.

{
  "death.attack.tater": "%1$s died from Tater damage!"
}

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

Теґи типу шкоди

Деякі типи шкоди можуть обійти обладунки, ефекти моба тощо. Теґи використовуються для керування такими властивостями типів шкоди.

Ви можете знайти наявні теґи типу шкоди в data/minecraft/tags/damage_type.

INFO

Зверніться до Вікі Minecraft, щоб отримати повний список теґів типу шкоди.

Додамо наш тип шкоди Tater до теґу типу шкоди bypasses_armor.

Щоб додати наш тип шкоди до одного з цих теґів, ми створюємо файл JSON у просторі імен minecraft.

data/minecraft/tags/damage_type/bypasses_armor.json

З таким змістом:

{
  "values": [
    "example-mod:tater"
  ]
}

Переконайтеся, що ваш теґ не замінює наявний теґ, встановивши для ключа replace значення false.