Starter Kit

📦 为加入世界的新玩家提供可配置的初始装备、物品、药水效果、Curios 和 Trinkets 饰品槽位和/或命令。兼容 FTB Team Islands。

模组 Fabric Forge NeoForge Quilt 冒险实用服务器工具管理装备

介绍

介绍由机器翻译自 Modrinth 原页面，仅供参考。

Starter Kit 是一个模组，允许首次加入世界的玩家获得在配置文件中设置的物品。可以将物品设置到物品栏中的任意特定槽位、副手以及盔甲槽位。该模组可以检测哪些玩家此前从未加入过。如果其他模组添加了物品，例如指南书，它们可以被完全移除，或者在初始套装设置之后再添加。这可以通过 addExistingItemsAfterKitSet 配置选项进行配置。

可用于服务器中为所有新玩家发放，也可在单人游戏中使用，以你选择的默认物品栏开局。在创建岛屿命令之后，还可选支持 FTB 的 Team Island 模组。

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

功能：
• 此处描述中附有指南。难度分为简单、中级和高级。
• 为首次加入世界的玩家提供自定义初始物品和/或药水效果。
• 支持多个套装。可以随机发放或由玩家选择。
• 有自定义追踪机制来确定哪些是新玩家，兼容现有世界。
• 大量命令！用于创建、添加、管理和选择初始套装。
• 如果安装在客户端，可以通过自定义 GUI 界面选择套装。如果未安装，则可以使用命令。
• 为你的套装添加描述。RPG 整合包，有人要吗？
• 移除其他模组添加的初始物品，例如指南书。或者在初始套装之后添加它们。
• 支持 Curios 和 Trinkets！这些槽位中的物品会保存在套装中并返还，无需安装其中任一模组。
• 发放套装时运行命令，例如授予技能。每个套装在 commands 文件夹中都有自己的文件。
• 套装名称、描述和选择套装文本可以是翻译键。非常适合多语言整合包。

环境：服务端

所有可用的配置选项：

显示剧透

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

randomKitWeights 默认 “”
当随机发放套件时，每个套件被选中的可能性，以逗号分隔的 kit_name:weight 对表示。未列出的套件权重为 1。例如 ‘warrior:5,wizard:1’ 使战士套件被选中的可能性是法师套件的 5 倍。

giveStarterKitOnFirstJoin 默认 true
新玩家首次加入时是否获得（或可以选择）初始套件。禁用时，套件仅通过 ‘/sk give <player>’ 发放，当玩家可以选择时会打开套件选择界面。适用于由 NPC 或命令方块发放套件的情况。

giveStarterKitOnRespawn 默认 false
玩家死亡后重生时是否再次获得上次获得的初始套件。当 keepInventory 游戏规则启用时无效。

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

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

formatKitNames 默认 true
是否应格式化套件名称。每个单词将首字母大写。

chooseKitText 默认 “%s, you can choose a starter kit!”
显示在套件选择界面上方或聊天栏中的文本（如果未安装该模组）。%s 将被替换为玩家名称。也可以像套件名称和套件描述一样，使用资源包中的翻译键。

lockKitChoiceScreen 默认 false
套件选择界面是否保持打开直到选择了一个套件。启用时，背包键和 Escape 键不会关闭它。此设置从每个玩家自己的配置中读取，因此整合包会在其发布的配置中设置此项。

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

enableFTBIslandCreateCompatibility 默认 true
在 FTB Team Islands 的 ‘/ftbteamislands create’ 命令之后，是否应重新设置初始套件。未安装时无效。

‘/starterkit’ 和 ‘/sk’ 均可使用。

管理员命令：
/sk add (kit_name) – 将你当前的背包添加到活动套件中。
/sk set (kit_name) – 将你当前的背包设置为唯一的活动套件。

/sk give <player> (kit_name) – 给予玩家一个随机（或指定）的初始套件。

/sk activate <kit_name>/_all – 将 kit_name 或所有套件从非活动移动到活动。
/sk deactivate <kit_name>/_all – 将 kit_name 或所有套件从活动移动到非活动。

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

用户命令：
/sk choose <kit_name> – 允许玩家通过命令选择一个初始套件。仅当客户端未安装 Starter Kit 且服务器启用了套件选择时才需要此操作。
/sk info <kit_name> – 显示 kit_name 的描述和物品。
/sk help – 在游戏内显示 Starter Kit 的命令。

使用指南：
该模组可以通过多种不同方式进行配置。为了更好地保持条理，我将难度分为三个不同的部分：简单、中级和高级。

简单：
设置自定义初始套件。添加/移除来自其他模组的初始物品。并通过命令给予玩家初始套件。

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

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

第 1 部分：简单
这是默认的初始套件，在未进行任何配置的情况下安装模组时将给予该套件：

你可以使用“/starterkit set (kit_name)”（或“/sk set (kit_name)”）命令设置自己的初始套件。套件名称是可选的。
使用此命令后，所有其他活跃的初始套件都会被移至非活跃文件夹。

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

就是这样！所有新玩家现在首次加入世界时都将获得“Upgraded”套件：

在位于“./config/serilum/starterkit.json5”的配置文件中，你可以选择是否应在套件之后移除或给予其他模组的初始物品。
这些模组初始物品的例子包括指南书。

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

第 2 节：中级
你可以使用“/starterkit add (kit_name)”命令添加另一个启用的新手礼包。
在默认配置下，这意味着新玩家现在会随机收到“Default”或“No Bread”新手礼包。

要查看所有启用的新手礼包，请使用“/starterkit list”命令。要查看未启用的新手礼包，请使用“/starterkit list inactive”：

要禁用一个已启用的礼包，请使用“/starterkit deactivate <kit_name>”。这会将礼包移动到“./config/serilum/starterkit/kits/inactive/”文件夹。

该模组还可以在新手礼包中同时给予药水效果！请确保配置中启用了“usePotionEffectsInStarterKit”。
然后，只需确保启用了药水效果，并使用“/starterkit set”或“/starterkit add”命令。
效果持续时间将设置为玩家当前拥有的准确时长，但我们会在后续步骤中将其向上取整。

在这个示例中，我给玩家添加了速度药水效果。使用上一条命令时该效果处于激活状态：

找到并打开我们刚刚创建的礼包。路径为“./config/serilum/starterkit/kits/Speed_Kit.txt”：

这是“Speed Kit”礼包的数据文件。它包含玩家将获得的物品，以及底部将给予玩家的效果。
当创建礼包时没有激活效果，该行将为空。否则它会复制确切的等级和持续时间。
在这个示例中，它包含对速度效果的引用。它是1 级，持续时间为3341 刻，等于 167 秒。20 刻 = 1 秒。

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

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

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

显示剧透

第 3 节：高级
Starter Kit 还包含一个自定义礼包选择界面！以下是使用“Default”礼包时的示例。
在本节中，我们将启用它、创建一个礼包并为其添加描述。

在配置中禁用“Randomize Multiple Kits Toggle”。请记住，它位于“./config/serilum/starterkit.json5”中。你也可以使用游戏内的配置编辑器来完成此操作：

“./config/serilum/starterkit/kits/in/”文件夹内有一些默认套件。让我们为这个示例启用它们。
使用“/starterkit activate _all”命令激活所有未激活的套件。

你可以使用“/starterkit list”命令查看当前哪些套件处于激活状态：

由于所有内容都包含默认值，你可以立即看到它生效！加载一个新世界，你就会看到选择套件的界面：

显示剧透

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

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