Skip to content
| Marketplace
Sign in
Visual Studio Code>Visualization>Bedrock Feature ViewerNew to Visual Studio Code? Get it now.
Bedrock Feature Viewer

Bedrock Feature Viewer

Moaswies

|
2 installs
| (0) | Free
在 VS Code 里 3D 预览 Minecraft 基岩版地物(feature / feature_rules):查看方块、结构与生成效果,自动应用资源包贴图,支持引用链浏览与随机种子重放。
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Bedrock Feature Viewer

简体中文 | English

在 VS Code 里三维预览 Minecraft 基岩版地物:打开行为包里的 feature 或 feature_rules JSON,即可看到它生成出来的方块、结构与地物效果——自动应用资源包贴图,无需任何额外步骤。

功能

  • 3D 预览:拖动旋转、滚轮缩放、双击复位;剖面切割(X/Y/Z + 半切)观察内部;方块图层逐层显隐。
  • 随机种子重放:同一种子结果一致,一键换种子看不同生成效果;矿石类地物自动放到地下预览。
  • 引用链解析:规则 → 子地物 → 方块逐级展开;缺失引用、循环引用在「Feature 引用链」视图中标注,点击即可预览链上任意一级。
  • 贴图自动应用:自动读取工作区资源包的方块贴图,包括序列帧动画贴图(火、熔岩等)与群系着色(树叶颜色可按群系切换,10 种预设)。
  • 非整块模型:栅栏、台阶、楼梯等自定义形状方块按模型渲染;扫描行为包 blocks/(含子目录)与 netease_blocks/ 的 minecraft:geometry 定义,按 .geo.json 模型渲染自定义几何方块。
  • 结构模板预览:structure_template_feature 自动读取行为包 structures/ 下的 .mcstructure 真实结构生成进预览。
  • 导出:把当前生成的方块清单保存为 JSON(走系统保存对话框)。
  • 自动刷新:编辑或保存 JSON 后预览自动更新。

打开预览

任选其一:

入口 操作
资源管理器 右键 feature / 规则 JSON → Feature Viewer: 预览 Feature / 规则
编辑器 在打开的 JSON 里右键 → 同上
编辑器标签 右键文件标签页 → 同上
编辑器右上角 预览按钮
快捷键 Ctrl+Alt+V
命令面板 Feature Viewer: 预览 Feature / 规则

预览面板在编辑器旁分栏打开;「在编辑器中打开」按钮可随时跳回源文件。

使用约定

  • 工作区内 features/、feature_rules/(以及网易 mod 的 netease_features/、netease_feature_rules/ 等同名目录)下的 JSON 会自动纳入引用解析。
  • 预览「规则」时建议直接从规则文件打开:部分地物依赖规则设置的变量,单独预览地物文件时面板会提示「缺上下文」。
  • 需要洞穴、洞顶等环境的地物(如洞穴散布、倒挂藤蔓)在平地预览中可能放置失败,失败原因会显示在状态条。
  • 材质与资源包:工作区资源包自动生效;也可在面板「材质与资源包」区手动导入文件夹 / .mcpack / .zip,手动导入优先于自动载入。

设置

设置 默认 说明
featureViewer.defaultSeed 49 预览使用的默认随机种子(面板内可随时修改)
featureViewer.autoRefresh true 编辑 / 保存文件时自动刷新预览

常见问题

  • 预览为空 / 提示未解析引用:被引用的子地物文件不在工作区对应目录里,把它放进 features/ 目录后点状态条上的「未解析」或执行「刷新引用链」。
  • *提示「缺上下文」(t. 变量)**:这类地物的参数由规则文件设置,请从规则 JSON 打开预览。
  • 贴图没生效:确认资源包里有 textures/terrain_texture.json;手动导入请选择资源包根目录(或它的上层目录)。
  • 矿石看不到:矿石生成在地下,面板会自动下潜预览;也可在「生成参数」里调整放置高度。

反馈

发现问题或想支持更多地物类型,请发送邮件至

shangguanxi114514@163.com 或bitterlem0nnn5@gmail.com


English

Preview Minecraft Bedrock Edition world-generation features in 3D, right inside VS Code. Open a feature or feature_rules JSON file from a behavior pack to see the blocks and structures it generates. Resource pack textures are applied automatically, with no extra setup required.

Features

  • 3D preview: Drag to rotate, scroll to zoom, and double-click to reset the view. Inspect interiors with X/Y/Z cross-section and half-cut views, and show or hide individual block layers.
  • Reproducible seeds: Reuse a seed to reproduce the same result, or try a new seed with one click to explore different outcomes. Ore features are automatically placed underground for previewing.
  • Reference chain explorer: Expand the chain from rules to child features to blocks. Missing references and circular references are highlighted in the Feature 引用链 (Feature Reference Chain) view; click a node to preview any level of the chain.
  • Automatic textures: Load block textures from workspace resource packs, including animated textures such as fire and lava. Biome tinting is supported, with 10 presets for foliage colors.
  • Custom block shapes: Render fences, slabs, stairs, and other non-full-cube blocks using their models.
  • Export: Save the generated block list as JSON through the system save dialog.
  • Automatic refresh: Update the preview as you edit or save the JSON file.

Open a preview

Use any of the following entry points. UI labels below match those shown in the extension; English translations are provided for reference.

Entry point Action
Explorer Right-click a feature or rule JSON file → Feature Viewer: 预览 Feature / 规则 (Preview Feature / Rule)
Editor Right-click inside an open JSON file → the same preview command
Editor tab Right-click the file tab → the same preview command
Editor toolbar Click the preview button in the upper-right corner
Keyboard shortcut Press Ctrl+Alt+V while editing a JSON file
Command Palette Run Feature Viewer: 预览 Feature / 规则

The preview opens beside the editor. Click 在编辑器中打开 (Open in Editor) to return to the source file at any time.

Usage notes

  • JSON files under features/ and feature_rules/ directories in the workspace are automatically included in reference resolution. The NetEase mod equivalents, netease_features/ and netease_feature_rules/, are also supported.
  • To preview a rule, open the rule JSON directly. Some features depend on variables supplied by their rule; previewing the feature on its own may display 缺上下文 (Missing Context).
  • Features that require caves, ceilings, or other specific environments, such as cave scatter features and hanging vines, may fail to place in the flat-ground preview. The status bar shows the reason for the failure.
  • Workspace resource packs are loaded automatically. You can also import a folder, .mcpack, or .zip from the 材质与资源包 (Materials & Resource Packs) section of the preview panel. Manually imported resources take priority over automatically loaded ones.

Settings

Setting Default Description
featureViewer.defaultSeed 49 Default random seed for previews; you can change it in the preview panel at any time
featureViewer.autoRefresh true Automatically refresh the preview when a file is edited or saved

Troubleshooting

  • Empty preview or unresolved references: A referenced child feature may be missing from the relevant workspace directories. Place it in the features/ directory, then click 未解析 (Unresolved) in the status bar or run Feature Viewer: 刷新引用链 (Refresh Reference Chain).
  • Missing context (t.* variables): These feature parameters are supplied by a rule. Open the preview from the rule JSON instead.
  • Textures are not applied: Check that the resource pack contains textures/terrain_texture.json. When importing manually, select the resource pack's root folder or its parent folder.
  • Ore is not visible: Ore generates underground, and the preview automatically moves the view below ground. You can also adjust the placement height under 生成参数 (Generation Parameters).

Feedback

To report a problem or request support for more feature types, email either of the following addresses:

  • shangguanxi114514@163.com
  • bitterlem0nnn5@gmail.com
  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft