Yarn：开源Minecraft映射，助力自由模组开发

项目介绍

Yarn是一款开源的Minecraft映射工具，致力于为所有用户提供无障碍、不受限制的Minecraft模组开发体验。它遵循Creative Commons Zero协议，使得任何人都可以自由地使用这些映射，无需担心版权问题。Yarn的目的是让Minecraft模组开发者能够自由地、开放地修改Minecraft，同时还能创新和调整映射，以适应他们的需求。

项目技术分析

Yarn采用Gradle作为构建工具，提供了一系列实用的任务，帮助开发者更好地处理映射。以下是Yarn中一些核心的Gradle任务：

• yarn：自动设置并下载最新版本的Enigma，这是一个用户界面，可以轻松编辑映射。此任务会自动映射枚举和部分常量字段名。
• yarnUnpicked：与yarn类似，但会取消选择常量并在Enigma中启动它们，这可能会稍微慢一些。
• yarnCommon：与yarn类似，但仅显示公共类。
• build：构建一个包含官方（混淆）、中介和Yarn名称（"命名"）之间的小型映射的GZip压缩档案。
• mapNamedJar：构建一个带有Yarn映射和自动映射字段（枚举等）的去混淆JAR包。
• decompileCFR：反编译映射后的源代码。注意：这并不是为了重新编译设计的。
• download：下载当前Minecraft版本的客户端和服务器JAR包到.gradle/minecraft目录。
• mergeJars：将客户端和服务器JAR包合并成一个合并JAR包，位于映射目录中的VERSION-merged.jar，其中VERSION是当前的Minecraft版本。

使用Yarn构建脚本需要Java 17或更高版本！

项目及应用场景

Yarn的主要应用场景是Minecraft模组开发。它允许开发者更容易地理解和修改Minecraft的核心代码，从而创建出独特的模组，为游戏增加新的内容或改进现有功能。以下是Yarn的一些常见应用场景：

• 模组开发：开发者可以使用Yarn提供的映射来创建新的Minecraft模组。
• 依赖管理：在Java项目中，Yarn可以作为依赖项，帮助管理Minecraft的版本和映射。
• 代码反编译：通过生成去混淆的JAR包，开发者可以更容易地理解Minecraft的内部工作原理。

项目特点

1. 开放性：Yarn遵循Creative Commons Zero协议，允许任何人自由使用、修改和分发。
2. 易用性：通过Gradle任务和Enigma用户界面，Yarn使得映射的创建和管理变得简单直观。
3. 兼容性：Yarn与主流的Minecraft模组开发工具兼容，如Fabric。
4. 灵活性：开发者可以根据自己的需求，调整和优化映射，以适应特定的模组开发要求。

总结而言，Yarn是一个强大的工具，不仅为Minecraft模组开发者提供了极大的便利，而且推动了开源社区中自由创新的氛围。通过其开放性和灵活性，Yarn成为了Minecraft模组开发领域的首选工具之一。如果你是一名Minecraft模组开发者，那么Yarn绝对值得一试！