AI声明：本文章使用AI起草文案；本文章附带的代码使用AI辅助创作。
下载：见文章最底部。
前言
如果你2014年-2016年的时候，在「方块启动器」(BlockLauncher)上用过百度贴吧6g3y大大制作过的《快速建造.js》，大概还记得屏幕边那个“E”按钮，以及它的功能：选两个点，长方体、球体、圆环、复制粘贴，点几下就能搞出来。
近十年后，我借助了DeepSeek把它按现代《我的世界》基岩版Script API接口重写了一遍。经过数轮打磨和细节调优，成品免费共享，给做地图的朋友们使用。
我并没有“把旧代码翻译一遍”，本重制版只在高版本MCBE使用现代化的SAPI接口复刻原案的功能行为，不包含原案的任何脚本代码、贴图或版权素材。作为原案的精神续作，本项目不会发布至任何商业平台上架出售，在这里仅做公益分享，MCBE地图创作者可以自由下载使用。
为什么要做重制版
因为自从「方块启动器」停更之后，如果想继续使用老版本快速建造js，就必须使用老版本MC，以及它的配套相关工作流。例如MCBE1.7.0平台、JAVA版1.12.2平台。这些平台已经远远落后于目前版本，直接使用这些平台进行作品开发要极大的局限性。其次是自从骁龙8gen3处理器彻底删除32位应用支持之后，相关工作流需要使用的软件已经完全无法启动了。
尽管我储备了多部能够运行32位软件的手机，那也不是长久之计。毕竟从骁龙8gen1开始，手机就开始阉割32位软件的支持，如果想用「方块启动器」，运行会很不稳定，经常闪退；而32位时代的最后巅峰骁龙870也属于特别旧的平台了，这个年代的手机坏一台少一台，实属鸡肋。
尽管目前在高版本MC的工作流中，也不乏其它快速建造的模组。不论是国际版，还是网易，还是JAVA版，均已经有类似快速建造功能的模组。
但是网易的快速建造，虽然功能强大，但是依赖网易的模组API，国际版无法使用，很难融入进国际版的工作流中；而国际版的快速建造类模组，多为国外出品的，很多都是英文版，没有中文，使用起来一些术语晦涩难懂，操作也很捉急。
而且即使硬着头皮使用英文版的模组，它们可能也不支持1.20.81这样“老版本”MC，因为1.20时代，SAPI才刚刚起步没多久，一些功能还不完善，并不是所有功能都可以制作。然而，我现在的所有工作流全部都基于1.20.81，所以我就需要一款支持这个版本的快速建造模组。
近年来，随着AI自动化办公软件的发展，想借助AI来制作MC模组也并非不可能。只需要有一点MCBE的开发常识，外加一个良好的项目管理经验，以及AI提示词引导，还有能够持续打磨调优的耐心，我就让DeepSeek协助我做了这么一个模组。
本重制版相关信息
名称：《快速建造》精神续作SAPI重制版fastbuild-sapi
版本：v0.2.0
原案：百度贴吧：6g3y
代码：蓝色大肥鱼
制作：dr风云迈啊密
目标平台：Minecraft Bedrock 1.20.81（国际服）
脚本 API：@minecraft/server 1.10.0、@minecraft/server-ui 1.1.0
实测环境：最低使用版本：1.20.81。最新版1.26.60实测功能基本齐全。高版本MC可加载，个别接口可能会有弃用警告，不影响主要功能。
工程形态：行为包 + 资源包，TypeScript + esbuild，模块化源码。
版权处理：不包含原脚本代码、LOGO、版权字符串和UI资源；只复刻了原案的功能行为，重制版所使用的算法全部独立实现。界面使用的是MCBE原版的交互表单。
重制版能做什么
1. 基础建造
两点选区：铁剑选点；也可手持方块右键选点（默认开启，可在设置关闭）
两点长方体：实心 / 空心 / 框架；可用当前选区，也可手动输入两点坐标
单点长方体：输入长、宽 、高
填充：选区填为指定方块ID，或使用手持方块
替换：指定来源方块与目标方块，或目标=手持方块
清空选区：把选区内方块设为空气
坐标查询：指南针对准方块使用，显示方块ID、状态、坐标、距离与选区信息
撤销：每个玩家保留最近10次操作，逐块恢复原方块及状态
重复上一次：木剑一键重复最近的填充/替换/几何/渗透；填充优先使用当前选区
取消：水桶取消已就绪操作；没有就绪操作时清空选区
2. 几何建造
线面类：连线、三点一面、四点曲面、取中点、三点面交点、指定坐标放置方块
圆球类：圆环、圆面、空球、实球、上半球、椭球、椭圆环、两点椭球
柱锥台类：圆柱、圆锥、圆台、金字塔、圆环
单点形状点击方块即以该点为中心/底面中心生成；多点形状可用铁剑依次选点
材料可以输入方块ID，也可以直接手持方块
写了兼容层，支持数字ID，例如35:7会转换为灰色羊毛
3. 地形填充
渗透、填坑、填平面。
强度表示最多修改方块数5万个方块，受分片预算与撤销保护。
4. 复制粘贴
5 个复制黏贴槽位
选区复制，单轴 ≤32、体积 ≤32768
含空气粘贴/跳过空气粘贴
粘贴不覆盖目标格已有方块
9种旋转+4种镜像，共13种变换
116倍放大粘贴
复制时去除水/岩浆，可额外排除指定方块ID
支持坐标输入复制/粘贴；粘贴时用时钟点击方块确定最小角
5. 性能优化与安全保护
这是新作和旧版最大的差别之一：
硬上限50万方块
超过5万方块先二次确认
每tick执行2000方块，分片处理
选区外、未加载区块自动跳过
撤销记录上限10万方块
操作进行中再次操作会提示“有操作正在执行，请稍候”
提供三档聊天通知：完全显示、只显示关键操作、完全不显示
6. 原案没有的额外功能
主菜单一键“获取所有建筑工具”，工具丢了可补领
编辑快捷栏物品：
42 项附魔分页复选，可逐项或统一填写等级
重命名物品
编辑物品Lore首行
附魔通过原版/enchant执行，需要世界开启作弊
表单按钮使用原版物品/UI 贴图作为图标，功能更好记
方块放置选点：手持方块右键即可选点，不会真的放置方块；材料取当时手持方块
本模组使用现代化的SAPI接口制作，能够安装在MCBE国际版上，包括手机、PC基岩版等能运行MCBE的设备，并不局限于安卓手机。
上手教程
0. 准备
Minecraft基岩版1.20.81或更高，最新版本实测功能基本完整
创造模式
如果要用附魔编辑，世界需要开启作弊
单人世界或服务器均可；多人时每个玩家各自维护选区和撤销记录
1. 安装
下载发布包后，双击或用 Minecraft 打开，自动导入行为包和资源包。
*注意：国际版的一个模组就是2个包，别只装一个包！
2. 进入世界
进入后会自动获得“快速建造工具箱”并显示欢迎消息。如果没收到，打开主菜单后点“获取所有建筑工具”，一键补发工具箱、铁剑、木剑、水桶、指南针、时钟。
3. 第一次建造
以造一个 10×5×10 的实心石头平台为例：
手持工具箱，对方块或空气使用，打开主菜单
切到铁剑，右键方块 A，提示“已选点 1”
右键方块 B，提示“已选点 2”和体积
打开主菜单 → 几何建造 → 两点长方体 → 实心
输入材料：minecraft:stone（或者是选使用手持材料）
等待完成提示
不满意就打开主菜单 → 编辑工具 → 撤销上一步，选区会逐块恢复原状。
4. 工具速查
主菜单入口包括：几何建造、填充与替换、复制粘贴、编辑工具、获取所有建筑工具、编辑快捷栏物品、设置、关于、退出。
5. 常用操作
■空心房子外壳：选房子两个对角 → 几何建造 → 两点长方体 → 空心 → 输入材料。内部保持原样，之后自己开门窗。
■球体：几何建造 → 球 → 输入半径 → 选材料 → 点击球心方块。
■复制一栋小屋：选完整区域 → 复制粘贴 → 复制当前选区 → 选槽位 → 粘贴（含空气或跳过空气）→ 用时针对准目标位置点击。需要转向就选旋转/镜像，需要放大就选 1~16 倍。
■填坑：填充与替换 → 渗透 / 填坑 / 填平面 → 输入强度 → 点击起点。适合填平水池、空洞、整片低洼地。
6. 常见问题
使用工具箱没反应：确认是创造模式、行为包+资源包双包已激活、手持的是工具箱而不是铁剑
铁剑选点没反应：要对准方块使用；如果用手持方块选点，确认设置里的“方块放置选点”是开启状态
提示体积过大：超过5万会二次确认，超过50万直接拒绝；先缩小范围或分几次做
建造没开始：检查选区是否完整、方块ID是否有效、是否有操作正在执行
卡顿：大范围操作会分片执行，但仍建议一次不要做太大；几何体半径越大，预计方块数增长越快
附魔失败：世界没开作弊、该附魔不适用于当前物品、等级超过原版上限，或当前版本没有重锤/长矛附魔
网易版用不了：网易版有更多功能强大的快速建造模组，我这个是国际版专用的。
JAVA版用不了、PCL用不了：JAVA版有创世神或者是Axiom，比我这个强大很多。我这个是基岩版的国际版用的。
与原作不同的地方
不能实现旧版Android悬浮窗，改为“工具箱物品+游戏内表单”的交互方式
仅创造模式可用，不过这个是为了安全考虑的设计
不能实现像素画，因为SAPI接口无法读取设备图片文件
不能实现各种树、洞穴、丘陵等自然景观，因为好用的地形编辑软件比这些专业得多
不能实现快速毁图、自动洞穴等高风险功能，容易炸档
虽然有写数字ID兼容层覆盖常用ID，但是并不是全部的旧ID。因为MCBE在某个版本之后就完全弃用数字ID了。
高版本MC可使用，但个别接口会显示弃用警告，直接无视，能用就好。
版权、署名与免费共享声明
原作《快速建造v5.1.js》（2016，BlockLauncher Pro / ModPE）版权归原作者 6g3y 所有。原作者并未授意我制作本模组，本模组并非原作者制作，而是粉丝制作，与原作者无关。
本工程是独立重写，不包含原脚本代码、LOGO、版权字符串和UI资源；仅复刻功能行为后使用新接口重新实现。
本工程代码由AI辅助生成。工程由我本人（dr风云迈啊密）主导设计、修改、测试。如果你对本重制版模组有什么需要反馈的，请直接在B站联系我。B站昵称：-风小云-
本工程按非商业、公益分享的方式免费提供，允许用于：
MC地图创作
创造服、公益服
MC教学、课程、教程内容
学习
本工程代码与文档的授权方式：【CC BY-NC-SA 4.0】。
本模组作为创作工具可以用于制作商业作品。但是如果你的地图里包含了本模组，且地图会上架商业平台，请在地图发布之前将本模组从地图内删除。你发布的内容不得包含本模组在内。
你只要发布的内容不包含本模组的文件，你的地图也只是用工具加速了创作过程而已，不属于越界使用。
七、下载与反馈
反馈 bug 请附上：MC 版本、操作步骤、截图或日志
欢迎分享你用它做出来的地图；也欢迎提交建议和代码改进
如果这个工具帮你省下了几个小时，欢迎回帖晒一张作品截图。看到有人用它把脑子里的建筑快速搭出来，就是这次重制版最大的意义。
以上。
