Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

使用资产库

在网站上

概览

如前所述，你可以在 Godot 的官方网站上访问资产库的 Web 前端。这是你第一次访问它时的样子：

image0

在顶部, 你看到 header , 它导航到AssetLib的各个其他部分, 目前, 它是空的, 因为我们没有登录.

搜索

在中心是 搜索栏+设置 部分, 以及它下面的 资源 部分 - 这使您可以根据一系列标准过滤掉某些类型的资源. 这些包括资源的 类别 (例如2D工具, 脚本和演示), 引擎版本 , 排序 (按更新日期, 按名称等)和 支持级别 .

虽然大多数其他过滤器设置是不言自明的，但值得讨论是资产库中“支持级别”的含义。目前有三个支持级别，每个资产只能属于一个。

官方 资源由官方Godot Engine开发人员创建和维护. 目前, 这些资源包括官方引擎演示, 它们展示了引擎工作的各个方面.

社区 资源由Godot社区成员提交和维护.

测试 资源是正在开发中的资源, 可能包含错误和可用性问题. 建议不要将它们用于正式的项目中, 但建议您下载并测试它们从而向原作者报告问题.

您可以混合和匹配任何搜索过滤器和条件，并在单击“搜索”按钮后，接收库中与其匹配的所有资源的列表。

image1

请注意, 搜索结果不会实时更新, 因此每次更改查询设置时都必须重新提交搜索查询.

资源的细分

现在让我们来看看资源的页面是什么样的以及它包含的内容.

image2

  1. 资源的缩略图/图标.

  2. 资源的名称.

  3. 资源的当前版本号.

  4. 资源类别,Godot版本和支持状态.

  5. 资源的原作者/提交者.

  6. 资源分配的许可证.

  7. 资源的最新编辑/更新日期.

  8. 资源的文字描述.

  9. 与资源相关的链接(下载链接, 文件列表, 问题跟踪器).

  10. 展示资源的图片和视频.

注册并登录

要将资源上传到AssetLib, 您需要登录, 为此, 您需要一个注册用户帐户. 将来, 这还可以让您访问其他功能, 例如对现有资源评论或评级. 您 不 需要登录就可以浏览和下载资源.

可以从AssetLib标题部分访问登录/注册页面.

image3

在这里, 您可以注册您的帐户, 该帐户需要有效的电子邮件地址, 用户名和密码(最好是强密码).

image4

然后, 您可以使用您的用户名和密码登录.

image5

这将改变AssetLib标题的外观. 现在你可以访问一些新的功能:

  • Feed, 显示已提交资源的状态更新列表(将来可能更多).

  • 您上传的资源列表.

  • 提交新资源的能力.

image6

你可以在本教程的下一部分 提交资源到资产库 中学习如何向库中提交资产，以及资产提交规范是什么。

在编辑器中

备注

The editor will display different categories of assets depending on whether you're browsing the Project Manager's Asset Library Projects tab or the editor's AssetLib tab.

The Project Manager's Asset Library Projects tab will only display assets that are standalone projects by themselves. This is denoted on the asset library with the Templates, Demos and Projects categories.

编辑器的 AssetLib 选项卡将只显示本身 不是 独立项目的资产。换句话说，它将显示除 Template、Demos 和 Projects 以外的所有类别的资产。

你也可以直接从Godot访问AssetLib:

image7

image14

单击它,Godot将从AssetLib获取有关资源的信息. 一旦完成, 您将看到一个类似于AssetLib网站的窗口, 但有一些不同之处:

image8

与AssetLib的网页版本类似, 您可以在此处按类别, 名称搜索资源, 并按名称或编辑日期等因素对其进行排序.

显然，你只能获取与你所运行的 Godot 版本一致的资产。项目、演示、模板可以从项目管理器的 AssetLib 里下载。扩展（工具、脚本、材质等）可以从项目的 AssetLib 里下载并添加到当前项目。此外，与网页前端不同，这些搜索结果是实时更新的（每次修改搜索内容后无需点击搜索按钮）。

将来，您将能够选择一个不同的 AssetLib 提供程序来获取资源（使用站点下拉菜单），但是目前只支持官方的 Godot 网站 版本的 AssetLib，和可能在本地 Web 服务器上运行的资产库（即 localhost 选项）。

单击资源时, 您将看到有关它的更多信息.

image9

如果单击Install按钮,Godot引擎将下载资源的压缩包, 并将在编辑器窗口的底部显示它的下载进度. 如果下载失败, 您可以使用Retry按钮重试.

image10

完成后, 您可以使用Install按钮继续安装它. 这将打开Package Installer窗口.

image11

在这里, 您可以看到将要安装的所有文件的列表. 您可以勾选您不想安装的任何文件,Godot引擎也会告知您无法安装的文件的任何问题. 这些文件将以红色显示, 将鼠标悬停在它们上方会显示一条消息, 说明无法安装的原因.

image12

完成后, 您可以按Install按钮, 该按钮将解压缩存档中的所有文件, 并导入其中包含的所有资源, 例如图像或3D模型. 完成此操作后, 您应该会看到一条消息, 指出Package安装已完成.

image13

您还可以使用Import按钮导入在其他位置获取的资源压缩包(例如直接从AssetLib 网页前端下载的), 这将引导您完成与我们刚刚通过Godot引擎实现的程序包安装过程.