Totem Limiter (Servers-Only)

Totem Limiter is a dedicated, server-side Fabric mod designed to balance gameplay by restricting the number of Totems of Undying a player can carry. This mod is built exclusively for server environments to ensure fair play in competitive PvP or hardcore survival communities.

Core Features

• Strictly Server-Side: No client-side installation is required. Players join with a vanilla client—this mod does not function in singleplayer or on client instances.
• Configurable Limit: Set the maximum number of totems allowed per player (default is 2).
• Smart Pickup Handling: When a player attempts to pick up a totem that exceeds the limit, the mod automatically drops the excess totem back onto the ground.
• Priority Preservation: The mod intelligently prioritizes keeping totems in the offhand or hotbar, dropping the "newest" totems first.
• Real-time Notifications: Players receive a clear chat message when they attempt to carry more totems than allowed.

How to Use

Installation

1. Ensure you have the Fabric Loader installed on your Minecraft server.
2. Download the totem-limiter.jar and place it into your server's mods folder.
3. Restart your server.
4. Note: Do not install this on your local Minecraft client; it is a server-only utility.

Configuration

After the first run, a configuration file will be generated at config/totem-limiter.json. You can modify the limit by editing this file:

{
  "maxTotems": 2
}

• maxTotems: Any positive integer (e.g., 1, 3, 5). Changes require a server restart to take effect.

Requirements

• Minecraft: 1.21.11
• Mod Loader: Fabric Server
• Dependencies: Fabric API (Server-side)

FAQ & Troubleshooting

Q: Does this work in singleplayer?
A: No. This mod is strictly designed for dedicated Fabric servers.

Q: Do my players need to download this?
A: No! This is a "vanilla-compatible" server mod. Players join with their standard Minecraft client.

Q: What happens if a player finds a totem in a chest?
A: If they are already at the limit, the totem will be dropped on the ground immediately upon being added to their inventory.

Q: Why isn't the limit working?
A: Ensure you have the Fabric API installed on the server, as it is a required dependency.

Support & Contributions

• Support: For help, troubleshooting, or feedback, please join the Discord server linked on this project page.
• Creator: Developed by t6200.
• License: MIT License.

Note: This mod is intended for server administrators to maintain game balance. Please ensure your players are aware of the limit to avoid confusion when excess totems are dropped!