# PassivePhantoms<\/p>\n
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.<\/p>\n
**Note: Movement improvements are experimental and phantoms may still get hung up on chorus trees.**<\/p>\n
## How It Works<\/p>\n
1. **Natural Spawning**: Phantoms spawn normally in the end (no overworld spawning)
\n2. **Passive Behavior**: New phantoms are completely passive and won’t target players
\n3. **Provocation**: When a player attacks a phantom (melee or projectile), it becomes “angry” and can attack back
\n4. **Projectile Aggression**: Phantoms also become aggressive when hit by arrows, tridents, snowballs, or other projectiles
\n5. **Immediate Response**: Angry phantoms immediately target and attack the player who hit them
\n6. **Persistent Anger**: Once a phantom is angry, it remains aggressive, retaining vanilla behaviors
\n7. **Mobcap Protection**: Maximum of 8 phantoms per chunk prevents infinite spawning and ensures fair distribution
\n8. **Movement Improvements**: Automatic stuck detection and escape assistance prevents phantoms from getting trapped in chorus fruit trees<\/p>\n
## Installation<\/p>\n
1. **Download**: Get the latest JAR file from the releases (v1.2.5)
\n2. **Install**: Place `PassivePhantoms-1.2.5.jar` in your server’s `plugins\/` folder
\n3. **(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.
\n4. **Restart**: Restart your server
\n5. **Verify**: Check the console for “PassivePhantoms plugin enabled!” message<\/p>\n
## Configuration<\/p>\n
The plugin generates a `config.yml` file on first run with the following options:<\/p>\n
– `debug_logging`: Enable\/disable debug messages (default: false)
\n– `passive_phantoms_enabled`: Enable\/disable the plugin (default: true)
\n– `phantom_settings.custom_spawn_control`: Control phantom spawning (default: true)
\n– `phantom_settings.end_spawn_chance`: Chance for phantoms to spawn in The End (default: 0.05 = 5%)
\n– `phantom_settings.max_phantoms_per_chunk`: Maximum phantoms per chunk (default: 8)
\n– `phantom_settings.movement_improvements_enabled`: Enable movement improvements (default: true)
\n– `phantom_settings.stuck_detection_ticks`: How often to check for stuck phantoms (default: 100 ticks = 5 seconds)
\n– `phantom_settings.stuck_threshold`: Consecutive checks before considering stuck (default: 3)
\n– `phantom_settings.stuck_distance_threshold`: Minimum movement distance (default: 1.0 blocks)
\n– `phantom_settings.max_stuck_attempts`: Maximum escape attempts before removal (default: 5)<\/p>\n
## Commands<\/p>\n
– `\/passivephantoms` – Shows plugin version and usage
\n– `\/passivephantoms reload` – Reloads the configuration
\n– `\/passivephantoms debug` – Toggle debug logging
\n– `\/passivephantoms status` – Check plugin status and phantom populations
\n– `\/passivephantoms list` – List aggressive phantoms<\/p>\n
## Permissions<\/p>\n
– `passivephantoms.reload` – Allows reloading the configuration (default: op)<\/p>\n
## Building from Source<\/p>\n
### Prerequisites
\n– Java 8 or higher
\n– Maven 3.6 or higher<\/p>\n
### Steps
\n1. Clone this repository
\n2. Run: `mvn clean package`
\n3. Find the compiled JAR in the `target\/` folder<\/p>\n
## Compatibility<\/p>\n
– **Minecraft Version**: 1.13 – 1.21+
\n– **Server Type**: Bukkit, Spigot, Paper
\n– **Java Version**: 8 or higher<\/p>\n
## Troubleshooting<\/p>\n
**Phantoms not spawning in the end**
\n– Verify plugin is enabled (true by defualt)
\n– Check spawn chance setting in config.yml, it is low be default, increase it to verify functionality<\/p>\n
**Phantoms not attacking after being hit:**
\n– Make sure you’re using the latest version
\n– Check server console for any error messages
\n– Verify the plugin is enabled in the console<\/p>\n
**Plugin not loading:**
\n– Ensure you’re using Java 8 or higher
\n– Check that the JAR file is in the correct plugins folder
\n– Verify your server version is compatible<\/p>\n
**Projectiles not making phantoms aggressive:**
\n– Ensure you’re using version 1.2.5 or higher
\n– Check that the projectile was shot by a player
\n– Verify debug logging is enabled to see detailed messages<\/p>\n
**Too many phantoms spawning:**
\n– The mobcap system limits phantoms to 8 per chunk
\n– Use `\/passivephantoms status` to check phantom populations
\n– Enable debug logging to see mobcap status messages<\/p>\n
**Config issues after updating:**
\n– If you experience errors or missing features after updating the plugin, delete the entire `PassivePhantoms` config folder and let the plugin generate a new one. This ensures all new settings are present and avoids legacy config problems.<\/p>\n
**Phantoms getting stuck in chorus fruit trees:**
\n– The movement improvement system automatically detects and helps stuck phantoms
\n– Enable `movement_improvements_enabled: true` in your config (default: enabled)
\n– Use `\/passivephantoms status` to check plugin status
\n– Adjust `stuck_detection_ticks` for more\/less frequent checks
\n– Increase `stuck_threshold` if phantoms are being helped too aggressively<\/p>\n
## License<\/p>\n
This project is open source. Feel free to modify and distribute as needed.<\/p>\n
## Support<\/p>\n
If you need help or have suggestions, please open an issue on the GitHub repository or join the linked Discord and navigate to # plugin-help<\/p>\n","protected":false},"excerpt":{"rendered":"
A Minecraft Bukkit\/Spigot plugin that makes phantoms spawn natrually in the end (no overworld spawn) & are passive until they are attacked by a player.<\/p>\n","protected":false},"featured_media":119675,"template":"","meta":{"_minecraft_slug":"passivephantoms","_minecraft_project_id":"zdnQbWA0","_minecraft_author":"MightyFinger77","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":192,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"passivephantoms.zip","_minecraft_size_bytes":108610,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T12:48:01.430743Z","_minecraft_date_created":"2025-07-11T05:03:25.232254Z","_minecraft_date_modified":"2026-03-21T04:55:03.504159Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/passivephantoms","_minecraft_icon_attachment_id":119675,"_minecraft_imported_at":"2026-06-07T01:00:31+00:00","_minecraft_import_hash":"868aa51671e29018a527e2180045f164","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,126,137,127,128,129],"mod_loader":[131,132,133,134],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-119674","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-mobs","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n