How to run code every tick in a Minecraft mod
The server runs 20 ticks a second, and after each one the loader fires a tick event: Fabric API’s ServerTickEvents.END_SERVER_TICK, ServerTickEvent.Post on NeoForge 1.20.5 and newer, TickEvent.ServerTickEvent (in its END phase) on Forge and older NeoForge. Count ticks (server.getTickCount(), getTickCounter() on 1.12.2) to do something every few seconds, and keep the work small: it runs all the time.
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.
- Listen to the server tick event when your mod starts.
- Use the tick count % (seconds * 20) == 0 to act every few seconds.
- Keep the work in it short.
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 |
|---|---|---|
| seconds | 300 |
How often it runs, in seconds. |
| message | Remember to take a break! |
The message it shows. |
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.19.1 to 1.21.1, Fabric 1.21.2 to 26.3
Section titled “Fabric 1.19.1 to 1.21.1, Fabric 1.21.2 to 26.3”Uses:
ServerTickEvents.END_SERVER_TICKMinecraftServer.getTickCountPlayerList.broadcastSystemMessage
src/main/java/com/example/examplemod/event/ReminderTickEvents.java
package com.example.examplemod.event;
import net.fabricmc.fabric.api.event.lifecycle.v1.ServerTickEvents;import net.minecraft.network.chat.Component;
// Runs after every server tick, 20 a second (Fabric API: ServerTickEvents.END_SERVER_TICK); this one acts every 300 seconds.public final class ReminderTickEvents { private static final int TICKS = 300 * 20;
private ReminderTickEvents() { }
// Called from the mod's onInitialize. public static void register() { ServerTickEvents.END_SERVER_TICK.register(server -> { if (server.getTickCount() % TICKS == 0) { server.getPlayerList().broadcastSystemMessage(Component.literal("Remember to take a break!"), false); } }); }}In your main mod class, inside onInitialize:
ReminderTickEvents.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.PostMinecraftServer.getTickCountPlayerList.broadcastSystemMessage
src/main/java/com/example/examplemod/event/ReminderTickEvents.java
package com.example.examplemod.event;
import net.minecraft.network.chat.Component;import net.neoforged.neoforge.common.NeoForge;import net.neoforged.neoforge.event.tick.ServerTickEvent;
// Fired after every server tick, 20 a second (NeoForge: ServerTickEvent.Post); this one acts every 300 seconds.public final class ReminderTickEvents { private static final int TICKS = 300 * 20;
private ReminderTickEvents() { }
// Called from the mod's constructor. public static void register() { NeoForge.EVENT_BUS.addListener(ReminderTickEvents::onServerTick); }
private static void onServerTick(ServerTickEvent.Post event) { if (event.getServer().getTickCount() % TICKS == 0) { event.getServer().getPlayerList().broadcastSystemMessage(Component.literal("Remember to take a break!"), false); } }}In your main mod class, inside <init>:
ReminderTickEvents.register();NeoForge 1.20.2 to 1.20.4
Section titled “NeoForge 1.20.2 to 1.20.4”Uses:
TickEvent.ServerTickEventMinecraftServer.getTickCountPlayerList.broadcastSystemMessage
src/main/java/com/example/examplemod/event/ReminderTickEvents.java
package com.example.examplemod.event;
import net.minecraft.network.chat.Component;import net.neoforged.neoforge.common.NeoForge;import net.neoforged.neoforge.event.TickEvent;
// Fired after every server tick, 20 a second (NeoForge: TickEvent.ServerTickEvent (END phase)); this one acts every 300 seconds.public final class ReminderTickEvents { private static final int TICKS = 300 * 20;
private ReminderTickEvents() { }
// Called from the mod's constructor. public static void register() { NeoForge.EVENT_BUS.addListener(ReminderTickEvents::onServerTick); }
private static void onServerTick(TickEvent.ServerTickEvent event) { if (event.phase == TickEvent.Phase.END && event.getServer().getTickCount() % TICKS == 0) { event.getServer().getPlayerList().broadcastSystemMessage(Component.literal("Remember to take a break!"), false); } }}In your main mod class, inside <init>:
ReminderTickEvents.register();Forge 1.17.1
Section titled “Forge 1.17.1”Uses:
TickEvent.ServerTickEventMinecraftServer.getTickCountPlayerList.broadcastSystemMessage
src/main/java/com/example/examplemod/event/ReminderTickEvents.java
package com.example.examplemod.event;
import net.minecraft.Util;import net.minecraftforge.fmllegacy.server.ServerLifecycleHooks;import net.minecraft.network.chat.TextComponent;import net.minecraft.network.chat.ChatType;import net.minecraft.network.chat.Component;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.TickEvent;
// Fired after every server tick, 20 a second (Forge: TickEvent.ServerTickEvent, in its END phase); this one acts every 300 seconds.public final class ReminderTickEvents { private static final int TICKS = 300 * 20;
private ReminderTickEvents() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(ReminderTickEvents::onServerTick); }
private static void onServerTick(TickEvent.ServerTickEvent event) { if (event.phase == TickEvent.Phase.END && ServerLifecycleHooks.getCurrentServer().getTickCount() % TICKS == 0) { ServerLifecycleHooks.getCurrentServer().getPlayerList().broadcastMessage(new TextComponent("Remember to take a break!"), ChatType.SYSTEM, Util.NIL_UUID); } }}In your main mod class, inside <init>:
ReminderTickEvents.register();Forge 1.18.2
Section titled “Forge 1.18.2”Uses:
TickEvent.ServerTickEventMinecraftServer.getTickCountPlayerList.broadcastSystemMessage
src/main/java/com/example/examplemod/event/ReminderTickEvents.java
package com.example.examplemod.event;
import net.minecraft.Util;import net.minecraftforge.server.ServerLifecycleHooks;import net.minecraft.network.chat.TextComponent;import net.minecraft.network.chat.ChatType;import net.minecraft.network.chat.Component;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.TickEvent;
// Fired after every server tick, 20 a second (Forge: TickEvent.ServerTickEvent, in its END phase); this one acts every 300 seconds.public final class ReminderTickEvents { private static final int TICKS = 300 * 20;
private ReminderTickEvents() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(ReminderTickEvents::onServerTick); }
private static void onServerTick(TickEvent.ServerTickEvent event) { if (event.phase == TickEvent.Phase.END && ServerLifecycleHooks.getCurrentServer().getTickCount() % TICKS == 0) { ServerLifecycleHooks.getCurrentServer().getPlayerList().broadcastMessage(new TextComponent("Remember to take a break!"), ChatType.SYSTEM, Util.NIL_UUID); } }}In your main mod class, inside <init>:
ReminderTickEvents.register();Forge 1.19
Section titled “Forge 1.19”Uses:
TickEvent.ServerTickEventMinecraftServer.getTickCountPlayerList.broadcastSystemMessage
src/main/java/com/example/examplemod/event/ReminderTickEvents.java
package com.example.examplemod.event;
import net.minecraft.network.chat.ChatType;import net.minecraft.network.chat.Component;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.TickEvent;
// Fired after every server tick, 20 a second (Forge: TickEvent.ServerTickEvent, in its END phase); this one acts every 300 seconds.public final class ReminderTickEvents { private static final int TICKS = 300 * 20;
private ReminderTickEvents() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(ReminderTickEvents::onServerTick); }
private static void onServerTick(TickEvent.ServerTickEvent event) { if (event.phase == TickEvent.Phase.END && event.getServer().getTickCount() % TICKS == 0) { event.getServer().getPlayerList().broadcastSystemMessage(Component.literal("Remember to take a break!"), ChatType.SYSTEM); } }}In your main mod class, inside <init>:
ReminderTickEvents.register();Forge 1.19.1 to 1.20.1
Section titled “Forge 1.19.1 to 1.20.1”Uses:
TickEvent.ServerTickEventMinecraftServer.getTickCountPlayerList.broadcastSystemMessage
src/main/java/com/example/examplemod/event/ReminderTickEvents.java
package com.example.examplemod.event;
import net.minecraft.network.chat.Component;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.TickEvent;
// Fired after every server tick, 20 a second (Forge: TickEvent.ServerTickEvent, in its END phase); this one acts every 300 seconds.public final class ReminderTickEvents { private static final int TICKS = 300 * 20;
private ReminderTickEvents() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(ReminderTickEvents::onServerTick); }
private static void onServerTick(TickEvent.ServerTickEvent event) { if (event.phase == TickEvent.Phase.END && event.getServer().getTickCount() % TICKS == 0) { event.getServer().getPlayerList().broadcastSystemMessage(Component.literal("Remember to take a break!"), false); } }}In your main mod class, inside <init>:
ReminderTickEvents.register();NeoForge 1.20.1
Section titled “NeoForge 1.20.1”Uses:
TickEvent.ServerTickEventMinecraftServer.getTickCountPlayerList.broadcastSystemMessage
src/main/java/com/example/examplemod/event/ReminderTickEvents.java
package com.example.examplemod.event;
import net.minecraft.network.chat.Component;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.TickEvent;
// Fired after every server tick, 20 a second (NeoForge: TickEvent.ServerTickEvent, in its END phase); this one acts every 300 seconds.public final class ReminderTickEvents { private static final int TICKS = 300 * 20;
private ReminderTickEvents() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(ReminderTickEvents::onServerTick); }
private static void onServerTick(TickEvent.ServerTickEvent event) { if (event.phase == TickEvent.Phase.END && event.getServer().getTickCount() % TICKS == 0) { event.getServer().getPlayerList().broadcastSystemMessage(Component.literal("Remember to take a break!"), false); } }}In your main mod class, inside <init>:
ReminderTickEvents.register();Fabric 1.19
Section titled “Fabric 1.19”Uses:
ServerTickEvents.END_SERVER_TICKMinecraftServer.getTickCountPlayerList.broadcastSystemMessage
src/main/java/com/example/examplemod/event/ReminderTickEvents.java
package com.example.examplemod.event;
import net.fabricmc.fabric.api.event.lifecycle.v1.ServerTickEvents;import net.minecraft.network.chat.ChatType;import net.minecraft.network.chat.Component;
// Runs after every server tick, 20 a second (Fabric API: ServerTickEvents.END_SERVER_TICK); this one acts every 300 seconds.public final class ReminderTickEvents { private static final int TICKS = 300 * 20;
private ReminderTickEvents() { }
// Called from the mod's onInitialize. public static void register() { ServerTickEvents.END_SERVER_TICK.register(server -> { if (server.getTickCount() % TICKS == 0) { server.getPlayerList().broadcastSystemMessage(Component.literal("Remember to take a break!"), ChatType.SYSTEM); } }); }}In your main mod class, inside onInitialize:
ReminderTickEvents.register();Fabric 1.16.5 to 1.18.2
Section titled “Fabric 1.16.5 to 1.18.2”Uses:
ServerTickEvents.END_SERVER_TICKMinecraftServer.getTickCountPlayerList.broadcastSystemMessage
src/main/java/com/example/examplemod/event/ReminderTickEvents.java
package com.example.examplemod.event;
import net.minecraft.Util;import net.minecraft.network.chat.TextComponent;import net.fabricmc.fabric.api.event.lifecycle.v1.ServerTickEvents;import net.minecraft.network.chat.ChatType;import net.minecraft.network.chat.Component;
// Runs after every server tick, 20 a second (Fabric API: ServerTickEvents.END_SERVER_TICK); this one acts every 300 seconds.public final class ReminderTickEvents { private static final int TICKS = 300 * 20;
private ReminderTickEvents() { }
// Called from the mod's onInitialize. public static void register() { ServerTickEvents.END_SERVER_TICK.register(server -> { if (server.getTickCount() % TICKS == 0) { server.getPlayerList().broadcastMessage(new TextComponent("Remember to take a break!"), ChatType.SYSTEM, Util.NIL_UUID); } }); }}In your main mod class, inside onInitialize:
ReminderTickEvents.register();Forge 1.16.5
Section titled “Forge 1.16.5”Uses:
TickEvent.ServerTickEventMinecraftServer.getTickCountServerLifecycleHooks.getCurrentServerPlayerList.broadcastMessage
src/main/java/com/example/examplemod/event/ReminderTickEvents.java
package com.example.examplemod.event;
import net.minecraft.util.text.StringTextComponent;
import net.minecraft.util.Util;import net.minecraft.util.text.ChatType;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.fml.server.ServerLifecycleHooks;import net.minecraftforge.event.TickEvent;
// Fired after every server tick, 20 a second (Forge: TickEvent.ServerTickEvent, in its END phase); this one acts every 300 seconds.public final class ReminderTickEvents { private static final int TICKS = 300 * 20;
private ReminderTickEvents() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(ReminderTickEvents::onServerTick); }
private static void onServerTick(TickEvent.ServerTickEvent event) { if (event.phase == TickEvent.Phase.END && ServerLifecycleHooks.getCurrentServer().getTickCount() % TICKS == 0) { ServerLifecycleHooks.getCurrentServer().getPlayerList().broadcastMessage(new StringTextComponent("Remember to take a break!"), ChatType.SYSTEM, Util.NIL_UUID); } }}In your main mod class, inside <init>:
ReminderTickEvents.register();Forge 1.12.2
Section titled “Forge 1.12.2”Uses:
TickEvent.ServerTickEventMinecraftServer.getTickCountFMLCommonHandler.getCurrentServerPlayerList.broadcastMessage
src/main/java/com/example/examplemod/event/ReminderTickEvents.java
package com.example.examplemod.event;
import com.example.examplemod.ExampleMod;import net.minecraft.server.MinecraftServer;import net.minecraft.util.text.TextComponentString;import net.minecraftforge.fml.common.FMLCommonHandler;import net.minecraftforge.fml.common.Mod;import net.minecraftforge.fml.common.eventhandler.SubscribeEvent;import net.minecraftforge.fml.common.gameevent.TickEvent;
// Fired after every server tick, 20 a second (Forge: TickEvent.ServerTickEvent, in its END phase); this one acts every 300 seconds.@Mod.EventBusSubscriber(modid = ExampleMod.MOD_ID)public final class ReminderTickEvents { private static final int TICKS = 300 * 20;
private ReminderTickEvents() { }
@SubscribeEvent public static void onServerTick(TickEvent.ServerTickEvent event) { MinecraftServer server = FMLCommonHandler.instance().getMinecraftServerInstance(); if (event.phase == TickEvent.Phase.END && server.getTickCounter() % TICKS == 0) { server.getPlayerList().sendMessage(new TextComponentString("Remember to take a break!")); } }}Sources
Section titled “Sources”- https://maven.fabricmc.net/docs/fabric-api-0.116.17+1.21.1/net/fabricmc/fabric/api/event/lifecycle/v1/ServerTickEvents.html
- https://docs.neoforged.net/docs/1.21.1/concepts/events
Related how-tos
Section titled “Related how-tos”- Do something when a player joins
- Give players items when they first join
- React to chat messages
- React when a player breaks a block
- React when a player right-clicks a block
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.