完整版BedrockWiki镜像！

2025-03-20 11:52:46 +08:00
parent 1994c41f01
commit bf9aa4b056
214 changed files with 9042 additions and 8867 deletions
--- a/docs/wiki/vr/editing-your-first-model.md
+++ b/docs/wiki/vr/editing-your-first-model.md
@@ -1,145 +1,154 @@
 ---
-title: Editing Your First Model
-category: Tutorials
+title: 编辑你的第一个模型
+category: 巧思案例
 mentions:
    - TheDoctor15
    - MedicalJewel105
    - TheItsNameless
    - SmokeyStack
 tags:
-    - expert
+    - 专家
 ---

-This tutorial will show you how to make your first VR model.
-For the sake of this tutorial we will be editing the right hand model.
+# 编辑你的第一个模型
+
+<!--@include: @/wiki/bedrock-wiki-mirror.md-->
+
+本教程将指导你如何制作第一个VR模型。  
+为方便演示，我们将以右手模型为例进行编辑。

 :::tip
-This tutorial makes use of the program [Blender](https://www.blender.org/download/), make sure you have it before following this tutorial.
+本教程需要使用 [Blender](https://www.blender.org/download/) 软件，请提前安装。
 :::

-## Viewing the model in Blender
+## 在Blender中查看模型

-First you need to import the model into Blender:
+首先需要将模型导入Blender：

 ![](/assets/images/vr/tutorial-hand-right/import-1.png)
 ![](/assets/images/vr/tutorial-hand-right/import-2.png)
 ![](/assets/images/vr/tutorial-hand-right/import-3.png)

-Your model is now imported but it misses a texture.
-To add a texture you will go to the Shading tab in blender.
-There you are going to add a texture element like this:
+模型导入后会发现缺少材质贴图。  
+进入着色器（Shading）选项卡添加纹理元素：

 ![](/assets/images/vr/tutorial-hand-right/shading-add-texture-element.png)
 ![](/assets/images/vr/tutorial-hand-right/texture-element.png)

-In that element you press open and select your texture in our case it is `something\VRpackTemplate\textures\hologram_hands.png`.
-Make sure you change linear to closest, otherwise your texture will look blurry.
-In the end it will look like this:
+点击"Open"选择材质贴图（示例路径：`something\VRpackTemplate\textures\hologram_hands.png`）。  
+**重要提示**：将过滤模式从线性（Linear）改为最近邻（Closest），否则贴图会模糊。  
+最终效果如下：

 ![](/assets/images/vr/tutorial-hand-right/texture-element-complete.png)

-Now its time to add the texture to the models material.
-You hold the yellow dot and connect it to the other yellow dot like this:
+将材质连接到模型上：  
+拖动黄色连接点完成材质关联：

 ![](/assets/images/vr/tutorial-hand-right/texture-base-connect.png)

-If everything went good your model should now look like this:
+成功关联后模型应显示正确贴图：

 ![](/assets/images/vr/tutorial-hand-right/texture-on-model.png)

-## Editing the model
+## 模型编辑指南

-With editing the model you have almost total freedom, the only requirement is that the model only uses 1 texture.
+在编辑模型时需注意：  
+- 只能使用单张贴图
+- 保持模型结构合理性

-### Editing the model (easy)
+### 基础编辑（手臂改造）

-Since this is the easy tutorial, we will show you how to make the hand into an arm.
-
-First we need to figure out the dimensions of this object.
+我们将把手部模型改造成前臂模型。  
+首先分析原始尺寸关系：

 ![](/assets/images/vr/tutorial-hand-right/model-dimensions.png)

-This image shows us that 3 pixels is equivalent to 18.75 meters in Blender, an arm is 12 pixels long so this means an arm is `4 * 18.75 = 75 meters` in Blender.
-When editing the dimensions it will look like this:
+图中显示：  
+- 3像素对应Blender中的18.75米
+- 前臂长度为12像素 → 换算为`4 * 18.75 = 75米`
+
+调整尺寸后：

 ![](/assets/images/vr/tutorial-hand-right/edited-dimensions-1.png)

-If we import it into minecraft the arm will be to far away. This is because the original model is made for a hand not an arm. So we need to move it `3 * 18.75 = 56.25 meters` down.
+由于原始模型为手部设计，需下移`3 * 18.75 = 56.25米`以适配手臂位置：

 ![](/assets/images/vr/tutorial-hand-right/edited-dimensions-2.png)

-#### Texturing
+#### 材质处理

-Since this is an arm we will use the steve arm model, you import it the same way like we did above.
+使用Steve角色手臂贴图：

 ![](/assets/images/vr/tutorial-hand-right/hologram-hands-steve.png)

+若出现拉伸现象：
+
 ![](/assets/images/vr/tutorial-hand-right/steve-texture-stretched.png)

-Now you might notice your texture is stretched out. to fix this we will go to UV-editing and edit the uv map.
-UV-editing looks almost the same to blockbench.
+进入UV编辑模式调整贴图坐标：

 ![](/assets/images/vr/tutorial-hand-right/uv-map.png)

 :::tip
-Its handy to turn on this magnet looking icon so its more precise.
+启用磁吸工具可提高编辑精度：  
 ![](/assets/images/vr/tutorial-hand-right/magnet-icon.png)
 :::

-We start with selecting the top and the bottom of the hand.
+1. 选择顶部和底部面片：

 ![](/assets/images/vr/tutorial-hand-right/uv-map-top-selected.png)

-Next we select the move tool.
+2. 使用移动工具调整位置：

 ![](/assets/images/vr/tutorial-hand-right/uv-map-pos.png)

-Now we move the top face and bottom face to the top of the texture.
+3. 将面片对齐至贴图顶部：

 ![](/assets/images/vr/tutorial-hand-right/uv-map-top-move-up.png)

-The same for the sides of the arm.
-
-Your new uv map should look something like this:
+4. 重复操作处理侧面：

 ![](/assets/images/vr/tutorial-hand-right/uv-map-side-up.png)

-If we look how the arm look we see all is now fixed.
+最终效果：

 ![](/assets/images/vr/tutorial-hand-right/uv-map-done.png)

-#### Export it!
+#### 模型导出

-It is time to now export your model first put the steve arm texture inside `VRpackTemplateRP\textures`.
-Call it `hologram_hands.png`.
+1. 将Steve手臂贴图放入`VRpackTemplateRP\textures`目录，命名为`hologram_hands.png`

 ![](/assets/images/vr/tutorial-hand-right/export-texture.png)

-Now lets export the model.
+2. 导出模型文件：

 ![](/assets/images/vr/tutorial-hand-right/export-model-1.png)

-Call the model `hologram_hand_right.obj`.
+命名模型为`hologram_hand_right.obj`：

 ![](/assets/images/vr/tutorial-hand-right/export-model-2.png)

-#### Testing it in game
+#### 游戏测试

-Load the pack into minecraft and try it out if it looks like this you succeeded in this tutorial!
+导入资源包后效果应如下所示：

 ![](/assets/images/vr/tutorial-hand-right/export-done.png)

+::: code-group
+```json [下载示例]
 <BButton
    link="https://github.com/Bedrock-OSS/wiki-addon/releases/download/download/vr_edit_model.mcpack"
    color=blue
->Get guide end results!</BButton>
+>获取教程最终成果！</BButton>
+```

-## Your progress so far
+## 当前进度

 <Checklist>

-   [x] Setup Minecraft VR
-   [x] Setup the pack
-   [x] Edit the models
+-   [x] 配置Minecraft VR环境
+-   [x] 创建资源包
+-   [x] 完成模型编辑

 </Checklist>
+```
--- a/docs/wiki/vr/index.md
+++ b/docs/wiki/vr/index.md
@@ -1,9 +1,9 @@
 ---
-title: Virtual Reality
+title: 虚拟现实 VR
 categories:
-    - title: General
+    - title: 基础
      color: blue
-    - title: Tutorials
+    - title: 巧思案例
      color: green
 ---
 <!--
--- a/docs/wiki/vr/installing-bedrock-vr.md
+++ b/docs/wiki/vr/installing-bedrock-vr.md
@@ -1,49 +1,53 @@
 ---
-title: Enabling VR
-category: General
+title: 启用VR模式
+category: 基础
 nav_order: 1
 mentions:
    - TheDoctor15
    - MedicalJewel105
 tags:
-    - guide
+    - 指南
 ---

-Minecraft VR was formerly available for download via the Oculus store, but that version hasn't been updated in a long time. This article will show you how to enable VR in the most recent version of Minecraft on your Windows PC.
+# 启用VR模式
+
+<!--@include: @/wiki/bedrock-wiki-mirror.md-->
+
+Minecraft VR 版本此前可通过Oculus商店下载，但该版本已长期未更新。本文将指导您在Windows PC上最新版本的Minecraft中启用VR模式。

 :::warning
-If you are on Playstation you don't need to follow this guide.
+PlayStation用户无需遵循本指南。
 :::

-## Creating the desktop shortcut
+## 创建桌面快捷方式

-Right-click on your desktop and create a new shortcut:
+在桌面右键点击并新建快捷方式：

 ![](/assets/images/vr/install/vr_desktop.png)

-As location you fill in `minecraft://Mode/?OpenXR=true`.
+在目标位置输入 `minecraft://Mode/?OpenXR=true`：

 ![](/assets/images/vr/install/vr_shortcut_path.png)

-You can name it how ever you want, in the end you should have a shortcut looking like this:
+可自定义快捷方式名称，最终应获得如下样式的快捷方式：

 ![](/assets/images/vr/install/vr_shortcut_icon.png)

-## Opening Minecraft in VR
+## 启动VR版Minecraft

-First make sure you connected your headset properly:
+请确保已正确连接头戴设备：

 ![](/assets/images/vr/install/vr_headset.png)

-When your headset is all setup it is time to open the shortcut.
+完成设备配置后，即可通过快捷方式启动游戏。

-## Your progress so far
+## 当前进度

 <Checklist>

-   [x] Setup Minecraft VR
-   [ ] Setup your VR resource pack
-   [ ] Create custom hands
-   [ ] Create a custom living room
+-   [x] 配置Minecraft VR
+-   [ ] 配置VR材质包
+-   [ ] 创建自定义手势
+-   [ ] 创建个性化虚拟空间

-</Checklist>
+</Checklist>
--- a/docs/wiki/vr/pack_setup.md
+++ b/docs/wiki/vr/pack_setup.md
@@ -1,57 +1,61 @@
 ---
-title: Setting Up the Pack
-category: General
+title: 设置资源包
+category: 基础
 mentions:
    - TheDoctor15
    - MedicalJewel105
    - TheItsNameless
    - SmokeyStack
 tags:
-    - expert
+    - 专家
 ---

-To start making your addon you should download this template.
-This template contains all the required assets for a start on making the VR pack.
+# 设置资源包
+
+<!--@include: @/wiki/bedrock-wiki-mirror.md-->
+
+开始制作附加包前，您需要下载这个模板文件。
+该模板包含了制作VR资源包所需的所有基础资源。

 <BButton
    link="https://github.com/Bedrock-OSS/wiki-addon/releases/download/download/vr_template.mcpack"
    color=blue
->Get the template!</BButton>
+>获取模板！</BButton>

 :::warning
-Dont delete `contents.json` and `textures_list.json` from the template.
+请勿删除模板中的 `contents.json` 和 `textures_list.json` 文件。
 :::

-## What does the template contain?
+## 模板包含哪些内容？

-The template contains 2 editable folders; `holograms` and `textures`,
-these folders contain the models and textures for the vr objects.
+模板包含两个可编辑文件夹：`holograms`（全息模型）和 `textures`（纹理），
+这些文件夹存放了VR物件的模型和纹理文件。

 ![](/assets/images/vr/setup/vr-template-contents.png)

-## Holograms
+## 全息模型

-This folder contains all the models the VR version of Minecraft uses, for example the VR hands.
+此文件夹包含Minecraft VR版使用的所有模型，例如VR手部模型。

 ![](/assets/images/vr/setup/vr-template-holograms.png)

-## Textures
+## 纹理

-This folder stores all textures for the models.
+此文件夹存储模型所需的所有纹理贴图。

 ![](/assets/images/vr/setup/vr-template-textures.png)

-## Merging the VR template with your own pack
+## 将VR模板与自有资源包合并

-This pack depends on the `contents.json` and `textures_list.json` to work. All assets from your pack, that the game will use, need to be defined in there.
-If you have 2 of the same files you are ought to combine them.
+本资源包依赖 `contents.json` 和 `textures_list.json` 文件运行。所有需要被游戏调用的资源都必须在其中定义。
+若存在同名文件，需要进行合并操作。

-## Your progress so far
+## 当前进度

 <Checklist>

-   [x] Setup Minecraft VR
-   [x] Setup the pack
-   [ ] Edit the models
+-   [x] 配置Minecraft VR环境
+-   [x] 设置资源包
+-   [ ] 编辑模型

-</Checklist>
+</Checklist>