Skip to content

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.

  1. Listen to the server tick event when your mod starts.
  2. Use the tick count % (seconds * 20) == 0 to act every few seconds.
  3. Keep the work in it short.

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.

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_TICK
  • MinecraftServer.getTickCount
  • PlayerList.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.Post
  • MinecraftServer.getTickCount
  • PlayerList.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();

Uses:

  • TickEvent.ServerTickEvent
  • MinecraftServer.getTickCount
  • PlayerList.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();

Uses:

  • TickEvent.ServerTickEvent
  • MinecraftServer.getTickCount
  • PlayerList.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();

Uses:

  • TickEvent.ServerTickEvent
  • MinecraftServer.getTickCount
  • PlayerList.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();

Uses:

  • TickEvent.ServerTickEvent
  • MinecraftServer.getTickCount
  • PlayerList.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();

Uses:

  • TickEvent.ServerTickEvent
  • MinecraftServer.getTickCount
  • PlayerList.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();

Uses:

  • TickEvent.ServerTickEvent
  • MinecraftServer.getTickCount
  • PlayerList.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();

Uses:

  • ServerTickEvents.END_SERVER_TICK
  • MinecraftServer.getTickCount
  • PlayerList.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();

Uses:

  • ServerTickEvents.END_SERVER_TICK
  • MinecraftServer.getTickCount
  • PlayerList.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();

Uses:

  • TickEvent.ServerTickEvent
  • MinecraftServer.getTickCount
  • ServerLifecycleHooks.getCurrentServer
  • PlayerList.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();

Uses:

  • TickEvent.ServerTickEvent
  • MinecraftServer.getTickCount
  • FMLCommonHandler.getCurrentServer
  • PlayerList.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!"));
}
}
}

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.