modzuozhi
801deb701a
- New client mixin MixinMinecraftPauseDetector: on each Minecraft.runTick, detect integrated-server pause and freeze/unfreeze all dimension loops via DimThreadCore.setPaused, so no worker writes LevelChunk while the main thread is saving/pausing. Fixes reproducible disconnect (packet decode IndexOutOfBounds on ClientboundLevelChunkWithLight) ~0.5s after opening the pause menu. - LevelTickLoop: add pause()/resume() (cancel next tick, stop self-rescheduling, re-schedule on resume) plus a paused guard at run() entry. Resilient to RejectedExecutionException when the master pool is already shut down. - ServerManager.setPaused: pause all loops, then wait up to 5s for the in-flight tick to fully settle before returning. - Keep existing work: TE whitelist command (/dimensionalripper tewhitelist), shard drop counters (entity/TE/chunk-env), POI lock optimization.
57 lines
3.1 KiB
Markdown
57 lines
3.1 KiB
Markdown
# Dimensional Ripper
|
|
|
|
Dimensional Ripper 是一个基于 **NeoForge 1.21.1** 的多线程维度并行优化模组。它通过独立维度 tick 循环与细粒度并行调度，充分利用多核 CPU 提升服务端性能，同时保持稳定的 20 TPS。
|
|
|
|
## 功能特性
|
|
|
|
- **维度并行 Tick**：每个维度拥有独立的 tick 循环与 worker 线程，维度之间互不拖累——单维度低 TPS 不会影响其他维度。
|
|
- **细粒度并行**：在维度内部对实体、方块实体、区块环境 tick 进行并行调度，充分压榨多核性能。
|
|
- **分片并行 (ShardGate)**：实体/方块实体/区块环境三阶段统一按稳定键分片（实体按 ID、TE 按方块坐标、区块环境按区块坐标），每片由跨 tick 的 CAS 门控独立提交。单个慢分片自动掉拍延后，不再阻塞对应阶段的并行屏障——把"单点慢"从拖垮全局变成只拖自己。
|
|
- **POI 并发锁优化**：将村民等实体高频读取的职业兴趣点（POI）存储从全互斥同步容器替换为无锁并发容器，消除并行 tick 下的全局锁瓶颈。约 1.9 万村民压测下 TPS 由 9 提升至 20（16 核）。
|
|
- **碰撞优化**：可禁用实体间碰撞，消除 O(n²) 碰撞开销，显著释放 TPS。
|
|
- **异步传送门传送**：支持原版下界/末地传送门与模组维度（如暮色森林、以太）传送门的异步预加载与渐进生成，避免传送到未加载区块导致的卡顿、冻结与虚空传送。
|
|
- **区块预取**：根据玩家位置与朝向预加载区块，加快跑图时的区块加载速度。
|
|
- **故障降级**：内置看门狗与故障熔断机制，异常时安全降级回原版串行 tick，保障服务器长期稳定运行。
|
|
|
|
## 环境要求
|
|
|
|
- Minecraft **1.21.1**
|
|
- NeoForge **21.1.x**
|
|
- JDK **21**
|
|
|
|
## ⚠️ 兼容性警告
|
|
|
|
> **不兼容警告**：本模组**不建议与任何其他多线程优化模组或跨维度交互类模组同时使用**。经实际测试，与这类模组共同加载会发生冲突并导致游戏崩溃。若需使用本模组，请单独加载，或移除其它多线程优化模组 / 跨维度交互模组。
|
|
|
|
## 指令
|
|
|
|
| 指令 | 说明 |
|
|
|------|------|
|
|
| `/dimensionalripper status` | 查看当前状态、TPS、各开关与掉拍分片统计 |
|
|
| `/dimensionalripper fine on\|off` | 开关维度内细粒度并行（实体/方块实体/区块环境） |
|
|
| `/dimensionalripper fine sharded on\|off` | 开关分片并行（实体/TE/区块环境，ShardGate，默认开启） |
|
|
| `/dimensionalripper nocollide on\|off` | 开关实体碰撞优化（默认开启） |
|
|
|
|
模组**默认启用**多线程与分片并行，开箱即用，无需额外配置。
|
|
|
|
## 构建
|
|
|
|
```bash
|
|
./gradlew build
|
|
```
|
|
|
|
构建产物位于 `build/libs/` 目录。
|
|
|
|
## 设计说明
|
|
|
|
本模组的设计思想借鉴了 Folia、MCMT、Chlorophyll 等项目的多线程调度方案，但全部代码基于 NeoForge API 独立实现，不包含任何 GPL 代码。
|
|
|
|
## 许可证
|
|
|
|
[MIT License](LICENSE) © 2026 xxdd001
|
|
|
|
---
|
|
|
|
> **AI 生成声明**：本 README 说明文档由 AI 辅助生成，使用的 AI 为 DeepSeek-V4-Flash。
|
|
|