Власні інтерактивні предмети

Базові предмети можуть зайти лише так далеко - зрештою вам знадобиться предмет, який взаємодіє зі світом, коли його використовують.

Є кілька ключових класів, які ви повинні зрозуміти, перш ніж дивитися на події ванілльних предметів.

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 повідомляє грі статус події, незалежно від того, чи була вона пройдена/проігнорована, невдала чи успішна.

Перевизначені події

На щастя, у класі Item є багато методів, які можна замінити, щоб додати до ваших предметів додаткові функції.

INFO

Чудовий приклад використання цих подій можна знайти на сторінці відтворення звукових подій, яка використовує подію useOn для відтворення звуку, коли гравець натискає ПКМ по блоку.

Метод	Інформація
hurtEnemy	Запускається, коли гравець влучає в сутність.
mineBlock	Запускається, коли гравець видобуває блок.
inventoryTick	Запускається кожного такту, поки предмет був в інвентарі.
onCraftedPostProcess	Запускається, коли предмет створено.
onCraftedPostProcess	Виконується, коли гравець натискає ПКМ по блоку предметом.
use	Запускається, коли гравець натискає ПКМ по блоку предметом.

Подія use()

Скажімо, ви хочете створити предмет, який викликає блискавку перед гравцем – вам потрібно буде створити спеціальний клас.

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

}

Подія використання є, мабуть, найкориснішою з усіх - ви можете використовувати цю подію, щоб створити нашу блискавку, вам слід створити її за 10 блоків перед гравцями, спрямованими обличчям.

@Override
public InteractionResult 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 InteractionResult.PASS;
	}

	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);

	return InteractionResult.SUCCESS;
}

Як зазвичай, вам слід зареєструвати свою річ, додати модель і текстуру.

Як бачите, блискавка повинна створитися в 10 блоках від вас - гравцем.