mod_village_pack/docs/ja.md

Village Pack — RPG マップとバトルのアート

Village Pack は、RPG Plus の世界を支えるアートキットです。マップを描くためのタイルセット、主人公・村人・モンスターの歩行スプライト、バトル肖像、バトル背景を収録しています。すべてが一つの絵画的な 2.5D スタイルで描かれているため、これで組んだマップは一つの世界に見えます。

これはアートのみです。歩いて回れる村、長老の家、森、砂漠は、RPG Demo と RPG Plus のコンテンツ MOD が持つマップとイベントであり、歩行・衝突・戦闘は RPG エンジンの仕事です。Village Pack は、それらが使う絵を供給します。

収録内容

village タイルセット

デモ世界のすべてのマップが village タイルセットを使います。二つの部分からなります。

オブジェクトはセルに置かれます：コテージ、祠のアーチ、洞窟の入り口、木々、茂み、井戸、焚き火、街灯、柵、看板、樽、宝箱（閉じた状態と開いた状態）、作業台、そして薪・石・キノコのような拾える物。一番上にはコテージの内装——長老の家が使う、1枚の 12 × 10 の部屋画像があります。

サーフェスは領域全体を埋めるシームレスな地面テクスチャです：草、石畳の道、土、明るい石の床、木の床、岩の多い森の小道、水。

いくつかのタイルには RPG エンジン用の追加プロパティがあります：水は通行不可、街灯と窓は光源を持ち、夕暮れや夜にマップ上で光ります。

季節の植生

4つの植生タイルセットは、同じ木々・茂み・切り株・花を、夏、秋、葉のない晩秋、雪の冬で表現します：オーク、トウヒ、シラカバ、ヤナギ、カエデ、マツ、丸い茂みとベリーの茂み、切り株と洞のある切り株、ヒナギクとスミレ。

1つのマップが使うタイルセットはちょうど1つで、収録マップのどれもまだ植生タイルセットを使っていません。マップ作者向けに用意された素材です。

砂漠と雪

• desert：砂と岩のサーフェスに、砂漠のオブジェクト——日干しレンガの建物、市場の日除け、ヤシ、サボテン、枯れ草——が付きます。RPG Plus の砂漠マップ Dry March はこれで描かれています。
• snow：新雪、氷、そして2種類の踏み固められた道（packed_snow と、さらに足跡の深い trampled_snow）に、小屋、荷車、井戸、岩、茂み、雪をかぶったトウヒ。収録マップはまだ使っていません。

キャラチップ：歩行スプライト

各キャラチップは 3 × 4 枚のシートです：4方向（下・左・右・上）それぞれに歩行3フレーム。村のセットには主人公、長老、村人、商人、スライム、狼がいます。砂漠のセットにはサソリ、甲虫、そして閉じた状態と開いた状態の樽が加わります。

バトル肖像と背景

大きな肖像は戦闘中の戦い手を示します：主人公、スライム、狼、そして砂漠のサソリと甲虫。

草原・森・砂漠の前哨の3枚の背景が、マップ上で始まった戦闘の背景として使われます。草原と森にはライティングシステム用の _depth が付いています。

どこで見られるか

Village Pack は rpg_plus ゲームの一部です。そのゲームでは：

• 村、長老の家、森、森の祠は village タイルセットで描かれ、
• 砂漠マップは desert を使い、
• 長老・商人・村人・狼・スライム・サソリ・甲虫がパックのキャラチップでマップを歩き、
• 戦闘では肖像が表示され、マップのシーンは village/meadow、village/forest、desert/outpost を戦闘背景にします。

タイルマップエディターは、選択したタイルセットをパレットとして表示します。これは長老の家を開いたところ：コテージの内装、オブジェクト、サーフェスの見本が village タイルセットです。

自分の RPG コンテンツで使う

1. 自分のゲームのコレクションに village_pack を含めます。エンジン MOD rpg が必要です。
2. そのアートを使うコンテンツ MOD の depends リストに village_pack>=1 を追加します。
3. アートは名前で参照します：

// マップ：マップ全体で1つのタイルセット
{ "Kind": "rpg_map", "Items": [ { "Id": "my_glade", "Tileset": "village" /* … */ } ] }

// キャラチップで描かれたマップイベント
{ "Id": "old_man", "X": 5, "Y": 3, "Sprite": "village/elder" }

// キャラクターのバトル肖像
{ "Id": "my_wolf", "Image": "characters/village/wolf" }

{
  "name": "my_glade",
  "defaultBackground": "village/meadow"
}

タイルセットの名前は village、vegetation_summer、vegetation_autumn、vegetation_bare、vegetation_winter、desert、snow です。キャラチップは village/<name> と desert/<name>、バトル背景は village/meadow、village/forest、desert/outpost です。

いちばん簡単な描き方は RPG マップエディターです。マップのタイルセットに village を選べば、タイル番号を打ち込む代わりにパレットで描けます。

制限と差し替え

• マップにつきタイルセットは1つ。village タイルセットと植生タイルセットを同じマップで混ぜることはできません。
• アートには光と遠近が焼き込まれています。2.5D の見た目のために描かれており、アイソメトリックレンダラーも同じ絵を再利用するため、非常に高いオブジェクトは描かれた角度を保ちます。
• 自分のゲーム向けに絵を差し替えるには、同じ相対名のファイルを自分の MOD に置き、village_pack に依存します。後から読み込まれる依存側が勝ちます。
• 元の生成画像・プロンプト・編集可能なソースはゲームの外にアーカイブされています。MOD に入っているのは実行用の絵とタイルセット定義だけです。

表示がおかしいとき

1. 地面やオブジェクトのないマップは、たいてい Tileset 名の打ち間違いか依存関係の欠落です。
2. キャラクターが見えない：Sprite 名と、キャラチップのシートが 3 × 4 フレームかを確認してください。
3. 戦闘の背景が無地：マップのシーンに defaultBackground がありません。