Universal Preview

Universal Preview

Universal Preview (UP) is a model inspection and investigation tool for Minecraft Java Edition. Examine an object, discover illustrated clues in a scene, and keep useful information in a personal notebook. It suits exploration maps, puzzles, exhibitions, and item guides.

Inspect Models and Discover Their Clues

Hold an item and press **V** to inspect it. Left-drag rotates, scrolling zooms, Ctrl plus left-drag pans, and R restores the creator's saved initial view. A stack renders a single model. With Preview Mode enabled, permitted blocks, dropped items, and all three display entity types can also be inspected.

Creators can place text and image anchors on model surfaces. Rings follow the model and hide behind its geometry, leaving clues on the back for players to discover. Screen overviews stay fixed. Open a ring when you want to read; longer content scrolls.

The rich editor supports multiple text and image elements, independent font sizes, a full palette, and live preview. Select text in either a group title or its body to apply bold, italic, underline, strikethrough, or color. Hold drag handles to reorder elements, or select them for bulk deletion. Previews do not spawn world objects, and ordinary viewing does not overwrite saved initial views.

Place Investigation Points in the World

With an empty main hand, approach and aim at a nearby ring within its discovery area, then press **V** to read or interact. Opaque walls block access to clues behind them. Holding an item retains the original preview entry.

When interaction is available, a compact hint below the crosshair shows the currently bound key on the left and "Inspect" plus the anchor name on the right. Gray borders and green accents match the editor. The UI stays independent of vanilla GUI Scale, and long names are not replaced with ellipses.

In Creative Mode with UP editor authorization, press **Right Alt** to edit through a detached camera while your body stays in place. WASD moves, Space rises, Shift descends, and Ctrl accelerates. Right-click and choose New to open the original rich text, image, and palette editor, with one optional command. Save takes effect directly after server confirmation.

Move anchors using translation arrows and plane handles; releasing the mouse saves the position. World anchors do not need rotation. Their discovery area can also be adjusted. Copy a saved anchor's complete spawn command for a command block or map function: for example, copy it, remove the anchor, and spawn it later when the story reaches that point.

Optional Commands and ChatBox Dialogues

Leave the command blank for information only. For world anchors, Repeat off means once per player per anchor, persisted across reconnects and server restarts. Repeat on allows execution on each fresh interaction.

New command-bearing changes must be saved by a server administrator, without a separate publication step. Regular players can trigger saved, authorized commands without gaining OP; ordinary editor authorization does not grant administrative command authority.

ChatBox is optional. Choose **Add Element → Add Dialogue** in a world anchor's editor and browse existing dialogues by namespace and folder. There is no command, resource ID, or internal entry group to enter. UP uses ChatBox's native API without providing another dialogue editor or modifying its datapacks.

Choose immediate playback, or let players read the information first and press a configurable key to begin. Enter is the default; rebind it by clicking the setting and pressing another key. Players can also click the dialogue entry in the information panel. Text, images, and dialogues share a sortable list with hold-and-drag handles, retaining their order after saving and reopening. Existing text, images, and commands remain available; item previews do not gain dialogue elements.

World information uses highly translucent frosted glass, with subtle localized blur rather than a full-screen filter.

Icons select the color target, using the same full gradient palette, hue strip, and HEX/RGB inputs. Text, anchor rings, and panel tint are stored independently, without preset-color buttons or linked color changes. Model anchors offer text and ring controls; world anchors additionally offer glass tint.

Keep the Clues You Read

Click the bookmark beside an expanded anchor's title to record its text and images, then press **B** to open your personal notebook. Clues from one source share a card, with up to 5 cards per page. Mark important entries, filter, drag to reorder, or confirm individual deletions without revealing unrecorded clues.

Records are read-only snapshots with formatting and images. Later changes or removal of a source do not erase them, and recording or rereading never replays commands. Images are archived by the server and synchronized automatically.

The default limit is 20 clues per player, adjustable by administrators from 0 to 256. Reaching or lowering a limit never deletes old records. Administrators can also inspect known online or offline players' notebooks read-only, or request a console summary, without changing their records.

Map and Server Controls

Preview Mode, editor authorization, and target preview permission are separate settings. Left-click with the permission pen to allow previewing a block, dropped item, or display entity; right-click to revoke it. Commands also accept entity selectors or block coordinates. Disabling Preview Mode still allows held-item inspection.

Servers can use /up preview_ui open and close to control target players' previews, including specified items, components, or entity SNBT. An optional hold-to-open progress ring takes about 750 milliseconds. Preview descriptions can travel with item components, entity data, or block configuration, allowing map functions to distribute prepared content.

Common starting points are /up editor true @s for editor authorization, /up notebook limit 20 @a for clue capacity, and /up notebook inspect for read-only inspection. The project README documents the full syntax and permissions.

Installation and Images

UP 4.0.0 currently targets Fabric **26.1.2 and 26.3**. Historical 26.1 and 26.2 editions end at UP 3.0.1. Multiplayer needs matching UP and Fabric API installations on client and server. Native dialogue elements additionally require the matching ChatBox version on both sides.

Put PNG files in <world>/universal_preview/, including subfolders, with a maximum of 8 MiB per file and 4096 pixels on either axis. When sharing or backing up a world, preserve this image directory and <world>/universal_preview_notebook/, which contains notebook records and archived images.

Universal Preview（通用预览）

Universal Preview（UP）是 Minecraft Java 版的模型预览与调查工具。查看物品细节，在场景中发现图文，再把有用的信息记进个人线索记录板，适合探索地图、解谜、展览和物品介绍。

看清模型，也能发现模型上的线索

主手拿着物品，按 **V** 打开预览，用左键拖动旋转、滚轮缩放、Ctrl 加左键平移，按 R 恢复制作者保存的初始视角。同一堆叠只显示一个模型。开启预览模式后，也能查看获得许可的方块、掉落物和三类展示实体。

制作者可在模型表面放置图文锚点。圆环随模型移动，被遮住时隐藏，玩家转到背面便能发现其他信息；整体说明则固定在屏幕上。文字和图片按需展开，长内容可滚动阅读。

图文编辑器支持多段文字、图片、独立字号、完整调色盘和实时预览。群组名称与正文都能框选文字，单独设置粗体、斜体、下划线、删除线和颜色；图文元素可长按拖柄调整顺序，勾选后批量删除。预览不生成真实世界物体，普通玩家查看也不会覆盖作者保存的视角。

直接布置世界调查点

主手为空时，靠近并对准范围内的圆环，按 **V** 阅读或触发交互。不透明墙会阻挡操作，不会隔墙打开背后的线索；手持物品时仍使用原有预览入口。

可以交互时，准心下方会显示一条清晰的按键提示：左边是当前绑定的按键，右边是“查看”和锚点名称。界面沿用编辑器的灰色边框与绿色点缀，固定 UI 尺度，不跟随原版 GUI Scale 忽大忽小；长名称也不会被省略号代替。

创造模式下获得 UP 编辑权限，按 **右 Alt** 进入离体镜头编辑。身体留在原地，WASD 移动，Space 上升，Shift 下降，Ctrl 加速。右键选择新建，直接使用原来的富文本、图片和调色盘编辑器，可附带一条命令。点击保存，服务器确认后立即生效。

锚点通过三维箭头和平面拖柄移动，松开鼠标保存位置，不需要旋转。发现范围也可调整。已保存的锚点可以复制完整生成指令，供命令方块或地图函数使用；例如先复制再移除，等剧情推进后再生成，不必从地图开局就摆在那里。

可选命令与 ChatBox 对话

命令留空即可只展示图文。世界锚点关闭重复执行时，每名玩家对每个锚点只执行一次，记录跨重进和服务器重启保留；开启后，每次新的交互都可执行。

带命令的新改动由服务器管理员保存，不需要额外发布。普通玩家可以触发已保存的授权命令，但不会获得 OP，普通编辑资格也不代替管理员的指令权限。

ChatBox 是可选联动。在世界锚点编辑器里点击 **添加元素 → 添加对话**，按命名空间和文件夹层级选择已有对话文件。不需要抄写命令、输入 ID 或理解内部起始分组。UP 通过 ChatBox 的原生 API 打开对话，不提供另一套对话编辑器，也不改写它的数据包。

对话提供两种打开方式：交互后立即开始，或先阅读说明，再按指定按键开始。后者默认回车，也可点击设置后直接按键重新绑定；玩家也能点击说明里的对话入口。文字、图片和对话放在同一列表里，长按拖柄即可上下调整顺序，保存重开仍保持原顺序。普通图文与命令继续保留，物品预览不增加对话入口。

世界说明使用高透磨砂玻璃底板，保留背景世界，轻微模糊只在信息板内生效，不是整屏滤镜。

文字、锚点圆环和信息板底色通过图标切换调色对象，使用同一个完整渐变色盘、色相条和 HEX／RGB 输入，分别保存、互不联动，没有预设颜色按钮。模型锚点可调文字与圆环，世界锚点额外可调玻璃底色。

把读过的线索留下来

展开锚点后，点击标题旁的书签收录当前图文，按 **B** 打开个人记录板。同来源的线索归入一张卡，每页最多 5 张来源卡，支持标重点、筛选、拖动排序和确认删除，不会自动暴露未记录的内容。

记录为只读快照，保留文字样式与图片，不因原线索改变或删除而消失；记录和回看都不会重放指令。图片由服务器归档、自动同步，无需玩家手动复制。

默认每人可记 20 条线索，管理员可设为 0 到 256 条；容量满或降低上限都不会删除旧记录。管理员也能只读查看本服已知的在线、离线玩家记录板，或通过控制台查看摘要，不修改对方内容。

地图作者与服务器控制

预览模式、编辑权限和目标预览许可分开管理。许可笔左键给予方块、掉落物或展示实体预览许可，右键取消；也可以用实体选择器批量配置实体，或按坐标配置方块。关闭预览模式后，玩家仍可查看主手物品。

服务器可以用 /up preview_ui open、close 为目标玩家打开或关闭预览，指定物品、组件或实体 SNBT；也可启用约 750 毫秒的按住预览键进度圈。模型介绍数据可随物品组件、实体或方块配置保存，方便地图函数分发预先设置好的内容。

常用入口：/up editor true @s 开启编辑资格，/up notebook limit 20 @a 设置线索容量，/up notebook inspect 只读查看玩家记录。完整语法和权限说明见项目 README。

安装与素材

4.0.0 当前面向 Fabric **26.1.2、26.3**；历史 26.1、26.2 版本停在 UP 3.0.1。多人游戏请为客户端和服务端安装匹配的 UP 与 Fabric API；使用原生对话元素时，两端还需安装相应版本的 ChatBox。

PNG 图片放在 <世界>/universal_preview/，支持子文件夹，单文件最大 8 MiB、宽高各不超过 4096 像素。分享或备份地图时，保留素材目录及包含记录板与图片归档的 <世界>/universal_preview_notebook/。