hEndermanFix

hEndermanFix is a lightweight Paper/Purpur plugin that fixes Enderman targeting behavior around Endermites.

The plugin automatically tracks Endermen and Endermites, finds the nearest valid Endermite within a configured radius, and keeps Endermen targeting it. It works automatically after startup and does not require commands, permissions, databases or external plugin dependencies.

---

Overview

hEndermanFix has one focused job: keeping Endermen properly locked on nearby Endermites.

When an Endermite appears, the plugin registers it and checks nearby Endermen. When an Enderman appears, the plugin registers it and searches for the closest valid Endermite in the same world. If a valid Endermite is found, the plugin sets it as the Enderman target.

The plugin also scans already loaded entities on startup, so existing Endermen and Endermites can be handled after a server restart.

---

Features

• Automatic Enderman target fixing
• Endermite tracking
• Enderman tracking
• Startup entity loading
• Nearest Endermite selection
• Configurable target radius
• Configurable check interval
• Configurable missed-check limit
• Optional Endermite player-spawned marking
• Optional AI forcing for Endermen
• Optional aware-state forcing for Endermen
• Automatic cleanup of invalid entities
• No commands required
• No permissions required
• No database required
• No external plugin dependencies

---

Targeting

The plugin keeps a lightweight runtime list of tracked Endermen and Endermites.

During each check cycle, hEndermanFix:

1. Verifies that the Enderman is still valid.
2. Searches for the nearest valid Endermite.
3. Checks that the Endermite is in the same world.
4. Checks the configured target radius.
5. Forces AI and aware state if enabled.
6. Sets the Endermite as the Enderman target.
7. Removes the Enderman from tracking after too many missed checks.

The repeating task stops automatically when there are no tracked Endermen left.

---

Config

Default configuration:

settings:
  enable: true
  targetRadius: 64.0
  checkPeriodTicks: 2
  maxMissedChecks: 50
  markEndermitePlayerSpawned: true
  forceAI: true
  forceAware: true

Options

Option	Description
settings.enable	Enables or disables the plugin logic
settings.targetRadius	Maximum search radius for nearby Endermites
settings.checkPeriodTicks	How often tracked Endermen are checked
settings.maxMissedChecks	How many missed checks are allowed before an Enderman is removed from tracking
settings.markEndermitePlayerSpawned	Marks tracked Endermites as player-spawned
settings.forceAI	Forces Enderman AI to enabled before targeting
settings.forceAware	Forces Enderman aware state to enabled before targeting

---

Commands

hEndermanFix has no commands.

The plugin works automatically through entity tracking and configuration.

---

Permissions

hEndermanFix has no permissions.

No player or administrator permissions are required.

---

Requirements

Requirement	Status
Paper or a compatible Paper fork	Required
Minecraft 1.16 or newer	Required
PlaceholderAPI	Not required
Vault	Not required
Database	Not required

Paper or a compatible Paper fork is required because the plugin uses Paper entity add and remove events.

The plugin is compiled for Java 8 bytecode. Use the Java version required by your Minecraft server version.

---

Install

1. Place hEndermanFix.jar into the plugins folder.
2. Restart the server.
3. Open the plugin folder:

plugins/hEndermanFix/

1. Edit config.yml if needed.
2. Restart the server after changing the configuration.

---

Notes

• The plugin starts automatically when the server enables it.
• There is no reload command.
• A server restart is recommended after editing the configuration.
• Lower checkPeriodTicks values make checks run more often.
• Higher targetRadius values increase the search area.
• The plugin does not change mob drops, mob caps, spawning rules or world generation.