🔮 Totem Warning

A missing totem is easy to overlook. Make sure you notice it before it matters.

Totem Warning is a client-side Fabric mod that adds customizable visual alerts when you don't have a Totem of Undying where you need one.

It keeps an eye on two important inventory locations: your offhand and your hotbar. If either one is missing a totem, you'll get a visual warning on your screen.

Whether you're preparing for a fight, exploring or simply playing survival, it's a small addition that can make you more aware of your inventory.

✨ Features

Two independent warning systems

🔴 Offhand Warning

Displays a full-screen color overlay when your offhand doesn't contain a Totem of Undying.

🟠 Hotbar Warning

Displays a customizable screen overlay when none of your nine hotbar slots contains a totem.

🎨 Make it yours

• Custom RGB colors for both warning systems.

• Adjustable overlay opacity.

• Five different layouts for Hotbar Warning.

• Custom positioning and dimensions using screen percentages.

• Live previews while changing settings.

• Separate controls for each warning system.

🌍 A few extra details

• Turkish, English and Spanish interface languages.

• Simple in-game configuration menu.

• Settings are saved automatically.

• Lightweight client-side functionality.

🎨 Hotbar Warning Layouts

Choose how and where the warning appears:

The Offhand Warning always uses a full-screen overlay. These five layouts are available exclusively for the Hotbar Warning.

⚙️ Configuration

Getting started is simple.

Press "K" in-game to open the settings menu.

From there, you can:

• Configure Offhand and Hotbar warnings separately.

• Adjust RGB colors and opacity.

• Choose your preferred warning layout.

• Set custom warning positions and sizes.

• Change the interface language.

• Preview your changes before saving.

The default keybind can be changed through Minecraft's Controls menu.

Default Settings

Configuration File

Your settings are stored locally at:

.minecraft/config/totemwarning.json

The file is generated automatically when the mod launches for the first time.

📦 Installation

Requirements

• Minecraft Java Edition 1.21.11

• Fabric Loader 0.18.1 or newer compatible release

• Fabric API 0.141.0+1.21.11 or compatible release

• Java 21 or newer

Steps

1. Install Fabric Loader for Minecraft 1.21.11.

2. Install the matching Fabric API.

3. Download the latest Totem Warning release.

4. Place the downloaded .jar file into your Minecraft mods folder.

5. Launch the game using your Fabric installation.

6. Press "K" to open the configuration menu.

That's all you need.

🌐 Client-Side Compatibility

Totem Warning runs entirely on your client.

• No server-side installation required.

• Other players don't need the mod.

• Can be used on multiplayer servers.

• No server configuration required.

The mod provides visual reminders only. It does not automatically equip, move or replenish totems.

🛠️ Building From Source

Want to build the project yourself?

Requirements: JDK 21 and Git.

git clone https://github.com/zartheusdev/totem-warning.git

cd totem-warning

./gradlew build

For Windows:

.\gradlew.bat build

Compiled files will be available in build/libs/.

🐛 Feedback & Support

Found something that doesn't work as expected, or have an idea for a future improvement?

Feel free to open an issue on GitHub.

Report a bug · View source code

Suggestions and contributions are welcome.

📄 License

Totem Warning is distributed under the MIT License.

See the LICENSE file for details.

A little warning can make a big difference.

*Made for Minecraft players who would rather notice a missing totem before it's t