🛌 True Sleep

"Experience the Night. Smooth Accelerated Time-Warp Sleeping with World Continuity."

---

📖 Introduction

Vanilla Minecraft sleep is an instant, jarring black screen fade. You right-click a bed, the screen cuts to black for two seconds, and it is suddenly broad daylight. In that instant snap, nocturnal immersion is completely severed: you never experience the tranquil sweep of stars, passing weather systems, or the gentle break of dawn. Furthermore, world simulation is frozen: crops stop growing, furnaces stop smelting, and automation pauses until morning.

True Sleep reimagines nighttime resting under the Vanilla Outsider design philosophy. Instead of skipping time with a black fade, True Sleep smoothly accelerates world time in a cinematic Time-Warp simulation. Watch celestial bodies arc across the sky in high-speed timelapse, furnace ores smelt, crops advance through growth cycles, and hoppers feed machinery continuously toward morning.

[!NOTE] 1 Jar 1 Version Policy: I build 1 dedicated JAR for each Minecraft version anchor (MC 1.20.1, MC 1.21.1, MC 1.21.11, MC 26.1.2, MC 26.2, MC 26.3+). Please download the exact build that matches your Minecraft installation.

Dedicated Server Ready: Seamlessly compatible with multiplayer servers. When enough players sleep (respecting vanilla's playersSleepingPercentage), time accelerates smoothly for everyone in the dimension without desynchronization or lag spikes!

Part of the Vanilla Outsider Collection — modern mods designed to refine and elevate the vanilla Minecraft experience.

---

✨ Features

🌌 Smooth Celestial Time-Warp Timelapse

• No Black Fade: The jarring black sleep overlay is completely removed (extractSleepOverlay bypassed), allowing you to watch the passage of time directly from your bed.
• Fluid Sky Rendering: Employs client-side celestial angle interpolation so the sun, moon, clouds, and stars glide smoothly across the sky without jitter or teleporting jumps during high-speed simulation.
• 15-Tick Wind-Down Deceleration: If sleep is interrupted or morning arrives, time smoothly decelerates over 15 ticks back to normal 20 TPS rather than abruptly snapping.

⚙️ World Continuity & Machine Acceleration

• Continuous Tile Entity Processing: Furnaces, smokers, blast furnaces, brewing stands, campfires, beehives, bee nests, and modded machines (#truesleep:accelerated_machines) continue processing during sleep at matching speeds.
• Smart Hopper Coupling: Hoppers feeding into or pulling from active production machines automatically accelerate to feed items at matching speeds, preventing automation bottlenecks.

🐑 Biological Farm Aging & Sleep Hunger

• Living Animal Simulation: While mobs are in stasis, biological aging continues: sheep regrow wool via natural grass grazing, chicken egg timers advance, and baby animals mature (AgeableMob).
• Sleep Hunger Drain: A modest amount of hunger drains overnight (~3 to 4 food points over a standard night) so you wake up naturally ready for breakfast, with an unbreakable safety floor at sprint threshold (6 food level / 3 drumsticks).

🛑 Mob Stasis & Dynamic Entity Unfreezing

• TPS Preservation: General mob AI ticking is paused during time warp to save CPU performance and prevent wandering, suffocating, or despawning.
• Worker Mob Exemption: Villagers and iron golems can be optionally exempted from freezing via truesleep:freeze_workers.
• Dynamic Per-Mob Unfreeze Rules: Generates dynamic GameRules (truesleep:unfreeze_<namespace>_<entity>) for every registered entity type, allowing redstone engineers to unfreeze specific mobs for automated farms.

🏊 Safe Rest & Vibration Damping

• Pulmonary Stasis / Drown Immunity: Resting players maintain full oxygen supply underwater (truesleep:drown_immunity), enabling safe underwater base naps.
• Vibration Suppression: Sculk sensors and wardens ignore vibrations during time warp to prevent false alarms and warden summonings while resting.

---

📊 Feature Comparison Matrix

Sleeping Aspect	Vanilla Minecraft Sleep	True Sleep
Visual Transition	Sudden, jarring black screen fade	Smooth, high-speed celestial timelapse
Sky & Star Motion	Frozen jump	Buttery-smooth client angle lerping
Tile Entity Processing	Frozen until dawn skip	Continuous furnace, brewing & machine progression
Hopper Automation	Paused	Smart coupling acceleration to match machines
Farm & Animal Aging	Frozen	Simulated wool grazing, egg laying & baby growth
Waking Transition	Abrupt instant snap	Gentle 15-tick deceleration wind-down
Underwater Naps	Drowning damage risk	Pulmonary stasis (drown immunity)
Multiplayer Compatibility	Abrupt vote skip	Smooth dimension-wide time acceleration

---

⚙️ Native GameRules & Server Configuration

Configure True Sleep parameters dynamically in-game via /gamerule:

GameRule Key	Type	Default	Valid Range	Description
truesleep:virtual_tps	Integer	1000	20 – 100000	Time Speed: How fast night passes. 1000 = 50x speed.
truesleep:engine_tps	Integer	50	20 – 200	Performance Limit: Server tick target during sleep (keep at 40–60 for smooth CPU).
truesleep:sleep_threshold	Integer	12542	0 – 23999	Sleep Threshold: In-game tick when sleeping becomes allowed (12542 = sunset).
truesleep:wake_time	Integer	0	0 – 23999	Wake Time: In-game tick when waking up occurs (0 = sunrise).
truesleep:accelerate_machines	Boolean	true	true / false	Speeds up furnaces, brewing stands, beehives, and machines during sleep.
truesleep:accelerate_hoppers	Boolean	true	true / false	Speeds up hoppers connected to active production machines.
truesleep:freeze_mobs	Boolean	true	true / false	Pauses mob AI during sleep to eliminate lag and prevent wandering.
truesleep:freeze_workers	Boolean	false	true / false	Pauses villagers and iron golems during sleep.
truesleep:biological_aging	Boolean	true	true / false	Simulates sheep wool grazing, egg timers, and baby animal growth.
truesleep:sleep_hunger	Boolean	true	true / false	Gently burns player hunger overnight with safety floor.
truesleep:drown_immunity	Boolean	true	true / false	Prevents drowning damage while sleeping underwater.
truesleep:unfreeze_<namespace>_<entity>	Boolean	false	true / false	Selectively allows a specific mob type to bypass sleep freezing.

---

💻 In-Game Brigadier Command Suite

True Sleep provides a complete in-game command suite under /truesleep:

Command Syntax	Permission	Description
/truesleep status	All Players	Displays current time-warp status (ACTIVE / IDLE) and simulation stride multiplier.
/truesleep get <setting>	Admin (Level 2)	Queries the live value of any True Sleep configuration setting.
/truesleep set <setting> <value>	Admin (Level 2)	Live-updates a setting and synchronizes GameRules immediately.
/truesleep reset <setting>	Admin (Level 2)	Restores a setting back to its factory default value.
/truesleep reload	Admin (Level 2)	Reloads config/truesleep.json and updates all live GameRules.

---

🎨 Optional Client Configuration GUI

Prefer a visual settings screen? True Sleep includes an optional client configuration screen powered by ModMenu and YetAnotherConfigLib (YACL v3):

• General Settings: Tune Performance Limit (engine_tps), Time Speed (virtual_tps), and Machine / Hopper acceleration.
• Dreamweaver Settings: Adjust Sleep Threshold, Wake Time, Mob Freezing, Worker Freezing, and Drown Immunity.
• Side-Safe: The GUI is strictly optional and client-only. Running True Sleep on dedicated servers without YACL will never cause crashes or classloader issues.

---

☕ Support & Creator Community

I am an independent solo developer creating lightweight, vanilla-enhancing mods that respect your time and game performance. If True Sleep enchants your nights, consider supporting my work:

[!TIP] 🇮🇩 Indonesian Local Payment Note: Indonesian supporters can support my development work directly using local payment options (GoPay, OVO, Dana, QRIS, LinkAja) via Saweria or SocioBuzz!

Join my Discord community for live development updates, early test builds, and friendly support:

• 💬 Discord Community: https://discord.gg/EV99bgAFqb

---

📜 Metadata & Permissions

Property	Value
Mod Name	True Sleep
Namespace / Mod ID	truesleep (vanilla-outsider-true-sleep)
License	GNU General Public License v3.0 (GPLv3)
Side Safety	Server & Client (Synchronized)
Source Code	GitHub Repository
Issue Tracker	GitHub Issues

[!IMPORTANT] 📦 Modpack Permissions & Distribution:
You are fully welcome to include this mod in any modpack on any platform! However, the mod file must be downloaded directly through official distribution channels (Modrinth or CurseForge). Re-uploading, mirroring, or redistributing the original mod JAR to third-party mirror sites, scraper portals, or unauthorized launchers is strictly prohibited.

⚖️ License & Fork Guidelines (No Zero-Change Re-uploads):
This project is open-source under the GNU GPLv3. You are fully encouraged to inspect the code, learn from it, and fork the repository to create genuine modifications, substantial feature expansions, or community ports—provided your project remains open-source under GPLv3 with proper attribution.
However, straight 1:1 re-uploads, clone forks with no meaningful functional changes, or re-publishing identical builds under different project names (e.g. to farm downloads or rewards) are strictly forbidden.

---