設定ファイルは 2種類 あります。それぞれ役割が異なります。
| ファイル | 場所 | 役割 |
|---|---|---|
| rarities.yml | plugins/GachaPlugin/ | 演出テンプレート（全ガチャ共通のデフォルト） |
| xxx.yml | plugins/GachaPlugin/gachas/ | ガチャの中身（1ファイル＝1ガチャ） |
各ガチャymlの上部に rarities セクションを書くと、そのガチャ専用の演出として使われます。
書かない場合は rarities.yml のデフォルトが自動的に適用されます。
ガチャyml内に rarities あり → そのガチャ専用の演出を使用
ガチャyml内に rarities なし → rarities.yml のデフォルトを使用
| やりたいこと | 変更するファイル | 変更する項目 |
|---|---|---|
| アイテムを追加・削除したい | gachas/xxx.yml | items セクション |
| 当選確率を変えたい | gachas/xxx.yml | 各アイテムの weight |
| このガチャ専用の演出を定義したい | gachas/xxx.yml の上部 | rarities セクションを追加 |
| 当選時のアイテム名の色を変えたい | ガチャyml上部 または rarities.yml | title_color |
| 当選時のサブタイトルの色を変えたい | ガチャyml上部 または rarities.yml | subtitle_color |
| 回転中のサブタイトルの文字をアイテムごとに変えたい | gachas/xxx.yml の items 内各アイテム | spin_label |
| 当選時の文字サイズを変えたい | ガチャyml上部 または rarities.yml | title.size |
| 当選時のSEを変えたい | ガチャyml上部 または rarities.yml | sound.name |
| 当選時のパーティクルを変えたい | ガチャyml上部 または rarities.yml | particle.pattern |
| ガチャの回転時間を変えたい | gachas/xxx.yml | spin.duration_ticks |
| 回転速度を変えたい | gachas/xxx.yml | spin.interval_start / interval_end |
| 回転中のSEを変えたい | gachas/xxx.yml | spin.sound |
| 焦らし演出を変えたい | gachas/xxx.yml | suspense セクション |
| ガチャ開始のチャット通知を変えたい | gachas/xxx.yml | announce.on_start.message |
| ガチャを新たに追加したい | gachas/ フォルダ | YMLファイルを新規作成 |
| 全ガチャのデフォルト演出をまとめて変えたい | rarities.yml | 対象レア度の設定を変更 |
番号ごとにレア度の演出を定義します。ガチャの中身で rarity: 1 のように番号を指定するだけで、その番号の演出が適用されます。
書く場所は2通りあります：
タイトル表示
| 項目 | 変更すると何が変わるか | 設定値の例 |
|---|---|---|
| title_color | 当選アイテム名の文字色 | &6（金色）&b（水色）&c（赤） |
| subtitle_color | サブタイトルの文字色（回転中・当選後の両方に適用） | &f（白）&7（灰色） |
| title.size | タイトルの文字サイズ | SMALL / NORMAL / LARGE |
| title.fadein | タイトルが出るまでの時間（tick） | 10 |
| title.stay | タイトルが表示される時間（tick） | 60 |
| title.fadeout | タイトルが消えるまでの時間（tick） | 20 |
サウンド
| 項目 | 変更すると何が変わるか | 設定値の例 |
|---|---|---|
| sound.name | 当選時に鳴るSE | UI_TOAST_CHALLENGE_COMPLETE |
| sound.pitch | 音の高さ（1.0が標準） | 0.5〜2.0 |
| sound.volume | 音量 | 0.0〜1.0 |