SkinConfig.jsonの設定
スキン全体の名称、バージョン、フォント設定、BGMのループポイントなどを設定するためのファイル です。
注記
TODO: バージョン情報
📁 ファイルの場所
📁 [ SkinName ]
┗ 📄 SkinConfig.json
🛠️ 設定内容
{
"skinName": "",
"skinVersion": "",
"skinDescription": "",
"mainFontPath": "",
"detailFontPath": "",
"nameplateEnglishFontPath": "",
"nameplateEnglishLetterSpacing": 0,
"mainFontOffsetX": 0,
"mainFontOffsetY": 0,
"detailFontOffsetX": 0,
"detailFontOffsetY": 0,
"entryBGMIntroTimeMs": 0,
"songSelectBGMIntroTimeMs": 0,
"resultBGMIntroTimeMs": 0,
"playerCustomizeBGMIntroTimeMs": 0
}
📖 各項目の説明
スキン情報
スキンの基本情報
以下の項目は、スキンの名称やバージョンを定義する最も基本的な情報です。
| 項目名 | データ型 | 説明 |
|---|---|---|
skinName | String | スキンの名前です。 |
skinVersion | String | スキンのバージョンです。 |
skinDescription | String | スキンの説明です。 |
フォント情報
フォントパス指定
以下の項目では、スキン内で使用するフォントファイルのパスを指定します。
指定するフォントは、スキンの Font フォルダ内 に配置する必要があります。
| 項目名 | データ型 | 説明 |
|---|---|---|
mainFontPath | String | 曲名など、画面内でメインに使用されるフォントを指定します。 |
detailFontPath | String | ジャンル説明など、補足情報表示に使用されるサブフォントを指定します。 |
nameplateEnglishFontPath | String | ネームプレートの英数字部分に使用されるフォントを指定します。 |
ヒント
- フォントパスは
Fontフォルダからの相対パス を指定してください。 - 対応形式は TrueType(
.ttf)や OpenType(.otf)など、ゲームが対応する形式に限られます。
フォント不足時の挙動
各項目で指定されているパスのフォントが存在しない場合、 Default.otf を参照します。
Default.otf も存在しない場合、エラーが表示され、ゲームを正しく起動することが出来ません。
フォント座標調整
以下の項目では、各フォントの描画位置や文字間隔を数値で調整できます。
値はすべて相対的なオフセットとして扱われます。
| 項目名 | データ型 | 説明 |
|---|---|---|
nameplateEnglishLetterSpacing | Integer | ネームプレートの英数字における文字間隔を調整します。負の値を指定すると、文字同士の間隔が狭くなります。 |
mainFontOffsetX | Integer | メインフォントの描画位置に対する X 座標のオフセットです。 |
mainFontOffsetY | Integer | メインフォントの描画位置に対する Y 座標のオフセットです。 |
detailFontOffsetX | Integer | 詳細フ ォントの描画位置に対する X 座標のオフセットです。 |
detailFontOffsetY | Integer | 詳細フォントの描画位置に対する Y 座標のオフセットです。 |
BGM情報
各シーンにおいて、BGM が最後まで再生されると、以下のプロパティで指定した時間(ミリ秒)に戻ってループ再生されます。
| 項目名 | データ型 | 説明 |
|---|---|---|
entryBGMIntroTimeMs | Integer | エントリー画面の BGM におけるループ開始位置(イントロ時間)です。 |
songSelectBGMIntroTimeMs | Integer | 選曲画面の BGM におけるループ開始位置(イントロ時間)です。 |
resultBGMIntroTimeMs | Integer | リザルト画面の BGM におけるループ開始位置(イントロ時間)です。 |
playerCustomizeBGMIntroTimeMs | Integer | プレイヤー設定画面の BGM におけるループ開始位置(イントロ時間)です。 |