Panorama Studio
Panorama Studio 是一款面向 Minecraft Java 1.21.11 的客户端 Fabric 模组。它无需旋转玩家实体即可捕获真正的六面全景图,允许你在游戏中浏览、重命名和删除捕获内容,并将任何捕获内容转换为标题屏幕资源包。
依赖项
- Minecraft Java 1.21.11
- Java 21 或更高版本
- Fabric Loader 0.18.1 或更高版本
- Fabric API 0.141.5+1.21.11
- Mod Menu 17.0.0 或更高版本
该模组仅适用于客户端,无需在服务器上安装。
使用方法
- 加入一个世界或服务器。
- 按
J 键打开 Panorama Studio,或在 Mod Menu 中打开 Mods → Panorama Studio。
- 选择 Capture(捕获),等待处理六个正方形面片和预览图。
- 选择一个捕获内容。点击其缩略图可进入全屏拖拽查看全景视图。
- 重命名它,通过确认对话框删除它,或选择 Make title pack(制作标题包)。
- 输入资源包名称。模组会在
resourcepacks/ 目录下创建 <name>.zip 文件,并默认自动启用它。
J 是该模组唯一的按键绑定,可在 Minecraft 正常的控制设置界面中进行配置。捕获功能仅在图库中启动。设置选项包括面片分辨率、超采样、每面片的预热渲染以及自动启用打包;每个选项都有解释性的悬停提示工具。
图库可按最新/最旧捕获日期排序,并按维度或服务器/单人世界进行筛选。
捕获内容存储在以下路径:
screenshots/panorama_studio/<capture-id>
渲染器兼容性
| 模组 |
行为 |
| Iris |
使用正常的 Iris 世界/光影管线。Iris 的时间统一变量在突发捕获期间保持固定,而一个容错兼容钩子会为每个面片刷新相机相关的统一变量。 |
| Sodium |
支持;Panorama Studio 在捕获期间启用标准的 FREX “完美帧”(flawless frames)模式。 |
| Bobby |
缓存区块正常渲染;完美帧模式要求 Bobby 完成加载已就绪的缓存区块。 |
| Voxy |
使用其正常的主目标渲染路径和完美帧队列排空机制。Voxy 本身需要 macOS 无法提供的硬件/驱动支持。 |
| Distant Horizons |
参与其正常的 GameRenderer 钩子和 LOD 传递。为每个方向执行一次预热渲染。 |
| Entity Culling |
在内存中仅在执行六次渲染时绕过实体和方块实体的剔除,并在之后立即恢复。 |
| Freecam by Hashalite |
捕获及其保存的坐标使用 Minecraft 的活动渲染相机,包括 Freecam 和三脚架相机位置。 |
所有兼容性集成均为可选,且采用容错机制(fail soft)。Panorama Studio 只能捕获客户端已经加载或缓存的区块或 LOD 数据;它无法凭空创造服务器从未发送的地形。如果某个可选渲染器被禁用或不可用,将捕获普通渲染的世界。
资源包行为
资源包针对 Minecraft 1.21.11 的资源格式 75.0,并以原子 .zip 文件形式发布。ZIP 文件和“资源包”屏幕中的名称遵循用户输入的名称,其中仅在 Windows/macOS 上不安全的字符会被替换。描述信息记录了服务器或单人世界、维度,以及该包是由 Panorama Studio 制作的。
启用新的 Panorama Studio 生成的资源包后,会自动取消选中带有 Panorama Studio 生成包标记的旧资源包,以确保最新的背景具有确定性优先级;旧的包 ZIP 文件不会被删除。在 Minecraft 完成一次资源重新加载后,会报告成功状态。
如果你只想将包添加到资源包文件夹中,请关闭 Auto-enable generated packs(自动生成并启用资源包)。
已知限制
- 高倍超采样和重型光影包可能会占用大量显存。内部渲染尺寸上限为 4096×4096。
- 在原子突发捕获期间可能会有六个读取缓冲池处于待处理状态。在 4096×4096 的上限下,这与原版全景捕获中大约 384 MiB 的原始 GPU 暂存数据相匹配(不含开销)。
- 任意光影包的时序历史、屏幕空间反射或随机效果无法为每种光影都做到数学上的无缝衔接,尽管原子渲染和过扫描消除了常见的移动/时间和帧缓冲区边缘问题。
- 高分辨率捕获可能会导致客户端短暂冻结,因为其渲染线程正在提交每个面片。这不会暂停或影响多人服务器。
本软件依据 MIT 许可证授权。
Panorama Studio
Panorama Studio is a client-side Fabric mod for Minecraft Java 1.21.11. It captures a true six-face panorama without rotating the player entity, lets you browse, rename, and delete captures in game, and turns any capture into a title-screen resource pack.
Requirements
- Minecraft Java 1.21.11
- Java 21 or newer
- Fabric Loader 0.18.1 or newer
- Fabric API 0.141.5+1.21.11
- Mod Menu 17.0.0 or newer
The mod is client-only and does not need to be installed on a server.
Use
- Join a world or server.
- Press
J to open Panorama Studio, or open Mods → Panorama Studio in Mod Menu.
- Choose Capture and wait while the six square faces and preview are processed.
- Select a capture. Click its thumbnail for the full-screen drag-to-look panorama viewer.
- Rename it, delete it with confirmation, or choose Make title pack.
- Enter a resource-pack name. The mod creates
<name>.zip under resourcepacks/ and enables it automatically by default.
J is the mod's only key binding and is configurable in Minecraft's normal controls screen. Capture is only started from the gallery. Settings cover face resolution, supersampling, per-face warm-up renders, and automatic pack enabling; each option has an explanatory hover tooltip.
The gallery can sort by newest/oldest capture date and filter by dimension or server/single-player world.
Captures are stored in:
screenshots/panorama_studio/<capture-id>
Renderer compatibility
| Mod |
Behaviour |
| Iris |
Uses the normal Iris world/shader pipeline. Iris's time uniforms stay fixed for the burst while a fail-soft compatibility hook refreshes camera-dependent uniforms for every face. |
| Sodium |
Supported; Panorama Studio enables the standard FREX “flawless frames” mode during capture. |
| Bobby |
Cached chunks render normally; flawless-frames mode asks Bobby to finish loading ready cached chunks. |
| Voxy |
Uses its normal main-target render path and flawless-frames queue draining. Voxy itself requires hardware/driver support that macOS does not provide. |
| Distant Horizons |
Its normal GameRenderer hooks and LOD passes participate. A warm-up render is performed for each direction. |
| Entity Culling |
Entity and block-entity culling are bypassed in memory only during the six renders and restored immediately afterward. |
| Freecam by Hashalite |
The capture and its saved coordinates use Minecraft's active render camera, including Freecam and tripod camera positions. |
All compatibility integrations are optional and fail soft. Panorama Studio can only capture chunks or LOD data the client already has loaded or cached; it cannot invent terrain the server never sent. If an optional renderer is disabled or unavailable, the ordinary rendered world is captured.
Resource-pack behaviour
Packs target resource format 75.0 for Minecraft 1.21.11 and are published as atomic .zip files. The ZIP and Resource Packs screen name follow the user-entered name, with only characters unsafe on Windows/macOS replaced. The description records the server or single-player world, dimension, and that the pack was made with Panorama Studio.
Enabling a new Panorama Studio pack deselects older packs carrying Panorama Studio's generated-pack marker so the latest background has deterministic priority; the older pack ZIPs are not deleted. Success is reported after Minecraft finishes a single resource reload.
Turn off Auto-enable generated packs if you only want the pack added to the resource-pack folder.
Known caveats
- High supersampling and heavy shader packs can use substantial VRAM. The internal render size is capped at 4096×4096.
- Six readback buffers can be outstanding during the atomic burst. At the 4096×4096 cap this matches vanilla panorama capture's roughly 384 MiB of raw GPU staging data before overhead.
- Arbitrary shader-pack temporal history, screen-space reflections, or stochastic effects cannot be made mathematically seamless for every shader, although atomic rendering and overscan remove the common movement/time and framebuffer-edge causes.
- High-resolution captures can briefly freeze the client while its render thread submits every face. This does not pause or alter a multiplayer server.
Licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧