- 版权类型
- 转载
- 语言支持
- 中文(简体)
- 适配Minecraft版本 [Java]
- 1.21
[MD]
# 轻松建造（Effortless Building）
适用于 Minecraft 1.20.4 的 Fabric 模组
---
## 简介
Effortless Building 是一个 Fabric 模组，旨在让大规模建造与清除操作在多人服务器上更快、更简洁、更安全。
传统方式下，每放置一个方块就会向服务器发送一个数据包。本模组改为由客户端计算完整预览，再将**一次性批量请求**发送给服务器。服务器随后对请求进行校验、检查背包或工具耐久，最终统一执行世界变更。
---
## 重要说明
**本模组不是 Spigot / Paper / Bukkit 插件。**
- 这是一个 **Fabric 模组**
- 需要运行 **Fabric 1.20.4 服务端**
- 客户端**同样需要**安装本模组
- 无法在普通的 Spigot / Paper / Bukkit 服务端上运行
---
## 功能
### 建造修饰器
- **镜像（Mirror）**：沿 X、Y 或 Z 轴镜像放置或清除方块
- **阵列（Array）**：沿某一方向重复执行同一操作多次
- **径向镜像（Radial Mirror）**：以某点为中心，将操作按圆形图案向四周复制
### 形状工具
- 单格（Single）
- 直线（Line）
- 墙面（Wall）
- 长方体（Cuboid）
- 球体（Sphere）
- 圆柱体（Cylinder）
### 多人游戏 / 生存系统
- 客户端—服务端数据包架构
- 服务端校验
- 生存模式下放置时检查背包物品
- 服务端消耗物品
- 批量挖掘模式并计算工具耐久损耗
- 不可破坏方块保护
- 批量操作的撤销与重做
### 预览系统
- 确认前显示幽灵预览
- 瞄准时实时更新形状
- 支持多种原版方块状态的上下文感知预览
- 放置与破坏预览采用不同颜色区分
---
## 安装
### 服务端安装
1. 安装 **Fabric 1.20.4 服务端**
2. 在服务端安装 **Fabric API**
3. 将 `effortlessbuilding-0.1.0.jar` 放入服务端的 `mods` 文件夹
4. 启动服务器一次，确认模组正常加载
### 客户端安装
1. 安装 **Fabric Loader 1.20.4**
2. 安装 **Fabric API**
3. 将 `effortlessbuilding-0.1.0.jar` 放入客户端的 `mods` 文件夹
4. 使用 Fabric 配置文件启动 Minecraft
### 安装注意事项
本模组需要**同时安装在服务端和客户端**。
- **客户端**负责预览、界面和形状计算
- **服务端**负责校验、背包检查、工具耐久、方块放置与破坏、撤销与重做
若服务端未安装本模组，批量操作的网络通信将无法正常工作。
---
## 使用方法
### 基础教程
1. 主手持**方块物品**进入**放置模式**，主手持**可损坏工具**进入**挖掘模式**
2. 将准星对准目标方块面或方块
3. 按 `Z` 设置**主锚点**
4. 移动准星预览形状
5. 可选：按 `X` 设置**副锚点**
6. 按 `B` 打开菜单
7. 选择形状和修饰器
8. 按 `V` 确认操作
### 默认按键
| 按键 | 功能 |
|------|------|
| `B` | 打开建造菜单 |
| `Z` | 设置主锚点 |
| `X` | 设置副锚点 |
| `C` | 清除锚点 |
| `V` | 确认放置 / 挖掘操作 |
| `U` | 撤销上一次批量操作 |
| `I` | 重做上一次已撤销的批量操作 |
---
## 放置模式与挖掘模式
### 放置模式
- 主手持方块物品
- 预览显示批量放置范围
- 生存模式下服务端检查背包
- 批量放置成功后消耗对应方块
### 挖掘模式
- 主手持可损坏工具
- 预览切换为批量挖掘范围
- 服务端在清除方块前验证工具有效性
- 每成功挖掘一个方块，工具损耗相应耐久
- 不可破坏的方块自动跳过
- 批量挖掘直接清除方块，**不会**产生正常掉落物
---
## 形状说明
**单格（Single）**
在目标位置放置或清除单个方块。
**直线（Line）**
设置一个点，再瞄准或设置第二个点，生成一条直线。
**墙面（Wall）**
设置两个点，生成一面平墙。可使用墙面轴向选项强制指定平面方向。
**长方体（Cuboid）**
设置两个对角点，生成一个立方体区域。
- 关闭**空心**：填充实心长方体
- 开启**空心**：仅保留外壳
**球体（Sphere）**
先设置球心，再通过第二个点设置或预览半径。
- 关闭**空心**：填充实心球体
- 开启**空心**：仅保留球壳
**圆柱体（Cylinder）**
先设置底面圆心，再通过第二个点定义高度和半径。可使用圆柱轴向选项控制圆柱的朝向。
---
## 修饰器说明
**镜像（Mirror）**
沿以下轴向进行镜像：X 轴、Y 轴、Z 轴。
适用于对称建筑、桥梁、塔楼、立面以及镜像清除。
**阵列（Array）**
- 选择方向
- 选择副本数量
- 选择间距
适用于柱子、窗户、支撑结构、重复性建筑及规律性批量清除。
**径向镜像（Radial Mirror）**
- 选择轴向
- 选择分段数量
适用于穹顶、圆形房间、塔楼、装饰图案及放射状清除。
---
## 生存模式行为
在生存模式下，服务端将执行以下操作：
- 检查玩家背包中是否有足够的方块用于放置
- 若背包缺少方块，拒绝放置操作
- 放置成功后消耗对应方块
- 撤销操作时将已放置的方块归还给玩家
- 检查批量挖掘模式是否使用了有效工具
- 每成功挖掘一个方块，扣除相应工具耐久
- 自动跳过不可破坏的方块
创造模式下，背包检查和耐久消耗均不生效。
---
## 撤销与重做
- `U`：撤销上一次批量放置或批量挖掘
- `I`：重做上一次已撤销的批量放置或批量挖掘
撤销与重做均在**服务端**处理，而非仅限客户端。
- 放置撤销：在生存模式下将已放置的方块归还给玩家
- 挖掘撤销：恢复已清除的方块
- 挖掘撤销**不会**恢复已损耗的工具耐久
---
## 技术说明
- 适配 **Minecraft 1.20.4**
- 使用 Fabric 网络接口，避免逐方块数据包轰炸
- 客户端负责计算形状方案与预览
- 服务端负责校验并执行最终的世界变更
- 批量挖掘模式与批量放置模式采用相同的客户端—服务端架构
---
## 已知限制
**邻居依赖型方块状态**
当前数据包格式对整次放置操作只发送**一种方块状态**。因此，部分依赖相邻方块的连接型方块在某些位置可能无法完美呈现，例如：
- 栅栏
- 墙
- 玻璃板
- 其他类似的连接型方块
**批量挖掘掉落物**
批量挖掘模式目前直接清除方块，不模拟原版掉落物及战利品表。
[/MD]
# 轻松建造（Effortless Building）
适用于 Minecraft 1.20.4 的 Fabric 模组
---
## 简介
Effortless Building 是一个 Fabric 模组，旨在让大规模建造与清除操作在多人服务器上更快、更简洁、更安全。
传统方式下，每放置一个方块就会向服务器发送一个数据包。本模组改为由客户端计算完整预览，再将**一次性批量请求**发送给服务器。服务器随后对请求进行校验、检查背包或工具耐久，最终统一执行世界变更。
---
## 重要说明
**本模组不是 Spigot / Paper / Bukkit 插件。**
- 这是一个 **Fabric 模组**
- 需要运行 **Fabric 1.20.4 服务端**
- 客户端**同样需要**安装本模组
- 无法在普通的 Spigot / Paper / Bukkit 服务端上运行
---
## 功能
### 建造修饰器
- **镜像（Mirror）**：沿 X、Y 或 Z 轴镜像放置或清除方块
- **阵列（Array）**：沿某一方向重复执行同一操作多次
- **径向镜像（Radial Mirror）**：以某点为中心，将操作按圆形图案向四周复制
### 形状工具
- 单格（Single）
- 直线（Line）
- 墙面（Wall）
- 长方体（Cuboid）
- 球体（Sphere）
- 圆柱体（Cylinder）
### 多人游戏 / 生存系统
- 客户端—服务端数据包架构
- 服务端校验
- 生存模式下放置时检查背包物品
- 服务端消耗物品
- 批量挖掘模式并计算工具耐久损耗
- 不可破坏方块保护
- 批量操作的撤销与重做
### 预览系统
- 确认前显示幽灵预览
- 瞄准时实时更新形状
- 支持多种原版方块状态的上下文感知预览
- 放置与破坏预览采用不同颜色区分
---
## 安装
### 服务端安装
1. 安装 **Fabric 1.20.4 服务端**
2. 在服务端安装 **Fabric API**
3. 将 `effortlessbuilding-0.1.0.jar` 放入服务端的 `mods` 文件夹
4. 启动服务器一次，确认模组正常加载
### 客户端安装
1. 安装 **Fabric Loader 1.20.4**
2. 安装 **Fabric API**
3. 将 `effortlessbuilding-0.1.0.jar` 放入客户端的 `mods` 文件夹
4. 使用 Fabric 配置文件启动 Minecraft
### 安装注意事项
本模组需要**同时安装在服务端和客户端**。
- **客户端**负责预览、界面和形状计算
- **服务端**负责校验、背包检查、工具耐久、方块放置与破坏、撤销与重做
若服务端未安装本模组，批量操作的网络通信将无法正常工作。
---
## 使用方法
### 基础教程
1. 主手持**方块物品**进入**放置模式**，主手持**可损坏工具**进入**挖掘模式**
2. 将准星对准目标方块面或方块
3. 按 `Z` 设置**主锚点**
4. 移动准星预览形状
5. 可选：按 `X` 设置**副锚点**
6. 按 `B` 打开菜单
7. 选择形状和修饰器
8. 按 `V` 确认操作
### 默认按键
| 按键 | 功能 |
|------|------|
| `B` | 打开建造菜单 |
| `Z` | 设置主锚点 |
| `X` | 设置副锚点 |
| `C` | 清除锚点 |
| `V` | 确认放置 / 挖掘操作 |
| `U` | 撤销上一次批量操作 |
| `I` | 重做上一次已撤销的批量操作 |
---
## 放置模式与挖掘模式
### 放置模式
- 主手持方块物品
- 预览显示批量放置范围
- 生存模式下服务端检查背包
- 批量放置成功后消耗对应方块
### 挖掘模式
- 主手持可损坏工具
- 预览切换为批量挖掘范围
- 服务端在清除方块前验证工具有效性
- 每成功挖掘一个方块，工具损耗相应耐久
- 不可破坏的方块自动跳过
- 批量挖掘直接清除方块，**不会**产生正常掉落物
---
## 形状说明
**单格（Single）**
在目标位置放置或清除单个方块。
**直线（Line）**
设置一个点，再瞄准或设置第二个点，生成一条直线。
**墙面（Wall）**
设置两个点，生成一面平墙。可使用墙面轴向选项强制指定平面方向。
**长方体（Cuboid）**
设置两个对角点，生成一个立方体区域。
- 关闭**空心**：填充实心长方体
- 开启**空心**：仅保留外壳
**球体（Sphere）**
先设置球心，再通过第二个点设置或预览半径。
- 关闭**空心**：填充实心球体
- 开启**空心**：仅保留球壳
**圆柱体（Cylinder）**
先设置底面圆心，再通过第二个点定义高度和半径。可使用圆柱轴向选项控制圆柱的朝向。
---
## 修饰器说明
**镜像（Mirror）**
沿以下轴向进行镜像：X 轴、Y 轴、Z 轴。
适用于对称建筑、桥梁、塔楼、立面以及镜像清除。
**阵列（Array）**
- 选择方向
- 选择副本数量
- 选择间距
适用于柱子、窗户、支撑结构、重复性建筑及规律性批量清除。
**径向镜像（Radial Mirror）**
- 选择轴向
- 选择分段数量
适用于穹顶、圆形房间、塔楼、装饰图案及放射状清除。
---
## 生存模式行为
在生存模式下，服务端将执行以下操作：
- 检查玩家背包中是否有足够的方块用于放置
- 若背包缺少方块，拒绝放置操作
- 放置成功后消耗对应方块
- 撤销操作时将已放置的方块归还给玩家
- 检查批量挖掘模式是否使用了有效工具
- 每成功挖掘一个方块，扣除相应工具耐久
- 自动跳过不可破坏的方块
创造模式下，背包检查和耐久消耗均不生效。
---
## 撤销与重做
- `U`：撤销上一次批量放置或批量挖掘
- `I`：重做上一次已撤销的批量放置或批量挖掘
撤销与重做均在**服务端**处理，而非仅限客户端。
- 放置撤销：在生存模式下将已放置的方块归还给玩家
- 挖掘撤销：恢复已清除的方块
- 挖掘撤销**不会**恢复已损耗的工具耐久
---
## 技术说明
- 适配 **Minecraft 1.20.4**
- 使用 Fabric 网络接口，避免逐方块数据包轰炸
- 客户端负责计算形状方案与预览
- 服务端负责校验并执行最终的世界变更
- 批量挖掘模式与批量放置模式采用相同的客户端—服务端架构
---
## 已知限制
**邻居依赖型方块状态**
当前数据包格式对整次放置操作只发送**一种方块状态**。因此，部分依赖相邻方块的连接型方块在某些位置可能无法完美呈现，例如：
- 栅栏
- 墙
- 玻璃板
- 其他类似的连接型方块
**批量挖掘掉落物**
批量挖掘模式目前直接清除方块，不模拟原版掉落物及战利品表。
[/MD]