# Nekoban Map Generator

역탐색 기반으로 소코반 맵을 생성하는 .NET 7 콘솔 툴입니다. 마스크(외곽 형태)를 지정하고, 목표에 박스를 놓은 상태에서 박스를 “pull”하여 시작 상태를 만들기 때문에 항상 풀 수 있는 맵만 출력합니다. 외벽은 `#`, 바깥은 `0`, 바닥은 `.`, 목표/박스/플레이어는 `G/$/@`로 표시합니다.

## 요구사항
- .NET 7 SDK

## 사용 방법
```bash
dotnet build
dotnet run -- <seed> [startId] [endId] > output.json
```
- 예: `dotnet run -- 12345 3 20 > stage.json`
- `seed`가 없으면 기본값(12345)을 사용합니다.
- `startId/endId`가 없으면 `levelbalance.json`에 정의된 밴드 범위를 사용합니다.
- 진행 상태는 stderr에 한 줄로 갱신됩니다(벽 생성중/박스 배치중/검증중/생성완료).

## 설정
- `levelbalance.json`: 레벨 밴드 설정(레벨 범위, 박스 수, 최소 푸시/턴/브랜칭, 마스크 세트/확장 범위, 역탐색 깊이/폭 스케일, 목표/박스 간 최소 거리, 주머니(포켓) 리라이팅). `maskSets`(micro/medium/large), `maskPadMin/max`, `reverseDepthScale/breadthScale`, `minAllowedBranching`, `minGoal/Box/WallDistance`, `pocketCarveMin/Max/Radius`를 밴드별로 조정해 난이도·길이감을 설계합니다.
- `mask_library.cs`: Microban/Novoban 스타일의 외곽 마스크 모음 + 중형/대형 마스크. 회전/반전/스케일 변형과 소규모 벽 지터가 자동 적용됩니다. 마스크를 추가해 형태 다양성을 늘릴 수 있습니다.
- `Program.cs`: 생성 튜닝(`GenerationTuning`)에 시도 횟수, 시간 한도, 릴랙스 단계 수, 역탐색 기본 깊이/폭, 외벽 정규화, 코너 데드락 필터 옵션 등이 정의되어 있습니다.

## 출력 형식
`output.json`은 다음 형태의 배열입니다.
```json
[
  {
    "id": 3,
    "grid": [
      "000000000",
      "00#####00",
      "00#...#00",
      "0##.$.##0",
      "0#@$.G.#0",
      "0##...##0",
      "00#.G.#00",
      "00#####00",
      "000000000"
    ],
    "lowestPush": 5,
    "pushLimit": 7
  }
]
```
- `grid`: 문자열 배열(행). `0`은 외부 void, `#`는 벽, `.`은 바닥, `G/$/@`는 목표/박스/플레이어.
- `lowestPush`: 솔버가 계산한 최소 푸시 수.
- `pushLimit`: 최소 푸시에 여유 패딩을 더한 제한 값.

## 메모
- 외벽은 항상 `#`로 둘러지며, `0`은 외부에서만 사용됩니다.
- 중복 레이아웃은 제거됩니다.
- 해법 패턴(푸시/턴/방향 런 요약) 해시를 이용해 유사 해법 레벨도 추가로 걸러냅니다.
- 더 느리게 돌려야 하면 `GenerationTuning`의 시도/시간 한도를 조정하세요.