PassivePhantoms

# PassivePhantoms A Minecraft Bukkit/Spigot plugin that makes phantoms spawn naturally in the end & are passive until they are attacked by a player. Features a per-chunk mobcap system to prevent infinite spawning and movement improvements to help prevent phantoms from getting hung up on chorus fruit trees. **Note: Movement improvements are experimental and phantoms may still get hung up on chorus trees.** ## How It Works 1. **Natural Spawning**: With custom spawn control, End spawns are enabled by default; Overworld is off unless `allow_overworld_spawning` is true 2. **Passive Behavior**: New phantoms are completely passive and won't target players 3. **Provocation**: When a player attacks a phantom (melee or projectile), it becomes "angry" and can attack back 4. **Projectile Aggression**: Phantoms also become aggressive when hit by arrows, tridents, snowballs, or other projectiles 5. **Immediate Response**: Angry phantoms immediately target and attack the player who hit them 6. **Persistent Anger**: Once a phantom is angry, it remains aggressive, retaining vanilla behaviors 7. **Mobcap Protection**: Maximum of 8 phantoms per chunk prevents infinite spawning and ensures fair distribution 8. **Movement Improvements**: Automatic stuck detection and escape assistance prevents phantoms from getting trapped in chorus fruit trees ## Installation 1. **Download**: Get the latest JAR file from the releases (v1.3.0-Dev2a) 2. **Install**: Place `PassivePhantoms-1.3.0-Dev2a.jar` in your server's `plugins/` folder 3. **(Recommended)**: If updating from an older version, delete the entire `PassivePhantoms` config folder and let the plugin generate a new one on next server start. This ensures you get all new config options and avoid legacy issues. 4. **Restart**: Restart your server 5. **Verify**: Check the console for "PassivePhantoms plugin enabled!" message ## Configuration The plugin generates a `config.yml` file on first run with the following options: - `debug_logging`: Enable/disable debug messages (default: false) - `passive_phantoms_enabled`: Enable/disable the plugin (default: true) - `phantom_settings.custom_spawn_control`: Control phantom spawning (default: true) - `phantom_settings.allow_overworld_spawning`: Allow vanilla Overworld phantom spawns when custom spawn control is on (default: false) - `phantom_settings.allow_end_spawning`: Allow custom End phantom spawns when custom spawn control is on (default: true) - `phantom_settings.end_spawn_chance`: Chance for phantoms to spawn in The End (default: 0.05 = 5%) - `phantom_settings.max_phantoms_per_chunk`: Maximum phantoms per chunk (default: 8) - `phantom_settings.movement_improvements_enabled`: Enable movement improvements (default: true) - `phantom_settings.stuck_detection_ticks`: How often to check for stuck phantoms (default: 100 ticks = 5 seconds) - `phantom_settings.stuck_threshold`: Consecutive checks before considering stuck (default: 3) - `phantom_settings.stuck_distance_threshold`: Minimum movement distance (default: 1.0 blocks) - `phantom_settings.max_stuck_attempts`: Maximum escape attempts before removal (default: 5) ## Commands - `/passivephantoms` - Shows plugin version and usage - `/passivephantoms reload` - Reloads the configuration - `/passivephantoms debug` - Toggle debug logging - `/passivephantoms status` - Check plugin status and phantom populations - `/passivephantoms list` - List aggressive phantoms - `/passivephantoms update` - Check Modrinth for a newer version ## Permissions - `passivephantoms.reload` - Allows reloading the configuration (default: op) - `passivephantoms.notify` - Receive update notice on join when outdated (default: op) - `passivephantoms.update` - Allows `/passivephantoms update` (default: op) ## Mobcap System The plugin implements a per-chunk mobcap system to prevent infinite phantom spawning: - **Per-chunk limit**: Configurable maximum phantoms per chunk (default: 8) - **Fair distribution**: Prevents single players from monopolizing all phantoms - **Multiple chunks**: Each chunk can independently reach its limit - **Efficient counting**: Uses chunk coordinates for fast phantom counting - **Debug monitoring**: Shows chunk status and phantom populations in debug logs - **Configurable**: Server admins can adjust the limit via `phantom_settings.max_phantoms_per_chunk` - **Strict enforcement**: The mobcap is strictly enforced; no chunk will ever exceed the configured limit, mirroring vanilla mobcap logic. - **Verification**: Enable `debug_logging: true` in your config to see log messages whenever the chunk mobcap is reached or enforced. ## Building from Source ### Prerequisites - Java 8 or higher - Maven 3.6 or higher ### Steps 1. Clone this repository 2. Run: `mvn clean package` 3. Find the compiled JAR in the `target/` folder ## Compatibility - **Minecraft Version**: 1.13 – 1.21+ / 26.x - **Server Type**: Bukkit, Spigot, Paper, **Folia** - **Folia**: Fully supported (`folia-supported: true`). En