Starter Kit - Starter Kit（新手工具包）

需要前置库模组 Collective。

   此模组是 The Vanilla Experience 整合包以及 Serilum's Customization Bundle 模组的一部分。
Starter Kit 是一个允许玩家在首次加入世界时，获得配置文件中设定物品的模组。可以将物品放入背包中的任意指定槽位、副手以及盔甲栏。模组能够检测哪些玩家从未加入过世界。如果其他模组会添加物品，例如指南书，那么这些物品可以被完全移除，或者在套装发放后再添加回来。这可以通过 addExistingItemsAfterKitSet 配置选项进行设置。

它既可用于服务器，为所有新玩家发放，也可用于单人模式，让你以自己选择的默认初始背包开局。还可选支持 FTB 的 Team Island 模组，在 create island 命令后生效。

该模组可仅安装在服务端使用。如果你希望玩家能够使用“Choose Kit GUI”，则客户端也必须安装该模组。或者，他们也可以通过服务器命令来选择套装。

功能：
 •  本描述中附带使用指南，难度分为简单、中级和高级。
 •  为首次加入世界的玩家发放自定义初始物品和/或药水效果。
 •  支持多个套装。可以随机发放，也可以由玩家自行选择。
 •  具有自定义追踪机制来判断谁是新玩家，并兼容现有世界。
 •  大量命令！用于创建、添加、管理和选择初始套装。
 •  如果安装在客户端，套装可通过自定义 GUI 界面选择；否则可使用命令。
 •  你还可以为套装添加描述。RPG 整合包玩家有福了？
 •  移除其他模组添加的初始物品，例如指南书；或者让它们在初始套装之后再加入。

可配置项： ( 我该如何配置？ )
randomizeMultipleKitsToggle（默认 = true）：当通过 /starterkit add 添加了多个初始套装时，有两种发放方式。启用后会随机选择一个；禁用后玩家可在首次加入时自行选择。
addExistingItemsAfterKitSet（默认 = true）：背包中原本已有的物品，例如其他模组添加的书，是否应在套装发放后重新加入背包。若禁用，它们将被移除。你仍然可以手动通过套装来设置这些物品。
usePotionEffectsInStarterKit（默认 = true）：是否启用药水/生物效果功能。启用后，通过 /sk（add/set）创建套装时，也会保存玩家当前激活的效果；在发放初始套装时，会将这些效果添加给新玩家。
formatKitNames（默认 = true）：是否格式化套装名称。每个单词的首字母都会大写。

chooseKitScreenHeader（默认 = "%s, you can choose a starter kit!"）：显示在套装选择界面上方的文本；如果模组未安装在客户端，则会显示在聊天中。%s 会替换为玩家名字。

announcePlayerKitChoiceInDedicatedServer（默认 = true）：当新玩家做出套装选择时，是否在服务器中广播公告。必须先禁用 'randomizeMultipleKitsToggle'，且至少要有 2 个可用的初始套装。
enableFTBIslandCreateCompatibility （默认 = true）：在 FTB Team Islands 的 '/ftbteamislands create' 命令执行后，是否重新设置初始套装。若未安装该模组，则无效果。

命令：
可以使用 '/starterkit' 和 '/sk' 两种形式。

管理员命令：
/sk add (kit_name) - 将你当前的背包添加为活动套装之一。
/sk set (kit_name) - 将你当前的背包设为唯一活动套装。

/sk give (kit_name) - 给某位玩家发放一个随机的（或指定的）初始套装。

/sk activate /_all - 将 kit_name 或所有套装从未激活移到已激活。
/sk deactivate /_all - 将 kit_name 或所有套装从已激活移到未激活。

/sk list (inactive) - 列出所有已激活（或未激活）的套装。
/sk reset - 重置所有追踪数据。玩家再次加入时会重新获得套装。
/sk reload - 从 config 文件夹重新加载 Starter Kit 的改动。

玩家命令：
/sk choose - 允许玩家通过命令选择一个初始套装。只有在客户端未安装 Starter Kit 且服务器启用了套装选择时才需要使用。
/sk info - 显示 kit_name 的描述和内容物品。
/sk help - 在游戏内显示 Starter Kit 的命令帮助。

使用指南：
这个模组可以用许多不同方式进行配置。为了方便理解，我将难度划分为三个部分：简单、中级 和 高级。

简单：
设置自定义初始套装。添加/移除其他模组的初始物品。以及通过命令给玩家发放初始套装。

中级：
添加额外的初始套装。通过命令停用某个套装。添加带有药水效果的初始套装，并设置等级与持续时间。

高级：
让玩家在首次加入时自行选择套装。将默认未激活套装移为激活。显示套装选择 GUI 界面。创建带有自定义描述的初始套装。


第 1 部分：简单
这是默认初始套装，在安装模组且不做任何配置时会自动发放：

你可以使用 '/starterkit set (kit_name)'（或 '/sk set (kit_name)'）命令设置自己的初始套装。套装名称是可选的。
使用该命令后，所有其他已激活的初始套装都会被移到未激活文件夹中。


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


就是这样！现在所有新玩家在首次加入世界时都会获得 "Upgraded" 套装：


在位于 './config/starterkit.json5' 的配置文件中，你可以选择是否移除其他模组添加的初始物品，或者让它们在套装发放后再给出。
这些模组初始物品的例子包括指南书。


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




第 2 部分：中级
你可以使用 '/starterkit add (kit_name)' 命令添加另一个已激活套装。
在默认配置下，这意味着新玩家现在会随机获得 "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 tick，也就是 167 秒。20 tick = 1 秒。


我打算把玩家将获得的效果改为速度 5 级，持续5 分钟。6000 tick = 300 秒 = 5 分钟：


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


就是这样！现在每当玩家首次加入世界时，他们都会获得 "Speed Kit" 套装。该套装包含一些标准物品，以及持续5 分钟的 速度 V 效果：

显示剧透内容

 


第 3 部分：高级
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 ' 命令选择一个套装：


------------------

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

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

评论已关闭，因为我无法追踪每个模组在各个平台上的独立页面。
如果有问题、想法、建议或其他任何内容，请前往 Github repo。谢谢！