Описание
# Combat Assistant Mod
PvP combat helper for Minecraft 1.21.11 (Fabric)
## Features
### Damage Dealt Tracker
Shows real-time damage dealt to enemies in the action bar. When you hit an entity, you'll see the exact amount of damage dealt displayed in red and yellow.
- Format: `Damage: 5.2`
- Tracks up to 30 blocks away
- Displays for 3 seconds after each hit
### Damage Taken Indicator
Displays damage you receive when hit by enemies. Helps you understand how much damage you're taking in combat.
- Format: `Damage Taken: 3.5`
- Shows for 3 seconds after each hit
- Useful for assessing threat levels
### Spear Combat Helper
Provides real-time feedback on spear lunge conditions. The mod shows you exactly what conditions are needed to perform a successful lunge attack.
Status messages:
- `Charge spear...` - Charge your attack fully
- `Move forward to lunge!` - You need forward momentum
- `READY TO LUNGE` (green) - Optimal conditions met
Lunge requirements:
- Fully charged attack (90% or higher)
- Moving forward
- Airborne or falling (jumping helps)
- Not in water
### Weapon Swap Detection
Helps to visualize attribute swaps with a notification message. Shows what weapon you swapped from and to.
- Format: `Swapped: Iron Sword to Diamond Sword`
- Displays in green when swap is detected
- Confirms equipment changes instantly
### Mace Range Helper
Displays the distance to the nearest entity when holding a mace. Helps you know if targets are within effective range.
- Format: `Mace Range: 4.2 blocks`
- Shows nearest entity distance
- Updates in real-time
## Installation
1. Download modid-1.0.0.jar from the releases
2. Place it in your .minecraft/mods/ folder
3. Launch Minecraft with Fabric Loader installed
4. All features will be enabled automatically
## Usage for Users
Download the mod. Open the folder where Minecraft is stored, and keep it in the mods folder.
## Usage FOR DEVS
Testing the mod in single player:
```
gradlew runClient
```
Building the mod from source:
```
gradlew build
```
The compiled JAR will be created at: build/libs/modid-1.0.0.jar
## PvP Combat Guide
### Attribute Swapping
Use your hotbar number keys (1-9) to quickly swap between weapons. The mod will confirm each swap with a notification message showing which weapon you switched to.
- Press hotbar keys for instant swaps
- Watch for the swap confirmation message
### Spear Lunge Technique
To land consistent spear lunges:
1. Jump first to guarantee you're airborne
2. Charge your attack by holding the attack button
3. Move forward while the attack is charging
4. Watch for the green "READY TO LUNGE" message
5. Release to execute the lunge
### Reading Damage Numbers
Monitor both damage dealt and damage taken to adjust your strategy:
- High damage dealt: Your attacks are landing effectively
- High damage taken: You may need better armor or healing
- Track patterns to understand matchups
### Mace Combat
When using a mace:
- Check the range indicator before attacking
- Mace has good reach compared to swords
- Most effective at close to medium range
## Technical Details
Language: Java 21
Minecraft Version: 1.21.11
Fabric Loader: 0.18.2 or higher
Fabric API: 0.139.4 or higher
Main Components:
- CombatAssistant.java - Main tick handler and event listener
- SpearHelper.java - Spear lunge condition detection
- DamageDealtTracker.java - Entity damage tracking
- DamageIndicator.java - Damage display system
- SpearOptimizationMixin.java - Server-side optimization mixin
## Compatibility
Works on multiplayer servers (no server mod required)
Works in single player worlds
Compatible with other Fabric mods
Errors might occur with lag optimization in multiplayer servers
## Building from Source FOR DEVS
Requirements:
- Java 21 or higher
- Gradle
Build:
```
gradlew build
```
Run client:
```
gradlew runClient
```
The mod uses Fabric Loom for development and Mixin for bytecode modifications.
## License
This mod is released under the CC0 license (public domain).