このプロジェクトについて

# Creator Mods Suite **Creator Mods Suite**は、Minecraft 1.21.1をプレイするMinecraftコンテンツクリエイター、YouTuber、配信者向けに特別に設計された包括的なMODスイートです。収録目的でゲームプレイを強化する8つの独立して切り替え可能な機能を提供し、単一のマルチローダーコードベース内でNeoForgeとFabricの両ローダーをサポートします。 ## 主な目的 このスイートはMinecraftの「ディレクターズツールキット」として機能し、クリエイターがコマンドやキーバインドを使って複雑なイベントを発生させ、カメラアングルを管理し、ゲームルールをその場で変更できるようにします。これにより、収録セッション中に一時停止したり、メニューに戻ったり、ゲームを再起動したりする必要がなくなり、スムーズでプロフェッショナルな映像を確保できます。 ## 主な機能 このスイートは8つの異なるモジュールで構成され、それぞれが特定の創作機能を担います: 1. **Director's Toolkit (`/toolkit`)**:画面上のカチンコ、テイクマーカー、モブ/プレイヤーのフリーズスイッチ、ウェーブスポナー、アリーナスナップショット、カメラブックマーク、クリーンフレームHUDトグルを備えた収録支援ツール。テイクを正確に制御できます。 2. **Ashen Colossus (`/colossus`)**:GeckoLibによって動作する、アニメーション付きの3フェーズボス戦。衝撃波スラム、溶岩の雨、ミニオンウェーブ、炎の輪による激怒フェーズなどのメカニクスを含みます。 3. **Power Kit (`/power`)**:ダッシュ、ファイアバースト、グラウンドパウンド、エンダープル、シールドドーム、モブフリーズといった6つのキーバインド発動能力を提供。サーバー権威のクールダウンと、ホットバー行による視覚的フィードバックを含みます。 4. **Rule Engine (`/rule`、`/shop`)**:11のスタッカブルなオプション(ランダムドロップ、クラフト増倍、溶岩フロア、巨大モブなど)でゲームルールをライブ変更可能。簡単に切り替えられるデータパックプリセットをサポートします。 5. **Evolve (`/evolve`)**:5段階のプレイヤー変身システムで、各段階でサイズ、ステータス強化、パッシブ能力を獲得し、パーティクルエフェクトとモデル交換を伴います。 6. **Event Director (`/event`)**:ブラッドムーン、隕石、シージ、ラッキーレイン、ヴォイドライズなどの演出されたワールドイベントを発生させます。イベントはフェーズベースで、コマンドでタイミング変更、スキップ、停止が可能です。 7. **Arsenal (`/arsenal`)**:Grapple Blade、Storm Bow、Gravity Hammer、Soul Scytheという4つのユニーク武器を導入し、それぞれ異なるメカニカルな相互作用を持ちます。 8. **Cursed Vault (`/vault`)**:呪われた祭壇を含むジグソーダンジョン構造で、ミニボス(Vault Keeper)を召喚し、その撃破時に開く封印されたチェストを配置。ワンコマンドのリセット機能を含みます。 ## クリエイター向け設計 * **コマンドライン制御**:すべての機能はチャットコマンド(例:`/colossus phase 3`、`/event skip`)で制御可能で、ゲームプレイを中断せずにリアルタイム調整を可能にします。 * **サイレントモード**:コマンドはチャットログではなくアクションバーにのみフィードバックを出力するよう設定でき、収録映像の乱雑さを防ぎつつ、エラーメッセージは操作者に表示されます。 * **独立した切り替え**:8つの機能はそれぞれ設定またはコマンドで個別に有効/無効化できます。無効化された機能はゲームワールドに何も登録せず、未使用時のパフォーマンスオーバーヘッドや視覚的干渉をゼロにします。 * **非侵入型HUD**:すべてのカスタムHUDレイヤーはバニラのF1フルスクリーンモードを尊重し、コマンドでプレイヤーごとにクリーンアップできるため、マルチカメラ構成を支援します。 * **カメラ安全性**:クリエイティブまたはスペクテイターモードのプレイヤーは敵対的メカニクス(ボス攻撃、環境ハザード)の対象外となり、カメラオペレーターがシーンを安全に飛行できます。 ## 技術的詳細 * **互換性**:Minecraft 1.21.1をNeoForge 21.1.250+およびFabric Loader 0.19.5+でサポート。Java 21が必要です。 * **アーキテクチャ**:ゲームプレイロジック用の共有`common/`モジュールを使用し、プラットフォーム固有のエントリポイントとMixin用に別々の`fabric/`および`neoforge/`モジュールを持ちます。これによりローダー間で同一の動作を保証します。 * **設定**:単一の`config/creatormods.json`ファイルで管理。バランス値はハードコードされた定数で、動的データはMinecraftデータパックを使用します。 * **テスト**:プロジェクトには広範なテストが含まれ、ローダーごとに486のJUnit 5ユニットテストと134のワールド内GameTestがあり、ロジック、ネットワーキング、インタラクティブなゲームプレイシナリオをカバーします。 * **アセット**:現在のアセットはプログラムで生成されたプレースホルダー(Pythonテクスチャ、ffmpegオーディオ)で、リソース不足なくMODが動作することを保証します。実際のアーティスティックアセットは計画されていますが、まだ含まれていません。 ## インストール ユーザーはソースからMODをビルドするか、提供されているJARがあればそれを使用する必要があります。依存関係にはGeckoLib(アニメーションに必要)とFabric API(Fabricビルド用)が含まれます。完全な機能を得るには、MODをクライアントとサーバーの両方にインストールする必要があります。 ## ライセンス このプロジェクトはMIT Licenseの下でライセンスされており、変更の公開義務なしにフォーク、改変、プライベートサーバーでの使用が許可されています。