

Starter Kit 是一款模组,允许首次加入世界的玩家获得配置文件中设定的物品。可以将物品设置为库存中的任何特定槽位、副手以及护甲槽位。该模组能够检测哪些玩家从未加入过。如果其他模组添加了物品(例如指南书),它们可以被完全移除,也可以在套装设置之后添加。这可以通过 addExistingItemsAfterKitSet 配置选项进行配置。
可用于服务器中所有新玩家,或在单人游戏中以你选择的默认库存开始游戏。在创建岛屿命令之后,还提供对 FTB 的 Team Island 模组的可选支持。
该模组可以仅服务端运行。如果你希望玩家能够使用“选择套装 GUI”,则客户端也必须安装它。或者,他们可以通过服务器命令选择套装。
功能:
• 描述中的指南。难度从简单、中级到高级不等。
• 向首次加入世界的玩家赠送自定义初始物品和/或药水效果。
• 支持多种套装。可以随机分配或由玩家选择。
• 有自定义追踪机制来确定谁是新玩家,兼容现有世界。
• 大量命令!用于创建、添加、管理和选择初始套装。
• 如果安装在客户端上,可以通过自定义 GUI 屏幕选择套装。如果没有安装,则可以使用命令。
• 为你的套装添加描述。RPG 整合包爱好者?
• 移除其他模组的初始物品,如指南书。或者在初始套装之后添加它们。
• 支持 Curios 和 Trinkets!这些槽位中的物品会保存在套装中并返还,无需依赖这两个模组。
• 当给予套装时运行命令,例如授予技能。每个套装在其命令文件夹中都有自己的文件。
• 套装名称、描述和选择套装文本可以是翻译键。非常适合多语言整合包。







所有可用的配置选项:
Show Spoiler
randomizeMultipleKitsToggle 默认值 true
当通过 /starterkit add 添加多个起始套件时,有两种分发方式。启用此选项后,将随机选择其中一个。禁用后,玩家在首次加入时可以自行选择一个。
randomKitWeights 默认值 ""
在随机发放套件时,每个套件被选中的概率,以逗号分隔的 kit_name:weight 对形式表示。未列出的套件权重为 1。例如 'warrior:5,wizard:1' 会使 warrior 套件的选中概率是 wizard 套件的 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 界面。创建带有自定义描述的起始套件。
第一部分:简单
这是默认起始套件,在未进行任何配置的情况下安装模组时会发放:

你可以使用 '/starterkit set (kit_name)'(或 '/sk set (kit_name)')命令来设置你自己的起始工具包。工具包名称是可选的。
使用该命令后,所有其他处于活动状态的起始工具包都会被移动到非活动文件夹中。

在这里你可以看到通过上一个命令创建的新起始工具包数据文件。它位于 './config/serilum/starterkit/kits/' 中:

就是这样!现在所有新玩家首次加入世界时都会收到 "Upgraded" 工具包:

在位于 './config/serilum/starterkit.json5' 的配置文件中,你可以选择是否在工具包发放后移除或给予其他模组添加的起始物品。
这些模组添加的起始物品的例子包括指南书等。

要手动给其他玩家(或你自己)发放起始工具包,你可以使用 '/starterkit give <player> (kit_name)' 命令。
如果省略 kit_name 参数:
如果模组通过 intermediate 模式配置,可能会随机发放一个工具包。
如果模组通过 advanced 模式配置,则会显示工具包选择界面。

第二部分:Intermediate 模式
你可以使用 '/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 tick,即 167 秒。20 tick = 1 秒。

我将更改玩家将获得的效果为 速度 5 级,持续时间为 5 分钟。6000 tick = 300 秒 = 5 分钟:

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

就是这样!每当玩家首次加入世界时,他们现在将收到 "Speed Kit" 工具包。其中包含一些标准物品以及 速度 V 效果,持续时间为 5 分钟:
Show Spoiler

第三部分:Advanced 模式
Starter Kit 还包含一个自定义的工具包选择界面!以下是带有 "Default" 工具包时的样子示例。
在本部分中,我们将启用此功能,创建一个工具包并为它添加描述。

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

在 ./config/serilum/starterkit/kits/inactive/ 文件夹内有一些默认的预设包。让我们在此示例中启用它们。
使用 /starterkit activate _all 命令来激活所有未启用的预设包。

你可以使用 /starterkit list 命令查看当前已启用的预设包:

由于所有设置都包含默认值,你可以立即看到其效果!加载一个新世界,你将看到选择预设包的界面:
Show Spoiler

让我们添加一个自定义预设包,并看看描述是如何工作的。
首先准备好你想要的物品栏内容,然后使用 /starterkit add 命令。
我将其命名为 "Pumpkin"。

所有预设包的描述都保存在 ./config/serilum/starterkit/descriptions/ 中。每当你创建或添加一个预设包时,这些文件会自动生成。
用你刚才设置的预设包名称打开描述文件。在我的例子中,该文件是 './config/serilum/starterkit/descriptions/Pumpkin.txt'。

这是任何新创建的预设包的默认描述内容。
该描述用于 选择预设包界面 以及 '/starterkit info <预设包名称>' 命令。

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

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

就是这样!现在描述将显示在选择预设包的界面上:

点击 "Choose Starter Kit" 按钮,即可获得所选的预设包:

Starter Kit 可以自动检测客户端是否安装了该模组。
支持仅服务器端使用。在这种情况下,玩家可以通过命令选择预设包。
每当服务器未收到来自客户端的响应(即模组未安装)时,在首次加入时将发送以下消息:

玩家可以使用 '/starterkit info <预设包名称>' 命令查看预设包中包含哪些物品:

可以使用 '/starterkit choose <预设包名称>' 命令来选择预设包:


只要下载仍托管在 CurseForge 或 Modrinth 生态系统中,你就可以在任何整合包中自由使用该模组。
Serilum.com 提供了所有可用模组的概览及更多信息。
如有问题、想法、建议或其他任何事项,请访问 Github 仓库。谢谢!


Starter Kit is a mod which allows players who join a world for the first time to receive items set in a config file. It's possible to set items to any specific slot in the inventory, to the offhand and to the armour slots. The mod can detect which players have never joined before. If another mod adds items, such as guide books, they can either be removed completely or added after the kit has been set. This is configurable via the addExistingItemsAfterKitSet config option.
Can be used in a server for all new players or in singleplayer to start off with a default inventory of your choosing. There is also optional support for FTB's Team Island mod after the create island command.
The mod can be used server-side only. If you want players to be able to use the "Choose Kit GUI", it has to be installed on the client as well. Alternatively, they can choose kits via server commands.
Features:
• A guide here in the description. Difficulty ranging from Simple, Intermediate and Advanced.
• Give players joining the world for the first time custom starter items and/or potion effects.
• Support for multiple kits. Can be given randomly or chosen by the player.
• There is custom tracking to determine who are new players, compatible with existing worlds.
• Lots of commands! For creating, adding, managing and choosing starter kits.
• If installed on the client, kits can be chosen via a custom GUI screen. If not, commands can be used.
• Add descriptions to your kits. RPG modpack, anyone?
• Remove other modded starter items, such as guide books. Or add them after the starter kit.
• Curios and Trinkets support! Items in those slots are saved in the kit and given back, without requiring either mod.
• Run commands when a kit is given, such as granting a skill. Each kit has its own file in the commands folder.
• Kit names, descriptions and the choose kit text can be translation keys. Great for multilingual modpacks.







All available config options:
Show Spoiler
randomizeMultipleKitsToggle default true
When multiple starter kits are added via /starterkit add, there are two ways to distribute them. With this enabled, one is chosen at random. When disabled, players can choose one on first join.
randomKitWeights default ""
How likely each kit is to be picked when kits are given randomly, as comma-separated kit_name:weight pairs. Kits that are not listed have a weight of 1. For example 'warrior:5,wizard:1' makes the warrior kit 5 times as likely as the wizard kit.
giveStarterKitOnFirstJoin default true
Whether new players receive (or get to choose) a starter kit when they join for the first time. When disabled, kits are only handed out via '/sk give <player>', which opens the kit choice screen when players can choose. Useful for an NPC or command block that hands out kits.
giveStarterKitOnRespawn default false
Whether players receive the last starter kit they got again when they respawn after dying. Does nothing when the keepInventory gamerule is enabled.
addExistingItemsAfterKitSet default true
Whether items that existed in the inventory, such as books added by other mods, should be added back to the inventory after the kit was set. If disabled, they'll be removed. You can still manually set them via the kit.
usePotionEffectsInStarterKit default true
If potion/mob effect functionality should be enabled. This means that when creating a kit via /sk (add/set), it also saves the active effects the player has. And when handing out the starter kits, it adds the effects to new players.
formatKitNames default true
If kit names should be formatted. Each word will be capitalized.
chooseKitText default "%s, you can choose a starter kit!"
The text used above the kit choice screen, or if the mod is not installed in the chat. %s will be replaced with the player's name. Can also be a translation key from a resource pack, just like kit names and kit descriptions.
lockKitChoiceScreen default false
Whether the kit choice screen stays open until a kit is chosen. When enabled, the inventory key and Escape do not close it. This is read from each player's own config, so a modpack sets it in the config it ships.
announcePlayerKitChoiceInDedicatedServer default true
Whether an announcement should be broadcasted to the server whenever a new player makes a kit choice. 'randomizeMultipleKitsToggle' must be disabled, and there must be at least 2 starter kits available.
enableFTBIslandCreateCompatibility default true
Whether the starter kit should be re-set after the '/ftbteamislands create' command from FTB Team Islands. Does nothing when it's not installed.

Both '/starterkit' and '/sk' can be used.
Admin Commands:
/sk add (kit_name) - Adds your current inventory to the active kits.
/sk set (kit_name) - Sets your current inventory as the only active kit.
/sk give <player> (kit_name) - Give a player a random (or specific) starter kit.
/sk activate <kit_name>/_all - Moves kit_name or all kits from inactive to active.
/sk deactivate <kit_name>/_all - Moves kit_name or all kits from active to inactive.
/sk list (inactive) - Lists all active (or inactive) kits.
/sk reset - Resets all tracking. Players receive another kit on join.
/sk reload - Reloads starter kit changes from the config folder.
User Commands:
/sk choose <kit_name> - Allows players to choose a starter kit via commands. This is only needed when Starter Kit is not installed on the client and the server enabled kit choices.
/sk info <kit_name> - Shows the description and items of kit_name.
/sk help - Shows the Starter Kit commands in-game.

Usage Guide:
The mod can be configured in many different ways. To keep a better overview, I've divided the difficulty into three different sections. Simple, Intermediate and Advanced.
Simple:
Set a custom starter kit. Add/Remove starter items from other mods. And giving players a starter kit via commands.
Intermediate:
Add an extra starter kit. Deactivate a kit via commands. Add a starter kit with potion effects, and setting the level and duration.
Advanced:
Make players choose a kit on first join. Move the inactive default kits to active. Show the choose kit GUI screen. Create a starter kit with a custom description.
Section 1: Simple
This is the default starter kit, which will be given when the mod is installed without any configuration:

You can set your own starter kit by using the '/starterkit set (kit_name)' (or '/sk set (kit_name)') command. The kit name is optional.
After using this command, all other active starter kits are moved to the inactive folder.

Here you can see the new starter kit data file that was created with the previous command. It's located in './config/serilum/starterkit/kits/':

That's it! All new players will now receive the "Upgraded" kit when they first join the world:

Inside the config file, located at './config/serilum/starterkit.json5', you can choose whether or not other modded starter items should be removed or given after the kit.
Examples of these modded starter items are guide books.

To give other players (or yourself) a starter kit manually, you can use the '/starterkit give <player> (kit_name)' command.
The kit_name argument is optional, if left out:
If the mod is configured via intermediate, a kit may be given randomly.
If the mod is configured via advanced, the kit choice screen may be shown.

Section 2: Intermediate
You can add another active kit by using the '/starterkit add (kit_name)' command.
With the default configuration, this means that new players will now randomly receive the "Default" or "No Bread" starter kit.

To see all active starter kits, use the '/starterkit list' command. To see inactive starter kits, use '/starterkit list inactive':

To disable an active kit, use '/starterkit deactivate <kit_name>'. This moves it to the './config/serilum/starterkit/kits/inactive/' folder.

The mod can also give potion effects alongside the starter kit! Make sure 'usePotionEffectsInStarterKit' is enabled in the config.
Then, just make sure to have the potion effect enabled, and use the '/starterkit set' or '/starterkit add' command.
The effect duration will be set to what the player has exactly now, but we will round that up in a later step.

For this example, I've given the player the speed potion effect. This was active when using the previous command:

Locate and open the kit we've just created. The path is './config/serilum/starterkit/kits/Speed_Kit.txt':

This is the data file for the "Speed Kit" kit. It contains the items the player will receive and at the bottom what effects will be given to the player.
When a kit is created without active effects, that line will be empty. Otherwise it copies the exact level and duration.
In case of this example, it contains a reference to the Speed effect. It's lvl 1 with a duration of 3341 ticks, which equals 167 seconds. 20 ticks = 1 second.

I'm going to change the effect a player will receive to Speed level 5, with a duration of 5 minutes. 6000 ticks = 300 seconds = 5 minutes:

You can reload any changes you've made to files inside './config/serilum/starterkit/' via the '/starterkit reload' command:

That's it! Whenever a player first joins a world, they will now receive the "Speed Kit" kit. Which contains a few standard items and the Speed V effect, with a duration of 5 minutes:
Show Spoiler

Section 3: Advanced
Starter Kit also contains a custom kit choosing screen! Here's an example of what it looks like with the "Default" kit.
In this section we'll enable this, create a kit and add a description for it.

Disable the "Randomize Multiple Kits Toggle" inside the config. Remember, it's located inside './config/serilum/starterkit.json5'. You can also use the in-game config editor for this:

There are some default kits located inside the './config/serilum/starterkit/kits/inactive/' folder. Let's enable those for this example.
Use the '/starterkit activate _all' command to activate all inactive kits.

You can use the '/starterkit list' command to see which kits are currently active:

Since everything contains default values, you can immediately see it working! Load a new world, and you'll be shown the choose kit screen:
Show Spoiler

Let's add our own custom kit, and see how the descriptions work.
Start off with an inventory of your choosing, and use the '/starterkit add' command.
I'm calling it "Pumpkin".

All kit descriptions are saved inside './config/serilum/starterkit/descriptions/'. These are automatically created whenever you create or add a kit.
Open the description file with the kit name you've just set. In my case, the file is './config/serilum/starterkit/descriptions/Pumpkin.txt'.

This is the default description content for any newly created kit.
The description is used for the choose kit screen, and the '/starterkit info <kit_name>' command.

Change the description to whatever you'd like! There isn't a size limit, but any overflow will be hidden. So make sure it's not too long:

To reload the changes we've made to the description file, use the '/starterkit reload' command:

That's it! The description will now be visible on the choose kit screen:

Click on the "Choose Starter Kit" button, and receive the selected kit:

Starter Kit can automatically detect if the mod has been installed on the client.
There is support for server-side only use. In that case, players can choose a kit via commands.
Whenever the server doesn't get a response from the client, meaning the mod isn't installed, the following message is sent on first join:

Players can use the '/starterkit info <kit_name>' command to see which items are included in the starter kit:

A kit can be chosen with the '/starterkit choose <kit_name>' command:


You may freely use this mod in any modpack, as long as the download remains hosted within the CurseForge or Modrinth ecosystem.
Serilum.com contains an overview and more information on all mods available.
For issues, ideas, suggestions or anything else there is the Github repo. Thanks!
评论 0
登录后参与评分
还没有评论,来抢沙发吧