跳到主要内容

EternalTD 设置

当前的 EternalTD 设置流程围绕 Nightbreak 管理的内容、通过 FreeMinecraftModels 提供的可选模型支持以及资源包辅助命令构建。

要求​

  • EternalTD 1.6.0
  • Java 21
  • 运行当前 1.21.4 API 线的 Paper/Spigot 兼容服务器

可选集成：

  • FreeMinecraftModels 用于 EternalTD 的自定义模型
  • ResourcePackManager 如果你希望 EternalTD 将其官方资源包注册到该插件而不是写入 server.properties
  • Floodgate、ModelEngine 和 LibsDisguises 是软依赖，不是当前设置流程的必要条件

EternalTD 创建的内容​

启动时，EternalTD 初始化或使用以下路径：

plugins/EternalTD/config.yml
plugins/EternalTD/content_packages/
plugins/EternalTD/imports/
plugins/EternalTD/levels/
plugins/EternalTD/waves/
plugins/EternalTD/npcs/
plugins/EternalTD/worlds/

旧版说明：

  • 插件现在将 levels/ 和 npcs/ 作为规范文件夹名称。
  • 在启动和重新加载时，它会自动将旧版的 Levels/ 和 NPCs/ 文件夹迁移到小写路径。

推荐的首次设置流程​

  1. 安装 EternalTD 并启动服务器一次。
  2. 使用 /nightbreaklogin <token> 链接你的 Nightbreak 账户。
  3. 运行 /etd downloadall 将所有可访问的 EternalTD 包下载到 plugins/EternalTD/imports。
  4. 运行 /etd install 应用官方 EternalTD 资源包设置。
  5. 随时运行 /etd setup 来浏览、启用、禁用或更新单个包。

/nightbreaklogin <token> 是共享的 Nightbreak/MagmaCore 账户流程的一部分，不是在 EternalTD 的 plugin.yml 中声明的命令。

/etd setup 菜单​

/etd setup 会打开共享的 MagmaCore 设置菜单。除了 EternalTD 内容包（按 Free Content、Premium Packs 和 Resources 筛选）之外，该菜单还提供以下标准的 MagmaCore 控制项：

  • Plugin Update（插件更新）条目，显示已安装的 EternalTD 版本与最新版本的对比，并在有可用更新时下载插件更新，
  • Recommended Plugins（推荐插件）条目，打开配套插件推荐视图（也可通过 /etd recommendedplugins 访问），
  • Automatic Updates（自动更新）切换按钮，用于开启或关闭 nightbreak.autoDownloadPluginUpdates 配置值，
  • Download All（全部下载）条目，运行 /etd downloadall（插件更新加上所有可用内容）。

出生点和大厅行为​

config.yml 当前包含：

  • setupDone —— 跟踪首次设置引导是否已完成的标志（默认 false）。
  • spawnLocations —— 默认为 etd_spawn,0,65,0,0,0。仅在 etd_spawn 世界存在时才会填充/使用。
  • manageSpawn —— 默认为 true。在 EternalTD 大厅世界可用时，将加入的玩家传送到那里。
  • playerGuide —— 游戏内指南书的文本。
  • nightbreak.autoDownloadPluginUpdates —— 默认为 false。共享的 MagmaCore 设置；当为 true 时，插件会在启动时自动下载可用的插件和内容更新（在下次重启后生效）。也可在游戏内通过 /etd setup 菜单的 "Automatic Updates" 按钮切换。

当 manageSpawn: true 且 etd_spawn 世界存在时，加入的玩家会被传送到配置的 EternalTD 出生点位置。

官方大厅包与游戏地图分开跟踪，作为 etd_spawn 世界安装在服务器的世界容器中。

导入后重新加载​

在手动导入或手动文件清理后使用 /etd reload。

EternalTD 重新加载当前执行以下操作：

  • 重新运行导入器
  • 重新加载内容包
  • 重新加载关卡、波次、NPC 和世界模板
  • 刷新包更新/访问状态
  • 重新初始化资源包辅助工具
  • 如果 FreeMinecraftModels 插件存在，请求其重新加载导入的内容