Phantom-Warn

A tiny vanilla-style status icon that warns when insomnia makes phantom spawns possible.

Phantom Warning

Version 1.0.0 Minecraft 26.3 Fabric NeoForge Modrinth downloads CurseForge downloads GitHub downloads

A tiny vanilla-style status icon that warns when insomnia makes phantom spawns possible. Client-side only - Minecraft 26.3 - Fabric and NeoForge

Based on the concept of Insomnia Notifier by Arthur Ginzburg. Independently reimplemented for Minecraft 26.3 Fabric and NeoForge. Not affiliated with the original author; no code or assets of the original were used.

The warning next to vanilla effects

What it does

After more than three in-game days without resting, Minecraft starts rolling phantom spawns for you at night. Phantom Warning shows a small icon exactly where vanilla shows harmful effects. No chat messages, no sounds, no banner in the middle of the screen.

  • Appears when your time since the last rest is above 72,000 ticks (3 in-game days, the vanilla limit).
  • Disappears at once when you lie down in a bed (a moment is enough) or die.
  • Overworld only by default - vanilla spawns phantoms nowhere else.
  • Inventory: listed in the effect list with your days awake, because vanilla hides the HUD icons there.
  • Game rule aware: hidden when spawn_phantoms is known to be off (singleplayer, LAN host, operator). Never hidden on a guess.
  • Client-side only: nothing to install on the server, no custom packets, works on vanilla servers.

It is a warning, not a prediction: the server still rolls the regional difficulty, the insomnia chance and a free spawn spot.

Icons

  • Insomnia (default): a glowing phantom eye.
  • Alert (optional, advancedChecks=true): red eye when everything the client can see is met - night or thunder, open sky, at or above sea level, not spectator, not peaceful.
  • Phantom style (iconStyle=phantom): a small phantom silhouette, also with calm and alert variant.

Settings

Optional, in config/phantomwarning.properties (created on first start):

  • enabled (true) - show the warning
  • iconStyle (eye) - eye or phantom
  • thresholdTicks (72000) - icon above this many ticks since the last rest
  • overworldOnly (true) - only warn in the Overworld
  • advancedChecks (false) - alert icon when the visible spawn conditions are met
  • useGameRule (true) - respect spawn_phantoms where it is known
  • showInInventory (true) - entry in the inventory effect list
  • resyncSeconds (60) - refresh interval of the statistic (15-3600)

How accurate is it?

The mod reads the real statistic from the server (the vanilla packet of the Statistics screen) and only shows the icon after the server confirmed a value above the threshold. Between refreshes it counts along with the rules of Minecraft 26.3 and learns the server's counting speed (NeoForge 26.3 servers were measured counting twice as fast as vanilla in the Overworld).

Limits: nothing is shown before the first server answer; the game rule is unknown on servers where you are not an operator; server plugins or mods that change phantom spawning can make the warning early or late.

Requirements

  • Fabric: Fabric API.
  • NeoForge: nothing else.
  • Client only. A server installation is not needed.

Links

Phantom-Warn Team

profile avatar
  • 9
    Projects
  • 6.4K
    Downloads
Donate

More from cptgummiballView all

  • Last Used project image

    Last Used

    See at a glance when you last used an item

    • 15
    • November 17, 2026
  • SignIt Modern project image

    SignIt Modern

    Sign any item with an emerald: signer, UTC timestamp and a collectible rarity

    • 2
    • November 17, 2026
  • Sticky Notes project image

    Sticky Notes

    Colourful paper notes you can write on and stick to any block face. For Fabric and NeoForge.

    • 36
    • November 17, 2026
  • QNet project image

    QNet

    Industrial tech from the first dynamo to dimensional rifts: build animated multiblock factories, run simulated reactors from fission to fusion and mine virtual dimensions with rift gates. Recipes adapt to other mods’ materials.

    • 500
    • November 17, 2026
  • Last Used project image

    Last Used

    See at a glance when you last used an item

    • 15
    • November 17, 2026
  • SignIt Modern project image

    SignIt Modern

    Sign any item with an emerald: signer, UTC timestamp and a collectible rarity

    • 2
    • November 17, 2026
  • Sticky Notes project image

    Sticky Notes

    Colourful paper notes you can write on and stick to any block face. For Fabric and NeoForge.

    • 36
    • November 17, 2026
  • QNet project image

    QNet

    Industrial tech from the first dynamo to dimensional rifts: build animated multiblock factories, run simulated reactors from fission to fusion and mine virtual dimensions with rift gates. Recipes adapt to other mods’ materials.

    • 500
    • November 17, 2026