Ефекти моба

Ефекти моба, також відомі як ефекти статусу або просто ефекти, є станом, який може вплинути на сутність. Вони можуть бути позитивні, негативні або нейтральні. Базова гра застосовує ці ефекти різними способами, такими як їжа, зілля тощо.

Команда /effect може бути використана для застосування ефектів до сутності.

Власні ефекти моба

Тут ми додамо новий спеціальний ефект під назвою Tater, який дає вам одне очко досвіду за кожен ігровий такт.

Розширення MobEffect

Створімо спеціальний клас ефекту, розширивши MobEffect, який є базовим класом для всіх ефектів.

public class TaterEffect extends MobEffect {
	protected TaterEffect() {
		// category: StatusEffectCategory - describes if the effect is helpful (BENEFICIAL), harmful (HARMFUL) or useless (NEUTRAL)
		// color: int - Color is the color assigned to the effect (in RGB)
		super(MobEffectCategory.BENEFICIAL, 0xe9b8b3);
	}

	// Called every tick to check if the effect can be applied or not
	@Override
	public boolean shouldApplyEffectTickThisTick(int duration, int amplifier) {
		// In our case, we just make it return true so that it applies the effect every tick
		return true;
	}

	// Called when the effect is applied.
	@Override
	public boolean applyEffectTick(ServerLevel level, LivingEntity entity, int amplifier) {
		if (entity instanceof Player) {
			((Player) entity).giveExperiencePoints(1 << amplifier); // Higher amplifier gives you experience faster
		}

		return super.applyEffectTick(level, entity, amplifier);
	}
}

Реєстрація вашого власного ефекту

Подібно до реєстрації блоків і предметів, ми використовуємо Registry.register для реєстрації нашого власного ефекту в реєстрі MOB_EFFECT. Це можна зробити в нашому ініціалізаторі.

public class ExampleModEffects implements ModInitializer {
	public static final Holder<MobEffect> TATER =
			Registry.registerForHolder(BuiltInRegistries.MOB_EFFECT, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "tater"), new TaterEffect());

	@Override
	public void onInitialize() {
		// ...
	}
}

Текстура

Значок ефекту моба — це PNG розміром 18x18, який з’явиться на екрані інвентарю гравця. Розмістіть ваш значок у:

resources/assets/example-mod/textures/mob_effect/tater.png

Завантажити Приклад текстури

Переклади

Як і будь-який інший переклад, ви можете додати запис із форматом ID "effect.example-mod.effect-identifier": "Value" до мовного файлу.

{
  "effect.example-mod.tater": "Tater"
}

Застосування ефекту

Варто поглянути на те, як ви зазвичай застосовуєте ефект до сутності.

TIP

Для швидкого тестування краще використати згадану раніше команду /effect:

effect give @p example-mod:tater

Щоб застосувати внутрішній ефект, потрібно використати метод LivingEntity#addEffect, який приймає MobEffectInstance і повертає логічне значення, яке вказує, чи було успішно застосовано ефект.

var instance = new MobEffectInstance(ExampleModEffects.TATER, 5 * 20, 0, false, true, true);
entity.addEffect(instance);

Аргумент	Тип	Опис
effect	Holder<MobEffect>	Голдер, який представляє ефект.
duration	int	Тривалість ефекту в тактах; не секунд
amplifier	int	Підсилювач до рівня ефекту. Він не відповідає рівню ефекту, а додається зверху. Отже, amplifier 4 => рівень 5
ambient	boolean	Це складно. Це в основному вказує, що ефект був доданий середовищем (наприклад, маяк) і не має прямої причини. Якщо true, значок ефекту в HUD буде показане накладення водянистого кольору.
particles	boolean	Чи слід показувати частинки.
icon	boolean	Чи показувати значок ефекту в HUD. Ефект буде показано в інвентарі незалежно від цього прапорця.

INFO

Щоб створити зілля, яке використовує цей ефект, перегляньте зілля.