Sakura Phantoms

SakuraPhantoms adds atmospheric, passive Phantoms to the End dimension. These creatures will fly around peacefully and only become aggressive if a player attacks them first.

Why this plugin?

Originally developed for my own server (hence the "Sakura" name), I decided to release this publicly after failing to find a suitable alternative. Most existing ambient phantom plugins suffer from legacy code, poor optimization, or heavy methods that drag down server performance.

SakuraPhantoms was written with performance first in mind. The code is clean, modern, and strictly optimized to ensure it adds atmosphere without costing you TPS.

Features

• Passive Behavior: Phantoms spawn naturally in the End but will not attack unless provoked.
• Highly Optimized: Uses efficient checks and lightweight scheduling to minimize server impact. No heavy loops or unoptimized entity tracking.
• Smart Spawning: Includes configurable limits per chunk and per player to prevent entity spam.
• Anti-Stuck System: Includes a smart task that detects if phantoms are stuck in terrain and gently unstucks them.
• Fully Configurable: Every aspect is customizable via config.yml (spawn chance, radius, height, limits, and more).

### Configuration
The plugin is ready to use out of the box, but you can tweak everything:
*   Spawn intervals and chances.
*   Minimum/Maximum spawn radius and height offsets.
*   Hard limits on phantoms per player/chunk.
*   Anti-stuck sensitivity.# PassivePhantoms Configuration

spawn:
  # Interval between spawn attempts in ticks (20 ticks = 1 second)
  interval-ticks: 100
  # Chance for spawn attempt to succeed per player (0.0 - 1.0)
  chance: 0.15
  # Maximum phantoms allowed per chunk
  max-per-chunk: 3
  # Maximum phantoms allowed around one player (in max-radius area)
  max-per-player: 8
  # Minimum distance from player for spawn (blocks)
  min-radius: 20
  # Maximum distance from player for spawn (blocks)
  max-radius: 40
  # Minimum height offset above player
  min-height-offset: 10
  # Maximum height offset above player
  max-height-offset: 30
anti-stuck:
  # Interval between stuck checks in ticks
  check-interval-ticks: 100
  # Minimum distance phantom must move to not be considered stuck (blocks)
  min-movement-distance: 2.0
  # Number of stuck checks before teleporting phantom
  max-stuck-checks: 3

Commands & Permissions

• /sakuraphantoms reload — Reload the configuration file.
• Permission: sakuraphantoms.reload (Default: OP)