CrazyCrates — Minecraftでカスタムクレートと報酬チェストを追加するプラグイン

CrazyCrates — Minecraftでカスタムクレートと報酬チェストを追加するプラグイン

CrazyCratesを使用すると、Minecraftサーバーにクレート（crates）を追加できます。各クレートは、ワールド内のブロックまたはメニュー内の位置であり、プレイヤーが鍵で開いてランダムな賞品を受け取るものです。プラグインは、11種類の異なるアニメーション、2種類の鍵 — 物理的（インベントリ内のアイテム）と仮想的（データベースに保存） — およびパーセンテージの代わりに重量ベースの確率システムを提供します。無料で配布されています。 

インベントリ内のアイテムとしてクレートを表示するメインメニュー /crates 

クレートの種類 

サーバー上の各クレートは、crates/フォルダ内の独立した .yml ファイルです。ファイルには CrateType パラメータがあり、開くアニメーションを決定します。

初回起動時に、プラグインは5つの確認された種類をカバーする6つの既製の例を生成します。/crazycrates forceopen <ファイル名> <ニックネーム>コマンドを使用して、鍵なしでテスト用にいずれかを開くことができます。

利用可能なすべての基本クレート 

Scroll - インベントリにアイテムの水平なリボンが表示され、スクロールし、徐々に遅くなり、真ん中の当選アイテムで止まります。このタイプは、CrateExample.ymlとAdvancedExample.ymlの2つの例で使用されています。

CrateExample の実行 — アイテムの水平なリボンがスクロールし、当選アイテムで止まります

Cosmic — インベントリに選択できる複数の賞品が表示されます。プレイヤーは取りたい賞品をクリックします。10秒以内に何も選択されなかった場合、プラグインは自動的に1つの賞品を付与します。Casino — ティア（tiers）を持つクレート。アニメーションは最初にティアを決定し、次にその中の特定の賞品を決定します。 

QuadCrate — 開くと、ワールド内のプレイヤーの周りに4つの物理的なクレートブロックがスポーンします。プレイヤーはそれぞれに近づき、順番に開きます — それぞれが別々の賞品を提供します。 

Wonder — フルインベントリのウィンドウが表示され、そこからアイテムが徐々に消えていきます。残ったものが賞品になります。

鍵

各クレートは独自の鍵を使用します。物理的な鍵 — は、プレイヤーがインベントリに保持する、カスタムの外観、名前、および説明（lore）を持つ通常のアイテムです。仮想的な鍵はスペースを取りません — プラグインのデータベースに保存され、プレイヤーのアカウントに紐付けられます。

デフォルトでは、物理的なクレートブロックは両方の種類を受け入れます。この動作は、config.ymlで組み合わせごとに個別に変更できます。

鍵を受け取る際にプレイヤーのインベントリがいっぱいの場合、設定に応じて、プラグインは仮想的な鍵に変換するか、地面に落とします。鍵なしでクレートを開こうとすると、プレイヤーは押し戻されます。

管理者は、オフラインのプレイヤーからも鍵を与えたり奪ったり、1つのコマンドでオンラインの全プレイヤーに一度に鍵を配布したり、利用可能なすべてのクレートからランダムな鍵を与えたりすることができます。適切な権限を持つプレイヤーは、自分の仮想キーを他の人に譲渡できます。

クレートの物理的な鍵 — カスタム説明付きのアイテム

確率システム 

各賞品の確率は、パーセンテージではなく、重量 — クレートファイル内の Weight パラメータ — によって決定されます。重量の値が高いほど賞品が出やすく、低いほど出にくくなります。

最大範囲は、クレート内のすべての重量の合計です。3つの賞品の重量が10、15、25の場合、範囲は50になります。1つ目の確率は20％、2つ目は30％、3つ目は50％です。

パーセンテージに対するこのアプローチの利点：合計が100を超えないようにする必要はありません。相対的な値を設定し、残りを再計算することなく新しい賞品を追加できます。

コマンド

メインのプラグインコマンドは/crazycratesで、エイリアスとして/cratesと/ccがあります。プレイヤーは/keys（自分のキーを見る）と/crates（メニューを開く）にのみアクセスできます。

管理コマンド：

• /crazycrates give および /crazycrates take — オフラインのプレイヤーを含む、特定のプレイヤーに鍵を与えたり奪ったりします。

• /crazycrates giveall — オンラインのすべてのプレイヤーに同時に鍵を配布します。

• /crazycrates forceopen — プレイヤーのために無料で鍵なしでクレートを開きます。

• /crazycrates editor — ワールド内でのクレート配置モード：ブロックを指してクレートをバインドします。

• /crazycrates debug — 設定をテストするために、クレートのすべての賞品を一度に受け取ります。

• /crazycrates mass-open — 指定された数のクレートを一度に大量に開きます。

• /crazycrates reload — サーバーを再起動せずにすべての構成を再ロードします。

• /crazycrates migrate — 他のプラグインからクレートをインポートするか、従来のファイル形式を変換します。

権限は3つのワイルドカードに分けられます。プレイヤー向けのcrazycrates.players.*、管理者向けのcrazycrates.admin.*、schematicsを使用するためのcrazycrates.schematic.*です。プレイヤーは、個別の権限を介して/giveallの大量配布から除外できます。

設定

すべてのプラグインファイルはplugins/CrazyCrates/フォルダにあります。メインはconfig.ymlで、グローバルなサーバー設定が集中しています。クレートはcrates/サブフォルダに保存され、それぞれが別々のファイルになります。examples/ フォルダには開発者からの例が含まれていますが、編集しないでください。/crazycrates reloadのたびに完全に上書きされます。すべてのメッセージテキストはmessages.ymlに抽出され、個別に編集されます。

config.ymlでは、いくつかの点に注意する必要があります。クレートの上のホログラムは、サーバーに DecentHolograms、FancyHolograms、または CMI がインストールされている場合、自動的に表示されます — プラグイン自体がそれらを拾います。何もない場合、ホログラムは単に表示されません。プレイヤーへのメッセージは、サーバーの設定方法に応じて、チャットまたはアクションバー（action bar）に送信できます。キーとクレートでのアクションのログ記録は、コンソールとファイルに対して個別に有効になります。ファイルのログは再起動時にzipにアーカイブされます。

各クレートは独自のファイルで構成されています。アニメーションの種類と賞品リストの他に、物理キーの外観、ブロックの上のホログラムのテキスト、プレビューウィンドウのサイズとデザイン、スクロール中および完了時のサウンド、結果が満足のいくものでなかった場合に賞品を再ロール（reroll）する機能などを定義します。

結論

CrazyCratesは、寄付ストアとサバイバルでのゲーム内進行の両方にアニメーションシステムを追加します。重量ベースの確率システムは、アクティブに編集する際にパーセンテージよりも便利です — 毎回リスト全体を再計算する必要はありません。

寄付システムを持つPvPおよびサバイバルサーバーの場合、CrazyCratesは便利な選択です。アニメーションなしの1つのクレートが必要なシンプルなサーバーの場合、QuickCrateと最小限の設定で十分です。