目录

1. 购买与更新
2. 安装
3. 获取支持
4. 使用 Blender
5. 使用 MACHIN3tools
6. 其他插件

购买与更新

什么是 Prime 和 DeusEx？

MACHIN3tools 有两种基础版本——Prime 和 DeusEx。

Prime 已包含几乎所有功能——按代码行数衡量^{这不是最佳的衡量方式！}Prime 是 DeusEx 版本的 85%。

但 DeusEx 还包含一些 Prime 版本中没有的更高级工具。

它们是：

• Edge Constrained Transform 工具
• Group Gizmos 与 Poses
• Punch It 流形挤出工具，与专用 PUNCHit 插件中的类似
• 高级装配/资源工具，如装配编辑、装配变体、装配原点方向/旋转调整等

在哪里购买 MACHIN3tools？

我所有的插件都在两个市场上销售：

• 在 Superhive 购买 MACHIN3tools^{前身为 Blender Market}
• 在 Gumroad 购买 MACHIN3tools

如何获取更新？

如果你之前购买过 MACHIN3tools，可以前往商店网站，直接下载你有权限获取的最新版本。

• 从 Superhive 下载 MACHIN3tools^{前身为 Blender Market}
• 从 Gumroad 下载 MACHIN3tools

下载完 MACHIN3tools .zip 文件后，如何实际安装的细节请参见更新安装说明。

付费更新如何运作？

如果你已超出 1 年免费更新期，我需要请你购买一个更新变体（update variant），它会再次解锁最新版本的访问权限。

付费更新的运作方式如下：

1. 新售出的 Prime 或 DeusEx 自购买之日起包含 1 年免费功能更新。
   • 如果这一年之内没有发布任何功能更新，则免费更新期会再顺延一年。
2. 从 Superhive^{前身为 Blender Market} 或 Gumroad 下载时，系统总会自动提供正确的版本。
   • 你只需像往常一样从市场上直接下载插件即可。
   • 如果存在比你当前可访问的版本更新的版本——因为你最初购买已超过一年——那么会提供你此前版本的下载链接，同时也会有一条关于新的付费更新的消息及其链接。
3. 要更新到最新版本，请在 Blender Market 或 Gumroad 购买 MACHIN3tools 的 Prime 或 DeusEx 更新变体——具体取决于你在哪里购买了自己的 MACHIN3tools 基础版本。
   • 如果你用的是 Prime，你需要 Prime 更新变体。
   • 如果你用的是 DeusEx，你需要 DeusEx 更新变体。
   • 访问你的下载时，在看到的可更新（Update Available）页面上也会提供所需更新变体的直接链接。

我认为这个更新系统对你我都公平。
我觉得它易用、透明且直接。不过如果你有任何疑问，欢迎随时联系我们。

为什么更新不是免费的？

持续的更新需要持续的工作，也就是在开发和文档上持续投入时间。 MACHIN3tools 在诞生后的头 3 年里完全免费，那是我回馈社区的方式。

2021 年——随着 0.8 版本发布——我引入了可选的 DeusEx 变体，它增加了一些更高级的工具，这些工具本可以轻易做成单一用途的独立插件，事实上 MACHIN3tools 中的许多其他工具也可以如此。
我确实为 DeusEx 收取了一点费用，但保持基础 Standard 变体免费，并持续为其添加功能、推动其演进。

去年 2024 年——随着 1.8 版本发布——我不得不停止免费的 Standard 变体，并推出了 MACHIN3tools 收费的 Prime 变体，试图扭转我当时已经持续了约一年的收入下滑，从而继续能够把大量的开发资源投入 MACHIN3tools。
如今一年过去了，不幸的是收入下滑只会加速，尤其是在过去 6 个月里。
因此我现在别无选择，只能对功能更新收取一点费用。

事实是，MACHIN3tools 就其包含的工具数量而言，一直是极度定价过低的，并且很大程度上依靠我其他插件的成功来补贴，尤其是 DECALmachine 和 MESHmachine，它们的定价要现实得多。

我一直在持续开发这些插件——这就是我做的全部事情，以至于近十年来我把自己在艺术上的抱负都搁置到了一边——我本可以把那些工作成果做成专门的独立小插件发布出去——就像其他创作者那样，但迄今为止我选择的是演进我现有的插件、工具和工作流程，并把这些努力作为免费更新发布。
然而随着收入全面下滑，这已不再是可行的策略。
所以现在一些改变是不可避免的。

为什么你不把新功能发布为独立的插件或新变体，而是更新现有的插件？

这听起来可能像是一种更简洁的做法，但在实践中它产生的问题比解决的问题还多。

这在实践中真正意味着，你要我做到以下几点：

• 让旧版本的插件继续在更新的 Blender 版本上工作
• 但更重要的是，同时维护同一插件——甚至其中的单个工具——的多个并行版本，每个版本都有不同的功能集
• 并且未来还要为所有这些组合进行测试和支持

换句话说，与其维护一个持续演进的产品，不如说是要维护一个不断增长的版本与 Blender 兼容性矩阵。

把功能拆分到独立插件或额外变体中会：

显著增加复杂性——因为每个功能或变体都变成了需要开发、测试、文档化和支持的产品。
削弱工具之间的整合——许多功能是为协同工作而设计的。拆分它们会削弱这种协同效应，让整体体验变得更差。
造成长期维护问题——跨多个 Blender 版本支持多个 MACHIN3tools 版本很快就会变成组合爆炸问题。例如：用户 A 购买了 MACHIN3tools 1.8 版，希望它在最新版 Blender 中工作；而用户 B 购买了 1.12 版，需要它在最新版 Blender 和其旅行笔记本电脑上的旧版本中都能工作。把这个乘上几个 MACHIN3tools 和 Blender 版本，就会迅速变得无法管理。
让用户感到更加混乱——因为最终你得到的不是一套内聚的工具集，而是一堆重叠产品的零散集合，兼容性也说不清。

另外，我不知道为什么，但这一点一直被忽视，或者被装作没看见： 持续开发必须可持续——指望多年前的一次性购买就能支撑起持续的更新、新功能以及对未来 Blender 版本的支持，这根本行不通。

因此，我会尽量把所有东西保持在尽可能少的、持续演进的插件中，这让我能够：

• 维护一致且整合的工作流程
• 减少开销、避免碎片化
• 专注于改进工具集，而不是管理产品的不断膨胀

简而言之，拆分不会降低复杂性，而是会让它成倍增加——无论对我还是对你——并最终增加成本，而非降低。

你承诺过永久免费更新！

不，我从来没有那样承诺过。我从未向任何人承诺过终身免费更新。相反，我对每个问起的人都说，只有在新销售足够多的情况下，我才能继续做下去。
而现在情况已经不再如此了，并且已经有好几个月了。

这对我来说不是业余爱好。这是我做的事，也是我付账单、养家糊口的方式。

Blender 是免费的，插件也必须是免费的！

Blender 对你来说是免费的，因为它靠成千上万的捐赠者和一套成熟的资金结构来维持。这样的资金支持让十几名左右的开发者得以全职工作，还支撑起基础设施和长远规划。

遗憾的是，我不在那个位置上——如果当初我试图靠捐赠来开发插件，这些插件根本就不会存在。

尽管 Blender 基金会常常宣称存在一种经过验证的开源商业模式，但事实是，这种模式只在非常特定的条件下才成立：机构背书和庞大的企业赞助——在 Blender 的情况下占到 60%-70%¹——庞大的用户群体以及持续、大量的捐赠。没有任何独立开发者拥有这种条件。

开源世界里满是废弃的项目。不是因为它们无用或做得不好，而是因为背后的开发者负担不起一直免费干活，最终燃尽了自己。依赖自愿贡献不是商业模式，而是一场赌博。

残酷的现实是：绝大多数人期望软件免费，但几乎没有人愿意为此提供经济回报。即便是受欢迎、被广泛使用的工具，往往也只能收到涓涓细流般的捐赠。这不可持续。

为插件定价，正是让像我这样的艺术家能够投入时间、精力和长期支持，去打造那些有效、持续演进并扩展 Blender 本身及其能力的工具。如果我们想要一个围绕 Blender 的、由功能强大且维护良好的工具组成的繁荣生态，就需要停止把付费插件视为对开源理想的背叛。
它们正是独立开发得以存续的原因。事实上，它们才是让 Blender 保持真正独立的东西。

更新定价

如果你购买 MACHIN3tools 还不到一年，那么最新版本对你是免费的。

我希望尽可能压低更新价格，最初打算定为产品价格的 10%，但 MACHIN3tools 本身定价已经很低，而市场手续费又那么高——包括一笔 $0.49 的固定支付处理费——所以我没法只收 10%，否则我什么也赚不到，那就失去意义了。

因此

• Prime 更新为 $2.00——税后我大约赚 $0.70
• DeusEx 更新为 $4.00——税后我大约赚 $1.70
• 活跃的 Patrons 赞助者中
  • Army 档位有资格获得免费的 MACHIN3tools 功能更新
  • Core 及更高档位有资格获得我所有产品的免费功能更新

这是订阅吗？

不，这完全不是订阅，因为我没有强迫任何人为了使用 MACHIN3tools 而更新。现在不会，将来也不会。 你可以随心所欲地一直使用你已有权限的版本（配合受支持的 Blender 版本）。

尽管如此，我预计会遭遇相当大的阻力，仅仅是因为之前停用 Standard 变体、推出 Prime 时我就已经收到了不少反对声音和差评。
但正如我说的，我别无选择。事情就是这样。^TM
我不能被指望免费干活，否则一年左右我就会倒闭。

话虽如此，如果情况顺利，我愿意把 1 年期延长到 2 年。这里没有什么是板上钉钉的，我会保持灵活，只能走着瞧。

如果情况不顺利，那我就不得不停止做这些拥有几十个工具、几十次更新的大型工作流程插件，转而换挡去做更小的单一用途插件，用我通常花在这些大型功能更新上的时间或更少的时间就能推出，就像这一领域的许多其他创作者多年来所做的那样。

我可以跳过更新吗？

当然可以！

最初的 Prime 购买与一次延后的 Prime 更新变体购买

假设我在 2025 年 5 月发布 MACHIN3tools 1.12，而你之前在 2024 年 1 月购买过 MACHIN3tools，这意味着你能访问的最新版本是 2024 年 11 月的 MACHIN3tools 1.11.1。

你认为 1.12 版本不值得^{而我不这么认为 :)}，所以你只是等着。

再假设 2026 年 2 月 1 日发布了 MACHIN3tools 1.15。这一次你抓住了机会，那么从那时起你将有权访问 MACHIN3tools 1.15，以及可能在 2026 年 2 月 1 日——你的更新购买日期——到 2027 年 1 月 31 日之间发布的所有其他功能更新，也就是一年。

安装

如何安装 MACHIN3tools？

更多细节请参见 安装 指南，务必注意 Blender 版本要求，并确保你的系统控制台以及与之相关的Blender 配置一切正常！

MACHIN3tools 能在 Blender 5.3-alpha/beta 中工作吗？

使用 Blender 的实验性构建版本，你可能会遇到插件突然失效的情况——即使它前一天还好好的。

我无法保证一切会持续正常工作。在实验性构建版本接近正式发布之前，修复其中被弄坏的东西不会是优先事项。

MACHIN3tools 能在 macOS 上工作吗？

能，100% 可以。

macOS 用户应按照官方说明正确安装 Blender。

避免直接从 Downloads 文件夹中运行它！
请注意，拖拽文件和文件夹时需要按住 COMMAND 键。
这样可以确保避开 AppTranslocation²。

此外，你的下载可能实际上并不会得到一个 .zip 文件，而是自动解压。 这可以而且需要在 Safari 设置中更改。

MACHIN3tools 能在 Arch Linux 上工作吗？

能，100% 可以。事实上，我自己只在 Linux 上使用过 Blender。^{顺便说一句，我不用 Arch}

建议 Arch Linux 用户以及基于 Arch 或类似的滚动发行版用户使用官方 Blender 构建版。
Community 仓库中的 Blender 包不附带自己的 Python，也不遵循官方建议。

因此，你的系统 Python 版本可能无法与 Blender 和/或 MACHIN3tools 或任何其他插件正常配合。

为什么有一个红色的按钮让我获取支持？

这是 Get Support 工具，旨在简化并理顺产品支持流程——万一你哪天真需要它的话。

插件偏好设置中的 Get Support 工具

这个按钮是红色的，为的是突出它、确保它被注意到，这样万一你遇到 MACHIN3tools 的问题，就会记得使用它。详情见下文。

3D 视图侧栏中的 Get Support 工具

3D 视图侧栏中的这个按钮也用于验证插件确实安装正确，正如安装视频中解释的那样。

获取支持

常规信息

为了提供帮助，我需要以下内容：

1. system-info.txt 文件——由 Get Support 工具生成。
2. 系统控制台输出——如下面视频所示
3. 购买凭证（Purchase Receipt）——由 Superhive 或 Gumroad 提供

安装失败

如果你的 MACHIN3tools 安装失败了，几乎可以肯定是因为插件/Blender 版本不匹配、其他有故障或版本不匹配的插件、系统 Python 版本不匹配，或一般的 Blender 配置问题，比如 Blender 的插件目录里出现了不该有的文件。
所有这些都可能影响新插件的安装尝试并导致其失败，因为它们常常会引发一连串的错误。
这些都不是新插件的错，但所有这些问题都能从系统控制台输出中清楚地看出来。

如果你遇到这种情况又无法自行解决，那么务必把系统控制台的完整内容发给我，而不仅仅是一张结尾的截图。事实上在这些情况下，开头往往更重要。 这些以及更多细节我都在安装视频中详细讲过。

插件错误/异常

如果你看到 MACHIN3tools 导致的错误/异常，请也把系统控制台输出发给我，最好以文本形式复制，而不只是一张错误弹窗的截图，因为截图可能没有涵盖足够的上下文。

用于复现问题的 .blend 文件

如果错误只在某个特定的 .blend 文件或某个特定的 Blender 环境中出现，而且你能复现它，请把该 blend 文件也随邮件一起附上。
尽量移除模型中对问题无关的任何部分，以减小文件体积。

联系

如需报告你使用插件时遇到的任何问题，请使用 电子邮件（eMail），而不是 X、Youtube、Artstation、Superhive 消息，也不是 Blender Artists 论坛帖。
就用电子邮件。我通常会很快回复，但也请耐心等待。

Blender

什么是系统控制台？

MACHIN3tools 导致 Blender 崩溃！

不，它不会。Blender 内嵌了一个 Python 解释器，插件代码中的任何错误——无论多严重——都会被 Blender 捕获，并在系统控制台中报告为错误消息。插件会失败，Blender 会继续运行。这正是它的设计方式。
如果 Python 真的能弄崩宿主应用程序，那任何理智的软件都不会去内嵌解释器。

如果 Blender 自身冻结或消失，那是 Blender 自己的 C/C++ 代码中的 bug，不是插件的问题。即便在此之前控制台里出现了 Python 错误——插件可能把 Blender 置于了意外状态——但优雅地处理好这一点仍然是 Blender 自身的责任，处理不好也是 Blender 的过错。

简单规则：

• 你在控制台中看到错误消息而 Blender 继续运行 → 那是插件的问题，报告给我
• Blender 冻结或消失 → 那是 Blender 的 bug，最终应提交到 Blender 错误跟踪器

我理解那种本能——你装了插件，出了问题，而我就在这里、很容易联系到，不像 Blender 开发者那样躲在错误跟踪器和审核队列后面。

但理解这种区别很重要，因为它决定了修复该从哪里来。在很多情况下，我能在自己这边找到变通办法。
如果我知道某个特定的 API 调用会在特定条件下导致 Blender 崩溃，我也许能够避开它或用不同的方式处理。但只有当你能配合我复现问题、缩小问题范围时，我才能做到。最重要的是，别因为 Blender 崩溃而怪我。那样往往会让整个交流变得毫无成效。

我只是一个人，制作并维护这些插件，不是工作室，也不是团队。我在意把事情做对，也很乐意深入研究崩溃报告，即使是那些不怪我报告。但我需要你的帮助才能做到。一份带有复现步骤的 bug 报告能起很大作用。因为一次 Blender 崩溃而给差评，对我和你，还有 Blender，都解决不了任何问题。

如何调出 Quad Sphere 弹出菜单？如何事后调整工具属性？

在 Blender 中，大多数工具的结果在调用之后都可以进行调整。
以 Quad Sphere 为例，你可以设置各种属性来改变球体的生成方式。

有 3 种方法可以做到这一点：

1. 面板

屏幕左下角的操作符属性面板

2. 从键位图弹出

重做上一步（Redo Last） 通过 快捷键调出的弹出菜单

默认按键为 F9 或 F6，具体取决于你选择的键位图

如果你喜欢使用这个弹出菜单，可以考虑把它映射到鼠标的某个按键上——我就是这么做的。

3. 从菜单弹出

位于 编辑菜单（Edit Menu） 中的 调整上一步操作（Adjust Last Operation） 条目

为什么 Blender 重启后我的键位图（或设置）更改没有被记住？

首先，请务必确保你做的任何更改确实保存了。

如果这还不能解决你的问题，那么请知道：“不生效”的键位图——有时还有插件偏好设置——是一个众所周知的 Blender 问题，而我根本无法复现它。

过去的报告表明，这跟 MACHIN3tools（或任何特定插件）无关，而是更深层的 Blender 问题。

它往往发生在以下情况：

1. 人们从之前的版本导入 Blender 偏好设置。
2. 人们从之前的版本导入 Blender 键位图。
3. 人们使用应用程序模板（App templates）。

理论上，任何已安装的插件如果实现得不好或者行为异常，也可能影响这一点，并搞乱其他插件的键位图。

例如——这里无意责怪它——相当多的人报告说，禁用 hair tool（然后再重新启用）解决了他们的 MACHIN3tools 键位图问题。

你当然也可以试试禁用 MACHIN3tools 本身再重新启用——但请注意，这会重置你所有的 MACHIN3tools 键位图和偏好设置。

真正有效的方法是从一个全新的 Blender 配置开始。

人们常常在不知情的情况下带着一堆 Blender 配置问题。如何发现这些问题，详见安装视频。 所以如果你这样做，请逐个重新激活你的插件，并留意系统控制台，尤其是在 Blender 重启之后。

MACHIN3tools

Severely Hidden 是什么意思？

我用 severely hidden（深度隐藏） 这个说法来指那些只存在于被排除或隐藏的集合中的物体。
它们之所以被称为 severely hidden，是因为正常切换可见性对它们没有作用，所以它们不仅无法被看到，也无法被选中。

在 HyperCursor^{在 Patreon 上处于预发布状态} 等插件中，mod 物体可以选择性地被移入这样的隐藏集合，以利于场景组织。

在 MACHIN3tools 中，像 Shade Smooth/Flat（平滑/平面着色）、Assembly Asset Creation（装配资产创建）或 Select Hierarchy（层级选择）这样的工具需要能够作用于这些物体，它们通过把物体链接到主场景集合来实现这一点（有时只是临时链接，且对用户不可见）。

其他插件

为什么有独立的 PUNCHit 插件？它和 MACHIN3tools DeusEx 中的 Punch It 工具有什么不同？

专用 PUNCHit 插件中的工具自 PUNCHit 1.1 版本起有所不同。

最初我把相同的流形挤出工具包含在 MACHIN3tools DeusEx 中，以此向现有的 DeusEx 用户表达感谢——他们是在 Standard 变体还免费的时候选择购买 DeusEx 的。
遗憾的是，随着两个插件同时上市，许多人购买了 PUNCHit 插件，之后才发现——尽管产品页面上已经用大字说明过——同样的工具在 MACHIN3tools DeusEx 中也有。
随之而来的是大量退款，这源于 Blender Market 的重复购买政策——这本来甚至都不该适用——却给我、顾客和 Blender Market 的工作人员都带来了负担和烦恼。

所以，从现在起，PUNCHit——这个插件——将是唯一继续接收功能更新的，而 Punch It——MACHIN3tools DeusEx 中的工具——将只接收维护更新。