Minecraftのクエストプラグインの作り方

手順

1. 1.目標の種類を選ぶ

   まずはいくつかから始めます。特定のモブを倒す、ブロックを壊す・置く、アイテムを集める、クラフトする、場所にたどり着く、NPCと話す。どのクエストもこれらの組み合わせです。

2. 2.クエストをファイルで定義する

   quests.ymlに各クエストを書きます。ID、名前、説明、数量付きの目標、報酬、条件(先に終わらせるクエスト、権限、レベル)。

3. 3.プレイヤーごとに進行状況を記録する

   各目標の元になるイベントを監視し、プレイヤーの進行状況に加算します。ログアウトや再起動でも消えないよう、SQLiteかファイルに保存します。

4. 4.進行状況を表示する

   進行中と完了済みのクエストを表示する/questsメニューに加えて、進行状況が変わったときのメッセージ、タイトル、ボスバー。

5. 5.報酬を渡す

   アイテム、経験値、Vault経由のお金、そのほかはlp user %player% permission set ...のようなコンソールコマンド。

6. 6.ビルドしてゲーム内でクエストをクリアする

   Codexeにコンパイルさせ、テストサーバーに参加し、クエストを受けてクリアします。その後、再起動して、進行状況と報酬が保存されているか確認します。

目標とその元になるイベント

クエストの依頼主

いちばん簡単な依頼主は、コマンドかメニューです。ワールド内のキャラクターにするなら、独自の名前とPersistentDataContainerのタグを付けた村人や防具立てで、ほかのプラグインなしで実現できます。プレイヤーが右クリックすると、プラグインがそれを認識します。サーバーですでにCitizensなどのNPCプラグインを使っているなら、プラグインが連携できるようにリクエストに名前を書いてください。

説明の例

「Questsという名前のPaper 1.21.4クエストプラグイン。目標の種類: モブを倒す、ブロックを壊す(プレイヤーが置いたものは除く)、アイテムを集める、クエストの依頼主としてタグ付けした村人と話す。クエストはquests.ymlで定義し、名前、目標、前提クエスト、報酬(アイテム、経験値、Vaultのお金、コンソールコマンド)を持つ。/questsで、受注可能、進行中、完了済みのクエストを表示するメニューを開く。進行状況はアクションバーに表示。進行中のクエストは最大3つ。デイリークエストはサーバー時間の深夜0時にリセット。進行状況はSQLiteに保存。」

デイリークエストと繰り返しクエスト

• リセットのタイミングを書きます。毎日決まった時刻か、プレイヤーがクリアしてから24時間後か。
• デイリークエストをプレイヤーごとにランダムにするか、全員同じにするかを書きます。
• フラグではなく最後にクリアした時刻を保存します。そうすれば、サーバーが止まっている間もリセットが正しく働きます。

よくある質問