• 26.2
• 26.1.2
• 1.21.11
• 1.21.10
• 1.21.8
• 1.21.4
• 1.21.1
• 1.20.4

Типи шкоди

Навчіться додавати власні типи шкоди.

WARNING

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

Типи шкоди визначають типи шкоди, яку можуть отримати сутності. Починаючи з 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 Wiki, щоб дізнатися про всі можливі ключі та значення.

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

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

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

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

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

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

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

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

DamageSource damageSource = new DamageSource(
		world.registryAccess()
				.lookupOrThrow(Registries.DAMAGE_TYPE)
				.get(ExampleModDamageTypes.TATER_DAMAGE.location()).get()
);

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

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

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

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

	@Override
	public void stepOn(Level world, BlockPos pos, BlockState state, Entity entity) {
		if (entity instanceof LivingEntity && world instanceof ServerLevel serverWorld) {
			DamageSource damageSource = new DamageSource(
					world.registryAccess()
							.lookupOrThrow(Registries.DAMAGE_TYPE)
							.get(ExampleModDamageTypes.TATER_DAMAGE.location()).get()
			);
			entity.hurtServer(serverWorld, 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 Wiki, щоб отримати повний список теґів типу шкоди.

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

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

data/minecraft/tags/damage_type/bypasses_armor.json

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

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

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