BurningTimesAi/공유/기획/FirstRising/맵/2026-09-28_FR_신규맵_실행순서.md

# FR 신규 맵 5종 — 실행 순서(PM 용)

작성 2026-09-28 · 스테이징 `C:\BurningTimes\FR_maps_staging\`

> **이 빌더는 Unity 에서 한 번도 실행해 보지 않았다.** 확인한 것은 ① 컴파일 오류 0(Unity 에 든 컴파일러) ② 맵 정의의 동선 검사(파이썬) ③ 프리팹 · 텍스처 경로 존재뿐이다.
> 첫 실행은 맵 하나(Graveyard)로 하고, 로그와 화면을 본 뒤 나머지를 돌리는 것을 권한다.

## ① 복사할 파일

스테이징의 `Assets\` 아래를 프로젝트의 같은 경로로 복사한다(`.meta` 는 없다 — Unity 가 만든다). 기존 파일을 덮어쓰는 것은 없다(전부 새 경로).

| 스테이징 경로 | 내용 | 개수 |
|---|---|---:|
| `Assets\BurningTimes\Editor\Maps\*.cs` | 공용 빌더(네임스페이스 `BurningTimes.EditorTools.Maps`) | 10 |
| `Assets\BurningTimes\Maps\<이름>\<이름>.map.json` | 맵 정의(데이터) | 5 |
| `Assets\BurningTimes\Maps\<이름>\Textures\FRMap_*.png` | 새로 만든 바닥 · 액체 텍스처(1024, 노멀 포함) | 20 |

```
robocopy C:\BurningTimes\FR_maps_staging\Assets C:\BurningTimes\FirstRising\Assets /E
```

빌더 파일 10개: `MapBuilder`(메뉴 · 진입점) · `MapDef`(데이터) · `MapContext`(실행 상태) · `MapGeometry`(거리 · 보이는 범위) · `MapPropPlacer`(소품 놓기 · 충돌 판정) · `MapTerrainBuilder`(바닥) · `MapLiquidBuilder`(물 · 용암 · 독액) · `MapDresser`(장면 묶음 · 담 · 띠) · `MapWalkMask`(걸을 수 있는 마스크 · 보이지 않는 벽) · `MapSceneAssembler`(씬 · 분위기).
숲 맵 빌더(`TV2DiabloMap.cs`)와 숲 맵 씬 · 에셋은 건드리지 않는다.

## ② 실행 명령

전제: **Play 중이 아닐 것 · 컴파일 중이 아닐 것 · 이름 없는(저장 안 한) 씬이 열려 있지 않을 것.** 지금 열려 있는 씬은 닫지 않는다(빌더가 새 씬을 덧붙여 열었다가 끝나면 닫고, 활성 씬을 되돌린다).

| 순서 | 명령 | 비고 |
|---|---|---|
| 1 | `unity command eval_file --file C:\BurningTimes\FR_maps_staging\unity_eval\map_refresh.cs --json` | 복사한 파일 가져오기 + 컴파일(이 프로젝트는 Auto Refresh 가 꺼져 있다). **Play 중이면 하지 말 것** |
| 2 | `unity command recompile_status` → 끝난 뒤 `unity command get_console_logs --severity error` | 컴파일 오류 0 확인 |
| 3 | `unity command eval_file --file ...\unity_eval\map_probe.cs --json` | 준비물 확인(아무것도 바꾸지 않는다). `builder=True` · 맵마다 `json=True tex=n/n` |
| 4 | `unity command eval_file --file ...\unity_eval\map_build_Graveyard.cs --detach` | 맵 하나 짓기. 끝나면 `Logs/bt_map_graveyard.txt` 마지막 줄이 `RESULT: OK` |
| 5 | 나머지: `map_build_RuinedKeep.cs` · `map_build_SpiderCave.cs` · `map_build_PlagueCatacomb.cs` · `map_build_HarborExecution.cs` (한꺼번에는 `map_build_all.cs`) | 모두 `--detach` |
| 6 | `Assets/Scenes/Maps/<이름>.unity` 를 열고 Play | 처음 열 때 맵 서브씬을 굽는다 |

- 코드에서 부를 때: `BurningTimes.EditorTools.Maps.MapBuilder.Build("Graveyard")` — 이름은 `Graveyard` · `RuinedKeep` · `SpiderCave` · `PlagueCatacomb` · `HarborExecution`. 로그 문자열을 돌려준다.
- 메뉴: `BurningTimes/Maps/<맵 이름>/Build` · `Remove` · `BurningTimes/Maps/모두 Build (5종)`.
- 걷어내기: `map_remove_<이름>.cs` 또는 메뉴 Remove — 빌더가 놓은 루트(`Map_<이름>` · `Map_<이름>_Ground` · `Map_<이름>_Bounds` · `Map_<이름>_Moon` · `Map_<이름>_Lights`)만 지운다. 씬 · 에셋 파일은 남는다.
- 다시 짓기: Build 를 다시 부르면 위 루트를 지우고 같은 시드로 다시 짓는다(결과 동일).

### 빌더가 만드는 것

| 경로 | 내용 |
|---|---|
| `Assets/Scenes/Maps/<이름>.unity` | 메인 씬 — `Assets/Scenes/TestVisual.unity` 사본(LevelEssential · TestMonstersController · SubScene · BT_Visual 유지). 이미 있으면 다시 복사하지 않는다 |
| `Assets/Scenes/Maps/<이름>/<이름>_Map.unity` | 맵 서브씬 — 빈 씬에서 새로 만든다 |
| `Assets/BurningTimes/Maps/<이름>/Terrain/` | 지형 데이터 · 지형 층 4개 |
| `Assets/BurningTimes/Maps/<이름>/Meshes/` | 보이지 않는 벽 메시 · 액체 수면 메시 |
| `Assets/BurningTimes/Maps/<이름>/Materials/` | 액체 재질 · 가림 반투명 재질(`Fade/`) |
| `Assets/BurningTimes/Maps/<이름>/Settings/<이름>_Volume.asset` | 후처리 볼륨 사본(맵마다 색 보정) |
| `Logs/bt_map_<이름>.txt` · `_layout.json` · `_props.json` · `_walkable.png` | 결과 기록(이름은 소문자) |

전역 저장(`AssetDatabase.SaveAssets`)은 쓰지 않는다. 우리가 만든 에셋만 `SaveAssetIfDirty` 로 저장하고, 씬은 위 두 개만 저장한다.

## ③ 예상 소요

**미확인(실측 없음).** 어림: 맵당 30~120초(지형 칠 512² · 소품 500~1,100개 놓기 · 담 따라가기). `unity command` 의 5초 제한을 넘으므로 반드시 `--detach`.
처음 Play 할 때 서브씬 굽기는 숲 맵 기준 20~30초 이상.

## ④ 실행 뒤 확인할 것

### 로그 `Logs/bt_map_<이름>.txt`

| 줄 | 기대값 | 어긋나면 |
|---|---|---|
| `RESULT:` | `OK` | `FAIL` 이면 그 뒤 예외 내용을 본다 |
| `이어지지 않는 조각` | **0 ㎡** | 0 이 아니면 어딘가 끊겼다 — 마스크 PNG 로 위치 확인 |
| `연결 복구: … 를 열었다` | 이 줄이 **없어야** 한다 | 있으면 그 공터로 가는 길을 소품이 막았다는 뜻(소품 배치 조정 필요) |
| `길 폭(중심선 기준 가장 좁은 곳)` | `6 m 미만 없음` | 몰이사냥 병목 기준 위반 — 그 길 가장자리 소품 확인 |
| `보스전 자리 안 … 막힌 칸` | **0 ㎡** | 보스 공터 안에 소품이 들어갔다 |
| `몬스터 무리 자리 … 확인 필요` | `없음` | 그 무리 자리가 막혔거나 둘레가 좁다 |
| `없는 프리팹 · 풀` | `없음` | 경로가 바뀌었다 |
| `점광원` | 48 이하 | 상한을 넘어 빛을 달지 않은 장치 수가 많으면 상한(`lightBudget`)이나 묶음의 빛을 조정 |
| `옛 셰이더(LOD 하위) 재질 교체 렌더러` | 참고 | 분홍색 소품이 보이면 이 수와 함께 보고 |
| `길 한가운데 · 공터 가운데라 놓지 않은 막는 소품` | 참고 | 많으면 묶음 자리가 길과 겹친다 |
| `담 '…'` | 먼 쪽 · 카메라 쪽 개수 | 0 이면 담이 안 놓였다 |

### 그림

- `Logs/bt_map_<이름>_walkable.png`(흰색 = 이동 가능 · 0.5 m 격자 · 위 = -z)을 `docs/img/<이름>_walkable_design.png`(소품 전 설계값)과 견준다. 길 · 공터의 큰 꼴이 같아야 하고, 소품 자리만 파여야 한다.
- 탑뷰 동선도 `docs/img/<이름>_topview.png` 와 실제 화면의 랜드마크 위치.

### 화면(Play · 캡처 권장 지점)

1. 시작 위치 — 야영지가 길을 막지 않는가 · 분위기 색이 테마대로인가.
2. 모아서 잡는 자리 — 가운데가 트였는가 · 키 큰 소품이 캐릭터를 가리지 않는가.
3. 보스전 자리 — 문 폭 · 둘레 담이 끊김 없이 이어지는가 · 바닥 띠가 읽히는가.
4. 담 — 조각이 겹치거나 비지 않는가 · 방향이 경계를 따라가는가.
5. 액체 — 수면 높이 · 색 · 발광 세기(용암 · 독액) · 물가가 지형에 자연스럽게 묻히는가.
6. 소품 크기 — 사람 키(약 1.8 m) 대비 어색한 것.
7. 충돌 — 보이는 것이 막고 비어 보이는 곳이 통과되는가(숲 맵과 같은 기준으로 자동 주행 `TVAutoPilot` · 배치 좌표는 `_layout.json`).
8. 몰이 — 무리를 끌고 고리를 돌 때 몬스터가 걸리는 곳.

## ⑤ 알려진 위험 · 미확인

| # | 내용 | 영향 | 대응 |
|---|---|---|---|
| 1 | **Unity 에서 실행한 적 없음** | 실행 중 예외 · 기대와 다른 배치 | 맵 하나로 먼저 실행 · 로그 확인. 예외가 나도 연 씬은 저장 없이 닫힌다 |
| 2 | 메인 씬은 `TestVisual.unity` **디스크 저장본**을 복사한다 | 보스 작업 구성(TVBossDirector 등)이 그대로 따라온다. 저장하지 않은 변경은 빠진다 | 뜻한 바가 아니면 복사 전에 TestVisual 을 저장하거나, 만든 메인 씬에서 정리 |
| 3 | 이름 없는 씬이 열려 있으면 새 씬을 덧붙여 만들 수 없다(Unity 제약) | 첫 Build 실패 | `map_probe.cs` 의 `untitledSceneOpen` 확인 |
| 4 | 프리팹 크기 · 방향은 놓을 때 재서 맞춘다 | 보이지 않는 조각(입자 · 그림자용 메시)이 크기에 섞이면 배율이 틀어질 수 있다 | `_props.json` 의 `scale` · 크기로 확인 → JSON 의 `fit`/`a`/`b` 조정 |
| 5 | MEP · MEP1 프리팹의 높이 축 미확정 | 목표 높이(`fit h`)로 적은 동굴 벽 · 석순 · 수정 · 버섯은 빌더가 실측하므로 영향 없음. 배율(`fit s`)로 적은 것은 숲 맵에서 쓴 값 | — |
| 6 | 불꽃 색 바꾸기(녹색 · 보라)는 입자 시작 색에 곱하는 방식 | 재질에 따라 색이 안 바뀔 수 있다 | 화면 확인 |
| 7 | 담은 경계선을 따라가며 한 칸씩 놓는다 | 굽은 곳 · 좁은 곳에서 겹치거나 빌 수 있다 | `seg`(한 칸 길이) · `gap` 조정 |
| 8 | 낭떠러지(`void`)는 지형만 파낸다(수면 없음) | 바닥 텍스처가 보여 구덩이처럼 보일 수 있다 | 어두운 판 · 안개 추가 검토 |
| 9 | 몬스터가 보이지 않는 벽 · 소품을 피하는 방식 미확인 | 몰이 중 걸림 | Play 실측 |
| 10 | 몬스터 구역의 몬스터 번호는 본뜬 씬(TestVisual) 값을 물려받는다 | 테마와 다른 몬스터가 나온다 | 구역별 몬스터 지정은 기획 · PM 결정 |
| 11 | 게임 본편 맵 목록(MapTable) 등록 없음 | 에디터 테스트 씬으로만 실행된다 | 본편 반영은 PD 지시 시 |
| 12 | 모바일 성능 미확인(소품 수 · 점광원 48 · 지형 1장) | — | 에디터 실측(배치 수 · 삼각형) 후 밀도(`density`) 조정 |
| 13 | 새 텍스처는 기본 압축(고품질)만 맞춘다(안드로이드 · iOS 개별 설정 없음) | 기기 빌드에서 형식이 기본값 | 필요 시 ASTC 지정 |
| 14 | 단두대 · 교수대 · 거미 알 모델 없음 | 처형대 · 알 둥지가 대체 소품 | 에셋조사 §6 — PD 결정 |
| 15 | 커밋 없음 | 새 파일은 모두 미추적 상태로 남는다 | PD 지시 시 커밋 |

## 값 고치기(재컴파일 없이)

맵 정의는 JSON 이라 값을 고친 뒤 Build 만 다시 부르면 된다.

- 직접 고치기: `Assets/BurningTimes/Maps/<이름>/<이름>.map.json`
- 원본에서 다시 만들기(권장 — 동선 검사 · 동선도가 함께 갱신된다): `tools/maps_def.py` 를 고치고 `python tools/build_maps.py` → `python tools/estimate_props.py` → `python tools/make_docs.py` → JSON 을 프로젝트로 복사.
- 컴파일 확인(에디터 없이): `bash tools/csc_check_maps.sh` — 프로젝트에는 아무것도 쓰지 않는다.
docs(BT27~BT37-FirstRising): 보스 구현 노트 v2 · 신규 맵 6종 문서 · 블렌더 소품 제작 도구 · 검증 도구 · 대화로그 · PD 지시 로그 이번 세션(2026-09-27 ~ 09-28) 작업물. FR 레포는 bt/work 159f17f6c0(BT27~BT33) · 1ce5df5b2e(BT34~BT36)로 push 완료. - 몬스터보스: 보스 패턴 구현 노트 v2(§11 종료 시 에러 정정 · §12 필드 이동) · 검증용 eval 스크립트 · 한글 주석 점검 도구 - 맵: 설계 · 에셋 조사 · 실행 순서 · 빌드 결과(§6 바닥 덧칠 · §7 이동 영역/동굴 바닥/사막 맵 · §8 블렌더 소품) · 그림(위에서 본 지도 · 바닥 전후 · 새 소품 화면) · tools/blender_props(소품 67종을 짜고 굽는 블렌더 스크립트) · tools/map_defs(사막 맵 정의) · tools/unity_eval(빌드 · 물리 점검 · 촬영 · 숲 맵 소품 배치) · 순회 스크립트 - 대화로그 2026-09-28(§1 ~ §5) - PD 지시 로그(개발팀): BT28 ~ BT37 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> 2026-09-28 06:06:00 +00:00			`# FR 신규 맵 5종 — 실행 순서(PM 용)`

			작성 2026-09-28 · 스테이징 `C:\BurningTimes\FR_maps_staging\`

			`> 이 빌더는 Unity 에서 한 번도 실행해 보지 않았다. 확인한 것은 ① 컴파일 오류 0(Unity 에 든 컴파일러) ② 맵 정의의 동선 검사(파이썬) ③ 프리팹 · 텍스처 경로 존재뿐이다.`
			`> 첫 실행은 맵 하나(Graveyard)로 하고, 로그와 화면을 본 뒤 나머지를 돌리는 것을 권한다.`

			`## ① 복사할 파일`

			스테이징의 `Assets\` 아래를 프로젝트의 같은 경로로 복사한다(`.meta` 는 없다 — Unity 가 만든다). 기존 파일을 덮어쓰는 것은 없다(전부 새 경로).

			`\| 스테이징 경로 \| 내용 \| 개수 \|`
			`\|---\|---\|---:\|`
			\| `Assets\BurningTimes\Editor\Maps\*.cs` \| 공용 빌더(네임스페이스 `BurningTimes.EditorTools.Maps`) \| 10 \|
			\| `Assets\BurningTimes\Maps\<이름>\<이름>.map.json` \| 맵 정의(데이터) \| 5 \|
			\| `Assets\BurningTimes\Maps\<이름>\Textures\FRMap_*.png` \| 새로 만든 바닥 · 액체 텍스처(1024, 노멀 포함) \| 20 \|

			```
			`robocopy C:\BurningTimes\FR_maps_staging\Assets C:\BurningTimes\FirstRising\Assets /E`
			```

			빌더 파일 10개: `MapBuilder`(메뉴 · 진입점) · `MapDef`(데이터) · `MapContext`(실행 상태) · `MapGeometry`(거리 · 보이는 범위) · `MapPropPlacer`(소품 놓기 · 충돌 판정) · `MapTerrainBuilder`(바닥) · `MapLiquidBuilder`(물 · 용암 · 독액) · `MapDresser`(장면 묶음 · 담 · 띠) · `MapWalkMask`(걸을 수 있는 마스크 · 보이지 않는 벽) · `MapSceneAssembler`(씬 · 분위기).
			숲 맵 빌더(`TV2DiabloMap.cs`)와 숲 맵 씬 · 에셋은 건드리지 않는다.

			`## ② 실행 명령`

			`전제: Play 중이 아닐 것 · 컴파일 중이 아닐 것 · 이름 없는(저장 안 한) 씬이 열려 있지 않을 것. 지금 열려 있는 씬은 닫지 않는다(빌더가 새 씬을 덧붙여 열었다가 끝나면 닫고, 활성 씬을 되돌린다).`

			`\| 순서 \| 명령 \| 비고 \|`
			`\|---\|---\|---\|`
			\| 1 \| `unity command eval_file --file C:\BurningTimes\FR_maps_staging\unity_eval\map_refresh.cs --json` \| 복사한 파일 가져오기 + 컴파일(이 프로젝트는 Auto Refresh 가 꺼져 있다). Play 중이면 하지 말 것 \|
			\| 2 \| `unity command recompile_status` → 끝난 뒤 `unity command get_console_logs --severity error` \| 컴파일 오류 0 확인 \|
			\| 3 \| `unity command eval_file --file ...\unity_eval\map_probe.cs --json` \| 준비물 확인(아무것도 바꾸지 않는다). `builder=True` · 맵마다 `json=True tex=n/n` \|
			\| 4 \| `unity command eval_file --file ...\unity_eval\map_build_Graveyard.cs --detach` \| 맵 하나 짓기. 끝나면 `Logs/bt_map_graveyard.txt` 마지막 줄이 `RESULT: OK` \|
			\| 5 \| 나머지: `map_build_RuinedKeep.cs` · `map_build_SpiderCave.cs` · `map_build_PlagueCatacomb.cs` · `map_build_HarborExecution.cs` (한꺼번에는 `map_build_all.cs`) \| 모두 `--detach` \|
			\| 6 \| `Assets/Scenes/Maps/<이름>.unity` 를 열고 Play \| 처음 열 때 맵 서브씬을 굽는다 \|

			- 코드에서 부를 때: `BurningTimes.EditorTools.Maps.MapBuilder.Build("Graveyard")` — 이름은 `Graveyard` · `RuinedKeep` · `SpiderCave` · `PlagueCatacomb` · `HarborExecution`. 로그 문자열을 돌려준다.
			- 메뉴: `BurningTimes/Maps/<맵 이름>/Build` · `Remove` · `BurningTimes/Maps/모두 Build (5종)`.
			- 걷어내기: `map_remove_<이름>.cs` 또는 메뉴 Remove — 빌더가 놓은 루트(`Map_<이름>` · `Map_<이름>_Ground` · `Map_<이름>_Bounds` · `Map_<이름>_Moon` · `Map_<이름>_Lights`)만 지운다. 씬 · 에셋 파일은 남는다.
			`- 다시 짓기: Build 를 다시 부르면 위 루트를 지우고 같은 시드로 다시 짓는다(결과 동일).`

			`### 빌더가 만드는 것`

			`\| 경로 \| 내용 \|`
			`\|---\|---\|`
			\| `Assets/Scenes/Maps/<이름>.unity` \| 메인 씬 — `Assets/Scenes/TestVisual.unity` 사본(LevelEssential · TestMonstersController · SubScene · BT_Visual 유지). 이미 있으면 다시 복사하지 않는다 \|
			\| `Assets/Scenes/Maps/<이름>/<이름>_Map.unity` \| 맵 서브씬 — 빈 씬에서 새로 만든다 \|
			\| `Assets/BurningTimes/Maps/<이름>/Terrain/` \| 지형 데이터 · 지형 층 4개 \|
			\| `Assets/BurningTimes/Maps/<이름>/Meshes/` \| 보이지 않는 벽 메시 · 액체 수면 메시 \|
			\| `Assets/BurningTimes/Maps/<이름>/Materials/` \| 액체 재질 · 가림 반투명 재질(`Fade/`) \|
			\| `Assets/BurningTimes/Maps/<이름>/Settings/<이름>_Volume.asset` \| 후처리 볼륨 사본(맵마다 색 보정) \|
			\| `Logs/bt_map_<이름>.txt` · `_layout.json` · `_props.json` · `_walkable.png` \| 결과 기록(이름은 소문자) \|

			전역 저장(`AssetDatabase.SaveAssets`)은 쓰지 않는다. 우리가 만든 에셋만 `SaveAssetIfDirty` 로 저장하고, 씬은 위 두 개만 저장한다.

			`## ③ 예상 소요`

			미확인(실측 없음). 어림: 맵당 30~120초(지형 칠 512² · 소품 500~1,100개 놓기 · 담 따라가기). `unity command` 의 5초 제한을 넘으므로 반드시 `--detach`.
			`처음 Play 할 때 서브씬 굽기는 숲 맵 기준 20~30초 이상.`

			`## ④ 실행 뒤 확인할 것`

			### 로그 `Logs/bt_map_<이름>.txt`

			`\| 줄 \| 기대값 \| 어긋나면 \|`
			`\|---\|---\|---\|`
			\| `RESULT:` \| `OK` \| `FAIL` 이면 그 뒤 예외 내용을 본다 \|
			\| `이어지지 않는 조각` \| 0 ㎡ \| 0 이 아니면 어딘가 끊겼다 — 마스크 PNG 로 위치 확인 \|
			\| `연결 복구: … 를 열었다` \| 이 줄이 없어야 한다 \| 있으면 그 공터로 가는 길을 소품이 막았다는 뜻(소품 배치 조정 필요) \|
			\| `길 폭(중심선 기준 가장 좁은 곳)` \| `6 m 미만 없음` \| 몰이사냥 병목 기준 위반 — 그 길 가장자리 소품 확인 \|
			\| `보스전 자리 안 … 막힌 칸` \| 0 ㎡ \| 보스 공터 안에 소품이 들어갔다 \|
			\| `몬스터 무리 자리 … 확인 필요` \| `없음` \| 그 무리 자리가 막혔거나 둘레가 좁다 \|
			\| `없는 프리팹 · 풀` \| `없음` \| 경로가 바뀌었다 \|
			\| `점광원` \| 48 이하 \| 상한을 넘어 빛을 달지 않은 장치 수가 많으면 상한(`lightBudget`)이나 묶음의 빛을 조정 \|
			\| `옛 셰이더(LOD 하위) 재질 교체 렌더러` \| 참고 \| 분홍색 소품이 보이면 이 수와 함께 보고 \|
			\| `길 한가운데 · 공터 가운데라 놓지 않은 막는 소품` \| 참고 \| 많으면 묶음 자리가 길과 겹친다 \|
			\| `담 '…'` \| 먼 쪽 · 카메라 쪽 개수 \| 0 이면 담이 안 놓였다 \|

			`### 그림`

			- `Logs/bt_map_<이름>_walkable.png`(흰색 = 이동 가능 · 0.5 m 격자 · 위 = -z)을 `docs/img/<이름>_walkable_design.png`(소품 전 설계값)과 견준다. 길 · 공터의 큰 꼴이 같아야 하고, 소품 자리만 파여야 한다.
			- 탑뷰 동선도 `docs/img/<이름>_topview.png` 와 실제 화면의 랜드마크 위치.

			`### 화면(Play · 캡처 권장 지점)`

			`1. 시작 위치 — 야영지가 길을 막지 않는가 · 분위기 색이 테마대로인가.`
			`2. 모아서 잡는 자리 — 가운데가 트였는가 · 키 큰 소품이 캐릭터를 가리지 않는가.`
			`3. 보스전 자리 — 문 폭 · 둘레 담이 끊김 없이 이어지는가 · 바닥 띠가 읽히는가.`
			`4. 담 — 조각이 겹치거나 비지 않는가 · 방향이 경계를 따라가는가.`
			`5. 액체 — 수면 높이 · 색 · 발광 세기(용암 · 독액) · 물가가 지형에 자연스럽게 묻히는가.`
			`6. 소품 크기 — 사람 키(약 1.8 m) 대비 어색한 것.`
			7. 충돌 — 보이는 것이 막고 비어 보이는 곳이 통과되는가(숲 맵과 같은 기준으로 자동 주행 `TVAutoPilot` · 배치 좌표는 `_layout.json`).
			`8. 몰이 — 무리를 끌고 고리를 돌 때 몬스터가 걸리는 곳.`

			`## ⑤ 알려진 위험 · 미확인`

			`\| # \| 내용 \| 영향 \| 대응 \|`
			`\|---\|---\|---\|---\|`
			`\| 1 \| Unity 에서 실행한 적 없음 \| 실행 중 예외 · 기대와 다른 배치 \| 맵 하나로 먼저 실행 · 로그 확인. 예외가 나도 연 씬은 저장 없이 닫힌다 \|`
			\| 2 \| 메인 씬은 `TestVisual.unity` 디스크 저장본을 복사한다 \| 보스 작업 구성(TVBossDirector 등)이 그대로 따라온다. 저장하지 않은 변경은 빠진다 \| 뜻한 바가 아니면 복사 전에 TestVisual 을 저장하거나, 만든 메인 씬에서 정리 \|
			\| 3 \| 이름 없는 씬이 열려 있으면 새 씬을 덧붙여 만들 수 없다(Unity 제약) \| 첫 Build 실패 \| `map_probe.cs` 의 `untitledSceneOpen` 확인 \|
			\| 4 \| 프리팹 크기 · 방향은 놓을 때 재서 맞춘다 \| 보이지 않는 조각(입자 · 그림자용 메시)이 크기에 섞이면 배율이 틀어질 수 있다 \| `_props.json` 의 `scale` · 크기로 확인 → JSON 의 `fit`/`a`/`b` 조정 \|
			\| 5 \| MEP · MEP1 프리팹의 높이 축 미확정 \| 목표 높이(`fit h`)로 적은 동굴 벽 · 석순 · 수정 · 버섯은 빌더가 실측하므로 영향 없음. 배율(`fit s`)로 적은 것은 숲 맵에서 쓴 값 \| — \|
			`\| 6 \| 불꽃 색 바꾸기(녹색 · 보라)는 입자 시작 색에 곱하는 방식 \| 재질에 따라 색이 안 바뀔 수 있다 \| 화면 확인 \|`
			\| 7 \| 담은 경계선을 따라가며 한 칸씩 놓는다 \| 굽은 곳 · 좁은 곳에서 겹치거나 빌 수 있다 \| `seg`(한 칸 길이) · `gap` 조정 \|
			\| 8 \| 낭떠러지(`void`)는 지형만 파낸다(수면 없음) \| 바닥 텍스처가 보여 구덩이처럼 보일 수 있다 \| 어두운 판 · 안개 추가 검토 \|
			`\| 9 \| 몬스터가 보이지 않는 벽 · 소품을 피하는 방식 미확인 \| 몰이 중 걸림 \| Play 실측 \|`
			`\| 10 \| 몬스터 구역의 몬스터 번호는 본뜬 씬(TestVisual) 값을 물려받는다 \| 테마와 다른 몬스터가 나온다 \| 구역별 몬스터 지정은 기획 · PM 결정 \|`
			`\| 11 \| 게임 본편 맵 목록(MapTable) 등록 없음 \| 에디터 테스트 씬으로만 실행된다 \| 본편 반영은 PD 지시 시 \|`
			\| 12 \| 모바일 성능 미확인(소품 수 · 점광원 48 · 지형 1장) \| — \| 에디터 실측(배치 수 · 삼각형) 후 밀도(`density`) 조정 \|
			`\| 13 \| 새 텍스처는 기본 압축(고품질)만 맞춘다(안드로이드 · iOS 개별 설정 없음) \| 기기 빌드에서 형식이 기본값 \| 필요 시 ASTC 지정 \|`
			`\| 14 \| 단두대 · 교수대 · 거미 알 모델 없음 \| 처형대 · 알 둥지가 대체 소품 \| 에셋조사 §6 — PD 결정 \|`
			`\| 15 \| 커밋 없음 \| 새 파일은 모두 미추적 상태로 남는다 \| PD 지시 시 커밋 \|`

			`## 값 고치기(재컴파일 없이)`

			`맵 정의는 JSON 이라 값을 고친 뒤 Build 만 다시 부르면 된다.`

			- 직접 고치기: `Assets/BurningTimes/Maps/<이름>/<이름>.map.json`
			- 원본에서 다시 만들기(권장 — 동선 검사 · 동선도가 함께 갱신된다): `tools/maps_def.py` 를 고치고 `python tools/build_maps.py` → `python tools/estimate_props.py` → `python tools/make_docs.py` → JSON 을 프로젝트로 복사.
			- 컴파일 확인(에디터 없이): `bash tools/csc_check_maps.sh` — 프로젝트에는 아무것도 쓰지 않는다.