Crazy AE2 Addons 翻译更新 (#5521)

Author: ChuijkYahus

projects/1.20/assets/crazy-ae2-addons/crazyae2addons/ae2guide/_zh_cn/crazyae2addons_index.md

@@ -32,10 +32,6 @@ Crazy AE2 Addons以多种方式拓展了应用能源2（Applied Energistics 2）
 
 <CategoryIndex category="Energy and Item Transfer"></CategoryIndex>
 
-## 数据变量
-
-<CategoryIndex category="Data Variables"></CategoryIndex>
-
 ## 生物存储
 
 <CategoryIndex category="Mob Storage"></CategoryIndex>

projects/1.20/assets/crazy-ae2-addons/crazyae2addons/ae2guide/_zh_cn/crazyguide/auto_builder.md

@@ -4,9 +4,9 @@ navigation:
   title: 自动建筑机
   icon: crazyae2addons:auto_builder
 categories:
-   - Monitoring and Automation
+  - Monitoring and Automation
 item_ids:
-   - crazyae2addons:auto_builder
+  - crazyae2addons:auto_builder
 ---
 
 # 自动建筑机
@@ -22,37 +22,40 @@ item_ids:
 ## 工作原理
 
 1. **为样板编码**
-   - 对两个位置使用建筑机样板以选择角落（右击选择第一个焦虑，Shift右击选择第二个）。
-   - 右击空气以将结构复制并存入物品。
-   - 范围内的所有方块都会被扫描，从而制成建筑机样板。
+    - 对两个位置使用建筑机样板以选择角落（右击选择第一个角落，Shift右击选择第二个）。
+    - 右击空气以将结构复制并存入物品。
+    - 范围内的所有方块都会被扫描，从而制成建筑机样板。
 
 2. **编辑样板（可选）**
-   - 手持建筑机样板Shift右击可打开一个文本编辑器GUI。
-   - 可在其中调整延时，或是加入重置、移除、循环、宏等命令。
-   - 右侧的数字是各命令间的延时，以刻计（默认20刻，合1秒），设为0可让其以最高速度运转。
+    - 手持建筑机样板Shift右击可打开一个文本编辑器GUI。
+    - 可在其中调整延时，或是加入重置、移除、循环、宏等命令。
+    - 右侧的数字是各命令间的延时，以刻计（默认20刻，合1秒），设为0可让其以最高速度运转。
 
 3. **放入样板**
-   - 将样板放入**自动建筑机**方块。
-   - 同一时刻只可放入一个样板。
-   - 可以通过自动方式向其中放入和从中取出样板。
+    - 将样板放入**自动建筑机**方块。
+    - 同一时刻只可放入一个样板。
+    - 可以通过自动方式向其中放入和从中取出样板。
 
 4. **提供能量和物品**
-   - 将自动建筑机连接至ME网络。
-   - 确保网络存储中有足够的建筑材料。
-   - 支持合成卡。
+    - 将自动建筑机连接至ME网络。
+    - 确保ME网络存储中有足够的建筑材料。
+    - 自动建筑机会在开始执行前抽取**当次所需的全部能量**。
+    - 支持合成卡。
 
 5. **触发建筑**
-   - 向顶部提供红石信号以开始建筑。
-   - 建筑机会一步步前进，依照样板进行搭建。
-   - 搭建完毕后，建筑机会向各面发出一个短红石脉冲。
-   - 加速卡可加快其工作速度。
+    - 向顶部提供红石信号以开始建筑。
+    - 建筑机会**基于其自身朝向**执行指令。
+    - **预览模式**会实时显示方块影像，在开始操作前可作参考。
+    - 搭建完毕后，建筑机会向各面发出一个短红石脉冲。
+    - 加速卡可加快其工作速度。
 
 ---
 
 ## 关键特性
 
-- **可根据样板搭建复杂结构**
+- **相对性**：结构会基于建筑机的朝向进行搭建
+- **预览模式**：在预定要放置和移除方块的位置实时显示方块预览影像
+- **能量预支**：程序开始时就将消耗整段程序所需的能量，能量不足便不会启动
+- **放置方块附带回收**：拆下的方块会返回ME网络存储
 - **完全与AE2的存储和供能系统集成**
 - **操作可使用红石控制**
-- **放置方块时可回收**（旧方块会进入存储系统）
-- 在建筑位置**实时显示方块预览**

projects/1.20/assets/crazy-ae2-addons/crazyae2addons/ae2guide/_zh_cn/crazyguide/auto_builder_language.md

@@ -47,14 +47,12 @@ item_ids:
 
 示例：
 
-\[stairs\](P(0)D) \[floor\](3{P(1)E})
+\[stairs\](P(0)D) \[floor\](3{P(1)R})
 
 主程序中可由以下方式使用：
 
 \[floor\]\[stairs\]
 
-宏最多可扩展至**50个递归层**，这是为避免出现无限循环。
-
 ### 程序代码
 
 指定实际的逻辑。可以直接使用指令，也可使用循环、宏、方块放置等。
@@ -65,14 +63,18 @@ item_ids:
 
 ### 移动
 
-| 代码 | 意义     |
-| ---- | -------- |
-| N    | 向北移动 |
-| S    | 向南移动 |
-| E    | 向东移动 |
-| W    | 向西移动 |
-| U    | 向上移动 |
-| D    | 向下移动 |
+| 代码 | 意义         |
+| ---- | ------------ |
+| U    | 向上移动     |
+| D    | 向下移动     |
+| F    | 向前移动     |
+| B    | 向后移动     |
+| L    | 向左移动     |
+| R    | 向右移动     |
+| H    | 返回起始点   |
+| X    | 清除（破坏） |
+
+实际移动方向的基准是**自动建筑机的当前朝向**，而不是东南西北等世界基本方位。
 
 每次移动都会将建筑机的游标向该方向移动**1格**。
 
@@ -106,17 +108,17 @@ X
 
 示例：
 
-4{P(1)E}
+4{P(1)R}
 
-放置方块1并向东移动，重复4次。
+放置方块1并向右移动，重复4次。
 
 循环可嵌套。
 
 示例：
 
-2{3{P(1)W}U}
+2{3{P(1)F}U}
 
-放置后向东移动，重复3次，然后向上移动。将此动作序列重复2次。
+放置后向前移动，重复3次，然后向上移动。将此动作序列重复2次。
 
 ---
 
@@ -134,9 +136,9 @@ P(0)Z(40)P(1)
 
 ---
 
-### 回到起点
+### 回到起始点
 
-R
+H
 
 令建筑机返回其启动位置。
 
@@ -152,19 +154,19 @@ R
 
 示例：
 
-\[stairStep\](P(0)U E)
+\[stairStep\](P(0)U F)
 
 ---
 
 ## 示例
 
 ### 1. 以一条线放置3格石头
 
-0(minecraft:stone) | P(0)E P(0)E P(0)
+0(minecraft:stone) | P(0)F P(0)F P(0)F
 
 功能一致，换用循环：
 
-0(minecraft:stone) | 3{P(0)E}
+0(minecraft:stone) | 3{P(0)F}
 
 ---
 
@@ -178,25 +180,25 @@ R
 
 ### 3. 搭建阶梯
 
-0(minecraft:oak_planks) | 5{P(0)U E}
+0(minecraft:oak_planks) | 5{P(0)U F}
 
-向上方和东方搭建5次。
+向上方和前方搭建5个阶梯。
 
 ---
 
 ### 4. 返回原点
 
-0(minecraft:stone) | 4{P(0)E} R
+0(minecraft:stone) | 4{P(0)F} H
 
-搭建向东延伸4格的小路，然后返回起点。
+搭建向前延伸4格的小路，然后返回起点。
 
 ---
 
 ### 5. 使用宏
 
-0(minecraft:stone),1(minecraft:dirt) | \[line\](3{P(0)E}) \[top\](U \[line\]) | \[line\]\[top\]\[line\]
+0(minecraft:stone),1(minecraft:dirt) | \[line\](3{P(0)F}) \[top\](U \[line\]) | \[line\]\[top\]\[line\]
 
-- 定义“线”/“line”，也即向东3格的石头小路。
+- 定义“线”/“line”，也即向前3格的石头小路。
 - 定义“上方”/“top”，也即在上方1格处搭建同样的“线”。
 
 ---
@@ -205,6 +207,6 @@ R
 
 本语言是一种严格语言：
 
-- 在P(n)中使用方块映射内不存在的ID → 错误。
-- 括号（{}、()、[]）错配 → 错误。
-- 宏无限递归 → 展开50次后产生错误。
+- 在P(n)中使用方块映射内不存在的ID -> 错误。
+- 括号（{}、()、[]）错配 -> 错误。
+- 宏无限递归 -> 错误。

projects/1.20/assets/crazy-ae2-addons/crazyae2addons/ae2guide/_zh_cn/crazyguide/crafting_scheduler.md

@@ -35,4 +35,4 @@ item_ids:
     - 给予一次红石脉冲。
 
 5. **可重复使用**
-    - 如果CPU空闲，则每次脉冲都会触发一次合成任务。
+    - 如果CPU空闲，则每次脉冲都会触发一次合成任务。

projects/1.20/assets/crazy-ae2-addons/crazyae2addons/ae2guide/_zh_cn/crazyguide/data_extractor.md

@@ -0,0 +1,112 @@
+---
+navigation:
+  parent: crazyae2addons_index.md
+  title: 数据提取器
+  icon: crazyae2addons:data_extractor
+categories:
+  - Monitoring and Automation
+item_ids:
+  - crazyae2addons:data_extractor
+  - crazyae2addons:player_data_extractor
+---
+
+# 数据提取器与玩家数据提取器指南
+
+本指南会介绍在应用能源2（AE2）网络中使用**数据提取器**和**玩家数据提取器**的方法。这些部件可读取外部数据，并将其送至**ME数据控制器**。此后，该数据会以变量的形式存在，供自动化和逻辑设施使用。
+
+---
+
+## 数据提取器
+
+**数据提取器**专长于从直接相邻的方块和方块实体中读取信息。
+
+### 可读取的数据
+
+* **物品管理器（Item handler）数据**
+
+    * `percentFilled` – 已填充的物品栏槽位的百分比占比。
+* **流体管理器（Fluid handler）数据**
+
+    * `fluidPercentFilled` – 流体容器（tank）的填充程度。
+    * `fluidAmount` – 当前流体的储量。
+    * `fluidCapacity` – 容器的容量。
+* **能量管理器（Energy handler）数据**
+
+    * `storedEnergy` – 当前FE的储量。
+    * `energyCapacity` – FE容器的最大容量。
+* **方块状态（Block state）数据**
+
+    * `blockName` – 方块的名称。
+    * `isAir` – 方块是否是空气。
+    * `isSolid` – 方块是否是固体方块。
+    * `redstonePower` – 相邻方块的红石信号强度。
+    * `blockLight` / `skyLight` – 方块处的光照等级。
+    * `blockHardness` – 摧毁所需时间。
+    * `blockExplosionResistance` – 爆炸抗性。
+    * `blockState:property` – 任意方块状态属性（如朝向）。
+
+* **安装有ComputerCraft Tweaked时功能更强**
+  * 相当于CC电脑，且可从外围设备中读取信息。
+
+### 使用方法
+
+1. 面向读取目标**放置子部件**。
+2. **右击**打开GUI。
+3. 点击**拉取**/**Fetch**以侦测目标所有可用的变量。
+4. 使用箭头按钮浏览可用变量。
+5. 选择其一，为其分配**变量名**。
+6. 设置**延时**（两次更新的间隔刻数）。
+7. 选定的值会以所给名称发送至**ME数据控制器**。
+
+---
+
+## 玩家数据提取器
+
+**玩家数据提取器**的功能与前者类似，但它会从玩家中读取，而非方块。
+
+### 可读取的数据
+
+* `playerName` – 玩家的名称。
+* `playerHealth` / `playerMaxHealth` – 当前生命值和最大生命值。
+* `playerDistance` – 与提取器的距离。
+* `playerIsSneaking` – 玩家是否在潜行。
+* `playerIsSprinting` – 玩家是否在疾跑。
+* `playerYaw` – 玩家的水平旋转角度。
+* `playerPitch` – 玩家的垂直旋转角度。
+
+### 使用方法
+
+1. **将子部件放置**于网络。
+2. 放置时，其会自动将放置者识别为目标。
+3. 打开GUI以查看可用变量。
+4. 点击**拉取**/**Fetch**以刷新列表。
+5. 选择其一，为其分配**变量名**。
+6. 设置**延时**以控制更新频率。
+7. 所选数据会发送至**ME数据控制器**。
+
+默认情况下，提取器会搜寻**距离最近的玩家**。在**玩家模式**下，其会选定特定的UUID（放置它的玩家）。
+
+---
+
+## GUI控制（两者均适用）
+
+* **拉取**/**Fetch** – 刷新可用变量。
+* **箭头（< >）** – 滚动变量界面。
+* **按钮（0–3）** – 选择列出的变量。
+* **所选**/**Selected** – 显示当前选中的变量。
+* **变量名** – 变量命名文本框（必须为ASCII字符，且会被转换为大写）。
+* **延时** – 更新间隔，以刻计。
+* **保存（+）** – 保存设置。
+
+---
+
+## 实用示例
+
+* 对某流体储罐放置**数据提取器**。
+* 拉取变量，选择`fluidAmount`。
+* 将变量名设为`&WATER_LEVEL`。
+* 此后即可在**ME数据控制器**中使用`&WATER_LEVEL`进行自动化。
+
+---
+
+这两种提取器都是强大的工具。它们能在AE2网络和**实时世界信息与玩家数据**间建立联系，以便进行高水平的自动化、状态监测，也可借此搭建功能自定的逻辑设施。