hEndermanFix
Automatic Enderman Targeting Fix for Paper-Based Servers
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
hEndermanFix is a lightweight plugin that keeps Endermen focused on nearby Endermites.
The plugin automatically tracks Endermen and Endermites, searches for the closest valid Endermite in a configurable radius, and forces Endermen to target it. It can also mark Endermites as player-spawned and force Endermen AI/aware state before applying the target.
No commands, permissions, databases or extra dependencies are required.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Main Features
- Automatic Enderman and Endermite tracking.
- Forces Endermen to target the nearest valid Endermite.
- Configurable target radius.
- Configurable target check interval.
- Configurable missed-check cleanup.
- Optional Endermite player-spawned marking.
- Optional force AI setting for Endermen.
- Optional force aware setting for Endermen.
- Loads already spawned entities when the plugin starts.
- Automatically unregisters dead or removed entities.
- No commands required.
- No permissions required.
- No database required.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
How It Works
When an Endermite appears in the world, hEndermanFix registers it and checks nearby entities.
If nearby Endermen are found, the plugin starts tracking them and repeatedly updates their target to the nearest valid Endermite inside the configured radius.
The plugin also scans already loaded worlds on startup, so existing Endermen and Endermites can be handled without waiting for new entities to spawn.
────────────────────────────────────────
Entity Tracking
The plugin listens for:
- Entity add events.
- Entity remove events.
- Entity death events.
This allows hEndermanFix to keep its internal entity lists clean and avoid tracking invalid or dead entities.
────────────────────────────────────────
Target Updates
During each check, the plugin:
- Removes invalid Endermites from tracking.
- Finds the nearest Endermite for each tracked Enderman.
- Checks that both entities are in the same world.
- Applies the target if needed.
- Removes Endermen that no longer have valid Endermites nearby after too many missed checks.
This keeps the system focused only on active and relevant entities.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Configuration
Default configuration:
Code (Text):
settings:
enable: true
targetRadius: 64.0
checkPeriodTicks: 2
maxMissedChecks: 50
markEndermitePlayerSpawned: true
forceAI: true
forceAware: true
────────────────────────────────────────
Settings
Code (Text):
enable
Enables or disables the plugin logic.
targetRadius
Maximum radius where Endermen can search for Endermites.
checkPeriodTicks
How often tracked Endermen should update their target.
maxMissedChecks
How many checks an Enderman can miss before it is removed from tracking.
markEndermitePlayerSpawned
Marks tracked Endermites as player-spawned.
forceAI
Forces Endermen AI to enabled before setting the target.
forceAware
Forces Endermen aware state to enabled before setting the target.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Commands
hEndermanFix does not add any commands.
The plugin works automatically after the server starts.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Permissions
hEndermanFix does not require any permissions.
There are no player commands or admin commands in the current version.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Requirements
- Java 8 or newer.
- Paper or a Paper-based fork.
- Minecraft 1.16 or newer.
Important: the plugin uses Paper entity world events, so Paper or a Paper-based server fork is required.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Installation
- Place hEndermanFix.jar into your server's plugins folder.
- Restart the server.
- Open the generated configuration file.
- Adjust the settings if needed.
- Restart the server again to apply configuration changes.
Configuration file:
Code (Text):
plugins/hEndermanFix/config.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Notes
- The plugin has no reload command.
- Restart the server after changing the configuration.
- The plugin does not modify blocks, inventories or player data.
- The plugin only works with Endermen and Endermites.
- The system automatically stops its target task when no tracked entities remain.