⏱️ Vanilla Outsider: 真實睡眠 (True Sleep) Wiki
📌 程式碼儲存庫原始碼聲明：本 Wiki 中的文件反映了程式碼儲存庫目前的最新原始碼狀態，可能包含尚未在 CurseForge 和 Modrinth 上發布的開發中功能或最新提交。
🧭 主文件導覽門戶
歡迎查閱 Vanilla Outsider: 真實睡眠 (True Sleep) 官方技術文件。本專案是遵循 Vanilla Outsider (VO) 原版外延設計哲學打造的高級世界模擬模組。
在原版 Minecraft 中，睡眠是透過在 0 個遊戲刻內將世界時鐘從黃昏跳轉到清晨來瞬間跳過黑夜（伴隨 $100\text{ ticks}$ 的淡入淡出畫面）。這種設計雖然簡單，但會瞬間強行暫停整個後台世界的模擬進程：熔爐燒煉半途凍結、農作物與幼年動物停滯生長、釀造台藥水進度停擺。
True Sleep 用極致絲滑、連續運行的伺服器 Tick 加速引擎（時間曲速 Time Warp）徹底取代了原版的瞬間跳過機制。遊戲時間以高達 50倍～250倍 的速度平滑加速，同時保持整個生機勃勃的世界正常運轉——擁有機器多倍 Tick 推進、農場生物學自然生長，以及無縫銜接的電影級天體日月星辰渲染。
🌟 核心子系統矩陣
| 子系統 | 技術描述 | 參考頁面 |
|---|---|---|
| ⚡ 時間曲速與跨步加速 | 動態調整伺服器 Tick 率與時間跨步（$20\text{ 至 }100{,}000\text{ Virtual TPS}$），並配備絲滑的 15 刻緩衝減速。 | 時間曲速與Tick加速引擎 |
| 🔥 機器與漏斗加速 | 對熔爐、煙燻爐、高爐、釀造台、蜂箱及相連漏斗執行多倍 Tick 推進以匹配曲速。 | 機器與漏斗加速 |
| 🐑 生物停滯與農場老化 | 凍結危險敵對生物尋路，同時真實模擬幼年動物成長、下蛋計時與羊吃草恢復羊毛。 | 生物停滯與農場老化 |
| 🥖 睡眠飢餓消耗與溺水免疫 | 模擬睡眠時的自然食物消耗（最低保護底線為 $6\text{ 點飢餓值}$），並提供水下呼吸肺部停滯保護。 | 睡眠飢餓消耗與溺水免疫 |
| 🌌 天體平滑與客戶端電影級天空 | 消除全黑遮罩，利用角插值演算法（$0.35\text{ 平滑因子}$）實現日月星辰的平滑縮時攝影效果。 | 天體平滑與客戶端電影級天空 |
| 🎛️ 動態遊戲規則 (GameRules) | 完全可配置的命名空間規則，涵蓋 truesleep:config 及各生物專屬的 truesleep:mob_settings 解凍規則。 | 命名空間GameRules參考 |
| 💻 專屬 Brigadier 指令 | 完整的 /truesleep 指令套件（status、get、set、reset、reload），支援管理員權限。 | Brigadier指令套件 (/truesleep) |
| ⚙️ 設定介面與 ModMenu | JSON 設定檔 (truesleep.json)、Cloth Config 客戶端介面支援與熱重載功能。 | 設定與圖形介面 (GUI) |
| 🏷️ 資料驅動標籤擴充 | 可自訂的資料包標籤：#truesleep:accelerated_machines 與 #truesleep:worker_mobs。 | API與資料驅動標籤擴充 |
🚀 快速上手與生存指南
1. 安裝步驟
- 安裝 Fabric Loader (
>=0.16.10)。 - 下載
vanilla-outsider-true-sleep-1.3.22+26.2.jar（或對應遊戲版本的建置檔案）。 - 確保前置依賴庫 Dasik Library (
>=1.8.0) 已放置在.minecraft/mods目錄中。 - 使用 Java 25+ 啟動 Minecraft（1.21.x 請使用 Java 21，1.20.1 請使用 Java 17）。
2. 遊戲內使用
- 當時間達到
12542 ticks（日落/黃昏）後，右鍵點擊任意床鋪進入睡眠。 - 告別原版的死黑螢幕，你將留在世界中，以令人震撼的電影級縮時攝影目睹黑夜飛速流逝！
- 觀察月亮與繁星在天空中劃過優美的弧線，與此同時你的熔爐正以超光速冶煉礦石。
- 清晨日出（
0 ticks）準時醒來，神清氣爽地迎接嶄新的一天。
📚 完整 Wiki 導覽目錄
True Sleep Wiki Root
├── 🧭 Compatibility & Lifecycle
│ ├── [版本相容性與生命週期矩陣](/vanilla-outsider-true-sleep/Version-Compatibility.md)
│ ├── [開發者環境與建置指南](./Developer-Setup-and-Building.md)
│ └── [故障排除與常見問題 (FAQ)](/vanilla-outsider-true-sleep/Troubleshooting-and-FAQ.md)
├── 🎮 Core Gameplay Mechanics
│ ├── [時間曲速與Tick加速引擎](/vanilla-outsider-true-sleep/Time-Warp-and-Tick-Acceleration.md)
│ ├── [機器與漏斗加速](/vanilla-outsider-true-sleep/Machine-and-Hopper-Acceleration.md)
│ ├── [生物停滯與農場老化](/vanilla-outsider-true-sleep/Mob-Stasis-and-Biological-Aging.md)
│ ├── [睡眠飢餓消耗與溺水免疫](/vanilla-outsider-true-sleep/Sleep-Hunger-and-Drown-Immunity.md)
│ └── [天體平滑與客戶端電影級天空](./Celestial-Sky-and-Client-Cinematics.md)
├── 🎛️ Administration & Configuration
│ ├── [命名空間GameRules參考](./GameRules.md)
│ ├── [Brigadier指令套件 (/truesleep)](./Commands.md)
│ ├── [設定與圖形介面 (GUI)](./Configuration.md)
│ └── [API與資料驅動標籤擴充](./API-and-Tags.md)
└── 💻 Technical Architecture
├── [架構解析與Mixin系統](./Architecture-and-Mixins.md)
└── [天體平滑與客戶端電影級天空](./Celestial-Sky-and-Client-Cinematics.md)📜 開發與開源協議
- 架構師與首席開發者：Dasik (Rifaditya)
- 所屬作品集：Vanilla Outsider (VO)
- 開源許可證：GNU General Public License v3.0 (GPLv3)