沉浸式传送门

MAJOR UPDATE 7/18/2026 (IMMERSIVErework)

在此之前， 我的传送门仍然是原版的紫色传送门方块，只是在其上渲染视图，并在其背后添加了我自己的传送机制。这意味着传送门只能存在于原版黑曜石框架能够放置的地方，背后完全没有沉浸式传送门真正的引擎机制。

现在，这个系统是对沉浸式传送门引擎的一次忠实、完整的移植。 传送门现在变成了实体，与 IP 完全一致：任何尺寸、任何位置、任何朝向、任何目的地，无论是同一维度还是不同维度，每帧都会渲染另一边的真实实时视图，并且实现真正的无缝穿越，保留你的动量、视角方向和手持状态。

（几乎）IP 能做到的一切，这个模组也能做到：

• 完整的 /portal 命令集： make_portal 可以指定任意宽/高，传送到任意维度和坐标；整套命令方块家族（cb_make_portal、目的地设置器、将传送门补全为双向双面集群）、圆形传送门、缩放传送门（巨型/微缩世界效果）、旋转和动画传送门、全局传送门（如环绕世界的边界）、goback 以及调试工具。
• 真实的传送门生成： 用打火石右键黑曜石框架，将生成一个无缝的双向、双面传送门集群，而非紫色方块。包含异步目的地搜索、远端自动构建框架、浮动进度指示器、现有框架链接、正确的 8:1 下界坐标映射，以及破坏框架时能正确移除传送门的机制。当你想要原版传送门时，潜行右键依然可以生成。
• 万物皆可穿越： 物品、箭矢、末影珍珠、动物、带乘客的矿车和船，都通过统一的传送管线进行传输。
• 递归： 可以通过传送门看到另一扇传送门，深度可达 5 层，包括在传送门循环中看到你自己的身影和其他生物。
• 镜子：（对玻璃使用打火石）、用于连接同维度框架对的传送门辅助方块，以及数据包定义的自定义传送门生成：你自己的框架方块、点火物品、目标维度和传送门形态（经典、翻转地板、缩放方块、单向等），均从标准数据包加载。
• 传送门魔杖和命令棒： 通过在世界中点击三个角来创建自定义传送门，拖拽和重塑现有传送门，复制/粘贴它们，所有这些功能都集成在专用的创造模式标签页中。
• 维度堆叠和替代维度： 将世界堆叠在一起，并在接缝处放置传送门（可从世界创建界面配置），此外还有 IP 的额外维度：空岛、混沌地形等。
• 真正的跨维度模拟： 每个传送门的另一侧都在服务器端真正地加载区块、进行光照计算和逻辑更新。

刻意改进之处：

• 末影珍珠无缝传送： 原版 IP 将珍珠传送交由原版加载屏幕路径处理，而我们的版本则保持无缝传送并保留动量。
• 动物跨维度后保持受惊状态： 一只逃跑的动物穿越传送门后，会在另一边继续恐慌，而原版 IP 会在穿越时丢失这个状态。
• 穿越处的烟花火箭边缘情况处理。

(7/19/2026) Sodium(0.9.1) 兼容性 (IMMERSIVErework3)

将 IP 更新至 Sodium 0.9.1 的现代异步架构：

(7/20/2026) IRIS(1.11.2) 兼容性 (IMMERSIVErework4)

Iris 可以工作，但光影不能。

(7/21/2026) 完整 IRIS(1.11.2) 兼容性 (IMMERSIVErework6)

光影传送门视图： 传送门现在可以在使用光影包时渲染实时视图，但维度光照可能不准确，且递归传送门不会显示。（IMMERSIVErework7 修复了使用同维度传送门时地形闪烁的问题）

CREDITS 🙏

沉浸式传送门 (Immersive Portals) 作者：qouteall

可以说，这是有史以来最棒的模组之一

❤️ ❤️ ❤️ ❤️ ❤️ ❤️

❤️感谢您将这个不可思议的项目开源❤️

❤️ ❤️ ❤️ ❤️ ❤️ ❤️

❓ 常见问题 ❓

这与沉浸式传送门有何不同？ 本模组遵循相同的核心架构（模板缓冲区渲染、次级世界上下文切换、按维度加载区块），但专为 MC 26.x 的新渲染系统构建。

它会影响性能吗？ 是的，您需要同时加载两个世界。

我可以将它包含在我的整合包中吗？ 可以。

我在哪里报告错误？ 请在 GitHub 仓库 中创建一个议题。请包含你的加载器、MC 版本以及 latest.log 日志文件。