Aliya’s Toolkit

Aliya’s Toolkit

English | 中文

Aliya’s Toolkit 是一款适用于 Minecraft 1.21.1 NeoForge 的生活便利类模组。它将快捷栏管理、连锁挖掘、快速建造和蓝图复制整合到一个工具箱中。目标很简单：少花点时间打开菜单、重复点击，多花点时间享受游戏。

你可以做什么

• 无需打开物品栏，即可将快捷栏与指定的物品栏一行互换。
• 自动补充快捷栏中的重要物品。
• 一次性破坏相连的方块，还支持大型方块预设。
• 只需点击两次，即可建造线条、矩形、圆形、球体和其他形状。
• 将建筑记录到蓝图盒中，以幽灵预览查看，然后在其他位置建造。
• 通过一个游戏内设置界面管理所有功能。

运行要求

项目	要求
Minecraft	1.21.1
模组加载器	NeoForge 21.1.265 或更高版本（21.1.x）
Java	21
安装	多人游戏需要客户端和服务器端；单人游戏只需安装客户端
其他模组	无必需模组

快速入门

1. 为 Minecraft 1.21.1 安装 NeoForge。
2. 将模组文件放入 mods 文件夹。多人游戏请在客户端和服务器端都安装此模组。
3. 启动游戏并进入一个世界。
4. 按下 Alt + X 打开 Aliya’s Toolkit Settings。
5. 使用五个选项卡设置物品白名单、连锁挖掘预设、快速建造预设和蓝图选项。

所有按键仅在游戏中生效，可在 选项 → 控制 → 按键绑定 → Aliya’s Toolkit 中更改。

快捷栏与物品栏

切换快捷栏

按下 X，即可通过以下两种模式之一切换快捷栏：

• 指定行（默认）：将九个快捷栏槽位与指定的物品栏一行互换（1 = 顶行，3 = 底行）。
• 循环：轮换物品栏的三行和快捷栏。正向：第 1 行 → 第 2 行 → 第 3 行 → 快捷栏 → 第 1 行；反向则按相反顺序循环。

无需打开物品栏。切换不会触发自动补充。

自动补充

当白名单中的物品从快捷栏消失时——例如物品用完、被丢弃或工具损坏——模组会将物品栏中匹配的物品堆叠移回快捷栏的同一槽位。

• 白名单共有九个槽位。打开 Alt + X → Automatic Refill，手持物品左键点击即可添加，右键点击则可清空槽位。将鼠标悬停在槽位上可查看物品提示。
• 精确匹配 可要求物品类型和物品数据均相同，例如附魔和自定义名称。耐久度始终会被忽略，因此新镐子可以替换损坏的镐子。
• 只有在游戏中，且没有打开物品栏、容器或聊天界面时，自动补充才会生效。

连锁挖掘

轻按 Z 可切换连锁挖掘。松开按键时切换才会生效。启用后，破坏一个方块也会破坏与其相连的同类方块。

• 连锁上限 用于设置一次最多破坏多少个方块。默认值为 64；范围为 1–256。
• 大型方块预设涵盖石头、泥土和下界岩等常见材料。每种预设都可设置截面形状，以及沿面朝方向延伸的层数。
• 允许其他方块 可让同一形状破坏区域内其他可破坏的方块。关闭此选项后，只会破坏最初选中的方块类型。
• 掉落物会集中到起点，并尽可能合并堆叠，避免物品散落一地。
• 按住 Z 并滚动滚轮可切换大型方块预设。

快速建造

轻按 C 可切换快速建造。松开按键时切换才会生效。按住 C 并滚动滚轮可更改当前预设。选定第一个点之前，准星会跟随一个绿色目标轮廓，让你确认快速建造已启用。

1. 右键点击第一个角以设置起点。预览会显示计划建造的形状和所需方块数量。
2. 再次右键点击以设置终点。模组会检查主手中的方块和可用材料。
3. 在生存模式下，方块会从物品栏和快捷栏中扣除。在创造模式下，不消耗材料。

快速建造支持点到点和中心到点放置，支持一维、二维和三维形状，以及线条、矩形、圆形和球体。每种形状都可以建成实心、空心或框架。

单次建造最多可放置 4096 个方块，目标位置最远可达 64 个方块。建造开始时会再次检查形状，因此目标无效时不会进行建造。

蓝图建造

进入蓝图模式

手持蓝图盒并按下 Ctrl + 右键。

• 一个空蓝图盒会进入绘制模式。
• 一个已包含蓝图的蓝图盒会进入建造模式。
• 进入模式时会显示蓝图建造：绘制模式或蓝图建造：建造模式。
• 在建造模式下，如果蓝图盒里没有建造材料，按下 Tab 可返回绘制模式。记录新蓝图会替换旧蓝图。
• 装有建造材料的蓝图盒会保持建造模式，直到其中的物品或蓝图被清空。

绘制蓝图

选定第一个点之前，准星会跟随一个淡黄色目标轮廓，让你确认绘制模式已启用。

• 右键点击两个位置以扩展选区。当前选区为浅蓝色，新预览区域为淡黄色。
• 左键点击两个位置以缩小选区。预览区域为淡红色。
• 之后的右键选区可以重新添加先前移除的区域；选区会按操作顺序依次应用。
• 你可以连续添加或移除多个选区。
• 选择位置时按住 Shift，可将位置吸附到所指方块的外侧表面。
• 在任意位置按下 Ctrl + 左键，即可记录建筑并收集所需材料（剪切）。模组会再次读取该区域，收集所需的方块物品、容器内物品和流体桶，将它们放入蓝图盒，并移除源方块。
• 在任意位置按下 Ctrl + 右键，即可仅记录蓝图（复制）。源方块会保留，蓝图盒中也不会放入材料。
• 记录时会过滤掉蓝图盒本身，避免蓝图意外收录另一个蓝图盒。
• 容器内的物品会计入材料需求。建成结构后，这些物品也会恢复。
• 两种记录操作都会退出绘制模式。

建造蓝图

• 进入建造模式后会立即显示幽灵预览，即使你的材料不足也一样。
• 滚动滚轮可将幽灵预览移近或移远。
• 按下 V 可让幽灵预览绕垂直轴旋转 90 度。
• 右键点击可固定幽灵预览，方便你四处走动并检查；左键点击可取消固定。
• 幽灵预览固定后，按下 Ctrl + 右键 可检查材料并开始建造。
• 如果材料充足，所需方块、容器内物品和桶会从蓝图盒中取出，并开始建造结构。如果材料不足，会显示提示并退出蓝图模式。
• 幽灵预览经过调整后更容易看清，且只显示可见的方块面；蓝图轮廓则会完整显示。材料足够建造时轮廓为绿色，不足时为红色。

幽灵预览会在指示器周围 8 个方块的半径内寻找有效放置位置。箱子、潜影盒、床和其他动画方块在预览中会显示实际外观。

自动收集流体

此选项默认开启，可在 Alt + X → Blueprint Build 中更改。

记录蓝图时，模组会查找可用桶装取的流体源，例如水和熔岩。

• 在剪切模式（Ctrl + 左键）下，模组会检查物品栏、快捷栏和副手中是否有空桶。如果空桶数量足够，就会消耗这些空桶，并将装满流体的桶加入蓝图材料清单。如果空桶不足，则会跳过该流体源并显示提示，但仍会继续记录蓝图的其他部分。
• 在复制模式（Ctrl + 右键）下，流体源会被记录到蓝图中，但不会消耗空桶，也不会添加装满流体的桶。建造时请带上所需的桶。

关闭此选项即可完全忽略流体源。

蓝图盒

蓝图盒是类似箱子的储物方块，可存放蓝图和建造所需的材料。共有六个等级：

蓝图盒	储物槽位	获取方式
蓝图盒	27（3×9）	箱子 + 8 张纸
铜质蓝图盒	45（5×9）	蓝图盒 + 8 个铜锭
铁质蓝图盒	63（7×9）	铜质蓝图盒 + 8 个铁锭
金质蓝图盒	81（9×9）	铁质蓝图盒 + 8 个金锭
钻石蓝图盒	108（12×9）	金质蓝图盒 + 8 颗钻石
下界合金蓝图盒	144（16×9）	锻造台：钻石蓝图盒 + 下界合金锭 + 下界合金升级模板

要打开手持的蓝图盒，按下 Alt + 右键。右键点击已放置的蓝图盒，也可以打开相同界面。

• 屏幕每次显示五行；使用滚动条或滚轮查看其余内容。
• 空箱子表示槽位已禁用。记录蓝图后，会显示半透明占位，标明需要哪些物品以及所需数量。
• 清空蓝图会把已存放的物品放回并移除蓝图。一键取出会把已存放的物品移入背包，同时保留蓝图。一键存入会把背包中符合条件的物品移入箱子。
• 蓝图箱可以像箱子一样配合漏斗和比较器使用。它们始终是单箱，不能放进另一个蓝图箱。
• 所有蓝图箱都会在水中上浮。铜制及更高等级的蓝图箱可防火、防岩浆；钻石及更高等级可防爆炸；下界合金蓝图箱的掉落物还能在岩浆中保留，掉进虚空时也会被移至安全位置。
• 用铁砧给蓝图箱改名会保留箱内物品和蓝图。破坏已放置的蓝图箱时，也会保留物品、蓝图和已存放的内容。

设置与多人游戏

按 Alt + X 打开设置界面。共有五个页面：

• 物品切换 — 选择“指定行”或“循环”模式、指定行模式使用的背包行，以及循环方向。
• 自动补充 — 开启或关闭“完全一致”，并编辑九格白名单。
• 连锁破坏 — 设置连锁数量、大量方块预设、方向锁定，以及是否允许破坏其它方块。
• 快速建造 — 选择、新建或删除预设，并设置操作、维度、形状和填充方式。
• 蓝图建造 — 开关自动收集流体，并查看当前蓝图操作提示。提示中显示的按键会与你实际的按键绑定一致。

白名单和设置按玩家分别保存，会随玩家数据存储，死亡和重生后仍然保留。

多人游戏中，请在客户端和服务端都安装本模组。每位玩家的设置互相独立。模组还提供全局配置选项，服务器管理员可以单独关闭某项工具。

默认按键

操作	默认按键
打开 Aliya的工具包 设置	Alt + X
切换快捷栏（指定行 / 循环）	X
开关连锁破坏	短按 Z
切换大量方块预设	按住 Z 并滚动滚轮
开关快速建造	短按 C
切换快速建造预设	按住 C 并滚动滚轮
打开主手中的蓝图箱	Alt + 右键
蓝图绘制：记录并收取（剪切）	Ctrl + 左键
蓝图建造：进入、记录复制或建造	Ctrl + 右键
蓝图建造：切换绘制/建造模式	Tab（箱子必须没有物品）
蓝图绘制：吸附到方块外侧面	按住 Shift
蓝图建造：旋转虚影	V（固定之前）
蓝图建造：固定/解除固定虚影	右键 / 左键
退出连锁破坏 / 快速建造 / 蓝图建造	`
蓝图建造：调整虚影距离	滚轮

所有按键都可以在控制菜单中重新绑定。连锁破坏、快速建造和蓝图建造属于模式类功能，同一时间只能开启一个。

注意事项

• 本版本适用于 Minecraft 1.21.1 和 NeoForge 21.1.x。
• 本模组目前只在接近原版的环境中测试过，也就是单人游戏。其它模组、大型整合包和专用多人服务器尚未测试。
• 在大型建筑上使用蓝图复制前，请备份重要世界，并建议先在测试世界中试用这些功能。
• 蓝图复制会记录方块、容器及其内容，以及可用桶收集的流体源头。大型建筑可能需要大量材料和足够开阔的建造空间。

许可

本模组使用 MIT License，欢迎放入整合包。

作者说明

本模组由 1% 灵感 + 99% AI 制作，是一个希望让建造和挖矿轻松一点的小工具。如果遇到异常，请尽量在接近原版的最小环境中复现，并在反馈中写清操作步骤。

---

中文说明

English | 中文

Aliya的工具包 是一个面向 Minecraft 1.21.1 / NeoForge 的便利工具模组，把快捷栏管理、连锁破坏、快速建造和蓝图复制整合在一起。它想解决的问题很简单：少开几次背包，少做重复操作，把时间留给真正想玩的内容。

主要功能

• 不用打开背包，就能把快捷栏和指定的背包行交换。
• 白名单物品从快捷栏消失后，自动从背包补回。
• 一次破坏相连的同类方块，并可使用“大量方块”形状预设。
• 两次选点，快速建造直线、矩形、圆形、球形等形状。
• 用蓝图箱记录建筑，以虚影预览，并在别处重新建造。
• 通过一个游戏内设置界面管理所有功能。

环境要求

项目	要求
Minecraft	1.21.1
模组加载器	NeoForge 21.1.265 或更新的 21.1.x
Java	21
安装位置	多人游戏需要客户端和服务端都安装；单人游戏只需客户端
其它模组	无需安装

快速开始

1. 为 Minecraft 1.21.1 安装 NeoForge。
2. 把模组文件放入 mods 文件夹。多人游戏请同时在客户端和服务端安装。
3. 进入游戏并打开一个世界。
4. 按 Alt + X 打开 Aliya的工具包 设置。
5. 在左侧五个页面中设置物品白名单、连锁破坏预设、快速建造预设和蓝图选项。

所有快捷键只在游戏内生效，都可以在 选项 → 控制 → 按键绑定 → Aliya’s Toolkit 中修改。

快捷栏与背包

快捷栏切换

按 X 切换快捷栏，支持两种模式：

• 指定行（默认）：把快捷栏九个格子和指定的一行背包互换（1 = 最上面一行，3 = 最后一行）。
• 循环：让背包三行和快捷栏按顺序轮换。正序为第一行 → 第二行 → 第三行 → 快捷栏 → 第一行；倒序方向相反。

切换不需要打开背包，也不会触发自动补充。

自动补充

白名单物品因为用光、丢弃或工具损坏而从快捷栏消失时，模组会把背包里的同类物品移回原来的快捷栏格。

• 白名单共有九个格子。打开 Alt + X → 自动补充，左键拿起物品设置，右键清空。鼠标悬停在槽位上可以查看物品信息。
• 完全一致 开启后，要求物品类型、附魔、自定义名称等数据一致；耐久值始终不参与比较，所以坏掉的镐可以用新镐补上。
• 打开背包、箱子或聊天等界面时不会触发自动补充。

连锁破坏

短按 Z 切换连锁破坏，松开按键时生效。开启后，挖掉一个方块会同时破坏周围相连的同类方块。

• 连锁数量 控制一次最多破坏多少格，默认 64，范围 1–256。
• 大量方块 预设适用于石头、泥土、下界岩等常见材料，可以设置横截面和沿朝向前方延伸的层数。
• 允许其它方块 开启时，形状范围内的其它可破坏方块也会一起破坏；关闭后只破坏与起点相同的方块。
• 掉落物会集中到起点并尽量合并，不会散落一地。
• 按住 Z 滚动滚轮可以切换大量方块预设。

快速建造

短按 C 切换快速建造，松开按键时生效；按住 C 滚动滚轮可以切换预设。第一次选点前，目标格会跟随准星显示绿色轮廓，便于确认快速建造已开启。

1. 第一次右键设置起点，界面会显示规划轮廓和所需方块数量。
2. 第二次右键设置终点，模组会检查主手方块和可用材料。
3. 生存模式会消耗背包和快捷栏中的方块；创造模式不消耗材料。

快速建造支持点到点、中心到点，一维、二维、三维，以及直线、矩形、圆形、球形等形状；每种形状可以选择实心、空心或框架。

一次最多建造 4096 个方块，目标点最远 64 格。建造开始前会再次检查目标区域，位置不合法时不会强行建造。

蓝图建造

进入蓝图模式

主手拿着蓝图箱，按 Ctrl + 右键：

• 空蓝图箱 进入 绘制模式。
• 已有蓝图 进入 建造模式。
• 进入后原有提示会显示 蓝图建造：绘制模式 或 蓝图建造：建造模式。
• 建造模式下，如果箱子里没有材料，可以按 Tab 回到绘制模式；记录的新蓝图会覆盖旧蓝图。
• 箱子里有材料时只能留在建造模式，直到清空材料或蓝图。

绘制蓝图

第一次选点前，目标格会跟随准星显示淡黄色轮廓，便于确认当前处于绘制模式。

• 右键两个位置扩选，已确定区域显示为浅蓝色，新增预览显示为浅黄色。
• 左键两个位置缩选，预览显示为浅红色。
• 之后右键扩选可以重新覆盖之前删除的区域；选区按操作顺序生效。
• 可以连续多次添加或删除选区。
• 选点时按住 Shift，可以把点吸附到指向方块的外侧面。
• 按 Ctrl + 左键 记录结构并收取材料（剪切）：模组会重新读取区域，把方块物品、容器内容和流体桶收进蓝图箱，并清除源方块。
• 按 Ctrl + 右键 只记录蓝图（复制）：源方块保持不变，也不会向蓝图箱放入材料。
• 蓝图箱本身会被过滤，避免把另一个蓝图箱错误地收进蓝图。
• 容器里的内容会作为材料需求记录，建造后会放回原来的容器和槽位。
• 两种记录方式都会退出绘制模式。

建造蓝图

• 进入建造模式后会立即显示虚影，即使材料不足也会显示。
• 滚动滚轮可以调整虚影远近。
• 按 V 让虚影绕竖直轴旋转 90°。
• 右键固定虚影，方便走近查看；左键解除固定。
• 固定后按 Ctrl + 右键 检查材料并建造。
• 材料足够时，会从蓝图箱扣除方块、容器内容和流体桶，然后开始建造；材料不足时会提示并退出蓝图模式。
• 虚影透明度略微提高，只绘制玩家可见的方块面；蓝图轮廓线仍然正常显示：材料足够时可以建造，轮廓为绿色；材料不足时为红色。

虚影会在指示器周围半径 8 格的范围内寻找合法位置。箱子、潜影盒、床等方块在预览中会显示真实外观。

自动收集流体

默认开启，可在 Alt + X → 蓝图建造 中关闭。

记录蓝图时，模组会识别可以用桶接取的流体源头，例如水和岩浆。

• 剪切模式（Ctrl + 左键）：检查背包、快捷栏和副手是否有足够的空桶。空桶足够时消耗空桶，把装满的桶作为蓝图材料放进蓝图箱；空桶不足时提示并跳过该流体源头，但其它方块仍然会被记录。
• 复制模式（Ctrl + 右键）：把流体源头记录进蓝图，但不消耗空桶，也不放入装满的桶；建造时需要自行准备对应的桶。

关闭该选项后，流体源头不会参与蓝图。

蓝图箱

蓝图箱是类似箱子的储物方块，用来保存蓝图和建造材料。共有六个等级：

蓝图箱	容量	获取方式
蓝图箱	27（3×9）	箱子 + 8 张纸
铜制蓝图箱	45（5×9）	蓝图箱 + 8 个铜锭
铁制蓝图箱	63（7×9）	铜制蓝图箱 + 8 个铁锭
金制蓝图箱	81（9×9）	铁制蓝图箱 + 8 个金锭
钻石蓝图箱	108（12×9）	金制蓝图箱 + 8 个钻石
下界合金蓝图箱	144（16×9）	锻造台：钻石蓝图箱 + 下界合金锭 + 下界合金升级模板

主手拿着蓝图箱按 Alt + 右键 可以打开界面；右键放在世界里的蓝图箱也可以打开同样的界面。

• 界面一次显示五行，使用右侧滚动条或滚轮查看剩余槽位。
• 没有蓝图时槽位是禁用的；记录蓝图后会显示半透明占位和每格需要的数量。
• 清空蓝图 会把物品放回背包并移除蓝图；一键取出 会取出物品但保留蓝图；一键存入 会把背包中符合条件的物品放进箱子。
• 蓝图箱可以像普通箱子一样配合漏斗和比较器使用；始终是单箱，不能放进另一个蓝图箱。
• 所有蓝图箱在水中都会上浮。铜制及以上防火、防岩浆；钻石及以上防爆炸；下界合金掉落物还能在岩浆中保留，并从虚空回到附近安全位置。
• 铁砧改名会保留内容和蓝图；破坏已放置的蓝图箱也会保留物品、蓝图和容器内容。

设置与多人游戏

按 Alt + X 打开设置界面，左侧有五个页面：

• 物品切换：选择指定行 / 循环模式、指定行号以及循环方向。
• 自动补充：开关“完全一致”，编辑九格白名单。
• 连锁破坏：设置连锁数量、大量方块预设、方向锁定和是否允许其它方块。
• 快速建造：选择、新建或删除预设，设置操作、维度、形状和填充方式。
• 蓝图建造：开关自动收集流体，并查看绘制、建造、缩放、旋转、打开箱子等操作提示；提示中的按键会跟随你的实际按键绑定。

白名单和所有设置都按玩家保存，死亡和重生后仍然保留。

多人游戏中，客户端和服务端都需要安装本模组，每位玩家的设置互相独立。服务器主人也可以通过全局配置单独关闭某个功能。

默认按键

操作	默认按键
打开 Aliya的工具包 设置	Alt + X
快捷栏切换（指定行 / 循环）	X
开关连锁破坏	短按 Z
切换大量方块预设	按住 Z 滚动滚轮
开关快速建造	短按 C
切换快速建造预设	按住 C 滚动滚轮
打开主手蓝图箱	Alt + 右键
蓝图绘制：记录并收取（剪切）	Ctrl + 左键
蓝图建造：进入、记录复制或建造	Ctrl + 右键
蓝图建造：切换绘制/建造模式	Tab（箱子必须没有物品）
蓝图绘制：吸附方块外侧面	按住 Shift
蓝图建造：旋转虚影	V（固定之前）
蓝图建造：固定/解除固定虚影	右键 / 左键
退出连锁破坏 / 快速建造 / 蓝图建造	`
蓝图建造：调整虚影距离	滚轮

所有按键都可以在控制菜单中修改。连锁破坏、快速建造和蓝图建造属于模式类功能，同一时间只能开启一个。

注意事项

• 本版本面向 Minecraft 1.21.1 和 NeoForge 21.1.x。
• 目前只在接近原版的环境中测试：单人游戏。其它模组、大型整合包和专用多人服务器尚未测试。
• 在重要建筑上使用蓝图复制前，请先备份世界，并建议先在测试世界中试用。
• 蓝图会记录方块、箱子等容器及其内容，以及可用桶收集的流体源头。大型建筑可能需要大量材料，也需要足够开阔的建造空间。

许可

本模组使用 MIT License，欢迎放入整合包。

作者说明

本模组由 1% 灵感 + 99% AI 制作，是一个希望让建造和挖矿轻松一点的小工具。如果遇到异常，请尽量在接近原版的最小环境中复现，并在反馈中写清操作步骤。