搬运一批Bedrock wiki内容，完善翻译
This commit is contained in:
boybook
393
docs/wiki/world-generation/structure-features.md
Normal file
393
docs/wiki/world-generation/structure-features.md
Normal file
@@ -0,0 +1,393 @@
|
||||
---
|
||||
title: Generating Custom Structures
|
||||
category: Tutorials
|
||||
mentions:
|
||||
- DerpMcaddon
|
||||
- SirLich
|
||||
tags:
|
||||
- experimental
|
||||
---
|
||||
|
||||
Structure feature is one of the most basic feature. It places exported `.mcstructure` file in the world.
|
||||
This tutorial will show you how to make:
|
||||
|
||||
- Surface structure,
|
||||
|
||||
- Underground structure,
|
||||
|
||||
- Floating structure,
|
||||
|
||||
- Underwater structure, and
|
||||
|
||||
- Water surface structure
|
||||
|
||||
:::tip
|
||||
For exporting structure on android devices, use this [resource pack](https://mcpedl.com/export-structure-button-android-addon/)
|
||||
:::
|
||||
|
||||
Make sure you put the `.mcstructure` file inside of `BP/structures/`!
|
||||
|
||||
## Surface Structure
|
||||
|
||||
### Feature File
|
||||
|
||||
<CodeHeader>BP/features/house_feature.json</CodeHeader>
|
||||
|
||||
```json
|
||||
{
|
||||
"format_version": "1.13.0",
|
||||
"minecraft:structure_template_feature": {
|
||||
"description": {
|
||||
"identifier": "wiki:house_feature"
|
||||
},
|
||||
"structure_name": "mystructure:house",
|
||||
"adjustment_radius": 4,
|
||||
"facing_direction": "random",
|
||||
"constraints": {
|
||||
"grounded": {},
|
||||
"unburied": {},
|
||||
"block_intersection": {
|
||||
"block_allowlist": [
|
||||
"minecraft:air" //The structure can only replace air
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Feature Rule
|
||||
|
||||
<CodeHeader>BP/feature_rules/plains_house_feature.json</CodeHeader>
|
||||
|
||||
```json
|
||||
{
|
||||
"format_version": "1.13.0",
|
||||
"minecraft:feature_rules": {
|
||||
"description": {
|
||||
"identifier": "wiki:plains_house_feature",
|
||||
"places_feature": "wiki:house_feature"
|
||||
},
|
||||
"conditions": {
|
||||
"placement_pass": "first_pass",
|
||||
"minecraft:biome_filter": {
|
||||
"test": "has_biome_tag",
|
||||
"operator": "==",
|
||||
"value": "plains"
|
||||
}
|
||||
},
|
||||
"distribution": {
|
||||
"iterations": 1,
|
||||
"x": {
|
||||
"extent": [0, 16],
|
||||
"distribution": "uniform"
|
||||
},
|
||||
"y": "q.heightmap(v.worldx, v.worldz)", //Generates the feature on the highest block on the column
|
||||
"z": {
|
||||
"extent": [0, 16],
|
||||
"distribution": "uniform"
|
||||
},
|
||||
"scatter_chance": {
|
||||
"numerator": 1,
|
||||
"denominator": 25
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
## Underground Structure
|
||||
|
||||
### Feature File
|
||||
|
||||
<CodeHeader>BP/features/bunker_feature.json</CodeHeader>
|
||||
|
||||
```json
|
||||
{
|
||||
"format_version": "1.13.0",
|
||||
"minecraft:structure_template_feature": {
|
||||
"description": {
|
||||
"identifier": "wiki:bunker_feature"
|
||||
},
|
||||
"structure_name": "mystructure:bunker",
|
||||
"adjustment_radius": 4,
|
||||
"facing_direction": "random",
|
||||
"constraints": {
|
||||
"block_intersection": {
|
||||
"block_allowlist": [
|
||||
"minecraft:air", //Makes the feature only replace air and stone
|
||||
"minecraft:stone"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Feature Rule
|
||||
|
||||
<CodeHeader>BP/feature_rules/overworld_bunker_feature.json</CodeHeader>
|
||||
|
||||
```json
|
||||
{
|
||||
"format_version": "1.13.0",
|
||||
"minecraft:feature_rules": {
|
||||
"description": {
|
||||
"identifier": "wiki:overworld_bunker_feature",
|
||||
"places_feature": "wiki:bunker_feature"
|
||||
},
|
||||
"conditions": {
|
||||
"placement_pass": "first_pass",
|
||||
"minecraft:biome_filter": {
|
||||
"test": "has_biome_tag",
|
||||
"operator": "==",
|
||||
"value": "overworld"
|
||||
}
|
||||
},
|
||||
"distribution": {
|
||||
"iterations": 1,
|
||||
"x": {
|
||||
"extent": [0, 16],
|
||||
"distribution": "uniform"
|
||||
},
|
||||
"y": {
|
||||
"extent": [
|
||||
11,
|
||||
50 //Makes the structure generate between y11 and y50
|
||||
],
|
||||
"distribution": "uniform"
|
||||
},
|
||||
"z": {
|
||||
"extent": [0, 16],
|
||||
"distribution": "uniform"
|
||||
},
|
||||
"scatter_chance": {
|
||||
"numerator": 1,
|
||||
"denominator": 15
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
## Floating Feature
|
||||
|
||||
### Feature File
|
||||
|
||||
<CodeHeader>BP/features/balloon_feature.json</CodeHeader>
|
||||
|
||||
```json
|
||||
{
|
||||
"format_version": "1.13.0",
|
||||
"minecraft:structure_template_feature": {
|
||||
"description": {
|
||||
"identifier": "wiki:balloon_feature"
|
||||
},
|
||||
"structure_name": "mystructure:balloon",
|
||||
"adjustment_radius": 4,
|
||||
"facing_direction": "random",
|
||||
"constraints": {
|
||||
"block_intersection": {
|
||||
"block_allowlist": [
|
||||
"minecraft:air" //Makes the structure only replace air
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Feature Rule
|
||||
|
||||
<CodeHeader>BP/feature_rules/overworld_balloon_feature.json</CodeHeader>
|
||||
|
||||
```json
|
||||
{
|
||||
"format_version": "1.13.0",
|
||||
"minecraft:feature_rules": {
|
||||
"description": {
|
||||
"identifier": "wiki:overworld_baloon_feature",
|
||||
"places_feature": "wiki:balloon_feature"
|
||||
},
|
||||
"conditions": {
|
||||
"placement_pass": "first_pass",
|
||||
"minecraft:biome_filter": {
|
||||
"test": "has_biome_tag",
|
||||
"operator": "==",
|
||||
"value": "overworld"
|
||||
}
|
||||
},
|
||||
"distribution": {
|
||||
"iterations": 1,
|
||||
"x": {
|
||||
"extent": [0, 16],
|
||||
"distribution": "uniform"
|
||||
},
|
||||
"y": {
|
||||
"extent": [
|
||||
100, //Makes the structure generate from y100 to y200
|
||||
200
|
||||
],
|
||||
"distribution": "uniform"
|
||||
},
|
||||
"z": {
|
||||
"extent": [0, 16],
|
||||
"distribution": "uniform"
|
||||
},
|
||||
"scatter_chance": {
|
||||
"numerator": 1,
|
||||
"denominator": 25
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
## Underwater Structure
|
||||
|
||||
::: tip
|
||||
For underwater structures, make sure you waterlogged the structure, because Minecraft won't waterlog them automatically!
|
||||
:::
|
||||
|
||||
### Feature File
|
||||
|
||||
<CodeHeader>BP/features/aqua_temple_feature.json</CodeHeader>
|
||||
|
||||
```json
|
||||
{
|
||||
"format_version": "1.13.0",
|
||||
"minecraft:structure_template_feature": {
|
||||
"description": {
|
||||
"identifier": "wiki:aqua_temple_feature"
|
||||
},
|
||||
"structure_name": "mystructure:aqua_temple",
|
||||
"adjustment_radius": 4,
|
||||
"facing_direction": "random",
|
||||
"constraints": {
|
||||
"block_intersection": {
|
||||
"block_allowlist": [
|
||||
"minecraft:water" //Makes the structure only replace water
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Feature Rule
|
||||
|
||||
<CodeHeader>BP/feature_rules/ocean_aqua_temple_feature.json</CodeHeader>
|
||||
|
||||
```json
|
||||
{
|
||||
"format_version": "1.13.0",
|
||||
"minecraft:feature_rules": {
|
||||
"description": {
|
||||
"identifier": "wiki:ocean_aqua_temple_feature",
|
||||
"places_feature": "wiki:aqua_temple_feature"
|
||||
},
|
||||
"conditions": {
|
||||
"placement_pass": "first_pass",
|
||||
"minecraft:biome_filter": {
|
||||
"test": "has_biome_tag",
|
||||
"operator": "==",
|
||||
"value": "ocean"
|
||||
}
|
||||
},
|
||||
"distribution": {
|
||||
"iterations": 1,
|
||||
"x": {
|
||||
"extent": [0, 16],
|
||||
"distribution": "uniform"
|
||||
},
|
||||
"y": "q.above_top_solid(v.worldx, v.worldz)", //Places the feature on top of the highest solid block on the column, so it won't place it on the surface of the water
|
||||
"z": {
|
||||
"extent": [0, 16],
|
||||
"distribution": "uniform"
|
||||
},
|
||||
"scatter_chance": {
|
||||
"numerator": 1,
|
||||
"denominator": 25
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
## Water Surface Structure
|
||||
|
||||
### Feature File
|
||||
|
||||
<CodeHeader>BP/features/raft_feature.json</CodeHeader>
|
||||
|
||||
```json
|
||||
{
|
||||
"format_version": "1.13.0",
|
||||
"minecraft:structure_template_feature": {
|
||||
"description": {
|
||||
"identifier": "wiki:raft_feature"
|
||||
},
|
||||
"structure_name": "mystructure:raft",
|
||||
"adjustment_radius": 4,
|
||||
"facing_direction": "random",
|
||||
"constraints": {
|
||||
"block_intersection": {
|
||||
"block_allowlist": [
|
||||
"minecraft:water", //Makes the structure only replace air and water
|
||||
"minecraft:air"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Feature Rule
|
||||
|
||||
<CodeHeader>BP/feature_rules/ocean_raft_feature.json</CodeHeader>
|
||||
|
||||
```json
|
||||
{
|
||||
"format_version": "1.13.0",
|
||||
"minecraft:feature_rules": {
|
||||
"description": {
|
||||
"identifier": "wiki:ocean_raft_feature",
|
||||
"places_feature": "wiki:raft_feature"
|
||||
},
|
||||
"conditions": {
|
||||
"placement_pass": "first_pass",
|
||||
"minecraft:biome_filter": {
|
||||
"test": "has_biome_tag",
|
||||
"operator": "==",
|
||||
"value": "ocean"
|
||||
}
|
||||
},
|
||||
"distribution": {
|
||||
"iterations": 1,
|
||||
"x": {
|
||||
"extent": [0, 16],
|
||||
"distribution": "uniform"
|
||||
},
|
||||
"y": 62, //Makes the feature generate only on y62, which is Minecraft water level
|
||||
"z": {
|
||||
"extent": [0, 16],
|
||||
"distribution": "uniform"
|
||||
},
|
||||
"scatter_chance": {
|
||||
"numerator": 1,
|
||||
"denominator": 25
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user