共有スキンシステムの概要

ここでは、TaikoNauts β2026.08.15より実装された「共有スキンシステム」について説明します。

共有スキンシステムとは

共有スキンシステムは、キャラ・ぷちキャラ・ネームプレートを、複数のスキンから共通して利用するための機能です。

通常、これらの素材は各スキンのフォルダ内に配置します。共有対象の素材を Shared フォルダへ配置すると、スキンを切り替えても同じ素材を引き続き利用できます。

important

共有できるのは、以下の3種類のみです。

キャラ（ Chara ）
ぷちキャラ（ PuchiChara ）
ネームプレート（ NamePlate ）

背景や効果音など、スキン全体の素材が共有される機能ではありません。

📁 フォルダ構成

共有スキンは、通常のスキンと同じ Image/99.Common/Cosmetic 配下に素材を配置します。

📁 Skins
 ┣ 📁 [ SkinName ]
 ┃ ┗ 📁 Image
 ┃   ┗ 📁 99.Common
 ┃     ┗ 📁 Cosmetic
 ┃       ┣ 📁 Chara
 ┃       ┣ 📁 PuchiChara
 ┃       ┗ 📁 NamePlate
 ┗ 📁 Shared
   ┗ 📁 Image
     ┗ 📁 99.Common
       ┗ 📁 Cosmetic
         ┣ 📁 Chara
         ┃ ┗ 📁 [ AssetId ]
         ┣ 📁 PuchiChara
         ┃ ┗ 📁 [ AssetId ]
         ┗ 📁 NamePlate
           ┗ 📁 [ AssetId ]

[ AssetId ] フォルダの内部構成は、通常のスキンへ配置する場合と同じです。

種類	配置先	関連ドキュメント
キャラ	`Image/99.Common/Cosmetic/Chara/[ AssetId ]`	キャラクター
ぷちキャラ	`Image/99.Common/Cosmetic/PuchiChara/[ AssetId ]`	ぷちキャラ
ネームプレート	`Image/99.Common/Cosmetic/NamePlate/[ AssetId ]`	-

🛠️ 共有フォルダの設定

共有フォルダの場所は、 Config/GameConfig.json の sharedSkinPath で設定できます。

{
  "skinPath": "Skins/SimpleStyle/",
  "sharedSkinPath": "Skins/Shared/"
}

項目名	データ型	説明
`sharedSkinPath`	`String`	共有スキンのルートフォルダを指定します。相対パスと絶対パスのどちらも使用できます。

`sharedSkinPath` を省略した場合

sharedSkinPath が空文字、空白、または未設定の場合は、選択中のスキンと同じ階層にある Shared フォルダが自動的に使用されます。

たとえば、 skinPath が次の設定の場合、共有フォルダは Skins/Shared になります。

{
  "skinPath": "Skins/SimpleStyle/",
  "sharedSkinPath": ""
}

📁 Skins
 ┣ 📁 SimpleStyle
 ┗ 📁 Shared  ← 自動的に参照される共有フォルダ

ヒント

通常は sharedSkinPath を空のままにし、各スキンと同じ階層へ Shared フォルダを配置するだけで利用できます。

🔍 素材の読み込みルール

ゲームは、共有フォルダと選択中のスキンの両方から素材を検索します。

同じIDの素材が存在する場合

選択中のスキンにある素材が優先されます。

1. [ SkinName ]/Image/99.Common/Cosmetic/[ Type ]/[ AssetId ]
2. Shared/Image/99.Common/Cosmetic/[ Type ]/[ AssetId ]

たとえば、選択中のスキンと Shared の両方に Chara/default が存在する場合は、選択中のスキン側の default が使用されます。

この仕組みにより、普段は共有素材を使用しながら、特定のスキンだけ同じIDの素材を差し替えることができます。

素材の並び順

検出された素材は、 AssetId の文字列順に並びます。

📝 AssetIdの命名規則

AssetId には、次の規則を満たすフォルダ名を使用してください。

先頭は半角英小文字（ a ～ z ）
2文字目以降は、半角英小文字・半角数字・ピリオド・アンダースコア・ハイフンを使用可能
半角英大文字、空白、日本語は使用不可

使用できるIDの例:

default
donchan01
festival-red
sample_chara
author.character

使用できないIDの例:

Default       # 半角英大文字を含む
01donchan     # 先頭が数字
my chara      # 空白を含む
キャラ        # 日本語を含む

警告

命名規則に合わないフォルダは読み込まれません。共有フォルダと選択中のスキンのどちらに配置した場合も、同じ命名規則が適用されます。

🔄 数値Index指定からID指定への変更

共有スキンシステムの導入に伴い、キャラ・ぷちキャラ・ネームプレートの指定方法が、フォルダの並び順を表す数値Indexから、フォルダ名と一致する文字列IDへ変更されました。

設定ファイル	旧プロパティ	新プロパティ	データ型	説明
`PlayerConfig.json`	`donchanType`	`donchanId`	`String`	使用するキャラの `AssetId` を指定します。
`PlayerConfig.json`	`puchiCharaType`	`puchiCharaId`	`String`	使用するぷちキャラの `AssetId` を指定します。
`NamePlateConfig.json`	`namePlateType`	`namePlateId`	`String`	使用するネームプレートの `AssetId` を指定します。

設定例:

PlayerConfig.json
{
  "donchanId": "default",
  "puchiCharaId": "festival-red"
}

NamePlateConfig.json
{
  "namePlateId": "default"
}

新プロパティへ指定する値は、対象素材の [ AssetId ] フォルダ名と完全に一致させてください。たとえば、素材の配置先が Chara/festival-red の場合は、 donchanId に "festival-red" を指定します。

旧プロパティから移行する場合

旧プロパティの数値は、同じ並び順の素材IDへは変換されません。旧プロパティのみが設定されている場合は default が使用されるため、必要に応じてプレイヤーカスタマイズ画面から素材を選び直してください。

導入手順

選択中のスキンと同じ階層に Shared フォルダを作成します。
Shared/Image/99.Common/Cosmetic の下に、素材の種類に応じたフォルダを作成します。
命名規則に従った AssetId フォルダを作成し、素材を配置します。
TaikoNautsを起動し、プレイヤーカスタマイズ画面から追加した素材を選択します。

共有フォルダを別の場所へ配置する場合は、 Config/GameConfig.json の sharedSkinPath にそのフォルダを指定してください。

共有スキンシステムとは​

📁 フォルダ構成​

🛠️ 共有フォルダの設定​

sharedSkinPath を省略した場合​

🔍 素材の読み込みルール​

同じIDの素材が存在する場合​

素材の並び順​

📝 AssetIdの命名規則​

🔄 数値Index指定からID指定への変更​

導入手順​