Effetti di Stato 1.20.4

Impara come aggiungere effetti di stato personalizzati.

WARNING

Questa pagina si applica alla versione 1.20.4. La documentazione delle versioni meno recenti potrebbe essere incompleta.

Gli effetti di stato, anche noti come effetti, sono una condizione che interessa un'entità. Possono essere positivi, negativi o neutrali in natura. Il gioco base applica questi effetti in vari modi, come cibi, pozioni ecc.

Il comando /effect può essere usato per applicare effetti su un'entità.

Effetti di Stato Personalizzati

In questo tutorial aggiungeremo un nuovo effetto personalizzato chiamato Tater che ti darà un punto esperienza in ogni tick di gioco.

Estendere MobEffect

Creiamo una classe per il nostro effetto personalizzato estendendo MobEffect, che è la classe base per tutti gli effetti.

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

Registrare il tuo Effetto Personalizzato

Come nella registrazione di blocchi e oggetti, usiamo Registry.register per registrare i nostri effetti personalizzati nel registro MOB_EFFECT. Questo può essere fatto nel nostro initializer.

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

Traduzioni e Texture

Puoi assegnare un nome al tuo effetto di stato e fornire un'icona che apparirà nello schermo dell'inventario del giocatore.

Texture

L'icona dell'effetto è un PNG 18x18. Posiziona la tua icona personalizzata in:

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

Traduzioni

Come ogni altra traduzione, puoi aggiungere una voce con formato ID "effect.example-mod.<effect-identifier>": "Valore" al file di lingua.

assets/example-mod/lang/en_us.json

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

Fase di Test

Usa il comando /effect give @p example-mod:tater per dare al giocatore il nostro effetto Tater. Usa /effect clear @p example-mod:tater per rimuovere l'effetto.

INFO

Per creare una pozione che usa questo effetto, per favore vedi la guida Pozioni.