Skip to content

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.

  1. Register a server tick listener for your loader.
  2. Return early unless the tick count divides 20.
  3. For each player, read the armor slot and test it against the armor item.
  4. Add the effect for 60 ticks to the player who wears it.

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.

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_TICK
  • LivingEntity.getItemBySlot
  • EquipmentSlot.HEAD
  • MobEffectInstance

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.Post
  • LivingEntity.getItemBySlot
  • EquipmentSlot.HEAD
  • MobEffectInstance

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

Uses:

  • TickEvent.ServerTickEvent
  • LivingEntity.getItemBySlot
  • EquipmentSlot.HEAD
  • MobEffectInstance

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

Uses:

  • TickEvent.ServerTickEvent
  • LivingEntity.getItemBySlot
  • EquipmentSlot.HEAD
  • MobEffectInstance

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

Uses:

  • TickEvent.ServerTickEvent
  • LivingEntity.getItemBySlot
  • EquipmentSlot.HEAD
  • MobEffectInstance

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

Uses:

  • TickEvent.ServerTickEvent
  • LivingEntity.getItemBySlot
  • EquipmentSlot.HEAD
  • MobEffectInstance

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

Uses:

  • TickEvent.ServerTickEvent
  • LivingEntity.getItemBySlot
  • EquipmentSlot.HEAD
  • MobEffectInstance

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

Uses:

  • TickEvent.ServerTickEvent
  • LivingEntity.getItemBySlot
  • EquipmentSlotType.HEAD
  • EffectInstance

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

Uses:

  • ServerTickEvents.END_SERVER_TICK
  • LivingEntity.getItemBySlot
  • EquipmentSlot.HEAD
  • MobEffectInstance

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

Uses:

  • TickEvent.ServerTickEvent
  • EntityLivingBase.getItemBySlot
  • EntityEquipmentSlot.HEAD
  • PotionEffect

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

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.