hEndermanFix

# 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: ```yaml 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: ```text plugins/hEndermanFix/ ``` 4. Edit `config.yml` if needed. 5. 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.