Minecraft 1.20.1, 1.21.1用Starter Kit MOD

Starter Kitは、初めてワールドに参加するプレイヤーがコンフィグファイルで設定されたアイテムを受け取れるようにするMODです。アイテムはインベントリの任意のスロット、オフハンド、防具スロットに設定できます。このMODはどのプレイヤーがこれまで参加したことがないかを検出できます。ガイドブックなど他のMODがアイテムを追加する場合、それらを完全に削除するか、キット設定後に追加することができます。これはaddExistingItemsAfterKitSetコンフィグオプションで設定できます。

サーバーで全新規プレイヤー向けに使用したり、シングルプレイでお好みのデフォルトインベントリで開始するために使用できます。また、create islandコマンド後のFTBのTeam Island MODへのオプションのサポートもあります。

このMODはサーバーサイドのみで使用できます。プレイヤーが「Choose Kit GUI」を使用できるようにしたい場合は、クライアントにもインストールする必要があります。あるいは、サーバーコマンドでキットを選択できます。

機能: • 説明欄にあるガイド。難易度はSimple、Intermediate、Advanced。 • 初めてワールドに参加するプレイヤーにカスタムのスターターアイテムやポーション効果を付与。 • 複数のキットをサポート。ランダムに付与したり、プレイヤーが選択できます。 • 新規プレイヤーを判定する独自のトラッキングがあり、既存のワールドとも互換性があります。 • 多数のコマンド! スターターキットの作成、追加、管理、選択が可能。 • クライアントにインストールされている場合、カスタムGUI画面でキットを選択できます。そうでない場合はコマンドを使用できます。 • キットに説明を追加できます。RPG MODパック向け! • ガイドブックなど他のMODのスターターアイテムを削除。またはスターターキットの後に追加。 • CuriosとTrinketsをサポート! それらのスロットのアイテムはどちらのMODも必要とせずにキットに保存され、返却されます。 • キット付与時にコマンドを実行できます。例えばスキルの付与など。各キットはcommandsフォルダに独自のファイルを持ちます。 • キット名、説明、キット選択テキストは翻訳キーにできます。多言語MODパックに最適。

利用可能なすべてのコンフィグオプション:

ネタバレを表示

randomizeMultipleKitsToggle デフォルト true /starterkit addで複数のスターターキットが追加された場合、それらを配布する方法は2つあります。これが有効な場合、1つがランダムに選ばれます。無効な場合、プレイヤーは初回参加時に1つを選択できます。

randomKitWeights デフォルト "" キットがランダムに付与される際に各キットが選ばれる確率を、カンマ区切りのkitname:weightペアで指定します。リストにないキットの重みは1です。例えば'warrior:5,wizard:1'とすると、warriorキットはwizardキットの5倍の確率で選ばれます。

giveStarterKitOnFirstJoin デフォルト true 新規プレイヤーが初めて参加したときにスターターキットを受け取る(または選択する)かどうか。無効な場合、キットは'/sk give <player>'でのみ配布され、プレイヤーが選択できる場合はキット選択画面が開きます。キットを配布するNPCやコマンドブロックに便利です。

giveStarterKitOnRespawn デフォルト false 死亡後にリスポーンしたとき、プレイヤーが最後に受け取ったスターターキットを再び受け取るかどうか。keepInventoryゲームルールが有効な場合は何もしません。

addExistingItemsAfterKitSet デフォルト true 他のMODが追加した本など、インベントリに存在していたアイテムを、キット設定後にインベントリに戻すかどうか。無効な場合、それらは削除されます。キット経由で手動で設定することは可能です。

usePotionEffectsInStarterKit デフォルト true ポーション/モブ効果機能を有効にするかどうか。つまり、/sk (add/set)でキットを作成する際に、プレイヤーが持っているアクティブな効果も保存されます。そしてスターターキットを配布する際に、新規プレイヤーにその効果を付与します。

formatKitNames デフォルト true キット名を整形するかどうか。各単語が大文字になります。

chooseKitText デフォルト "%s, you can choose a starter kit!" キット選択画面の上、またはMODがインストールされていない場合はチャットに表示されるテキスト。%sはプレイヤー名に置き換えられます。キット名やキット説明と同様に、リソースパックの翻訳キーにすることもできます。

lockKitChoiceScreen デフォルト false キットが選択されるまでキット選択画面を開いたままにするかどうか。有効な場合、インベントリキーとEscapeでは閉じられません。これは各プレイヤー自身のコンフィグから読み込まれるため、MODパックは同梱するコンフィグで設定します。

announcePlayerKitChoiceInDedicatedServer デフォルト true 新規プレイヤーがキットを選択するたびに、サーバー全体にアナウンスをブロードキャストするかどうか。'randomizeMultipleKitsToggle'が無効で、かつ利用可能なスターターキットが2つ以上ある必要があります。

enableFTBIslandCreateCompatibility デフォルト true FTB Team Islandsの'/ftbteamislands create'コマンド後にスターターキットを再設定するかどうか。インストールされていない場合は何もしません。

'/starterkit'と'/sk'の両方を使用できます。

管理者コマンド: /sk add (kitname) - 現在のインベントリをアクティブなキットに追加します。 /sk set (kitname) - 現在のインベントリを唯一のアクティブなキットとして設定します。

/sk give <player> (kitname) - プレイヤーにランダムな(または特定の)スターターキットを付与します。

/sk activate <kitname>/all - kitnameまたはすべてのキットを非アクティブからアクティブに移動します。 /sk deactivate <kitname>/all - kitnameまたはすべてのキットをアクティブから非アクティブに移動します。

/sk list (inactive) - すべてのアクティブな(または非アクティブな)キットを一覧表示します。 /sk reset - すべてのトラッキングをリセットします。プレイヤーは参加時に再びキットを受け取ります。 /sk reload - コンフィグフォルダからスターターキットの変更を再読み込みします。

ユーザーコマンド: /sk choose <kitname> - プレイヤーがコマンドでスターターキットを選択できるようにします。これはStarter Kitがクライアントにインストールされておらず、サーバーがキット選択を有効にしている場合にのみ必要です。 /sk info <kitname> - kitnameの説明とアイテムを表示します。 /sk help - ゲーム内でStarter Kitのコマンドを表示します。

使用ガイド: このMODはさまざまな方法で設定できます。より見やすくするため、難易度を3つのセクションに分けました。Simple、Intermediate、Advancedです。

Simple: カスタムのスターターキットを設定。他のMODのスターターアイテムを追加/削除。コマンドでプレイヤーにスターターキットを付与。

Intermediate: 追加のスターターキットを追加。コマンドでキットを非アクティブ化。ポーション効果付きのスターターキットを追加し、レベルと持続時間を設定。

Advanced: 初回参加時にプレイヤーにキットを選択させる。非アクティブなデフォルトキットをアクティブに移動。キット選択GUI画面を表示。カスタム説明付きのスターターキットを作成。

セクション1: Simple これはデフォルトのスターターキットで、設定なしでMODをインストールしたときに付与されます:

'/starterkit set (kitname)'(または'/sk set (kitname)')コマンドで独自のスターターキットを設定できます。キット名は省略可能です。このコマンドを使用すると、他のすべてのアクティブなスターターキットは非アクティブフォルダに移動されます。

ここでは、先ほどのコマンドで作成された新しいスターターキットのデータファイルを確認できます。場所は'./config/serilum/starterkit/kits/'です:

これで完了です! すべての新規プレイヤーは、初めてワールドに参加したときに「Upgraded」キットを受け取ります:

'./config/serilum/starterkit.json5'にあるコンフィグファイル内で、他のMODのスターターアイテムを削除するか、キットの後に付与するかを選択できます。これらのMOD製スターターアイテムの例としてはガイドブックがあります。

他のプレイヤー(または自分自身)に手動でスターターキットを付与するには、'/starterkit give <player> (kitname)'コマンドを使用できます。kitname引数は省略可能で、省略した場合: MODがIntermediateで設定されている場合はキットがランダムに付与されることがあります。MODがAdvancedで設定されている場合はキット選択画面が表示されることがあります。

セクション2: Intermediate '/starterkit add (kitname)'コマンドで別のアクティブなキットを追加できます。デフォルトの設定では、新規プレイヤーは「Default」または「No Bread」スターターキットをランダムに受け取ることになります。

すべてのアクティブなスターターキットを表示するには、'/starterkit list'コマンドを使用します。非アクティブなスターターキットを表示するには、'/starterkit list inactive'を使用します:

アクティブなキットを無効にするには、'/starterkit deactivate <kitname>'を使用します。これにより、'./config/serilum/starterkit/kits/inactive/'フォルダに移動されます。

このMODはスターターキットと一緒にポーション効果も付与できます! コンフィグで'usePotionEffectsInStarterKit'が有効になっていることを確認してください。あとは、ポーション効果を有効にした状態で、'/starterkit set'または'/starterkit add'コマンドを使用するだけです。効果の持続時間はプレイヤーが現在持っている正確な値に設定されますが、後の手順で切り上げます。

この例では、プレイヤーにspeedポーション効果を付与しました。これは先ほどのコマンドを使用したときにアクティブでした:

作成したばかりのキットを見つけて開きます。パスは'./config/serilum/starterkit/kits/SpeedKit.txt'です:

これが「Speed Kit」キットのデータファイルです。プレイヤーが受け取るアイテムと、下部にプレイヤーに付与される効果が含まれています。アクティブな効果なしでキットを作成した場合、その行は空になります。それ以外の場合は、正確なレベルと持続時間がコピーされます。この例の場合、Speed効果への参照が含まれています。レベル1で持続時間は3341ティック、つまり167秒です。20ティック = 1秒です。

プレイヤーが受け取る効果をSpeedレベル5、持続時間5分に変更します。6000ティック = 300秒 = 5分です:

'./config/serilum/starterkit/'内のファイルに加えた変更は、'/starterkit reload'コマンドで再読み込みできます:

これで完了です! プレイヤーが初めてワールドに参加するたびに、「Speed Kit」キットを受け取ります。これにはいくつかの標準アイテムと、持続時間5分のSpeed V効果が含まれています:

ネタバレを表示

セクション3: Advanced Starter Kitにはカスタムのキット選択画面もあります! 以下は「Default」キットでの表示例です。このセクションではこれを有効にし、キットを作成して説明を追加します。

コンフィグ内の「Randomize Multiple Kits Toggle」を無効にします。場所は'./config/serilum/starterkit.json5'です。ゲーム内のコンフィグエディタでもこれを行えます:

'./config/serilum/starterkit/kits/inactive/'フォルダにいくつかのデフォルトキットがあります。この例ではそれらを有効にしましょう。'/starterkit activate all'コマンドですべての非アクティブなキットをアクティブにします。

'/starterkit list'コマンドで現在アクティブなキットを確認できます:

すべてにデフォルト値が含まれているため、すぐに動作を確認できます! 新しいワールドを読み込むと、キット選択画面が表示されます:

ネタバレを表示

独自のカスタムキットを追加して、説明がどのように機能するか見てみましょう。お好みのインベントリを用意し、'/starterkit add'コマンドを使用します。名前は「Pumpkin」にします。

すべてのキット説明は'./config/serilum/starterkit/descriptions/'内に保存されます。これらはキットを作成または追加するたびに自動的に作成されます。設定したキット名の説明ファイルを開きます。私の場合、ファイルは'./config/serilum/starterkit/descriptions/Pumpkin.txt'です。

これは新しく作成されたキットのデフォルトの説明内容です。説明はキット選択画面と'/starterkit info <kitname>'コマンドで使用されます。

説明は好きなように変更してください! サイズ制限はありませんが、はみ出した部分は非表示になります。長すぎないようにしてください:

説明ファイルに加えた変更を再読み込みするには、'/starterkit reload'コマンドを使用します:

これで完了です! 説明がキット選択画面に表示されるようになります:

「Choose Starter Kit」ボタンをクリックして、選択したキットを受け取ります:

Starter Kitは、MODがクライアントにインストールされているかどうかを自動的に検出できます。サーバーサイドのみでの使用をサポートしています。その場合、プレイヤーはコマンドでキットを選択できます。サーバーがクライアントから応答を得られない場合、つまりMODがインストールされていない場合、初回参加時に次のメッセージが送信されます:

プレイヤーは'/starterkit info <kitname>'コマンドでスターターキットに含まれるアイテムを確認できます:

キットは'/starterkit choose <kitname>'コマンドで選択できます:

ダウンロードがCurseForgeまたはModrinthのエコシステム内でホストされている限り、このMODはどのMODパックでも自由に使用できます。

Serilum.comには、利用可能なすべてのMODの概要と詳細情報があります。

問題、アイデア、提案などについてはGithubリポジトリがあります。ありがとうございます!