From 3b9320d1e0ea2c3628eea3eb1a30181600acf0f2 Mon Sep 17 00:00:00 2001
From: modzuozhi <modzuozhi@local>
Date: Wed, 9 Sep 2026 22:22:43 +0800
Subject: [PATCH] Update README: document sharding command and new
 optimizations

---
 README.md | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index a03e2dc..c73fb9b 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,8 @@ Dimensional Ripper 是一个基于 **NeoForge 1.21.1** 的多线程维度并行
 
 - **维度并行 Tick**：每个维度拥有独立的 tick 循环与 worker 线程，维度之间互不拖累——单维度低 TPS 不会影响其他维度。
 - **细粒度并行**：在维度内部对实体、方块实体、区块环境 tick 进行并行调度，充分压榨多核性能。
+- **实体分片并行 (ShardGate)**：实体按稳定 ID 分为与 CPU 核数对应的若干片，每片由跨 tick 的 CAS 门控独立提交。单个慢分片自动掉拍延后，不再阻塞整个实体 tick 屏障——把"单点慢"从拖垮全局变成只拖自己。
+- **POI 并发锁优化**：将村民等实体高频读取的职业兴趣点（POI）存储从全互斥同步容器替换为无锁并发容器，消除并行 tick 下的全局锁瓶颈。约 1.9 万村民压测下 TPS 由 9 提升至 20（16 核）。
 - **碰撞优化**：可禁用实体间碰撞，消除 O(n²) 碰撞开销，显著释放 TPS。
 - **异步传送门传送**：支持原版下界/末地传送门与模组维度（如暮色森林、以太）传送门的异步预加载与渐进生成，避免传送到未加载区块导致的卡顿、冻结与虚空传送。
 - **区块预取**：根据玩家位置与朝向预加载区块，加快跑图时的区块加载速度。
@@ -25,11 +27,12 @@ Dimensional Ripper 是一个基于 **NeoForge 1.21.1** 的多线程维度并行
 
 | 指令 | 说明 |
 |------|------|
-| `/dimensionalripper status` | 查看当前状态、TPS 与各开关 |
-| `/dimensionalripper fine on\|off` | 开关细粒度并行 |
-| `/dimensionalripper nocollide on\|off` | 开关实体碰撞优化 |
+| `/dimensionalripper status` | 查看当前状态、TPS、各开关与掉拍分片统计 |
+| `/dimensionalripper fine on\|off` | 开关维度内细粒度并行（实体/方块实体/区块环境） |
+| `/dimensionalripper fine sharded on\|off` | 开关实体分片并行（ShardGate，默认开启） |
+| `/dimensionalripper nocollide on\|off` | 开关实体碰撞优化（默认开启） |
 
-模组**默认启用**多线程，开箱即用，无需额外配置。
+模组**默认启用**多线程与分片并行，开箱即用，无需额外配置。
 
 ## 构建