# 首次安装

{% hint style="danger" %}
**确保**所有插件和服务器软件都是最新的！\
**始终检查**你下载的ItemsAdder版本！

* <mark style="color:red;">**v3仅适用于1.20.4及以下版本**</mark>
* <mark style="color:red;">**v4仅适用于1.20.6及以上版本**</mark>
  {% endhint %}

## 安装引导

{% @guideflow/guideflow-embed requestedurl="<https://app.guideflow.com/player/qkqgg70u1p>" fullWidth="true" %}

***

## 步骤1 - 安装插件和库

* 关闭服务器
* 将[**ProtocolLib**](https://ci.dmulloy2.net/job/ProtocolLib/lastSuccessfulBuild/) JAR文件放入`plugins`文件夹
* 将[**LoneLibs**](https://www.spigotmc.org/resources/lonelibs.75974/) JAR文件放入`plugins`文件夹
* 将**ItemsAdder** JAR文件放入`plugins`文件夹
* 启动服务器
* 让ItemsAdder完成加载**所有内容**

## 步骤2 - 首次安装资源包

{% hint style="warning" %}
这一步很重要，如果不完成这一步，插件<mark style="color:red;">**将无法工作**</mark>！
{% endhint %}

在使用插件之前，你需要决定资源包的托管方式。\
点击这里选择资源包的托管方式（最佳方式：`自托管`）。

{% content-ref url="cha-jian-shi-yong-fang-fa/resourcepack-hosting" %}
[resourcepack-hosting](https://itemsadder.devs.beer/chinese/cha-jian-shi-yong-fang-fa/resourcepack-hosting)
{% endcontent-ref %}

***

## 步骤3 - （可选）添加官方ItemsAdder自定义内容

![](https://2963347129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-3369173170%2Fuploads%2Fgit-blob-fb056ca03a9797276c6f3b686f55499bac879b3c%2Fitems_showcase_gif.apng?alt=media)

**ItemsAdder**自带大量已创建的自定义内容。\
这些内容不会自动包含在下载的插件中，因为有些人可能不希望每个物品/功能自动添加到他们的服务器中。

### 在[这里下载“默认包”](https://github.com/ItemsAdder/DefaultPack/releases/latest)（可选）

<div align="left"><img src="https://2963347129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-3369173170%2Fuploads%2Fgit-blob-2a5c745eaae043edd4e700af3df66fcec75e42b3%2Fimage%20(47).png?alt=media" alt=""></div>

* 将内容解压到`ItemAdder`文件夹中，如果提示覆盖文件，请选择覆盖
* 运行`/iazip`命令
* 如果你没有使用**自托管**，请按照你的[托管方式](https://itemsadder.devs.beer/chinese/cha-jian-shi-yong-fang-fa/resourcepack-hosting)进行操作

***

## 步骤4 - （可选）添加其他ItemsAdder自定义内容

### 在[这里下载“其他包”](https://github.com/ItemsAdder/OtherPacks/releases/latest)（可选）

<div align="left"><img src="https://2963347129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-3369173170%2Fuploads%2Fgit-blob-4a06d9c5cbe73f61b4ffd72936c0187da7f68b35%2Fimage%20(50).png?alt=media" alt=""></div>

* 将内容解压到`ItemAdder`文件夹中，如果提示覆盖文件，请选择覆盖
* 运行`/iazip`命令
* 如果你没有使用**自托管**，请按照你的[托管方式](https://itemsadder.devs.beer/chinese/cha-jian-shi-yong-fang-fa/resourcepack-hosting)进行操作

## 步骤5 - （可选）移除默认物品

{% content-ref url="faq/latest-itemsadder" %}
[latest-itemsadder](https://itemsadder.devs.beer/chinese/faq/latest-itemsadder)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://itemsadder.devs.beer/chinese/first-install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.