Notice: If you want to use this mod in 1.21, get Cherry On Top, the phantom spawning rework is included in it as a feature.

Features

Altitude-Based Phantom Spawning

When enabled, the game attempts to spawn phantoms around the player when they're above the defined starting Y height. The chance that the spawn attempt will succeed is based on how much higher the player is above the starting Y height.

• Replaces the vanilla insomnia-based phantom spawning mechanic
• Setting the doInsomnia game rule to false still disables all phantom spawns
• Phantoms still only spawn at night, and still won't spawn if there is a block above the player that blocks light
• The chance of the spawn attempt succeeding is the following: 1 - (startingYHeight / playerYPosition)

Configuration options:

• Toggle altitude-based spawning on or off
• Set the starting Y height for spawning (default 128)
• Set the frequency at which the spawn check will run, in seconds (default 30 + random number from 0 to 29)

Repel Phantom Spawns with Defined Items

When enabled, phantoms will be unable to spawn if the player is holding any item defined as a repellent item in their main hand or off-hand.

Configuration options:

• Toggle phantom repelling on or off
• Add new items to the phantom repellent item list (default: minecraft:phantom_membrane)

QA

Why?

The vanilla phantom spawning mechanic sucks.

More features?

Maybe. I'm open to suggestions.

Backport to older versions?

Maybe in the future.

Forge?

No