搬运一批Bedrock wiki内容,完善翻译

This commit is contained in:
boybook
2025-03-20 00:13:44 +08:00
parent ead7392a76
commit 4896c1a4f2
163 changed files with 33930 additions and 1464 deletions

View File

@@ -0,0 +1,145 @@
---
title: Editing Your First Model
category: Tutorials
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.
:::tip
This tutorial makes use of the program [Blender](https://www.blender.org/download/), make sure you have it before following this tutorial.
:::
## Viewing the model in Blender
First you need to import the model into 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:
![](/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:
![](/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:
![](/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.
![](/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.
![](/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.
![](/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.
![](/assets/images/vr/tutorial-hand-right/uv-map-top-selected.png)
Next we select the move tool.
![](/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.
![](/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:
![](/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`.
![](/assets/images/vr/tutorial-hand-right/export-texture.png)
Now lets export the model.
![](/assets/images/vr/tutorial-hand-right/export-model-1.png)
Call the model `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)
<BButton
link="https://github.com/Bedrock-OSS/wiki-addon/releases/download/download/vr_edit_model.mcpack"
color=blue
>Get guide end results!</BButton>
## Your progress so far
<Checklist>
- [x] Setup Minecraft VR
- [x] Setup the pack
- [x] Edit the models
</Checklist>

11
docs/wiki/vr/index.md Normal file
View File

@@ -0,0 +1,11 @@
---
title: Virtual Reality
categories:
- title: General
color: blue
- title: Tutorials
color: green
---
<!--
- title: Documentation
color: red -->

View File

@@ -0,0 +1,49 @@
---
title: Enabling VR
category: General
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.
:::warning
If you are on Playstation you don't need to follow this guide.
:::
## 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`.
![](/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
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
</Checklist>

View File

@@ -0,0 +1,57 @@
---
title: Setting Up the Pack
category: General
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.
<BButton
link="https://github.com/Bedrock-OSS/wiki-addon/releases/download/download/vr_template.mcpack"
color=blue
>Get the template!</BButton>
:::warning
Dont delete `contents.json` and `textures_list.json` from the template.
:::
## 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.
![](/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.
![](/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
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.
## Your progress so far
<Checklist>
- [x] Setup Minecraft VR
- [x] Setup the pack
- [ ] Edit the models
</Checklist>