
Sanity Neo
A sanity system for Minecraft 1.21 NeoForge
Screenshots

About this Mod
Features
Core Sanity System
- Sanity Bar: Visual HUD overlay showing current sanity level (0-100%)
- Persistent Data: Player sanity is tracked and saved between sessions
- Dynamic Updates: Sanity changes based on multiple environmental factors
Sanity Factors
Light Level:
- Darkness (< 7 light level): Decreases sanity
- Bright light (>= 12 light level): Slowly recovers sanity
Hunger:
- Low hunger (≤ 6 food level): Decreases sanity faster
Sleep:
- Sleeping in a bed restores 50 sanity points
- Only applies when completing a full sleep cycle (not interrupted)
Thirst Integration (ThirstWasTaken mod):
- Ready for integration when ThirstWasTaken mod is present
- Will affect sanity when thirst is low
Temperature Integration (Cold Sweat mod):
- Ready for integration when Cold Sweat mod is present
- Extreme temperatures will affect sanity
Hallucinations & Visual Effects (Liminal Spaces Theme)
Visual Impairments (Sanity < 80%)
- Vignette Effect: Screen edges darken progressively
- Screen Distortion: Wavy lines and artifacts appear
- Color Shift: Desaturated/reddish color overlay
- Random Flashes (epilepsy warning): Quick white/red screen flashes
Hallucinations (Sanity < 30%)
Visual Hallucinations:
- Shadowy shapes appearing in corners
- Unsettling text messages ("You are not alone", "Behind you", etc.)
- Screen shake indicators
Entity Hallucinations (Sanity < 30%):
- Temporary phantom entities that appear and fade
- Completely harmless - cannot attack or damage player
- Include zombies, skeletons, endermen, creepers, phantoms
- Entities are ethereal (no AI, silent, invulnerable, no gravity)
- Auto-despawn after a few seconds
Sound Hallucinations (Sanity < 50%):
- Random eerie sounds from around the player
- Cave ambience, enderman sounds, ghast cries, warden ambience, etc.
Sanity Effects
Based on sanity level, players experience increasing debuffs:
- 20% or below: Nausea II, Darkness, Weakness
- 20-40%: Nausea I, Darkness
- 40-60%: Darkness
- 60-80%: Minor visual effects only
Available Versions
How to Install Sanity Neo on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set neoforge Loader
In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "Sanity Neo". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11, 1.21.10, 1.21.9 (+8 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Sanity Neo server crashes on startup – what to do?
Most common cause: wrong neoforge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is Sanity Neo compatible with neoforge?
Sanity Neo officially supports neoforge for Minecraft 1.21.11, 1.21.10, 1.21.9. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Sanity Neo – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Sanity Neo consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Sanity Neo with just one click on your server.