Teragonで詰まりやすい代表的なトラブルと、その原因・直し方をまとめます。原因の多くはパス設定かマップの作成順序に行き着きます。解決しないときはTeragon公式Discordの #discussions も活用してください。
POIが配置されない／おかしい
次のような症状は、ほぼすべて同じ原因＝パス設定です。
- 町のタイルはあるのにPOIが乗っていない
- 原野（wilderness/region）POIが重なって配置される
- POIを選択・ホバーしてもサムネイルが出ない（※少しズームしないと出ません）
- 原野POIがマップ端から見切れている
- ゲーム内で町だけが周囲より高く持ち上がり、町の周りに段差（崖）ができる
- POIがあるべき場所に、岩盤まで四角く掘れた穴ができる
直し方：
- バニラPOIが出ない → Game Directory がゲームの
.exeがある正しいフォルダを指しているか確認。 - カスタムPOIが出ない → Add Source Path がPOIのある場所（Modsフォルダやそのサブフォルダ等）を正しく指しているか確認。Modsフォルダ全体や各MODのトップを指している場合は、Subdirectories（サブフォルダ）チェックを有効にすること。
- POI Property List のタイプミス → リスト内のPOI名がファイル名と完全一致していないと見つかりません。
中身が空っぽの町（Hollow Town）
外周だけあって中心が空っぽの町ができることがあります（山や湖を町が取り囲んでいる場合とは別物）。これは Town Property List で max size が約8タイルより大きいのに center パラメータが無い町が原因です。8タイル超の町には center パラメータを付けると解消します。
Update Preview でデスクトップに落ちる／マップ欠落の致命的エラー
最も多い原因は、まだ作っていない（または名前が違う）マップを参照していることです。
Update Previewで名前を指定している各マップ（Biome Map / Region Map 等）は、そのマップを作成するコマンドを先に実行しておく必要があります。例：バイオームマップを作る前に Biome Map Name を入れて Update Preview するとクラッシュ（v0.50.0以降は改善）。- 名前のタイプミスも同じエラーになります。作成時と参照時で名前が一致しているか確認。
- マップを作るコマンドが無効化（disabled）されていないか確認。なお、同じマップを作るコマンドが複数あって一部だけ有効、という状態は問題ありません（各マップにつき最低1つ有効であればOK）。
町がまったく生成されない
Create Towns で町ができない主な原因は次の通りです。
- 地形が荒すぎる … 町を置くには平らな場所が要ります。
Create Townsの Flatness Threshold や Elevation Deviation Threshold を上げる、または丘・山・湖を減らして平地を確保する。 - 地形が高すぎる／低すぎる …
Create Townsで町の最低・最高標高を設定できます。地形がその範囲外だと町は作られません。背の高いPOIや地下深くまで伸びるPOIは、標高に余裕がないと配置できない点にも注意（例：250mに町を置くと最高255mまで5mしかなく、5mより高いPOIは置けない）。 - パスが間違っていてPOIが見つからない …
Tools → Initial Setupでパスを確認。これが原因のときは、プレビュー上では町が入るはずの平地が見えるのに何も無い、という見え方になります。
困ったら、まず Console（F7）タブ を開いてエラーメッセージを探すのが近道です（保存ログには詳細が出ません）。原因の切り分けには、下部の Interrupt で各コマンドの直後に止めてプレビュー確認する方法も有効です。