本帖最后由 XSUIBINGX 于 2021-8-22 22:37 编辑

1.何为此物？

FabricWiki 以及其 Github 的描述如下
A Gradle plugin to setup a deobfuscated development environment for Minecraft mods. Primarily used in the Fabric toolchain.

简单说就是用于 fabric 模组构建的工具链一部分。

上游 fabricloom 并没有加入切换 Minecraft 资源文件下载的功能，所以在国内搭建 fabric 模组开发环境以及构建 fabric 模组是很缓慢的一件事情，第一次资源下载及构建时长甚至可能长达 1小时。 为了解决这个问题，我们 fork 了原先的 fabricloom 并且尝试增加切换 Minecraft 资源文件下载源的功能。

这个项目本质上来说是我们想向上游合并但是一直没有成功的功能，因此我们做了单独的版本供大家使用。为什么做？因为下载速度真的太慢了，也不想用附魔方法。

2.他能干什么？

他可以对原版 fabricloom 的如下下载部分进行切换

  • Minecraft Libraries
  • Minecraft Assets
  • Minecraft Version Manifests
  • Minecraft Experimental Versions
  • Fabric Repository

3.如何使用？


如果您想用的 loom 版本为 0.10，那么恭喜：官方 loom 已经支持！请跳过修改 loom 版本，直接进入配置部分。

首先你需要添加我们的 maven 仓库到 settings.gradle 。fabricloomCN 的开发者的仓库均提供了下载。

  • https://maven.icedlab.tech/loom/
  • https://repository.hanbings.io/proxy/

修改后的 settings.gradle 文件或许长的像是下面这样

  1. pluginManagement {
  2. repositories {

  4. // 存放 fabricloomCN 的主仓库
  5. maven {
  6. name = 'Iced\'s loom maven'
  7. url = 'https://maven.icedlab.tech/loom/'
  8. }

  10. // 存放 fabricloomCN 的代理仓库
  11. maven {
  12. name = 'Hanbing\'s proxy maven'
  13. url = 'https://repository.hanbings.io/proxy/'
  14. }

  16. // fabricloom 原版的仓库
  17. maven {
  18. name = 'Fabric'
  19. url = 'https://maven.fabricmc.net/'
  20. }

  22. // 其余插件所存放的仓库
  23. gradlePluginPortal()
  24. }
  25. }
复制代码

然后在 build.gradle 修改插件名如下。

修改前
  1. plugins {
  2. id 'fabric-loom' version '0.9-SNAPSHOT'
  3. }
复制代码

修改后
  1. plugins {
  2. id 'loomcn' version '0.9-SNAPSHOT'
  3. }
复制代码

最后在 gradle.properties 当中（包括 模组工程 中的以及 用户目录 下的，二选一）根据你的需求填写以下配置

配置内容
举例
Minecraft Libraries
loom_libraries_base = https://maven.icedlab.tech/proxy/
Minecraft Assets
loom_resources_base = https://download.mcbbs.net/assets/
Minecraft Version Manifests
loom_version_manifests = https://bmclapi2.bangbang93.com/mc/game/version_manifest.json
Minecraft Experimental Versions
loom_experimental_versions = https://maven.fabricmc.net/net/minecraft/experimental_versions.json
Fabric Repository
loom_fabric_repository = https://repository.hanbings.io/proxy/

如果您不添加的话，他会使用原先的下载源。

好了，现在 loom 会从您指定的下载源进行下载了。 如果有时间的话您可以搭配出对您来说最快速的组合 。

没有看懂？可以参考 fabric-mod-example-for-cn 这里有完整的例子 。

4.是否有推送到上游的计划？

很高兴的告诉你，是有这个计划的，并且已经尝试让 fabricloom 开发者们接受这个特性。


在2021年8月22日晚，本功能正式进入loom 0.10主线。


5.目前适用的 Minecraft 版本

目前我们已经移植了这个功能到以下 fabricloom 版本：

  • loom 0.7（可用，但是不完整。正在移植）
  • loom 0.9（完整）
  • loom 0.10（进入主线，以后版本均可用）

也就是说已经适用于以下 Minecraft 版本

  • 1.15.x
  • 1.16.x
  • 1.17.x

正在有计划移植到 loom 0.6 与 loom 0.8 。但是综合考虑到似乎使用 loom 0.6 的模组现在正在维护数量较少所以可能不会进行。

其余版本暂时没有移植计划，包括 loom 0.10。

6.关于下载源

目前为 fabricloomCN 贡献代码的两位开发者均提供了自己的 Minecraft 依赖文件 下载源。

  • https://maven.icedlab.tech/proxy /
  • https://repository.hanbings.io/proxy/

但是我们不提供 Minecraft 的资源文件下载。因为这个镜像本质上是为我们自己方便开发而搭建。

如果您有需要的话可以使用我们的依赖文件下载源。在其中包含了 fabric 的开发依赖 。

此外我们更加推荐使用用以下 Minecraft 资源文件 下载源，他们有着不俗的下载速度。

  • https://bmclapi2.bangbang93.com/assets/
  • https://download.mcbbs.net/assets /

7.其他

在使用换源功能之前， 您需要知晓并且同意以下内容 ：

  • 我们 不保证 您所使用的下载源是安全正确的。
  • 如果您因为使用 fabricloomCN 因为使用了含有 危险内容的下载源 而产生了损失， 我们没有责任与义务赔偿你的损失 。


本项目的储存地址在 Github（dev/0.9-cn分支） ， Github（dev/0.9分支）

8.感谢

感谢 fabric 社区的付出让我们有了如此灵活的 API 可以使用。

感谢正在准备高考的 hanbings 和我一起修改 fabricloom 成为 fabricloomCN 并且使之符合 fabric 社区的代码要求。

感谢所有推动本项目向上游合并的朋友。

以及感谢您看到了最后。