> For the complete documentation index, see [llms.txt](https://btehkmu.gitbook.io/btehkmu-zhi-nan-guide-book/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://btehkmu.gitbook.io/btehkmu-zhi-nan-guide-book/shen-qi-mu-fu-tou-we/worldedit/ji-ben-zhi-shi.md).

# 基本知識

{% tabs %}
{% tab title="方向/座標系統" %}

## 方向Orientation/座標系統Coordinates

{% tabs %}
{% tab title="方向Orientation" %}

## 解釋Explaining

> WE指令預設的作用方向為玩家視角望向的地方，若是想要指定特定的\[方向]，可以輸入各個方向名稱/代號，其中又可分為絕對方向與個人方向： 

#### 絕對方向 

`絕對方向即基於MC世界座標的方位,查看[座標系統 Coordinate System]更多：` 

<div align="left"><figure><img src="https://4090587073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiCsqZvQt6N8bYG3CEYIb%2Fuploads%2FI6knUrytQNam883pbYMo%2Fimage.png?alt=media&amp;token=05079a04-5cfb-4381-847b-9ee68ab5b6d6" alt="" width="163"><figcaption><p>F3 畫面</p></figcaption></figure></div>

> 東：`e`、`east` 西：`w`、`west` 南：`s`、`south` 北：`n`、`north` 上：`u`、`up` 下：`d`、`down`
>
> 例子： //stack 10 west (向西)

<div align="left" data-with-frame="true"><figure><img src="https://4090587073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiCsqZvQt6N8bYG3CEYIb%2Fuploads%2FW9HvLuEXX41MaHt7jEJs%2Fimage.png?alt=media&amp;token=d4380f7c-2642-4434-9271-f7e8317f8453" alt="" width="563"><figcaption></figcaption></figure></div>

#### 個人方向&#x20;

相對方向即相對於玩家面朝的方向

> 前：`f`、`front`、`me`或省略 後：`b`、`back` 左：`l`、`left` 右：`r`、`right`
>
> 例子：//stack 5 back(向後)

<div align="left" data-with-frame="true"><figure><img src="https://4090587073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiCsqZvQt6N8bYG3CEYIb%2Fuploads%2FzbYUCs7VsVNr2xHFr18M%2Fimage.png?alt=media&amp;token=e914ecac-6aaf-409d-bf0a-9c81d8721ddf" alt="" width="563"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="座標系統Coordinates" %}

## 解釋Explaining

Minecraft世界座標是由三個絕對座標（X, Y, Z）所組成的空間直角座標系。&#x20;

> X軸為東西向，正方向為東 Y軸為高低向，正方向為上 Z軸為南北向，正方向為南

因此，三條座標軸形成了右手座標系：當首長前伸時，掌心朝左為X軸正向(東)，拇指朝上為Y軸正向(上)，食指朝前為Z軸正向(南)。透過這樣可以更為簡單地記住各座標軸。另外可以在Minecraft中放置向日葵，其花朵永遠面向東方，所以可以用於指示方向。&#x20;

<figure><img src="https://4090587073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiCsqZvQt6N8bYG3CEYIb%2Fuploads%2FkxxWBBdoPwsQYDAn554A%2Fimage.png?alt=media&amp;token=ec9664fe-d227-4a1c-824f-1d5cf7f3705a" alt=""><figcaption></figcaption></figure>

打開F3即可查看方向（藍框）和坐標（紅框）。

<div align="left"><figure><img src="https://4090587073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiCsqZvQt6N8bYG3CEYIb%2Fuploads%2FZRNfvEUJ6gBgAH1yNU3b%2Fimage.png?alt=media&amp;token=82b8b96a-4ca4-453b-bc81-c64af3f7bd33" alt="" width="375"><figcaption></figcaption></figure></div>
{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="標籤列表Label" %}

## 解釋Explaining

* -a：=air。(無視空氣方塊)
* -b : =biomes 。(包含生物群系)
* -c：=center。(中心
* -d：=default。(預設值)
* -e：=entity。(包含實體)
* -h：=horizontal、hollow。(中空或水平)
* -o：=origin。(原位置)
* -r：=raw。(原始/無法覆蓋)
* -s：=selection。(以選區為基準)
* -v：=vertical。(垂直延伸)
  {% endtab %}

{% tab title="方塊Blocks" %}

### Minecraft ID 列表：

{% embed url="<https://minecraft-ids.grahamedgecombe.com/>" %}

{% tabs %}
{% tab title="方塊資料格式" %}
`F3+H`可顯示更詳細的提示，將鼠標移至背包內的方塊上時，可以看到這樣的格式：

> 名稱 (#數字ID/數值) minecraft:英文ID 然而這樣的資訊仍不夠詳細，以下將深入說明。

### 方塊資料格式

WE所使用的方塊數值格式為：<kbd>方塊ID:數值</kbd>。 其中，ID使用英文或數字皆可；

<div align="left" data-with-frame="true"><figure><img src="https://4090587073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiCsqZvQt6N8bYG3CEYIb%2Fuploads%2FtNBUdlqzcZgUm7RhjsY6%2Fimage.png?alt=media&amp;token=85c57b34-be95-48fb-8017-d31b712a1720" alt=""><figcaption></figcaption></figure></div>

ID可分為方塊ID與物品ID等，簡言之你拿在手上時是物品，放到世界上才是方塊。\
而WE是針對方塊操作的，也就是需要使用方塊ID。&#x20;

***

### 資料值

資料值為ID的附加字串，記錄了方塊的顏色、狀態、朝向等資料。但有許多的資料值是不會在背包內顯示的，如流體的厚度、植物的生長階段、方塊的不同狀態、朝向等。因此在使用WE時，不妨測試更改不同資料值帶來的變化。數值在0\~15間，當數值為0時可連`:`一同省略。

<div align="left" data-with-frame="true"><figure><img src="https://4090587073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiCsqZvQt6N8bYG3CEYIb%2Fuploads%2FhDxiEtETcoRd129b2Quz%2Fimage.png?alt=media&amp;token=84dc7103-25ac-40f9-a31e-aa97588bc9be" alt="" width="76"><figcaption></figcaption></figure></div>

在 Minecraft 中，每個方塊都有額外的「屬性 (block states)」，例如方向、是否含水、是否連接牆壁等等。WorldEdit 允許玩家在方塊名稱後面，使用 **`[屬性=值]`** 的格式來指定。

#### 🛠️ 用法格式：

```
方塊名稱[屬性1=值,屬性2=值,...]
```

✔ 你可以一次設定多個屬性\
✔ 如果不寫，會用遊戲的預設值\
✔ 常見屬性有：

* `facing`（朝向，例如 north, south, east, west, up, down）
* `type`（上半/下半，例如 bottom, double, top）
* `waterlogged`（是否注水）True or False
* `powered`（紅石是否通電）True or False
* `open`（門是否開啟）True or False
* `age`（作物成熟度，0–7）
* `level`（液體流動層級，0–15）

<div align="left" data-with-frame="true"><figure><img src="https://4090587073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiCsqZvQt6N8bYG3CEYIb%2Fuploads%2FkOM4L7vu9T1FFyRfoquq%2Fimage.png?alt=media&amp;token=d53d3150-94ad-4f26-8e56-54e30092aa36" alt="" width="563"><figcaption></figcaption></figure></div>

### 告示牌文字語法

若想要連同告示牌上的內容一起設置，語法為：`方塊ID:資料值|[第1列內容]|[第2列內容]|[第3列內容]|[第4列內容]`。 其中，各列內容可留白，但分隔符號`|`需保留，另外若文本中含有空格，則前述語法整串需用`" "`符號包裹。
{% endtab %}

{% tab title="特殊方塊ID " %}

### 木塊/Wood

* 橡木塊/Oak Wood: 17:12
* 杉木塊/Spruce Wood: 17:13
* 樺木塊/Birch Wood: 17:14
* 叢林木塊/Jungle Wood: 17:15
* 相思木塊/Acacia Wood: 162:12
* 黑橡木塊/Dark Oak Wood: 162:13

### 平滑岩Smooth Stone

* 平滑石頭/Smooth Stone: 43:8
* 平滑砂岩/Smooth Sandstone: 43:9
* 平滑紅砂岩/Smooth Red Sandstone: 181:9

### 不會腐爛的樹葉/Leaves that don’t decay

* 橡木樹葉/Oak Leaves: 18:4
* 杉木樹葉/Spruce Leaves: 18:5
* 樺木樹葉/Birch Leaves: 18:6
* 叢林木樹葉/Jungle Leaves: 18:7
* 相思木樹葉/Acacia Leaves: 261:4
* 黑橡木樹葉/Dark Oak Leaves: 261:5

### 蘑菇方塊/Mushroom Block

* 蘑菇柄/Mushroom Stem: 99:15/100:15
* 棕色蘑菇方塊/Brown Mushroom Block: 99:14
* 紅色蘑菇方塊/Red Mushroom Block: 100:14
* 剝皮蘑菇方塊/Stripped Mushroom Block: 99:0/99:11~~99:13/100:0/100:11~~100:13
* 其他蘑菇方塊/Other Mushroom Block: 99:1~~99:10/100:1~~100:10

### 其他/Other

* 小麥/Wheat: 59:0\~59:7
* 胡蘿蔔/Carrot: 141:0\~141:7
* 馬鈴薯/Potato: 142:0\~142:7
* 甜菜/Beetroot: 207:0\~207:3
* 直立鐵製地板門/Upright Iron Trapdoors:167:4\~ 167:7
  {% endtab %}
  {% endtabs %}
  {% endtab %}

{% tab title="遮罩/圖樣" %}
「遮罩」和「圖樣」一樣常用於WE的命令中。與「圖樣」不同的是，遮罩決定了哪些方塊將受到指令、筆刷等的影響。以下為遮罩的形式：

{% tabs %}
{% tab title="圖樣pattern" %}
「圖樣」是一項許多WE指令會用到的參數，可以是一種方塊，也可以非常複雜。圖樣決定了在使用指令、工具等操作時，會將哪些方塊設置到世界中。以下為圖樣的形式：

### 單一方塊

最基本的圖樣就是單一方塊，即`方塊ID:資料值`。未輸入資料值時，則使用預設方塊，即資料值=0。

### 隨機圖樣

可以隨機設置任意數量圖樣的圖樣。使用上在圖樣間以`,`分隔即可，就會隨機平均分配這些圖樣。另外也可以用`<數字>%<圖樣>`來指定每個圖樣所佔的比例。 注：`%`前的數字加總不必是100，該數字僅代表一個相對的比例。

### 剪貼簿圖樣

使用`#copy`或`#clipboard`，可以把剪貼簿裡的方塊作為圖樣來設置。另外可以在後方添加`@[x,y,z]`來偏移圖樣，即`#clipboard@[x,y,z]`。
{% endtab %}

{% tab title="遮罩Masks" %}

### 方塊遮罩

這是最簡單的一種遮罩形式，像圖樣一樣可以是單一方塊或複數方塊，若有複數方塊同樣以`,`分隔。而不同的地方在於，方塊未輸入資料值時泛指所有該方塊的所有狀態。

### 反向遮罩

驚嘆號`!`表示否定後續的內容，亦即`![遮罩]`可以理解為保護\[遮罩]內的設定，僅影響\[遮罩]以外的方塊。

### 組合遮罩

可以將各式\[遮罩]以空格 分隔，再以`" "`框取，如`"[遮罩A] [遮罩B]"`。此時的遮罩表示各\[遮罩]間的交集。用法類似僅用or符號(`||`)分隔，如`[遮罩A]||[遮罩B]`。 ##偏移遮罩 在\[遮罩]之前加上`>`、`<`分別表示向上或向下偏移，即影響該遮罩上方或下方的方塊。 注：偏移符號可連用，如`>>>[遮罩]`表示影響該遮罩上方3格的方塊。

### 表達式遮罩

若遮罩有更複雜的條件需要滿足，可以`=`作為開頭，再加上數學表達式來表示。詳閱：<https://worldedit.enginehub.org/en/latest/usage/other/expressions/> 範例：`//gmask =queryRel(x,y,z,方塊ID,資料值)`，表示僅影響相對於該方塊x, y, z位置的方塊。亦可用and符號(`&&`)或or符號(`||`)串聯多項條件。座標系統參考：<https://discord.com/channels/692753403742388285/1125656953784377424。>

### 特殊遮罩

* `#existing`：適用於非空氣的任何方塊，但與`!0`略有不同。
* `#solid`：適用於被視為「實體」的方塊。
* `#surface或#exposed`：適用於物體表面，即其中一面暴露於空氣的任何方塊。
* `#region、#sel或#selection`：主要供筆刷使用，僅影響使用此遮罩前所選取的區域。若欲更換影響範圍則需重新選取並再次輸入遮罩指令。
  {% endtab %}
  {% endtabs %}
  {% endtab %}
  {% endtabs %}