⏱️ 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)