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!