How to make armor that gives a potion effect in a Minecraft mod
Armor has no built-in effect hook, so check on a timer: once a second, for each player, read the item in an armor slot (the head slot, say) and test whether it is your armor item. If it matches, add an effect that lasts a little longer than the check (60 ticks for a 20-tick check), so it never flickers. Hide the particles to keep the screen clear. For a full set, test four slots. For your own armor item, test with the item you registered.
Works on Minecraft 1.20.1 to 26.3 on NeoForge; Minecraft 1.16.5 to 26.3 on Fabric; Minecraft 1.16.5 to 1.20.1 on Forge; Minecraft 1.12.2 on Forge. Each example was compiled against its loader and version before it shipped in Linen.
- Register a server tick listener for your loader.
- Return early unless the tick count divides 20.
- For each player, read the armor slot and test it against the armor item.
- Add the effect for 60 ticks to the player who wears it.
What you can change
Section titled “What you can change”The example uses these values. Change them in the code.
| Setting | In the example | What it does |
|---|---|---|
| helmet | IRON_HELMET |
The helmet that triggers it. |
| effect | NIGHT_VISION |
The effect it gives. |
For each loader and version
Section titled “For each loader and version”The example mod is examplemod in the package com.example.examplemod. Use your own mod id and package.
Fabric 1.18 to 1.21.1, Fabric 1.21.2 to 26.3
Section titled “Fabric 1.18 to 1.21.1, Fabric 1.21.2 to 26.3”Uses:
ServerTickEvents.END_SERVER_TICKLivingEntity.getItemBySlotEquipmentSlot.HEADMobEffectInstance
src/main/java/com/example/examplemod/event/HelmetBoostArmor.java
package com.example.examplemod.event;
import net.fabricmc.fabric.api.event.lifecycle.v1.ServerTickEvents;import net.minecraft.server.level.ServerPlayer;import net.minecraft.world.effect.MobEffectInstance;import net.minecraft.world.effect.MobEffects;import net.minecraft.world.entity.EquipmentSlot;import net.minecraft.world.item.Items;
// While a player wears IRON_HELMET, they get NIGHT_VISION. Checked once a second (Fabric API: ServerTickEvents.END_SERVER_TICK).public final class HelmetBoostArmor { private HelmetBoostArmor() { }
// Called from the mod's onInitialize. public static void register() { ServerTickEvents.END_SERVER_TICK.register(server -> { if (server.getTickCount() % 20 != 0) { return; } for (ServerPlayer player : server.getPlayerList().getPlayers()) { if (player.getItemBySlot(EquipmentSlot.HEAD).is(Items.IRON_HELMET)) { player.addEffect(new MobEffectInstance(MobEffects.NIGHT_VISION, 60, 0, true, false)); } } }); }}In your main mod class, inside onInitialize:
HelmetBoostArmor.register();NeoForge 1.20.5 to 1.21.1, NeoForge 1.21.2 to 26.3
Section titled “NeoForge 1.20.5 to 1.21.1, NeoForge 1.21.2 to 26.3”Uses:
ServerTickEvent.PostLivingEntity.getItemBySlotEquipmentSlot.HEADMobEffectInstance
src/main/java/com/example/examplemod/event/HelmetBoostArmor.java
package com.example.examplemod.event;
import net.minecraft.server.level.ServerPlayer;import net.minecraft.world.effect.MobEffectInstance;import net.minecraft.world.effect.MobEffects;import net.minecraft.world.entity.EquipmentSlot;import net.minecraft.world.item.Items;import net.neoforged.neoforge.common.NeoForge;import net.neoforged.neoforge.event.tick.ServerTickEvent;
// While a player wears IRON_HELMET, they get NIGHT_VISION. Checked once a second (NeoForge: ServerTickEvent.Post).public final class HelmetBoostArmor { private HelmetBoostArmor() { }
// Called from the mod's constructor. public static void register() { NeoForge.EVENT_BUS.addListener(HelmetBoostArmor::onTick); }
private static void onTick(ServerTickEvent.Post event) { if (event.getServer().getTickCount() % 20 != 0) { return; } for (ServerPlayer player : event.getServer().getPlayerList().getPlayers()) { if (player.getItemBySlot(EquipmentSlot.HEAD).is(Items.IRON_HELMET)) { player.addEffect(new MobEffectInstance(MobEffects.NIGHT_VISION, 60, 0, true, false)); } } }}In your main mod class, inside <init>:
HelmetBoostArmor.register();NeoForge 1.20.2 to 1.20.4
Section titled “NeoForge 1.20.2 to 1.20.4”Uses:
TickEvent.ServerTickEventLivingEntity.getItemBySlotEquipmentSlot.HEADMobEffectInstance
src/main/java/com/example/examplemod/event/HelmetBoostArmor.java
package com.example.examplemod.event;
import net.minecraft.server.level.ServerPlayer;import net.minecraft.world.effect.MobEffectInstance;import net.minecraft.world.effect.MobEffects;import net.minecraft.world.entity.EquipmentSlot;import net.minecraft.world.item.Items;import net.neoforged.neoforge.common.NeoForge;import net.neoforged.neoforge.event.TickEvent;
// While a player wears IRON_HELMET, they get NIGHT_VISION. Checked once a second (NeoForge: TickEvent.ServerTickEvent (END phase)).public final class HelmetBoostArmor { private HelmetBoostArmor() { }
// Called from the mod's constructor. public static void register() { NeoForge.EVENT_BUS.addListener(HelmetBoostArmor::onTick); }
private static void onTick(TickEvent.ServerTickEvent event) { if (event.phase != TickEvent.Phase.END || event.getServer().getTickCount() % 20 != 0) { return; } for (ServerPlayer player : event.getServer().getPlayerList().getPlayers()) { if (player.getItemBySlot(EquipmentSlot.HEAD).is(Items.IRON_HELMET)) { player.addEffect(new MobEffectInstance(MobEffects.NIGHT_VISION, 60, 0, true, false)); } } }}In your main mod class, inside <init>:
HelmetBoostArmor.register();Forge 1.17.1
Section titled “Forge 1.17.1”Uses:
TickEvent.ServerTickEventLivingEntity.getItemBySlotEquipmentSlot.HEADMobEffectInstance
src/main/java/com/example/examplemod/event/HelmetBoostArmor.java
package com.example.examplemod.event;
import net.minecraftforge.fmllegacy.server.ServerLifecycleHooks;import net.minecraft.server.level.ServerPlayer;import net.minecraft.world.effect.MobEffectInstance;import net.minecraft.world.effect.MobEffects;import net.minecraft.world.entity.EquipmentSlot;import net.minecraft.world.item.Items;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.TickEvent;
// While a player wears IRON_HELMET, they get NIGHT_VISION. Checked once a second (Forge: TickEvent.ServerTickEvent, END phase).public final class HelmetBoostArmor { private HelmetBoostArmor() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(HelmetBoostArmor::onTick); }
private static void onTick(TickEvent.ServerTickEvent event) { if (event.phase != TickEvent.Phase.END || ServerLifecycleHooks.getCurrentServer().getTickCount() % 20 != 0) { return; } for (ServerPlayer player : ServerLifecycleHooks.getCurrentServer().getPlayerList().getPlayers()) { if (player.getItemBySlot(EquipmentSlot.HEAD).is(Items.IRON_HELMET)) { player.addEffect(new MobEffectInstance(MobEffects.NIGHT_VISION, 60, 0, true, false)); } } }}In your main mod class, inside <init>:
HelmetBoostArmor.register();Forge 1.18.2
Section titled “Forge 1.18.2”Uses:
TickEvent.ServerTickEventLivingEntity.getItemBySlotEquipmentSlot.HEADMobEffectInstance
src/main/java/com/example/examplemod/event/HelmetBoostArmor.java
package com.example.examplemod.event;
import net.minecraftforge.server.ServerLifecycleHooks;import net.minecraft.server.level.ServerPlayer;import net.minecraft.world.effect.MobEffectInstance;import net.minecraft.world.effect.MobEffects;import net.minecraft.world.entity.EquipmentSlot;import net.minecraft.world.item.Items;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.TickEvent;
// While a player wears IRON_HELMET, they get NIGHT_VISION. Checked once a second (Forge: TickEvent.ServerTickEvent, END phase).public final class HelmetBoostArmor { private HelmetBoostArmor() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(HelmetBoostArmor::onTick); }
private static void onTick(TickEvent.ServerTickEvent event) { if (event.phase != TickEvent.Phase.END || ServerLifecycleHooks.getCurrentServer().getTickCount() % 20 != 0) { return; } for (ServerPlayer player : ServerLifecycleHooks.getCurrentServer().getPlayerList().getPlayers()) { if (player.getItemBySlot(EquipmentSlot.HEAD).is(Items.IRON_HELMET)) { player.addEffect(new MobEffectInstance(MobEffects.NIGHT_VISION, 60, 0, true, false)); } } }}In your main mod class, inside <init>:
HelmetBoostArmor.register();Forge 1.19 to 1.20.1
Section titled “Forge 1.19 to 1.20.1”Uses:
TickEvent.ServerTickEventLivingEntity.getItemBySlotEquipmentSlot.HEADMobEffectInstance
src/main/java/com/example/examplemod/event/HelmetBoostArmor.java
package com.example.examplemod.event;
import net.minecraft.server.level.ServerPlayer;import net.minecraft.world.effect.MobEffectInstance;import net.minecraft.world.effect.MobEffects;import net.minecraft.world.entity.EquipmentSlot;import net.minecraft.world.item.Items;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.TickEvent;
// While a player wears IRON_HELMET, they get NIGHT_VISION. Checked once a second (Forge: TickEvent.ServerTickEvent, END phase).public final class HelmetBoostArmor { private HelmetBoostArmor() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(HelmetBoostArmor::onTick); }
private static void onTick(TickEvent.ServerTickEvent event) { if (event.phase != TickEvent.Phase.END || event.getServer().getTickCount() % 20 != 0) { return; } for (ServerPlayer player : event.getServer().getPlayerList().getPlayers()) { if (player.getItemBySlot(EquipmentSlot.HEAD).is(Items.IRON_HELMET)) { player.addEffect(new MobEffectInstance(MobEffects.NIGHT_VISION, 60, 0, true, false)); } } }}In your main mod class, inside <init>:
HelmetBoostArmor.register();NeoForge 1.20.1
Section titled “NeoForge 1.20.1”Uses:
TickEvent.ServerTickEventLivingEntity.getItemBySlotEquipmentSlot.HEADMobEffectInstance
src/main/java/com/example/examplemod/event/HelmetBoostArmor.java
package com.example.examplemod.event;
import net.minecraft.server.level.ServerPlayer;import net.minecraft.world.effect.MobEffectInstance;import net.minecraft.world.effect.MobEffects;import net.minecraft.world.entity.EquipmentSlot;import net.minecraft.world.item.Items;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.TickEvent;
// While a player wears IRON_HELMET, they get NIGHT_VISION. Checked once a second (NeoForge: TickEvent.ServerTickEvent, END phase).public final class HelmetBoostArmor { private HelmetBoostArmor() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(HelmetBoostArmor::onTick); }
private static void onTick(TickEvent.ServerTickEvent event) { if (event.phase != TickEvent.Phase.END || event.getServer().getTickCount() % 20 != 0) { return; } for (ServerPlayer player : event.getServer().getPlayerList().getPlayers()) { if (player.getItemBySlot(EquipmentSlot.HEAD).is(Items.IRON_HELMET)) { player.addEffect(new MobEffectInstance(MobEffects.NIGHT_VISION, 60, 0, true, false)); } } }}In your main mod class, inside <init>:
HelmetBoostArmor.register();Forge 1.16.5
Section titled “Forge 1.16.5”Uses:
TickEvent.ServerTickEventLivingEntity.getItemBySlotEquipmentSlotType.HEADEffectInstance
src/main/java/com/example/examplemod/event/HelmetBoostArmor.java
package com.example.examplemod.event;
import net.minecraft.entity.player.ServerPlayerEntity;import net.minecraft.potion.EffectInstance;import net.minecraft.potion.Effects;import net.minecraft.inventory.EquipmentSlotType;import net.minecraft.item.Items;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.TickEvent;import net.minecraftforge.fml.server.ServerLifecycleHooks;
// While a player wears IRON_HELMET, they get NIGHT_VISION. Checked once a second (Forge: TickEvent.ServerTickEvent, END phase).public final class HelmetBoostArmor { private HelmetBoostArmor() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(HelmetBoostArmor::onTick); }
private static void onTick(TickEvent.ServerTickEvent event) { if (event.phase != TickEvent.Phase.END || ServerLifecycleHooks.getCurrentServer().getTickCount() % 20 != 0) { return; } for (ServerPlayerEntity player : ServerLifecycleHooks.getCurrentServer().getPlayerList().getPlayers()) { if (player.getItemBySlot(EquipmentSlotType.HEAD).getItem() == Items.IRON_HELMET) { player.addEffect(new EffectInstance(Effects.NIGHT_VISION, 60, 0, true, false)); } } }}In your main mod class, inside <init>:
HelmetBoostArmor.register();Fabric 1.16.5 to 1.17.1
Section titled “Fabric 1.16.5 to 1.17.1”Uses:
ServerTickEvents.END_SERVER_TICKLivingEntity.getItemBySlotEquipmentSlot.HEADMobEffectInstance
src/main/java/com/example/examplemod/event/HelmetBoostArmor.java
package com.example.examplemod.event;
import net.fabricmc.fabric.api.event.lifecycle.v1.ServerTickEvents;import net.minecraft.server.level.ServerPlayer;import net.minecraft.world.effect.MobEffectInstance;import net.minecraft.world.effect.MobEffects;import net.minecraft.world.entity.EquipmentSlot;import net.minecraft.world.item.Items;
// While a player wears IRON_HELMET, they get NIGHT_VISION. Checked once a second (Fabric API: ServerTickEvents.END_SERVER_TICK).public final class HelmetBoostArmor { private HelmetBoostArmor() { }
// Called from the mod's onInitialize. public static void register() { ServerTickEvents.END_SERVER_TICK.register(server -> { if (server.getTickCount() % 20 != 0) { return; } for (ServerPlayer player : server.getPlayerList().getPlayers()) { if (player.getItemBySlot(EquipmentSlot.HEAD).getItem() == Items.IRON_HELMET) { player.addEffect(new MobEffectInstance(MobEffects.NIGHT_VISION, 60, 0, true, false)); } } }); }}In your main mod class, inside onInitialize:
HelmetBoostArmor.register();Forge 1.12.2
Section titled “Forge 1.12.2”Uses:
TickEvent.ServerTickEventEntityLivingBase.getItemBySlotEntityEquipmentSlot.HEADPotionEffect
src/main/java/com/example/examplemod/event/HelmetBoostArmor.java
package com.example.examplemod.event;
import com.example.examplemod.ExampleMod;import net.minecraft.entity.player.EntityPlayer;import net.minecraft.init.Items;import net.minecraft.init.MobEffects;import net.minecraft.inventory.EntityEquipmentSlot;import net.minecraft.potion.PotionEffect;import net.minecraftforge.fml.common.Mod;import net.minecraftforge.fml.common.eventhandler.SubscribeEvent;import net.minecraftforge.fml.common.gameevent.TickEvent;
// While a player wears IRON_HELMET, they get NIGHT_VISION. Checked once a second (Forge: TickEvent.PlayerTickEvent, END phase, server side).@Mod.EventBusSubscriber(modid = ExampleMod.MOD_ID)public final class HelmetBoostArmor { private HelmetBoostArmor() { }
@SubscribeEvent public static void onTick(TickEvent.PlayerTickEvent event) { EntityPlayer player = event.player; if (event.phase != TickEvent.Phase.END || player.world.isRemote || player.ticksExisted % 20 != 0) { return; } if (player.getItemStackFromSlot(EntityEquipmentSlot.HEAD).getItem() == Items.IRON_HELMET) { player.addPotionEffect(new PotionEffect(MobEffects.NIGHT_VISION, 60, 0, true, false)); } }}Sources
Section titled “Sources”- https://docs.fabricmc.net/1.21.1/develop/events
- https://docs.neoforged.net/docs/1.21.1/concepts/events
- https://maven.fabricmc.net/docs/fabric-api-0.116.17+1.21.1/net/fabricmc/fabric/api/event/lifecycle/v1/ServerTickEvents.html
Related how-tos
Section titled “Related how-tos”- Give players items when they first join
- Spawn a mob every few seconds
- An item that fills the hunger bar
- An item that gives the player another item
- An item that heals you when you use it
In Linen
Section titled “In Linen”Linen’s How-tos library has this page too, with the example for your own mod’s loader and Minecraft version. Hover a name in your code and Linen points to the how-tos that explain it. Both are free. Download Linen.