初始套件

关于本模组

Starter Kit 是一款允许首次加入世界的玩家获得配置文件中所设定物品的模组。你可以将物品设置到物品栏中的任何特定槽位、副手槽以及盔甲槽。模组能够检测哪些玩家从未加入过服务器。如果其他模组添加了物品（例如指南书），你可以选择完全移除它们，或者在套装发放后将这些物品添加回来。这可以通过 addExistingItemsAfterKitSet 配置选项进行设置。

该模组可用于服务器中，为所有新玩家提供初始物品，也可用于单人游戏，以你选择的默认物品栏开局。模组还提供了对 FTB 的 Team Island 模组的可选支持，可在创建岛屿命令后生效。

该模组可以仅在服务端使用。如果你希望玩家能够使用“选择套装 GUI”功能，则还需要在客户端安装此模组。或者，玩家也可以通过服务器命令来选择套装。

功能特性：

• 本页面下方有使用指南，难度分为简单、进阶和高级三个等级。
• 为首次加入世界的玩家提供自定义初始物品和/或药水效果。
• 支持多个套装，可以随机给予或由玩家自行选择。
• 具备自定义跟踪功能，用以识别新玩家，且与现有世界兼容。
• 大量命令！用于创建、添加、管理和选择初始套装。
• 如果客户端安装了模组，玩家可以通过自定义 GUI 界面选择套装；否则，可以使用命令进行选择。
• 为你的套装添加描述。适合 RPG 整合包？
• 移除其他模组添加的初始物品（如指南书），或在初始套装发放后再添加它们。

依赖

需要 Collective

包含在 The Vanilla Experience 整合包中 包含在 Serilum 自定义整合包中

环境：服务端

可配置

配置指南

所有可用的配置选项：

显示剧透

randomizeMultipleKitsToggle   默认值 true 当通过 /starterkit add 命令添加多个初始套装时，有两种分发方式。启用此选项后，将随机选择一个。禁用时，玩家在首次加入时可自行选择一个。

addExistingItemsAfterKitSet   默认值 true 是否应在设置套装后，将物品栏中已存在的物品（例如其他模组添加的书）重新添加回物品栏。如果禁用，这些物品将被移除。你仍然可以通过套装手动设置它们。

usePotionEffectsInStarterKit   默认值 true 是否启用药水/生物效果功能。这意味着在通过 /sk (add/set) 创建套装时，也会保存玩家当前拥有的效果。并且在发放初始套装时，会将效果添加到新玩家身上。

formatKitNames   默认值 true 是否格式化套装名称，每个单词的首字母将大写。

chooseKitScreenHeader   默认值 "%s，你可以选择一个初始套装！" 显示在套装选择界面上方的文本，若模组未安装则显示在聊天栏中。%s 将被替换为玩家名字。

announcePlayerKitChoiceInDedicatedServer   默认值 true 每当新玩家做出套装选择时，是否向服务器广播公告。'randomizeMultipleKitsToggle' 必须禁用，且至少要有 2 个可用的初始套装。

enableFTBIslandCreateCompatibility   默认值 true 是否应在 FTB Team Islands 的 '/ftbteamislands create' 命令后重新设置初始套装。如果未安装该模组，则此选项无效。

命令

'/starterkit' 和 '/sk' 均可使用。

管理员命令：

/sk add (套件名) - 将你当前的物品栏添加到激活的套件中。 /sk set (套件名) - 将你当前的物品栏设置为唯一激活的套件。

/sk give <玩家> (套件名) - 给予玩家一个随机（或特定）的初始套件。

/sk activate <套件名>/_all - 将指定套件或所有套件从非激活状态移至激活状态。 /sk deactivate <套件名>/_all - 将指定套件或所有套件从激活状态移至非激活状态。

/sk list (inactive) - 列出所有激活（或非激活）的套件。 /sk reset - 重置所有追踪记录，玩家在下次加入时将再次获得套件。 /sk reload - 从配置文件夹重新加载初始套件的更改。

用户命令：

/sk choose <套件名> - 允许玩家通过命令选择初始套件。仅当客户端未安装 Starter Kit 且服务器启用了套件选择时才需要此命令。 /sk info <套件名> - 显示指定套件的描述和物品。 /sk help - 在游戏中显示 Starter Kit 的命令帮助。

描述

使用指南：

该模组可以通过多种方式进行配置。为了更清晰地了解，我将难度分为三个不同部分：简单、进阶和高级。

简单：

设置一个自定义的初始套件。添加/移除其他模组提供的初始物品。并通过命令给予玩家一个初始套件。

进阶：

添加一个额外的初始套件。通过命令停用套件。添加一个带药水效果的初始套件并设置其等级和持续时间。

高级：

让玩家在首次加入时选择套件。将非激活的默认套件移至激活状态。显示套件选择 GUI 界面。创建一个带有自定义描述的初始套件。

第一部分：简单

这是模组在未进行任何配置时安装后，将给予新玩家的默认初始套件：

![]

你可以使用 '/starterkit set (套件名)'（或 '/sk set (套件名)'）命令来设置你自己的初始套件。套件名是可选的。 使用此命令后，所有其他激活的初始套件将被移至非激活文件夹。

![]

这里你可以看到通过上一个命令创建的新的初始套件数据文件。它位于 './config/starterkit/kits/' 中：

![]

就是这样！所有新玩家在首次加入世界时都将收到名为“Upgraded”的套件：

![]

在位于 './config/starterkit.json5' 的配置文件中，你可以选择是移除其他模组添加的初始物品，还是在套件发放后将其给予玩家。 这些模组初始物品的示例包括指南书。

![]

要手动给予其他玩家（或自己）初始套件，你可以使用 '/starterkit give <玩家> (套件名)' 命令。 套件名参数是可选的，如果省略： 如果模组按进阶方式配置，可能会随机给予一个套件。 如果模组按高级方式配置，可能会显示套件选择界面。

![]

第二部分：进阶

你可以通过 '/starterkit add (套件名)' 命令添加另一个激活的套件。 使用默认配置，新玩家现在将随机收到“Default”或“No Bread”初始套件。

![]

要查看所有激活的初始套件，请使用 '/starterkit list' 命令。要查看非激活的初始套件，请使用 '/starterkit list inactive'：

![]

要禁用某个激活的套件，请使用 '/starterkit deactivate <套件名>'。这会将其移动到 './config/starterkit/kits/inactive/' 文件夹中。

![]

该模组还可以在给予初始套件的同时提供药水效果！请确保配置中已启用 'usePotionEffectsInStarterKit'。 然后，只需确保药水效果处于激活状态，并使用 '/starterkit set' 或 '/starterkit add' 命令。 效果持续时间将设置为玩家当前剩余的确切时间，但我们将在后续步骤中对其进行四舍五入。

![]

在这个例子中，我给了玩家一个速度药水效果。这个效果是在执行上一条命令时处于激活状态的：

![]

找到并打开我们刚刚创建的套件。路径是 './config/starterkit/kits/Speed_Kit.txt'：

![]

这是“Speed Kit”套件的数据文件。它包含了玩家将收到的物品，以及文件底部将给予玩家的效果。 如果创建的套件没有激活效果，该行将为空白。否则，它将精确复制效果等级和持续时间。 以本示例为例，它包含对速度效果的引用。效果是 1 级，持续时间为 3341 刻，相当于 167 秒。20 刻 = 1 秒。

![]

我将把玩家将获得的效果更改为 速度 5 级，持续时间为 5 分钟。6000 刻 = 300 秒 = 5 分钟：

![]

你可以通过 '/starterkit reload' 命令重新加载你在 './config/starterkit/' 内对文件所做的任何更改：

![]

就是这样！每当玩家首次加入世界时，他们现在将收到“Speed Kit”套件，其中包含一些标准物品以及持续时间为 5 分钟 的 速度 V 效果：

显示剧透

![]

第三部分：高级

Starter Kit 还包含一个自定义套装选择界面！以下是“Default”套件的界面示例。 在本部分中，我们将启用此功能，创建一个套件并为其添加描述。

![]

在配置中将“Randomize Multiple Kits Toggle”设置为禁用。请记住，它位于 './config/starterkit.json5' 中。你也可以使用游戏内的配置编辑器进行修改：

![]

在 './config/starterkit/kits/inactive/' 文件夹中有一些默认套件。让我们在本示例中启用它们。 使用 '/starterkit activate _all' 命令来激活所有非激活的套件。

![]

你可以使用 '/starterkit list' 命令查看当前激活的套件：

![]

由于一切都使用默认值，你现在就能看到它的效果！加载一个新世界，你将会看到套装选择界面：

显示剧透

![]

让我们添加自己的自定义套件，并看看描述是如何工作的。 首先，准备一个你想要的物品栏，然后使用 '/starterkit add' 命令。 我将它命名为“Pumpkin”。

![]

所有套装描述都保存在 './config/descriptions/' 中。每当你创建或添加套件时，这些文件会自动生成。 打开与你刚设置的套件名称相同的描述文件。在我的例子中，文件是 './config/descriptions/Pumpkin.txt'。

![]

这是任何新创建套件的默认描述内容。 该描述用于 选择套装界面 和 '/starterkit info <套件名>' 命令。

![]

将描述改为你想要的任何内容！没有大小限制，但任何超出部分都会被隐藏。所以请确保描述不要太长：

![]

要重新加载我们对描述文件所做的更改，请使用 '/starterkit reload' 命令：

![]

就是这样！描述现在将显示在套装选择界面上：

![]

点击“Choose Starter Kit”按钮，即可收到所选套装：

![]

Starter Kit 可以自动检测模组是否已安装在客户端。 支持仅在服务端使用。在这种情况下，玩家可以通过命令选择套件。 当服务器没有收到客户端的响应（意味着模组未安装）时，首次加入时会发送以下消息：

![]

玩家可以使用 '/starterkit info <套件名>' 命令查看初始套装中包含哪些物品：

![]

可以使用 '/starterkit choose <套件名>' 命令选择套装：

![]

说明与链接

你可以自由地在任何整合包中使用此模组，只要下载仍托管在 CurseForge 或 Modrinth 生态系统中即可。

Serilum.com 包含了所有可用模组的概览和更多信息。

如有问题、想法、建议或任何其他事项，请访问 Github 仓库。谢谢！