# Town Pack — 町・家・バーの背景とバーの環境音

Town Pack は、小さな町を舞台にした物語のための完成済み背景素材です。描かれた背景3枚——町の入口の街角、家の玄関、夜のバー——と、バーの環境音ループを収録しています。物語・シーン・キャラクターは含まないので、どこで画像を見せるかはゲームが決めます。

内蔵の2つのゲームがすでにこのセットを共用しています。**Cthangover** は町の入口と玄関を、**My Novel** テンプレートは3枚の背景とバーの環境音をすべて使います。どちらのゲームも同じファイルをこの mod から読み込むため、Town Pack 側の修正や画質向上は両方に届きます。

## 収録内容

町の入口 `town/town_entry`：縞模様の日除けがかかった店々が並ぶ、石畳の街角です。

![町の入口の背景：石畳の街角に立つ、緑と白の日除けがついた角建物。](assets/town_entry.jpg)

家の玄関 `home/vestibule`：階段、肘掛け椅子、額絵のあるホールです。

![玄関の背景：暖かな光のホールに、木の階段、肘掛け椅子、ベンチ、額装された絵。](assets/vestibule.jpg)

バー `bar/bar`：提灯の灯るテーブル、カウンター、瓶の棚です。

![バーの背景：梁の見える天井の下、提灯に照らされたテーブル、カウンター、瓶の棚。](assets/bar.jpg)

バーの環境音 `bar/bar_ambient`：Ambience サウンドチャネル用の、バーの雰囲気を収めた Ogg Vorbis ループです。

3枚の画像はいずれも 1920 × 1024 です。それぞれに、同じ名前に `_depth` という接尾辞を付けたグレーの対応ファイルがあります：

![町の入口の深度マップ：同じ構図のグレースケール版。](assets/town_entry_depth.jpg)

深度画像を直接目にすることはありません。背景を表示するとき、ゲームは `<name>_depth` も読み込み、ライティングシステムに渡します。システムはこれを使って、シーンの上に置かれた光を計算します。深度画像のない背景も、普通に表示されます。

## どこで見られるか

- **Cthangover:** `town_entry` シーン（町の入口）と `home_vestibule` シーン。
- **My Novel テンプレート:** `my_novel_town`、`my_novel_home`、`my_novel_bar`。バーのシーンでは `bar/bar_ambient` も鳴ります。

同じ町の入口が、My Novel テンプレートでは物語の一行とともにゲームの幕を開けます：

![My Novel の最初のシーン：町の入口の背景に「夕暮れの町。街灯はもうともり、石畳を涼しい風が吹き抜けていく」の一文。](assets/reuse-my-novel.jpg)

そして Cthangover では、同じ絵の上を別の物語が自分の選択肢で彩ります：

![Cthangover の町の入口：同じ背景に「家に帰る」と「路地を調べる」の選択肢。](assets/reuse-cthangover.jpg)

Town Pack は両方のゲームのコレクションに含まれ、一緒に読み込まれます。インストールしても、ほかのゲームにこれらの場所が追加されるわけではありません。背景を使うのは、ゲーム自身のシーンです。

## 自分のゲームで使う

1. 自分のコンテンツ mod の `depends` リストに `town_pack>=1` を追加します。
2. ゲームのコレクションに `town_pack>=1` を加えます。My Novel テンプレートの **Assets** ブロックがその例です。
3. リソースは下記の名前で参照します。名前は `backgrounds/` と `sounds/` からの相対で、拡張子は付きません。

```jsonc
// mods/my_game/manifest.json — 既存のリストに追加
"depends": ["town_pack>=1"]
```

テンプレートの `my_novel_bar` シーンから取った、バーを表示して環境音を鳴らすシーンです：

```json
{
  "name": "my_bar",
  "defaultBackground": "bar/bar",
  "defaultAmbient": "bar/bar_ambient"
}
```

シナリオは会話の途中で絵を切り替えることもできます：

```scenario
background town/town_entry
text "こんな時間、通りはひっそりとしている。"
```

使える名前は次のとおりです：

```text
town/town_entry     backgrounds/town/town_entry.png
home/vestibule      backgrounds/home/vestibule.png
bar/bar             backgrounds/bar/bar.png
bar/bar_ambient     sounds/bar/bar_ambient.ogg
```

## 自分のゲーム向けに画像を差し替える

Town Pack を編集せずに画像を差し替えるには、自分の mod に同じ相対名のファイル（例：`backgrounds/bar/bar.png`）を置き、その `depends` に `town_pack>=1` と書きます。所有者に依存する mod は後から読み込まれ、そちらが優先されます。背景を差し替えるときは、同名の `_depth` ファイルも一緒に置いてください。そうしないと Town Pack の元の深度画像がそのまま見つかり、光が古い絵の構図に合わせて落ちてしまいます。

依存関係がなければ、同じ名前を置く2つの mod の優先順位は未定義です。この問題はリソースマップツールがエラーとして報告します。

## うまく表示されないとき

1. 背景が真っ黒、または表示されない場合は、名前の打ち間違いがまず疑わしいです。名前は大文字小文字を区別し、区切りは `/` です。
2. Town Pack がインストールされているだけでなく、起動したゲームに含まれているか確認してください。
3. バーの音が鳴らない：シーンの `defaultAmbient` が `bar/bar_ambient` になっているか、**Settings → Sound** で **Ambience** が有効か確認してください。音の再生は Audio Engine mod が担います。