AutoModpack 使用教程

1. 模组简介与原理

AutoModpack 是一个 Minecraft 模组，用于服务端自动分发模组包给客户端。其原理是服务端将模组包上传到服务器，客户端连接服务器时自动下载或更新模组包。这种方式可以方便地管理和分发模组包，减少手动下载和更新的麻烦。

2. 环境要求

在使用 AutoModpack 之前，需要确保以下环境要求：

  • Minecraft 版本：1.20.1
  • Forge 版本：对应 1.20.1 的 Forge 版本
  • Java 版本：17

    • 3. 服务端安装与配置步骤

    3.1 下载 AutoModpack 模组

    首先，需要下载 AutoModpack 模组。可以从官方网站或模组平台下载最新版本的 AutoModpack。

    3.2 放入 mods 目录

    下载完成后，将 AutoModpack 模组放入服务端的 mods 目录中。

    3.3 启动服务端

    启动服务端，确保 AutoModpack 模组正常加载。

    3.4 配置模组包

    将要分发的模组放进服务端的 modpack 目录中。这个目录可以通过配置文件指定。

    3.5 上传/生成模组包

    可以使用 /automodpack 命令来上传或生成模组包。例如，使用 /automodpack upload 命令来上传模组包。

    3.6 配置文件说明

    AutoModpack 的配置文件通常位于 config 目录中，名为 automodpack.json（部分旧版本为 automodpack.cfg）。这个文件包含了模组包的路径、上传设置等配置项。可以通过编辑这个文件来配置 AutoModpack。

    4. 客户端安装

    4.1 安装 AutoModpack

    客户端需要安装 AutoModpack 模组。将 AutoModpack 模组放入客户端的 mods 目录中。

    4.2 首次进服自动下载模组包

    当客户端首次连接到服务端时，会自动下载模组包。

    4.3 自动更新的过程

    当服务端更新模组包时，客户端会自动检测并更新模组包。这个过程通常发生在客户端连接到服务端时。

    5. 常用命令与权限

    AutoModpack 模组提供了多个子命令来管理模组包的上传、重载、启用、禁用等操作。以下是这些子命令的作用和用法：

  • /automodpack upload <文件名>：上传模组包到服务端。文件名应为模组包文件（.zip 文件）的名称。
  • /automodpack reload：重载模组包配置。用于更新模组包列表或配置文件后使其生效。
  • /automodpack enable <模组名>：启用指定模组。模组名应为模组的ID（通常在模组的 mods.toml 文件中定义）。
  • /automodpack disable <模组名>：禁用指定模组。
  • /automodpack host：开启服务端直传（host）模式。客户端将直接从服务端下载模组包。

    • 权限节点：

  • automodpack.command.upload：允许使用 /automodpack upload 命令。
  • automodpack.command.reload：允许使用 /automodpack reload 命令。
  • automodpack.command.enable：允许使用 /automodpack enable 命令。
  • automodpack.command.disable：允许使用 /automodpack disable 命令。
  • automodpack.command.host：允许使用 /automodpack host 命令。

    • 6. 分发模式说明

    AutoModpack 支持两种分发模式：服务端直传（host）模式和外部文件服务器（URL）模式。

  • 服务端直传（host）模式：客户端直接从服务端下载模组包。这种模式简单易用，但可能会增加服务端的负载。
  • 外部文件服务器（URL）模式：客户端从外部文件服务器下载模组包。这种模式可以减轻服务端的负载，但需要额外配置文件服务器。

    • 配置文件服务器：

  • 在服务端的 config/automodpack.json 文件中，设置 url 项为文件服务器的URL。
  • 确保文件服务器支持HTTP或HTTPS协议。

    • 7. 常见问题排查

    以下是一些常见问题的排查方法：

  • 客户端下载失败：
  • 检查服务端是否正确配置了模组包。
  • 检查客户端是否有足够的磁盘空间。
  • 检查网络连接是否稳定。
  • 更新不生效：
  • 检查模组包是否正确更新。
  • 检查服务端是否正确配置了模组包。
  • 重载模组包配置（使用 /automodpack reload 命令）。
  • 模组冲突：
  • 检查模组包是否包含冲突的模组。
  • 禁用冲突的模组（使用 /automodpack disable 命令）。
  • 进服被踢：
  • 检查客户端是否正确安装了 AutoModpack 模组。
  • 检查客户端是否有足够的权限（检查权限节点）。

    • 8. 注意事项

    以下是一些需要注意的事项：

  • mods 目录同步规则：服务端的 mods 目录将与客户端的 mods 目录同步。确保服务端的 mods 目录正确配置。
  • config 同步：服务端的 config 目录将与客户端的 config 目录同步。确保服务端的 config 目录正确配置。
  • 客户端必须装 AutoModpack 才能进服：客户端必须安装 AutoModpack 模组才能连接到服务端。确保客户端正确安装了 AutoModpack 模组。
    • 本文档由 Cloudflare Workers AI 免费额度模型（@cf/meta/llama-3.3-70b-instruct-fp8-fast）生成，ぴよまる整理排版。
    命令、权限节点、配置文件等细节可能随版本变化，以 AutoModpack 官方发布页（CurseForge / Modrinth）为准。
    🏠 返回总站