CraftersLife.event.fireworks_display

CraftersLife 夏イベントの最終日付近に開催する花火大会向け Paper プラグインです。

Paper 1.21.11 / Java 21 を対象に、Velocity 構成では花火を表示したい Paper サーバーへ導入して使います。

機能

• config.yml に複数の花火イベントを登録
• 花火の色、形、フェード色、発射数、発射間隔、開催時間、打ち上げ座標・範囲を設定
• 文字を花火で表示。複数行、表示切替、フェードイン/アウト、文字別色、位置別色、グラデーションに対応
• /fireworks start [event] で手動開始
• /fireworks stop [event|all] で停止
• /fireworks reload で設定再読み込み
• 任意の日時スケジュールによる自動開始

コマンド

コマンド	用途
/fireworks help	ヘルプを表示
/fireworks list	登録イベント一覧を表示
/fireworks config [event]	イベント設定の概要を表示
/fireworks start [event]	花火イベントを開始
/fireworks stop [event|all]	花火イベントを停止
/fireworks reload	config.yml を再読み込み

権限

• crafterslife.fireworks.command: 表示系コマンド
• crafterslife.fireworks.admin: 開始・停止・再読み込み

ビルド

./gradlew build

Windows では次のコマンドでもビルドできます。

.\gradlew.bat build

生成された Jar は build/libs/CraftersLife.event.fireworks_display-1.0.0.jar に出力されます。

仕様

詳しい仕様と運用方針は docs/SPEC.md を参照してください。

文字花火の設定例

text-display:
  enabled: true
  anchor:
    x: 0.5
    y: 96.0
    z: 36.0
  facing: SOUTH
  frames:
    - code: "opening"
      text:
        - "CRAFTERSLIFE"
        - "FINAL"
      hold-seconds: 5.0
      fade-in-seconds: 1.0
      fade-out-seconds: 1.0
      gradient:
        enabled: true
        mode: HORIZONTAL
        colors:
          - "#FF3355"
          - "#FFD166"
          - "#05FFA1"