Собственные интерактивные предметы

Базовые предметы могут зайти так далеко, что вы можете добавить предмет, который имеет интерактивность с миром при использовании.

Есть несколько ключевых классов которые вы должны понять, прежде чем будете рассматривать события с ванильными предметами.

InteractionResultHolder

Для предметов более распространённым InteractionResultHolder является ItemStacks - этот класс говорит игре, что нужно заменять (или не заменять) после того, как событие произошло.

Если в событие ничего не произошло, вам нужно будет использовать метод InteractionResultHolder#pass(stack), где stack это текущий стек предметов.

Вы можете получить текущий стек предметов, получая стек из руки игрока. Обычно события, требующие InteractionResultHolder, передают эту функцию методу события.

InteractionResultHolder.pass(user.getStackInHand(hand))

Если вы передадите текущий стек, тогда ничего не изменится, независимо от того, объявите ли вы событие неудавшимся, прошедшим/проигнорируемым или успехом.

Если вы хотите удалить текущий стек, вам следует передать пустой. То же самое сказать про уменьшение, вы извлекаете текущий стек и уменьшаете его на количество которое вы хотите:

ItemStack heldStack = user.getStackInHand(hand);
heldStack.decrement(1);
InteractionResultHolder.success(heldStack);

InteractionResult

Аналогичным образом, InteractionResult говорит игре статус события, не смотря было ли оно пройдено/проигнорированно, неудачно или успешно.

Переопределяемые события

К счастью, класс предмета имеет множество методам, которые можно переопределить, чтобы добавить дополнительную функциональность вашим предметам.

INFO

Отличный пример использование этих событие вы можете найти на странице Воспроизведение SoundEvents, где событие useOn воспроизводит звук когда игрок кликает правой кнопкой мыши по блоку.

Метод	Информация
hurtEnemy	Вызывается когда игрок, ударяет сущность.
mineBlock	Вызывается когда игрок, ломает блок.
inventoryTick	Вызывается каждый тик когда предмет находится в инвентаре.
onCraftedPostProcess	Вызывается когда предмет, создаётся.
useOn	Вызывается когда игрок кликает правой кнопкой мыши предметом на блок.
use	Вызывается когда игрок кликает правой кнопкой мыши предметом.

Событие use()

Допустим, что вы хотите сделать предмет, который вызывает молнию перед игроком, вам нужно будет создать отдельный класс.

public class LightningStick extends Item {
	public LightningStick(Properties settings) {
		super(settings);
	}

}

Событие use, вероятно, самое полезное из всех, вы можете использовать это событие, чтобы призвать молнию, вы должны создать её перед игроками в 10 блоков от направления.

@Override
public InteractionResultHolder<ItemStack> use(Level world, Player user, InteractionHand hand) {
	// Ensure we don't spawn the lightning only on the client.
	// This is to prevent desync.
	if (world.isClientSide) {
		return InteractionResultHolder.pass(user.getItemInHand(hand));
	}

	BlockPos frontOfPlayer = user.blockPosition().relative(user.getDirection(), 10);

	// Spawn the lightning bolt.
	LightningBolt lightningBolt = new LightningBolt(EntityType.LIGHTNING_BOLT, world);
	lightningBolt.setPos(frontOfPlayer.getCenter());
	world.addFreshEntity(lightningBolt);

	// Nothing has changed to the item stack,
	// so we just return it how it was.
	return InteractionResultHolder.success(user.getItemInHand(hand));
}

Как обычно, вам необходимо зарегистрировать свой предмет, добавьте модель и текстуру.

Как видите, молния должна появиться в 10 блоках перед вами, игроком.