Mobeffekte 1.21.11

Lerne, wie man benutzerdefinierte Mobeffekte erstellt.

WARNING

Diese Seite ist für die Version 1.21.11 geschrieben. Dokumentationen für ältere Versionen sind möglicherweise unvollständig.

Mobeffekte, auch bekannt als Statuseffekte oder einfach Effekte, sind eine Bedingung, die eine Entität beeinflussen kann. Sie können positiver, negativer oder neutraler Natur sein. Das Basisspiel wendet diese Effekte auf verschiedene Weise an, zum Beispiel durch Nahrung, Tränke usw.

Der Befehl /effect kann verwendet werden, um Effekte auf eine Entität anzuwenden.

Benutzerdefinierte Mobeffekte

In diesem Tutorial fügen wir einen neuen benutzerdefinierten Effekt namens Tater hinzu, der dir einen Erfahrungspunkt pro Spieltick gibt.

stepOn erweitern

Lasst uns eine benutzerdefinierte Effektklasse erstellen, indem wir MobEffect erweitern, die die Basisklasse für alle Effekte ist.

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

Deinen benutzerdefinierten Effekt registrieren

Ähnlich wie bei der Registrierung von Blöcken und Items verwenden wir Registry.register, um unseren benutzerdefinierten Effekt in der MOB_EFFECT-Registry zu registrieren. Dies kann in unserem Initialisierer geschehen.

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() {
		// ...
	}
}

Texturen

Das Mobeffekt-Symbol ist ein 18x18 PNG, welches in der Oberfläche des Inventars des Spielers erscheinen wird. Platziere dein eigenes Icon in:

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

Beispiel Textur herunterladen

Übersetzungen

Wie jede andere Übersetzung kannst du einen Eintrag mit dem ID-Format "effect.example-mod.effect-identifier": "Wert" zur Sprachdatei hinzufügen.

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

Einen Effekt anwenden

Es lohnt sich, einen Blick darauf zu werfen, wie man normalerweise einen Effekt auf eine Entität anwendet.

TIP

Für einen schnellen Test ist es möglicherweise besser, den zuvor erwähnten Befehl /effect zu verwenden:

effect give @p example-mod:tater

Um einen Effekt intern anzuwenden, solltest du die Methode LivingEntity#addEffect verwenden, die eine MobEffectInstance entgegennimmt und einen boolean zurückgibt, der angibt, ob der Effekt erfolgreich angewendet wurde.

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

Argument	Typ	Beschreibung
effect	Holder<MobEffect>	Ein Halter, der den Effekt darstellt.
duration	int	Die Dauer des Effekts in Ticks, nicht in Sekunden
amplifier	int	Der Verstärker auf das Level des Effekts. Es entspricht nicht dem Level des Effekts, sondern wird zusätzlich zu diesem hinzugefügt. Folglich, amplifier von 4 => Level von 5
ambient	v	Dies ist ein schwieriger. Es gibt im Grunde an, dass der Effekt durch die Umgebung (z. B. ein Leuchtfeuer) hinzugefügt wurde und keine direkte Ursache hat. Wenn true, wird das Icon des Effekts im HUD mit einer türkiesen Überlagerung erscheinen.
particles	v	Ob Partikel angezeigt werden sollen.
icon	v	Ob das Icon des Effekts im HUD angezeigt werden soll. Der Effekt wird im Inventar unabhängig von dieser Flag angezeigt.

INFO

Um einen Trank zu erstellen, der diesen Effekt nutzt, lies bitte die Anleitung Tränke.