## 📋 Description
TotemCounterV2 is a professional Fabric mod for Crystal PVP players. It accurately tracks totem pops with a fully customizable, mouse-interactive HUD featuring transparent backgrounds and smooth animations.
## ✨ Features
- ✅ **100% Accurate Counting** - Entity status packet detection with duplicate filtering
- ✅ **Mouse-Interactive HUD** - Left-click drag to move, right-click corners to resize
- ✅ **Transparent Backgrounds** - 40% opacity for minimal screen obstruction
- ✅ **Preset Soft Colors** - Beautiful pastel color palette
- ✅ **Auto-Reset on Death** - Counters reset when player dies
- ✅ **Customizable Hotkeys** - Choose your preferred config key (L/J/K/M)
- ✅ **Edit Mode** - Press **Ş** key for quick HUD editing
- ✅ **Mod Menu Integration** - Full configuration through Mod Menu
- ✅ **Totem Icons** - Visual totem items in HUD
- ✅ **Distance Filter** - Show only nearby players
- ✅ **Auto Sorting** - Most pops displayed first
- ✅ **Performance Optimized** - Minimal CPU/RAM impact
- ✅ **Open Source** - MIT license
## 📥 Download
Download the latest release from [Releases](../../releases) page:
- **[totemcounterv2-2.0.0.jar](../../releases)** - Compatible with all Minecraft 1.21.x versions
**Single JAR for all 1.21 versions!** Works on 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, and future 1.21.x releases.
## 🚀 Installation
### Requirements
1. **Minecraft** 1.21.x (any 1.21 version)
2. **[Fabric Loader](https://fabricmc.net/use/)** 0.15.11+
3. **[Fabric API](https://modrinth.com/mod/fabric-api)** (latest for your MC version)
4. **Java 21** ([Download Adoptium JDK 21](https://adoptium.net/temurin/releases/?version=21))
### Steps
1. Install Fabric Loader for Minecraft 1.21.x
2. Download latest Fabric API from Modrinth/CurseForge
3. Download **totemcounterv2-2.0.0.jar** from [Releases](../../releases)
4. Place both JAR files in `.minecraft/mods` folder
5. Launch Minecraft with Fabric profile
6. First launch: **Choose your config hotkey** (L/J/K/M)
## 🎮 Usage
### First Time Setup
On first launch, you'll be prompted to choose your **config menu hotkey**:
- **L** (recommended)
- **J**
- **K**
- **M**
### Basic Usage
1. Join a server or world
2. HUD automatically displays when players pop totems
3. Counters reset automatically when players die
4. Press your **config key** to open settings
5. Press **Ş** key to enter Edit Mode
### Hotkeys
- **L/J/K/M** (your choice): Open configuration menu
- **Ş**: Toggle Edit Mode (drag & resize HUD)
- **ESC**: Exit Edit Mode and save
### Edit Mode
**Activate:** Press **Ş** key or click "EDIT MODE" button in settings
**Controls:**
- **Left-Click Drag HUD**: Move position
- **Right-Click Drag Corners**: Resize (yellow handles)
- **Ş or ESC**: Save and exit
### Settings Menu
**Open:** Press your config key (default: L) or via **Mod Menu**
#### Color Settings
Choose from beautiful preset colors (no hex codes needed!):
**Text Colors:**
- Soft White, Soft Pink, Soft Blue, Soft Green
- Soft Yellow, Soft Purple, Soft Orange, Soft Mint
**Background Colors** (40% opacity - transparent!):
- Dark BG, Gray BG, Blue BG, Green BG, Purple BG, Very Clear BG (20%)
**Border Colors:**
- White Border, Gold Border, Aqua Border, Red Border, Lime Border
#### Display Options
- **Show Background**: Background on/off
- **Show Border**: Border on/off
- **Show Icon**: Show/hide totem icons ⭐
- **Show Self**: Display your own totem count
- **Show Only Nearby**: Distance filter
- **Nearby Distance**: How many blocks (default: 50)
- **Max Players**: Maximum players shown (default: 10)
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }