Differences

This shows you the differences between two versions of the page.

--- zh_cn:tutorial:introduction [2019/12/18 06:20] – created lightcolour
+++ zh_cn:tutorial:introduction [2025/11/11 21:53] (current) – sinoaakira
@@ Line 1: / Line 1: @@
-====== Fabric 改装入门 ======
+====== Fabric Mod 开发入门 ======
-这是对制作Fabric模组时可以使用的一些常用技术的快速介绍。
+本文简要介绍一些制作 Fabric Mod 时常用的技巧。
-要为Minecraft制作mod，通常必须以非标准的方式与Minecraft的代码进行交互。
+要制作 Minecraft Mod，您通常需要以非标准的方式与 Minecraft 的代码进行交互。
-尽管Minecraft变得越来越灵活，可以适应变化，但它并不是天生就可以进行修改的。
+虽然 Minecraft 对修改的兼容性越来越强，但它本身并非为 Mod 设计。
-与其他改装API不同，Fabric Loader不会覆盖Minecraft的类文件以添加更多功能。
+与其他 Mod Loader 不同，Fabric Loader 不会覆盖 Minecraft 的类文件来添加更多功能。
-而是使用[[https://github.com/SpongePowered/Mixin/wiki|The Mixin库]]注入代码。
+相反，它使用 Mixin 库注入代码。
-但是，大多数时候您不会直接使用此库。
+不过，大多数情况下您并不会直接使用这个库。
-Mixins可能很脆弱，有时会引起冲突。
+Mixin 可能实现的很糟，不同的 Mixin 有时还会导致冲突。
-因此，Fabric API已经为您实现了一些常用功能。
+因此，Fabric API 已经为您实现了一些常用功能。
-如果核心Fabric API中不存在它，那么通常它将存在于第三方库中。
+如果 Fabric API 中没有您需要的功能，通常可以在第三方库中找到。
-在几乎每种情况下，与自己实现mixin相比，最好使用Fabric API或第三方库。
+几乎在所有情况下，使用 Fabric API 或第三方库都比自己实现 Mixin 更可取。
-但是有时候，您不需要任何这些。
+不过有时候，您根本不需要这些。
-尽管Minecraft并非专为改装而设计，但它仍然包含许多功能，您无需进行任何其他更改即可访问它们。
+虽然 Minecraft 并非为 Mod 设计，但它仍然包含许多无需任何额外修改即可使用的功能。
-本文将按优先顺序介绍影响Minecraft的所有方法。
+本文将按优先顺序介绍所有可以影响 Minecraft 的方法。
-===== Native Minecraft APIs =====
+===== 原生 Minecraft API =====
-如果Minecraft已经允许您执行某些操作，请不要重新发明轮子。
-一个很好的例子是“ Registry”类，它使您无需修改Minecraft的代码即可添加块和项目。
-Minecraft还将JSON数据文件用于各种数据驱动功能。
+如果 Minecraft 已经允许你做某件事，就不要重复造轮子。
-您可以将JSON文件添加到您的mod中，然后由Fabric API注入这些文件。
+一个很好的例子是 "<yarn class_2378>" 类，它允许你在不修改 Minecraft 代码的情况下添加方块和物品。
-例如，块模型和战利品表是通过JSON文件实现的。
-===== The Fabric API =====
-安装在客户端中的Fabric本身分为两个部分。
-   -Fabric Loader，用于加载您的mod并调用您的入口点。
+Minecraft 也使用 JSON 数据文件来实现各种数据驱动功能。
-   -Fabric API，这是一个可选的库，提供一些常用的API。
+您可以将 JSON 文件添加到您的模组中，这些文件随后会通过 Fabric API 注入。
+例如，方块模型和战利品表都是通过 JSON 文件实现的。
-故意将API保持相对较小，以使Fabric可以更快地移植到新的Minecraft版本。
-您可以通过查看[[https：//github.com/FabricMC/fabric |其GitHub上的源代码]]来了解Fabric API中包含的内容。
+===== Fabric API =====
-Fabric API包含许多常见的事件挂钩，以及用于联网和渲染之类的通用实用程序。
+安装到客户端后的 Fabric 本体分为两部分：
-===== Third Party APIs =====
+  - Fabric Loader，用于加载您的 Mod 并调用 Mod 入口点。
+  - Fabric API，一个可选库，提供一些常用的实用 API。
-由于Fabric API故意保持较小且集中，因此存在第三方API来填补空白。
+为了更快地将 Fabric 移植到较新的 Minecraft 版本，Fabric API 的设计有意保持相对精简。
-Mixins允许任何第三方库以与核心Fabric API相同的方式影响Minecraft的代码。
-您应尽可能使用这些而不是编写自己的mixin，以最大程度地减少发生冲突的可能性。
-您可以在此Wiki上找到[[documentation:libraries |第三方库]]的不完整列表。
+您可以通过查看 GitHub 上的 [[https://github.com/FabricMC/fabric|Fabric 源代码]] 来了解 Fabric API 包含哪些内容。
-===== Mixins =====
+Fabric API 包含许多常用的事件钩子和通用工具，例如用于网络通信和渲染的工具。
-Finally, you can use mixins.
-Mixins are a powerful feature that let you change any of Minecraft's own code.
-Some mixins can cause conflict, but used responsibly these are key to adding unique behavior to your mod.
-Mixins come in a variety of flavors, in rough order of preference:
+===== 第三方 API =====
-  * Adding Interfaces
+由于 Fabric API 的设计初衷是保持精简和专注，因此需要第三方 API 来弥补其功能上的不足。
-  * Callback Injectors
+Mixin 允许任何第三方库以与 Fabric API 相同的方式影响 Minecraft 的代码。
-  * Redirect Injectors
+为了最大程度地减少冲突的可能性，您应该尽可能使用 Fabric API 和第三方 API，而不是编写自己的 Mixin。
-  * Overwrites, you should never use these
-This is not a complete list, but rather a quick overview.
+您可以在 Fabric Wiki 上找到一个 [[zh_cn:community:library_mods|第三方库]] 的不完整列表。
-Some mixin types are omitted here.
+===== Mixin =====
-==== Adding Interfaces ====
-这可能是使用mixin的最安全方法之一。
+最后，你可以使用 Mixin 库。
-新的接口实现可以添加到任何Minecraft类中。
+Mixin 是一项强大的功能，允许你修改 Minecraft 的任何代码。
-然后，可以通过将类强制转换为接口来访问该接口。
+某些 Mixin 可能会导致冲突，但如果使用得当，它们是为你的 Mod 添加独特行为的关键。
-这不会改变类的任何内容，只会增加新的内容，因此极不可能发生冲突。
-需要注意的是，您插入的函数签名（名称+参数类型）必须是唯一的。 因此，如果您使用常见的参数类型，请确保为其指定一个非常独特的名称。
+Mixin 有多种类型，大致按优先级排序如下：
-==== Callback Injectors ====
+  * 添加接口
-回调注入器使您可以向现有方法以及该方法中的特定方法调用添加回调挂钩。
+  * 回调注入
-它们还使您可以拦截和更改方法的返回值，并尽早返回。
+  * 重定向注入
-回调注入可能会堆叠，因此不太可能引起mod之间的冲突。
+  * 覆盖
+这并非完整列表，而是一个简要概述。
+此处省略了一些 Mixin 类型。
+==== 添加接口 ====
-==== Redirect Injectors ====
+这可能是最安全的 Mixin。
+您可以向任何 Minecraft 类添加新的接口实现。
+然后，您可以通过将类强制转换为该接口来访问它。
+这不会改变类的任何属性，只会添加新的功能，因此几乎不可能发生冲突。
-通过重定向，您可以使用自己的代码在目标方法内包装方法调用或变量访问。
+需要注意的是，您注入的函数签名 (函数名 + 参数类型) 必须是唯一的。因此，如果您使用常见的参数类型，请务必给它起一个非常独特的名字。
-非常谨慎地使用这些功能，目标调用或访问只能在所有mod之间重定向一次。
-如果两个mod重定向相同的值，将导致冲突。
-首先考虑回调注入。
-==== Overwrite ====
+==== 回调注入 ====
-避免完全覆盖。
-它们完全替换了一个方法，删除了所有现有代码，并与该方法上的任何其他类型的mixin发生冲突。
+Mixin 允许您为现有方法以及该方法内部的特定方法调用添加回调钩子。
-它们极有可能不仅与其他mod冲突，而且与Minecraft本身的更改冲突。
+它还允许您拦截并更改方法的返回值，并提前返回。
-您极有可能不需要覆盖来完成您想做的事情，请使用其他方法。
+回调注入可以叠加，因此不太可能导致 Mod 之间的冲突。
+==== 重定向注入 ====
+Mixin 允许你用自定义代码重定向目标方法中的方法调用或变量访问。
+请谨慎使用重定向，所有模块中，同一个目标调用或变量访问只能重定向一次。
+如果两个模块重定向了相同的值，就会导致冲突。
+请优先考虑回调注入。
+==== 重写方法 ====
+重写方法时务必格外小心。
+使用 Mixin 重写方法本质上是完全替换方法，移除所有现有代码，并可能与该方法上的其他 Mixin 冲突。
+重写方法极有可能不仅与其他模组冲突，还会与 Minecraft 本身冲突。
+您很可能不需要重写方法来实现您想要的功能。