Differences

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

--- ru:tutorial:introduction [2020/08/23 12:22] – created magicsweet
+++ ru:tutorial:introduction [2022/02/11 07:11] (current) – немного заменил слова furnygo
@@ Line 21: / Line 21: @@
 ===== Native Minecraft APIs =====
-If Minecraft already lets you do something, don't re-invent the wheel.
+Если Minecraft уже позволяет вам что-то делать, не изобретайте заново колесо.
-A good example of this is the "Registry" class, which lets you add blocks and items without any modifications to Minecraft's code.
+Хорошим примером этого является класс "Registry", который позволяет добавлять блоки и элементы без каких-либо изменений в код Minecraft.
-Minecraft also uses JSON data files for various data-driven features.
+Minecraft также использует файлы данных JSON для различных функций, управляемых данными.
-You can add JSON files to your mod, which are then injected by the Fabric API.
+Вы можете добавить JSON-файлы в свой мод, которые затем вводятся Fabric API.
-For example, block models and loot tables are implemented through JSON files.
+Например, модели блоков реализуются с помощью JSON-файлов.
 ===== The Fabric API =====
-Fabric itself, as installed into a client, is split up into two parts.
+Сам Fabric, установленный в клиенте, разделен на две части.
-  - The Fabric Loader, which loads your mod and calls your entry point.
+  - Fabric Loader, который загружает ваш мод и вызывает вашу точку входа.
-  - The Fabric API, an optional library that provides some common useful APIs.
+  - Fabric API, опциональная библиотека, которая содержит некоторые общие полезные интерфейсы.
-The API is intentionally kept relatively small, to make porting Fabric to newer Minecraft versions faster.
+API намеренно держится относительно небольшим, чтобы ускорить перенос Fabric на более новые версии Minecraft.
-You can find out what's included in the Fabric API by looking over [[https://github.com/FabricMC/fabric|its source code on GitHub]].
+Вы можете узнать, что входит в состав Fabric API, просмотрев его [[https://github.com/FabricMC/fabric|исходный код на GitHub]].
-The Fabric API contains a lot of common event hooks, and general utilities for things like networking and rendering.
+Fabric API содержит множество общих событий и общих утилит для таких вещей, как создание сетей и рендеринг.
-===== Third Party APIs =====
+===== Сторонние API =====
-Because the Fabric API is intentionally kept small and focused, third party APIs exist to fill in the gaps.
+Поскольку Fabric API намеренно остается небольшим и сфокусированным, сторонние API существуют для заполнения пробелов.
-Mixins allow any third party library to affect Minecraft's code in the same way as the core Fabric API can.
+Mixins позволяют любой сторонней библиотеке влиять на код Minecraft точно так же, как это делает Fabric API.
-You should use these instead of writing your own mixins where possible to minimize the possibility for conflicts.
+Вы должны использовать их вместо того, чтобы писать свои собственные mixins, где это возможно, чтобы свести к минимуму возможность конфликтов.
-You can find an incomplete lists of [[documentation:libraries|third party libraries]] on this wiki.
+Вы можете найти неполные списки [[ru:documentation:libraries|сторонних библиотек]] на этой вики.
 ===== Mixins =====
-Finally, you can use mixins.
+Наконец, вы можете использовать mixins.
-Mixins are a powerful feature that let you change any of Minecraft's own code.
+Mixins - это мощная функция, которая позволяет вам изменять любой код Minecraft.
-Some mixins can cause conflict, but used responsibly these are key to adding unique behavior to your mod.
+Некоторые mixins могут вызвать конфликт, но при правильном использовании они являются ключом к добавлению уникального поведения в ваш мод.
-Mixins come in a variety of flavors, in rough order of preference:
+Mixins бывают самых разных вкусов:
-  * Adding Interfaces
+  * Добавление Интерфейсов
   * Callback Injectors
   * Redirect Injectors
-  * Overwrites, you should never use these
+  * Перезапись
-This is not a complete list, but rather a quick overview.
+Это не полный список, а скорее краткий обзор.
-Some mixin types are omitted here.
+==== Добавление Интерфейсов ====
-==== Adding Interfaces ====
-This is probably one of the safest ways to use mixins.
+Это, вероятно, один из самых безопасных способов использования mixins.
-New interface implementations can be added to any Minecraft class.
+Новые реализации интерфейса могут быть добавлены в любой класс Minecraft.
-You can then access the interface by casting the class to it.
+Затем вы можете получить доступ к интерфейсу, приведя к нему класс.
-This doesn't change anything about the class, it only adds new things, and is therefore very unlikely to conflict.
+Это ничего не меняет в классе, это только добавляет новые вещи, и поэтому очень маловероятно, что они будут конфликтовать.
-One caveat is that the function signature (name + parameter types) you inject must be unique. So if you use common parameter types, be sure to give it a very unique name.
+Одно предостережение заключается в том, что сигнатура функции (имя + типы параметров), которую вы вводите, должна быть уникальной. Поэтому, если вы используете общие типы параметров, обязательно дайте ему уникальное имя.
 ==== Callback Injectors ====
-Callback injectors let you add callback hooks to existing methods, as well as on specific method calls within that method.
+Callback injectors позволяет добавлять хуки обратного вызова к существующим методам, а также к конкретным вызовам методов внутри этого метода.
-They also let you intercept and change the return value of a method, and return early.
+Они также позволяют перехватывать и изменять возвращаемое значение метода, а также возвращать его раньше.
-Callback injects can stack, and are therefore unlikely to cause conflicts between mods.
+Инъекции обратного вызова могут стекаться и поэтому вряд ли вызовут конфликты между модами.
 ==== Redirect Injectors ====
-Redirects let you wrap method calls or variable access within a target method with your own code.
+Redirects позволяют переносить вызовы методов или доступ к переменным в целевой метод с помощью собственного кода.
-Use these very sparingly, a target call or access can only be redirected once between all mods.
+Используйте их очень экономно, целевой вызов или доступ можно перенаправить только один раз между всеми модами.
-If two mods redirect the same value, that will cause a conflict.
+Если два мода перенаправляют одно и то же значение, это вызовет конфликт.
-Consider callback injects first.
-==== Overwrite ====
+==== Перезапись ====
-Avoid overwrites completely.
+Всегда избегайте перезаписи.
-They replace a method entirely, removing all existing code and conflicting with any other types of mixins on the method.
+Они полностью заменяют метод, удаляя весь существующий код и конфликтуя с любыми другими типами mixins в методе.
-They are extremely likely to conflict not just with other mods, but also with changes to Minecraft itself.
+Они с большой вероятностью вступят в конфликт не только с другими модами, но и с изменениями в самом Minecraft.
-You most likely do not need an overwrite to do what you want to do, please use something else.
+Скорее всего, вам не нужна перезапись, чтобы сделать то, что вы хотите сделать, пожалуйста, используйте что-то другое.