> For the complete documentation index, see [llms.txt](https://leawinds-organization.gitbook.io/yetanotherconfiglib-jian-ti-zhong-wen-fei-guan-fang/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://leawinds-organization.gitbook.io/yetanotherconfiglib-jian-ti-zhong-wen-fei-guan-fang/gai-shu.md).

# 概述

YetAnotherConfigLib 是什么，什么时候用它，什么时候不该用它。

{% hint style="danger" %}
这不是官方文档！官方文档位于 [https://docs.isxander.dev](https://docs.isxander.dev/yet-another-config-lib/)
{% endhint %}

{% hint style="warning" %}
目前本 wiki 正在编写中，还没有完成！
{% endhint %}

## ❓这是什么？

首先，YACL 是一个配置屏幕生成器，它涵盖了在 Minecraft 中创建用户友好的 GUI，以允许用户轻松配置他们的模组。它还提供了一个单独的配置 API，可以轻松地为您保存和加载字段，几乎不费吹灰之力。

<figure><img src="https://1519116863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWiUFZnUcH6D7I7YlJC1P%2Fuploads%2Fl9gvsY3DOH8WmRSuUy79%2FScreenshot%202023-11-26%20at%2014.19.22.png?alt=media&amp;token=df47d3f7-cdf2-419c-9668-6ad188e5c1bf" alt=""><figcaption><p>介绍 YACL 的最好方法是使用图像。一张图片胜过千言万语！</p></figcaption></figure>

## 它为什么存在？

这个模组是为了填补 FabricMC 模组这一领域的一个漏洞而制作的。现有的配置库无法实现我作为开发人员想要从它们那里得到的东西。

* [**Cloth Config**](https://github.com/shedaniel/cloth-config) **已过时。**&#x5176;开发者已经澄清说，他们可能不会再添加任何功能，他们不想碰它。（[citation](https://user-images.githubusercontent.com/43245524/206530322-3ae46008-5356-468e-9a73-63b859364d4e.png)
* [**Spruce UI**](https://github.com/LambdAurora/SpruceUI) **并非为配置而设计。**&#x4ECE;本质上讲，设计感觉很混乱。
* [**MidnightLib**](https://modrinth.com/mod/midnightlib) **内置了太多不需要的功能。**&#x5C3A;寸可能不大，但玩家（包括YACL原作者）可能不想捆绑这些东西。
* [**OwO Lib**](https://modrinth.com/mod/owo-lib) **包含许多其他功能。**&#x5B83;并不专注于配置，但是如果你正在构建内容模组，则建议你使用它。

正如你所看到的，遗憾的是，它们每个都有缺点。 这就是 YACL 发挥作用的地方！

## YACL 好在哪？

YACL 好在事后诸葛亮。 它可以看到其他人所做的工作，并结合最好的部分，使其成为一个很棒的竞争者。 以下几点可能会让你信服：

* **好用的 API：YACL 从** [Sodium](https://modrinth.com/mod/sodium) 的内部配置库吸收灵感。
* **Minecraft 样式：**&#x59;ACL 被设计成适合原版 Minecraft 的样式。

## ✅ 什么时候应该用它？

YACL 在设计时考虑了客户端模组(不支持在服务器上加载的模组)，因此它们可以快速为用户生成出色的UI，因此推荐这些类型的模块使用 YACL。

此外，在这两个环境中都需要的模组也支持其配置API，因此服务器管理员可以使用文件进行配置，而客户端可以使用GUI进行配置。但是，没有服务器-客户端同步功能可供使用，这可能会限制你的模组的功能。

## ⛔ 什么时候不该用它？

在服务器专用模组上，不建议只依赖于 YACL 的配置 API。这是因为您要求用户下载 YACL，这将频繁更新永远不会被你的模组使用的功能，更不用说浪费存储空间了。
