Sakura Phantoms
A lightweight, high-performance plugin that adds passive Phantoms to the End dimension.
87
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
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.
performance first 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
* Fully Configurable: Phantoms spawn naturally in the End but will not attack unless provoked. * Fully Configurable: Uses efficient checks and lightweight scheduling to minimize server impact. No heavy loops or unoptimized entity tracking. * Fully Configurable: Includes configurable limits per chunk and per player to prevent entity spam. * Fully Configurable: 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).
Config
```
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)
