• 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.

{
  // ...
  "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.