Totem Balancer

Totem Balancer is a lightweight Minecraft Fabric mod designed to enhance gameplay balance by preventing the overuse of the Totem of Undying. The mod is lightweight, easy to install, and configurable to fit different server rules or personal preferences.

Features

Configurable cooldown timer between uses of the Totem of Undying.
Configurable amount of Totems of Undying a player can carry.
Clear in-game notifications when cooldown is active or item limit is exceeded.
Fully configurable via commands or the config file.

Installation

Place the mod JAR file into the server's mods folder and start the server.

Configuration

When the server starts for the first time, a config file will be generated at config/totem_balancer.json:

{
  "maxTotems": 1,
  "cooldownSeconds": 20,
  "playerMaxTotems": {},
  "playerCooldownSeconds": {}
}

You can also modify the settings at runtime using server commands:

/totemBalancer setCarryLimit <limit> [player] — Sets the maximum number of Totems globally or for a specific player.
/totemBalancer setCooldown <seconds> [player] — Sets the cooldown time in seconds globally or for a specific player.
/totemBalancer removeCarryLimit <player> — Removes a custom carry limit for the given player.
/totemBalancer removeCooldown <player> — Removes a custom cooldown for the given player.

Contributing

Feel free to open issues or pull requests on the GitHub page!

This mod is compatible with Minecraft 1.21.x and requires the corresponding Fabric API version.