Yarn 使用与启动教程

Yarn 使用与启动教程

yarn Libre Minecraft mappings, free to use for everyone. No exceptions. 项目地址: https://gitcode.com/gh_mirrors/yarn8/yarn

1. 项目介绍

Yarn 是一套开放、无限制的 Minecraft 映射，所有人都可以在创意共享零许可证（Creative Commons Zero license）下免费使用。该项目的目的是让每个人都能自由开放地修改 Minecraft，同时还能根据需要创新和处理这些映射。

2. 项目快速启动

要使用 Yarn 进行 Minecraft 的修改或作为 Java 项目中的依赖，您可以使用 loom Gradle 插件。以下是快速启动的步骤：

首先，确保您安装了 JDK 17 或更高版本。

然后，在项目根目录下运行以下命令以启动 Enigma 编辑界面：

• 对于 Linux 和 macOS 用户：./gradlew yarn
• 对于 Windows 用户：gradlew yarn

这将自动下载并启动最新版本的 Enigma，并配置为使用合并的 JAR 文件和映射。

如果要生成一个包含 Yarn 映射和自动映射字段（例如枚举等）的反混淆 JAR 文件，可以运行以下命令：

./gradlew mapNamedJar

这将生成一个名为 <minecraft version>-named.jar 的 JAR 文件，可用于反混淆代码。

3. 应用案例和最佳实践

• 案例一：在自定义的 Minecraft 模组中，使用 Yarn 映射简化开发流程。
• 案例二：作为 Java 项目的一部分，集成 Yarn 来进行反混淆处理，便于阅读和调试。

最佳实践：

• 在提交映射之前，请遵循命名约定。
• 使用 pull requests 提交您的更改，并与社区讨论您的命名更改。
• 不要复制和粘贴来自其他项目的映射，除非它们也是使用 CC0 许可证的。

4. 典型生态项目

以下是一些使用 Yarn 的典型生态项目：

• Fabric：一个用于 Minecraft 模块开发的框架，它与 Yarn 映射无缝集成。
• Loom：一个 Gradle 插件，用于简化在 Minecraft 项目中使用 Yarn 的过程。

通过这些项目和插件，开发者可以更高效地进行 Minecraft 的修改和开发工作。

yarn Libre Minecraft mappings, free to use for everyone. No exceptions. 项目地址: https://gitcode.com/gh_mirrors/yarn8/yarn