Files
mod_town_pack/docs/ja.md
T

5.8 KiB

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

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

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

収録内容

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

町の入口の背景:石畳の街角に立つ、緑と白の日除けがついた角建物。

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

玄関の背景:暖かな光のホールに、木の階段、肘掛け椅子、ベンチ、額装された絵。

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

バーの背景:梁の見える天井の下、提灯に照らされたテーブル、カウンター、瓶の棚。

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

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

町の入口の深度マップ:同じ構図のグレースケール版。

深度画像を直接目にすることはありません。背景を表示するとき、ゲームは <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 の最初のシーン:町の入口の背景に「夕暮れの町。街灯はもうともり、石畳を涼しい風が吹き抜けていく」の一文。

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

Cthangover の町の入口:同じ背景に「家に帰る」と「路地を調べる」の選択肢。

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

自分のゲームで使う

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

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

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

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

background town/town_entry
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 が担います。