Description
## What is Enderman Look Guard?
Enderman Look Guard is a client-side quality-of-life mod for Fabric that prevents one of Minecraft's most common mistakes: accidentally looking an Enderman in the eyes. Instead of snapping your camera away harshly, the mod gently nudges your view direction in the moment before accidental stare would happen — so it feels like protective aim assistance rather than forced camera control.
It does not remove Endermen, change their behavior, alter combat, or touch any server-side mechanics. Endermen remain completely vanilla. The mod only adjusts where you are looking.
---
## How it works
Each game tick, the mod checks whether your crosshair is drifting toward a nearby Enderman. If it is, it applies a small camera correction a soft push away from the Enderman's eye line. The effect repeats each tick while the risk condition remains true. This means:
- No sudden snapping or teleporting of your view
- No disruption to your normal movement or aim
- Protection fades naturally the moment you are no longer at risk
Detection checks multiple vertical points on the Enderman's body, not just one spot, so it matches real gameplay well.
---
## Features
- **Gentle camera nudge** : soft, repeated correction instead of jarring snaps
- **Configurable detection range** : set your max distance from 0 (unlimited) to 256 blocks
- **Separate horizontal and vertical sensitivity** : tune yaw and pitch correction independently
- **Optional HUD indicator** : shows "Enderman Protection Active" near your crosshair when protection triggers
- **Mod Menu config screen** : all settings are adjustable in-game with tooltips on every option
- **Immediate save on change** : no need to exit the config screen to apply settings
- **Lightweight and client-side only** : install on any server, no server-side component needed
---
## Default configuration
| Setting | Default | Range |
|---|---|---|
| Enabled | true | — |
| Show HUD | true | — |
| Max Distance | 64 blocks | 0–256 |
| Yaw Adjust | 2.0 | 0–10 |
| Pitch Adjust | 1.0 | 0–10 |
Max Distance of 0 = unlimited (up to 256 blocks). Config is saved to `config/endermanlookguard.json`.
---
## Requirements
- Fabric Loader
- Fabric API
- Mod Menu (optional, for in-game config screen)
---
## What this mod is NOT
This is not a combat automation tool, a cheat, or a mob-disabling mod. Endermen are never frozen, killed, or altered. It is purely a preventive accessibility and quality-of-life aid.