Merge pull request 'refactor(cb): codeblock 메서드 모듈화 Phase 1b (cb/*.mjs 17종, 바이트 동일)' (#71) from feature/cb-modularization into feature/gen-modularization

Reviewed-on: #71

.claude/settings.json

@@ -2,17 +2,19 @@
   "$schema": "https://json.schemastore.org/claude-code-settings.json",
   "permissions": {
     "deny": [
-      "Read(./ui/DefaultGroup.ui)",
+      "Read(./ui/*.ui)",
       "Read(./map/*.map)",
-      "Read(./RootDesk/MyDesk/SlayDeckController.codeblock)",
-      "Edit(./ui/DefaultGroup.ui)",
+      "Read(./RootDesk/MyDesk/*.codeblock)",
+      "Edit(./ui/*.ui)",
       "Edit(./map/*.map)",
-      "Edit(./RootDesk/MyDesk/SlayDeckController.codeblock)",
+      "Edit(./RootDesk/MyDesk/*.codeblock)",
       "Edit(./Global/common.gamelogic)",
-      "Write(./ui/DefaultGroup.ui)",
+      "Edit(./Global/SectorConfig.config)",
+      "Write(./ui/*.ui)",
       "Write(./map/*.map)",
-      "Write(./RootDesk/MyDesk/SlayDeckController.codeblock)",
-      "Write(./Global/common.gamelogic)"
+      "Write(./RootDesk/MyDesk/*.codeblock)",
+      "Write(./Global/common.gamelogic)",
+      "Write(./Global/SectorConfig.config)"
     ]
   }
 }

CLAUDE.md

@@ -1,6 +1,6 @@
 # SlayMaple — CLAUDE.md
 
-MapleStory Worlds 기반 Slay the Spire 풍 덱빌더. 게임 전체가 데이터(`data/*.json`) + 생성기(`tools/`) 단일 소스이고, `ui/DefaultGroup.ui`(8.3MB)·codeblock·map 파일은 **생성 산출물**이다.
+MapleStory Worlds 기반 Slay the Spire 풍 덱빌더. 게임 전체가 데이터(`data/*.json`) + 생성기(`tools/`) 단일 소스이고, `ui/DefaultGroup.ui`(~7.1MB)·codeblock·map 파일은 **생성 산출물**이다.
 
 @RULES.md
 

Global/SectorConfig.config

@@ -23,7 +23,8 @@
             "map://map02",
             "map://map03",
             "map://map04",
-            "map://map05"
+            "map://map05",
+            "map://lobby"
           ]
         }
       ],

Global/common.gamelogic

@@ -32,10 +32,10 @@
             {
               "@type": "script.SlayDeckController",
               "Enable": true,
-              "Energy": 0,
-              "MaxEnergy": 3,
-              "Turn": 0,
-              "TweenEventId": 0
+              "Energy": 0.0,
+              "MaxEnergy": 3.0,
+              "Turn": 0.0,
+              "TweenEventId": 0.0
             }
           ],
           "@version": 1

README.md

@@ -1,7 +1,7 @@
 # SlayMaple
 
 [MapleStory Worlds(MSW)](https://maplestoryworlds.nexon.com/) 기반으로 제작하는 **Slay the Spire 풍 덱빌더 로그라이크** 월드.
-턴제 카드 전투, 덱 구성, 보상 선택, 맵 노드 진행을 메이플 월드 위에서 구현하는 것을 목표로 합니다.
+로비 마을에서 NPC와 상호작용해 런을 시작하고, 턴제 카드 전투·덱 구성·보상 선택·절차 생성 맵 진행·전직·영혼 메타 성장을 메이플 월드 위에서 구현합니다.
 
 > 이 저장소는 MSW **로컬 워크스페이스(Local Workspace)** 데이터를 git으로 형상관리하기 위한 것입니다.
 > 공동작업자는 이 저장소를 통해 월드 데이터를 주고받습니다. (클라우드 공동제작 모드 미사용)
@@ -32,9 +32,10 @@ git push
 ```bash
 git pull
 ```
-받아온 뒤, 메이커에서 **로컬 워크스페이스를 다시 로드(reload)** 해야 새 codeblock/모델 파일이 에디터 상태로 반영됩니다.
+받아온 뒤, 메이커에서 **로컬 워크스페이스를 다시 로드(reload)** 해야 새 codeblock/모델/맵 파일이 에디터 상태로 반영됩니다.
 
 > 💡 같은 파일을 동시에 수정하면 git 충돌이 날 수 있으니, **서로 다른 맵/codeblock/UI를 나눠서** 작업하는 것을 권장합니다.
+> ⚠️ git pull 후 reload를 빠뜨리면 메이커의 stale 상태가 디스크를 덮어쓸 수 있습니다. 재생성 후에도 reload → 빌드 콘솔 0 에러 확인.
 
 ---
 
@@ -42,107 +43,145 @@ git pull
 
 ```
 slaymaple/
-├── data/                       # 게임 데이터 단일 소스 (생성기가 읽어 주입)
-│   ├── cards.json              # 카드 32종(클래스·직업별) + 클래스별 시작 덱
-│   ├── enemies.json            # 적 정의(일반/정예/보스, 디버프 인텐트 포함)
+├── data/                       # 게임 데이터 단일 소스 (생성기가 읽어 주입). 맵은 정적 데이터 없음(절차 생성)
+│   ├── cards.json              # 카드 122장(클래스·2차전직별 + 저주) + 클래스별 시작 덱
+│   ├── enemies.json            # 적 12종(일반/정예/보스, 디버프 인텐트 포함)
 │   ├── potions.json            # 물약 6종 + 드랍률·슬롯·상점가
-│   └── relics.json             # 유물 19종(StS 효과 × 메이플 장비) + 시작 유물 + 풀
+│   ├── relics.json             # 유물 19종(StS 효과 × 메이플 장비) + 시작 유물 + 풀
+│   ├── cardframes.json         # 커스텀 카드 프레임 3종(전사/마법사/도적 × normal/unique/legend) + 보상 등급 가중치
+│   └── camera.json             # 맵별 카메라 설정값(줌·오프셋·고정 영역)
 ├── Global/                     # 월드 전역 설정 · 공용 모델 · 게임로직
-│   ├── common.gamelogic        # SlayDeckController 부착 지점 (카드 UI 전투)
+│   ├── common.gamelogic        # SlayDeckController 부착 지점 (산출물)
 │   ├── DefaultPlayer.model     # 플레이어 모델 (턴전투용 이동 정지 freeze 적용)
-│   ├── *.model                 # 몬스터 등 공용 모델 (freeze 적용)
+│   ├── ChaseMonster.model · MoveMonster.model   # 몬스터 공용 모델
+│   ├── SectorConfig.config     # 섹터/맵 등록 (lobby + map01~05 = 6 entries)
 │   ├── WorldConfig.config      # 월드 설정
 │   └── ...
 ├── RootDesk/
-│   └── MyDesk/                 # 작업용 책상 — codeblock(스크립트)·모델·타일셋
-│       ├── SlayDeckController.codeblock  # 게임 전체 컨트롤러 (생성물, 직접 편집 금지)
-│       ├── Monster.codeblock      # 필드 액션 몬스터 (HP·피격·리스폰, 카드 전투와 별개)
-│       ├── MonsterAttack.codeblock · PlayerAttack.codeblock · PlayerHit.codeblock
-│       ├── UIPopup.codeblock · UIToast.codeblock
-│       └── RectTileData_Henesys.tileset
-├── map/
-│   └── map01.map ~ map11.map    # 맵 11종 (공식 배경 + STS풍 우측 배치)
+│   └── MyDesk/                 # 작업용 책상 — codeblock(스크립트)·타일셋
+│       ├── SlayDeckController.codeblock  # 게임 전체 컨트롤러 (★산출물, 직접 편집 금지)
+│       ├── Monster.codeblock · MonsterAttack.codeblock   # 필드 액션 몬스터 (카드 전투와 별개)
+│       ├── PlayerAttack.codeblock · PlayerHit.codeblock · UIPopup.codeblock · UIToast.codeblock
+│       ├── CombatMonster.codeblock   # 맵 몬스터 EnemyId 마커 + /common 자기등록
+│       ├── MapCamera.codeblock       # 맵별 카메라 적용
+│       ├── PlayerLock.codeblock      # 전투맵 플레이어 입력·이동 잠금
+│       ├── LobbyNpc.codeblock        # 로비 NPC 상호작용(근접·클릭)
+│       └── LobbyMobility.codeblock   # 로비 이동·공격 해제 + 카메라 추종
+├── map/                         # 맵 6종 (산출물)
+│   ├── lobby.map               # 로비 허브 맵 (마을 배경, NPC 4종, 전투 없음)
+│   └── map01.map ~ map05.map   # 5막 전투/맵 노드 (공식 배경 + STS풍 우측 배치)
 ├── tools/                       # 결정적 생성기·도구 (주체별 폴더, 단일 소스)
-│   ├── deck/                    # gen-slaydeck.mjs(★게임 전체 생성: 카드/덱·맵·상점·유물·메인메뉴 UI+SlayDeckController+common) · gen-cardhand.mjs(손패 초기 생성)
-│   ├── map/                     # gen-maps.mjs(맵 생성) · gen-map-encounters.mjs(맵별 인카운터) · rogue-map.mjs(절차 생성 JS 미러+테스트)
+│   ├── deck/                    # gen-slaydeck.mjs(★게임 전체 생성: 카드/덱·전투·맵노드·상점·유물·로비·메뉴 UI + SlayDeckController + common) · gen-cardhand.mjs
+│   ├── map/                     # gen-maps.mjs(맵 배경/타일) · gen-lobby-map.mjs(로비 맵+NPC) · gen-map-encounters.mjs(노드별 몬스터 그룹) · rogue-map.mjs(절차 생성 JS 미러)+test
 │   ├── camera/                  # gen-camera.mjs(맵별 고정 카메라 codeblock)
-│   ├── player/                  # freeze-turn-player.mjs(이동 정지) · gen-player-lock.mjs(입력 차단·시선 고정 codeblock)
-│   ├── monster/                 # freeze-turn-monsters.mjs(필드 몬스터 AI/이동 정지)
-│   ├── balance/                 # sim-balance.mjs(밸런스 시뮬·몬테카를로) · sim-balance.test.mjs
+│   ├── player/                  # gen-player-lock.mjs(전투맵 입력 잠금) · freeze-turn-player.mjs(모델 이동 정지) · gen-lobby-npc.mjs(LobbyNpc·LobbyMobility codeblock)
+│   ├── monster/                 # gen-combat-monster.mjs(EnemyId 마커) · freeze-turn-monsters.mjs(필드 AI 정지)
+│   ├── balance/                 # sim-balance.mjs(전투 밸런스 몬테카를로 시뮬) · sim-balance.test.mjs
+│   ├── verify/                  # count.mjs(산출물 카운트 검증 헬퍼 — 경로 내장)
 │   └── git/                     # gitea-pr.mjs(UTF-8 안전 PR 생성/수정/머지 — RULES.md 참조)
-├── ui/                         # UI 그룹 (Default / Popup / Toast)
+├── ui/                         # UI 그룹 (DefaultGroup 8.3MB 산출물 / PopupGroup / ToastGroup)
 ├── docs/
-│   ├── slaymaple_basic_framework.md   # 전투 프레임워크 설계 문서
-│   └── superpowers/specs|plans/       # 각 기능 설계·구현 계획 문서
-├── RULES.md                    # 협업·AI 에이전트 하네스 규칙 (토큰 가드·PR 절차)
+│   ├── slaymaple_basic_framework.md     # 전투 프레임워크 설계 문서
+│   ├── ui-generation-structure.md       # UI 생성 구조 문서
+│   └── superpowers/specs|plans/         # 각 기능 설계·구현 계획 문서(P1~P15)
+├── RULES.md                    # 협업·AI 에이전트 하네스 규칙 (토큰 가드·검증·PR 절차)
 ├── CLAUDE.md                   # Claude Code 자동 로드 (RULES.md 임포트)
 └── README.md
 ```
 
+> ⚠️ **`map/*.map` · `ui/DefaultGroup.ui` · `*.codeblock` · `Global/*.gamelogic`는 생성 산출물**입니다 — 직접 편집하면 다음 재생성 때 사라집니다. 게임 변경은 `data/*.json` 또는 `tools/`의 생성기를 고친 뒤 재생성하세요(자세한 규칙은 [`RULES.md`](RULES.md)).
 > `.mcp.json`, `.codex/` 는 **Authorization 토큰이 포함**되어 있어 git에서 제외됩니다(`.gitignore`). 각자 로컬에서 직접 구성하세요.
 
 ---
 
 ## 게임 프레임워크 현황
 
-**StS2풍 덱빌더 로그라이크가 end-to-end로 완성**됐습니다 — 메인 메뉴(승천 선택) → 캐릭터 선택(전사/마법사) → 절차 생성 맵 → 전투/엘리트/상점/휴식/유물 방 → 보상·전직·덱 성장 → 보스 → 다음 막 → 런 클리어(승천 해금). 게임 전체는 `/common` 엔티티에 부착된 **`SlayDeckController` 단일 컴포넌트**로 동작하며, 모든 산출물(`ui/DefaultGroup.ui` · `SlayDeckController.codeblock` · `common.gamelogic`)은 **`tools/deck/gen-slaydeck.mjs` 단일 소스에서 생성**됩니다(직접 편집 금지, 결정적 출력 — `RULES.md` 참조). 게임 데이터는 **`data/*.json`** 가 단일 소스.
+**StS2풍 덱빌더 로그라이크가 end-to-end로 완성**됐고, 이제 **로비 마을을 기점으로 반복 런**이 돕니다:
 
-### 구현된 기능 (배포 퀄리티 P1~P12, PR #34~#47)
+```
+로비 맵(NPC 4종) → 모험가 NPC → 캐릭터 선택(전사/도적/마법사) → 절차 생성 맵(5막)
+   → 전투/엘리트/상점/휴식/유물 방 → 보상·전직·덱 성장 → 보스 → 다음 막
+   → 런 클리어(승천 해금) → 로비 복귀(영혼 정산) → 다음 런 …
+```
+
+게임 전체는 `/common` 엔티티에 부착된 **`SlayDeckController` 단일 컴포넌트**로 동작하며, 모든 산출물(`ui/DefaultGroup.ui` · `SlayDeckController.codeblock` · `common.gamelogic`)은 **`tools/deck/gen-slaydeck.mjs` 단일 소스에서 생성**됩니다(결정적 출력, 직접 편집 금지 — `RULES.md` 참조). 게임 데이터는 **`data/*.json`** 가 단일 소스, 맵 구조는 **런타임 절차 생성**(`GenerateMap` Lua ↔ `tools/map/rogue-map.mjs` JS 미러).
+
+### 구현된 기능 (배포 퀄리티 P1~P15, PR #34~#57)
 
 | 영역 | 내용 |
 |---|---|
-| **캐릭터·전직** | 시작 시 **전사(HP80)/마법사(HP70)** 선택, 클래스별 시작 덱. 보스 클리어 시 [유물] vs [**2차 전직**] — 전사→파이터/페이지/스피어맨, 법사→위자드(불·독)/위자드(썬·콜)/클레릭. 전용 카드는 해당 클래스만 획득(보상·상점 풀 필터) |
-| **카드 전투** | 에너지 3·5장 드로우·**드래그 사용**(공격=적에 드롭, 스킬=위로 스윕). 카드 32종 — kind **Attack/Skill/Power**(파워: 소멸·매턴 지속 효과). 메커니즘: 다단히트·방어 무시·자가 디버프·드로·회복·**전체 공격(AoE)**·**독(DoT)** |
+| **로비 마을** | 전용 물리 맵 `lobby.map`(마을 배경). **NPC 4종 월드 엔티티** — 모험가(런 시작)·사서(카드 도감)·상인(영혼 상점)·안내원(게시판). 근접 시 머리 위 마크 + `↑`키 **또는 직접 클릭**으로 상호작용. **이동·공격 모션은 로비 맵에서만** 풀림(전투맵은 잠금), 카메라는 로비에서 **플레이어 추종**(전투맵은 고정) |
+| **캐릭터·전직** | 시작 시 **전사(HP80)/도적(HP70)/마법사(HP70)** 3종 선택, 클래스별 시작 덱. 보스 클리어 시 [유물] vs [**2차 전직**] — 각 클래스 3종(전사→파이터/페이지/스피어맨, 법사→위자드불독/위자드썬콜/클레릭, 도적→Shiv/Poison/Trickster). 전용 카드는 해당 클래스 풀만 획득 |
+| **카드 전투** | 에너지 3·드로우·**드래그 사용**(공격=적에 드롭, 스킬=위로 스윕). 카드 **122장** — kind **Attack/Skill/Power/Status**. 메커니즘: 다단히트·방어 무시·자가 디버프·드로·회복·**전체 공격(AoE)**·**독(DoT)**·**retain**(턴 종료 손패 유지)·**sly discard**(버림 트리거) |
 | **버프/디버프** | StS 표준 — **힘**(+N 영구)·**약화**(주는 피해 −25%)·**취약**(받는 피해 +50%)·**독**(매 행동 틱). 양방향(적 디버프 인텐트 포함), 인텐트는 최종 예상치 표시 |
-| **전투 연출** | 공격 이펙트·데미지 팝업·적 개별 차례·**공격/피격/독뎀 모션**(아바타 상태 전이·몬스터 hit 클립·런지/넉백) |
-| **절차 생성 맵** | 막 시작마다 **8층×4열 StS식 경로 생성**(런마다 다름). 층 규칙: 1~2층 전투만 → 3층~ 상점/휴식 → 4층~ 엘리트/**유물 방** → 7층 휴식 가중 → 8층 보스. 점선 경로·상태 4단(현재/방문/도달/잠김)·층 카운터 |
-| **유물 방(보물)** | 상자 클릭 → 흔들림 → 열림 연출 → 유물 + 메소 획득 |
-| **유물 19종** | StS 효과 × 메이플 장비 외형. TopBar **아이콘 행 + 마우스오버 툴팁**. 훅: combatStart/turnStart/cardPlayed/combatEnd/combatReward/onPlayerDamaged/attackCalc/passive. **장인의 벨트**=물약 슬롯 3→5칸 |
-| **물약 6종** | 승리 40% 드랍·상점 판매·슬롯 클릭 → 사용(전투 중)/버리기 메뉴·툴팁 |
-| **상점/휴식** | 카드 3종·유물·물약 판매(메소), 휴식=HP 회복 |
-| **승천(Ascension)** | A1~A10 누적 모디파이어(적 강화·시작 HP 감소·보상 감소). **UserDataStorage로 유저별 영구 저장**(서버 RPC), 런 클리어 시 다음 단계 해금 |
-| **멀티 act** | 보스 클리어→다음 막 텔레포트(맵·인카운터 변경, 적 스케일 `1+(막-1)*0.6`), 3막 클리어 시 런 종료→메뉴 복귀 |
-| **밸런스 시뮬** | `tools/balance/sim-balance.mjs` — 전투 규칙 JS 미러(몬테카를로) + `tools/map/rogue-map.mjs`(맵 생성 미러). **테스트 40건** |
+| **전투 연출** | 공격 이펙트·**몬스터 데미지 팝업(자릿수 스킨)**·드래그 타깃 마커·적 개별 차례·**공격/피격/독뎀 모션**(아바타 상태 전이·몬스터 hit 클립·런지/넉백) |
+| **절차 생성 맵** | 막 시작마다 **경로 생성**(런마다 다름, **가로 진행**). 층 규칙: 1~2층 전투만 → 3층~ 상점/휴식 → 4층~ 엘리트/**유물 방** → 보스 수렴. 점선 경로·상태 4단·층 카운터. 노드 타입별 **몬스터 랜덤 구성**(일반 1~3 / 엘리트 / 보스) + intent 랜덤 행동 |
+| **유물 19종 / 물약 6종** | 유물: StS 효과 × 메이플 장비 외형, TopBar 아이콘 + 마우스오버 툴팁, 8종 훅. 물약: 승리 40% 드랍·상점·슬롯 메뉴. 보물 방=상자 연출 → 유물+메소 |
+| **카드 프레임·등급** | 커스텀 프레임 3종(전사/마법사/도적 × normal/unique/legend), 카드 5개 사이트 통합 레이아웃. 보상 등급 가중 추첨 70/25/5 |
+| **영혼(Soul) 메타 성장** | 승천과 별개의 영구 강화 화폐. 2차 전직 상태로 보스 클리어 시 적립 → 로비 영혼 상점 4종 해금(시작 메소 +60·HP +15·덱 정제·시작 유물 +1). **UserDataStorage 영구 저장** |
+| **승천(Ascension)** | A1~A10 누적 모디파이어(적 강화·시작 HP 감소·보상 감소). UserDataStorage 유저별 영구 저장, 런 클리어 시 다음 단계 해금 |
+| **멀티 act** | **5막** 진행(보스 클리어→다음 막 텔레포트, 맵·인카운터 변경, 적 스케일 `1+(막-1)*0.45`), 5막 클리어 시 런 종료 |
+| **경제** | 화폐 표기 **메소**(코인 아이콘), 카드/유물/물약 메소 가격. 내부 식별자는 Gold 유지 |
+| **밸런스 시뮬** | `tools/balance/sim-balance.mjs` — 전투 규칙 JS 미러(몬테카를로) + `tools/map/rogue-map.mjs`(맵 생성 미러) + node 단위테스트 |
 
 > ⚠️ 수치(적 스탯·경제·승천 배율)는 1차 조정 상태입니다. 정밀 밸런싱은 `sim-balance.mjs`로 검증하며 진행합니다.
+> ℹ️ 도적(Silent) 카드 88장은 효과·프레임은 적용됐으나 **카드 아이콘(image/fx) 미할당** 상태입니다(전사·마법사 카드는 실 스킬 아이콘 적용 완료).
 
 ### 유용한 스크립트 호출
 `/common` 엔티티(또는 Play Test 컨텍스트)에서:
 ```lua
 local c = _EntityService:GetEntityByPath("/common").SlayDeckController
-c:SelectClass("warrior")  -- 또는 "magician"
-c:StartNewGame()          -- 캐릭터 선택 → 런 시작
-c:PickNode("r1c2")        -- 맵 노드 선택 (절차 생성 그리드 id) / "boss"
-c:PlayCard(1)             -- 손패 slot 카드 사용
-c:EndPlayerTurn()         -- 턴 종료 → 적 턴 → 다음 턴
-c:PickReward(1)           -- 보상 카드 1택(0=건너뛰기)
-c:BuyCard(1) / c:BuyRelic() / c:BuyPotion()  -- 상점 구매
-c:SetJob("fighter")       -- 전직 (보스 보상 선택 화면에서)
-c:AdjustAscension(1)      -- 메뉴에서 승천 단계 +1
+-- 로비
+c:OnLobbyNpcInteract("run")    -- 모험가(런 시작) / "codex"(도감) / "shop"(영혼상점) / "board"(게시판)
+c:ShowLobby()                  -- 로비 맵 복귀 + 상태 초기화
+-- 런
+c:SelectClass("warrior")       -- "warrior" / "bandit" / "magician"
+c:StartNewGame()               -- 캐릭터 선택 → 런 시작(map01 텔레포트)
+c:PickNode("r1c2")             -- 맵 노드 선택(절차 생성 그리드 id) / "boss"
+c:PlayCard(1)                  -- 손패 slot 카드 사용
+c:EndPlayerTurn()              -- 턴 종료 → 적 턴 → 다음 턴
+c:PickReward(1)                -- 보상 카드 1택(0=건너뛰기)
+c:BuyCard(1) / c:BuyRelic() / c:BuyPotion()   -- 상점 구매(메소)
+c:SetJob("fighter")            -- 전직 (보스 보상 선택 화면)
+c:AdjustAscension(1)           -- 메뉴에서 승천 단계 +1
 ```
 
-밸런스 검증: `node tools/balance/sim-balance.mjs [N] [--seed S]` · 테스트: `node --test tools/balance/sim-balance.test.mjs`.
+밸런스 검증: `node tools/balance/sim-balance.mjs [N] [--seed S]` · 테스트: `node --test tools/balance/sim-balance.test.mjs tools/map/rogue-map.test.mjs`.
 상세 설계는 [`docs/slaymaple_basic_framework.md`](docs/slaymaple_basic_framework.md) 및 `docs/superpowers/specs/` 참조.
 
+### 산출물 재생성
+```bash
+node tools/deck/gen-slaydeck.mjs        # 게임 전체(UI·컨트롤러·common·맵 인카운터)
+node tools/map/gen-maps.mjs             # map01~05 배경/타일
+node tools/map/gen-lobby-map.mjs        # 로비 맵 + NPC 배치
+node tools/player/gen-lobby-npc.mjs     # 로비 codeblock(LobbyNpc·LobbyMobility)
+node tools/camera/gen-camera.mjs        # 맵별 카메라
+node tools/player/gen-player-lock.mjs   # 전투맵 입력 잠금
+node tools/monster/gen-combat-monster.mjs   # 몬스터 EnemyId 마커
+```
+> 산출물 검증은 내용 출력 없이 카운트만: `node tools/verify/count.mjs <ui|cb|common> <regex>...` (자세한 가드는 [`RULES.md`](RULES.md)).
+
 ---
 
 ## 아키텍처 메모
 
-현재 게임 전체 로직이 `SlayDeckController` 단일 codeblock에 모여 있습니다. 초기 설계 문서가 제안한 3분할(`SlayCardCatalog`/`SlayRunState`/`SlayCombatManager`)은 **기능적으로 모두 구현**됐으나 아직 한 컴포넌트 안에 있습니다. 시스템이 더 커지면 그때 분리를 고려합니다. 카드/적/맵/유물 데이터는 이미 `data/*.json`로 외부화돼 있습니다.
+현재 게임 전체 로직이 `SlayDeckController` 단일 codeblock에 모여 있습니다. 초기 설계의 3분할(`SlayCardCatalog`/`SlayRunState`/`SlayCombatManager`)은 **기능적으로 모두 구현**됐으나 아직 한 컴포넌트 안에 있습니다. 맵 NPC·카메라·입력 잠금 등 **맵 단위 동작은 별도 codeblock**(LobbyNpc/LobbyMobility/MapCamera/PlayerLock/CombatMonster)으로 분리해 각 맵 루트/엔티티에 부착합니다. 카드/적/맵/유물/프레임/카메라 데이터는 `data/*.json`로 외부화돼 있습니다.
+
+> ⚠️ **전투 규칙과 맵 생성은 Lua(gen-slaydeck 내장)와 JS 미러(sim-balance/rogue-map)로 이중 구현**입니다. 한쪽을 고치면 반드시 다른 쪽도 동기화하고 테스트하세요(`RULES.md` §6).
 
 ---
 
 ## 향후 개선 계획 (후속 후보)
-- [x] 전투 루프 · 런 루프 · 절차 생성 맵 · 상점/휴식/유물 방 · 유물 19종 · 물약 · 버프/디버프 · Power · 전직(전사/법사 2차) · 승천+개인 저장 · 전투 모션 **(P1~P12 완료)**
-- [ ] **런 이어하기** — 진행 중 런 직렬화 저장(승천에서 도입한 UserDataStorage 확장, 메뉴의 "이어하기" 활성화)
-- [ ] **카드 제거/업그레이드** — 상점 카드 제거 슬롯, 휴식 노드에서 카드 강화(StS 스타일 +수치)
+- [x] 전투 루프 · 런 루프 · 절차 생성 맵 · 상점/휴식/유물 방 · 유물 19종 · 물약 · 버프/디버프 · Power · 전직(전사/법사/도적 2차) · 승천+개인 저장 · 전투 모션 · 커스텀 프레임 · **반복 런·로비 맵·NPC·영혼·메소·카메라 추종 (P1~P15 완료)**
+- [ ] **도적 카드 아이콘** — Silent 88장에 실 스킬 아이콘(image/fx) 할당, 2차 전직 설명 한글화
+- [ ] **런 이어하기** — 진행 중 런 직렬화 저장(UserDataStorage 확장, 메뉴 "이어하기" 활성화)
+- [ ] **카드 제거/업그레이드** — 상점 카드 제거 슬롯, 휴식 노드에서 카드 강화
 - [ ] **이벤트 노드(?)** — 랜덤 텍스트 이벤트(선택지·리스크/리워드)
-- [ ] **3차 전직** — 2막 보스 보상으로 확장(크루세이더/나이트/버서커, 메이지 3차 등)
-- [ ] **도적·궁수 클래스** — 캐릭터 선택 슬롯 확장(도적 잠금 해제), 클래스별 카드 풀
-- [ ] **정밀 밸런싱** — 첫 인카운터 승률 100% 완화, 직업별 카드 효율 튜닝(`sim-balance.mjs` 리포트 기반)
-- [ ] **상점 보장 규칙** — 막당 상점 최소 1회 등장(현재 가중 랜덤이라 미등장 가능)
-- [ ] **연출 보강** — 사운드(타격·획득), EndTurn 버튼 적 턴 중 시각 비활성화, 맵 화면에 유물/물약 표시
-- [ ] **승천 확장** — A10 초과 단계, 승천별 기록(클리어 횟수) 표시
+- [ ] **3차 전직** — 후반 막 보상으로 확장
+- [ ] **궁수 등 추가 클래스** — 캐릭터 선택 슬롯 확장
+- [ ] **정밀 밸런싱** — 첫 인카운터 승률 완화·직업별 카드 효율 튜닝(`sim-balance.mjs` 리포트 기반)
+- [ ] **상점 보장 규칙** — 막당 상점 최소 1회 등장
+- [ ] **연출 보강** — 사운드(타격·획득), 맵 화면에 유물/물약 표시
 
 ---
 
@@ -153,5 +192,5 @@ c:AdjustAscension(1)      -- 메뉴에서 승천 단계 +1
    ```
 2. MSW Maker에서 이 폴더를 **로컬 워크스페이스 경로**로 지정해 월드 열기
 3. `.mcp.json` / `.codex/` 는 git에 없으므로, 본인 토큰으로 직접 생성 (MCP·Codex 사용 시)
-4. 작업 전 항상 `git pull`, 작업 후 `git add/commit/push`
+4. 작업 전 항상 `git pull` + 메이커 reload, 작업 후 `git add/commit/push`
 5. **AI 에이전트(Claude Code 등)로 작업한다면 [`RULES.md`](RULES.md) 필독** — 생성 산출물 접근 금지(토큰 가드)·검증 절차·PR 도구(`tools/git/gitea-pr.mjs`) 규칙. Claude Code는 `CLAUDE.md`가 자동 적용

RULES.md

@@ -11,13 +11,32 @@ Claude Code는 `CLAUDE.md`가 이 파일을 임포트하므로 자동 적용된
 
 | 산출물 (절대 Read/Edit 금지) | 크기 | 단일 소스 (여기만 편집) | 재생성 명령 |
 |---|---|---|---|
-| `ui/DefaultGroup.ui` | **8.3MB** | `data/*.json` + `tools/deck/gen-slaydeck.mjs` | `node tools/deck/gen-slaydeck.mjs` |
-| `RootDesk/MyDesk/SlayDeckController.codeblock` | 132KB | 〃 | 〃 |
-| `Global/common.gamelogic` | 1KB | 〃 | 〃 |
-| `map/map01.map`~`map11.map` | 각 ~200KB | `tools/map/`·`tools/monster/`·`tools/camera/` | 해당 생성기 |
+| `ui/DefaultGroup.ui` | **~7.1MB** | `data/*.json` + `tools/deck/`(`gen-slaydeck.mjs`+`lib/`+`hud/`) | `node tools/deck/gen-slaydeck.mjs` |
+| `RootDesk/MyDesk/SlayDeckController.codeblock` | ~270KB | 〃 | 〃 |
+| `Global/common.gamelogic` | ~1KB | 〃 | 〃 |
+| `map/map01.map`~`map05.map`, `map/lobby.map` | 각 ~210KB | `tools/map/`·`tools/monster/`·`tools/camera/`·`tools/player/` (↓ 보조 생성기) | 해당 생성기 |
+| `RootDesk/MyDesk/CombatMonster.codeblock` | ~2KB | `tools/monster/gen-combat-monster.mjs` | `node tools/monster/gen-combat-monster.mjs` |
+| `RootDesk/MyDesk/PlayerLock.codeblock` | ~2KB | `tools/player/gen-player-lock.mjs` | `node tools/player/gen-player-lock.mjs` |
+| `RootDesk/MyDesk/MapCamera.codeblock` | ~2KB | `tools/camera/gen-camera.mjs` (값: `data/camera.json`) | `node tools/camera/gen-camera.mjs` |
+| `RootDesk/MyDesk/LobbyNpc.codeblock`·`LobbyMobility.codeblock` | 각 ~2-3KB | `tools/player/gen-lobby-npc.mjs` | `node tools/player/gen-lobby-npc.mjs` |
+| `Global/SectorConfig.config` | ~1KB | `tools/map/gen-maps.mjs`·`gen-lobby-map.mjs` (패치) | 해당 생성기 |
 
-- `.claude/settings.json`의 permissions.deny가 위 파일의 Read/Edit/Write 도구 사용을 차단한다 (이 저장소를 열면 자동 적용).
-- 게임 로직·UI 수정 = **`tools/deck/gen-slaydeck.mjs`(생성기 JS) 또는 `data/*.json`(데이터)을 수정** → 재생성 → 산출물은 통째로 커밋.
+- `.claude/settings.json`의 permissions.deny가 위 파일의 Read/Edit/Write 도구 사용을 차단한다 (이 저장소를 열면 자동 적용). deny는 **glob** — `ui/*.ui`·`map/*.map`·`RootDesk/MyDesk/*.codeblock`·`Global/common.gamelogic`·`Global/SectorConfig.config`. 따라서 **메이커 저작 codeblock/UI**(`Monster`·`MonsterAttack`·`PlayerAttack`·`PlayerHit`·`UIPopup`·`UIToast`.codeblock, `ui/PopupGroup.ui`·`ui/ToastGroup.ui`)**도** Read/Edit 금지 — 이들은 생성기가 없으니 **메이커에서** 편집한다(텍스트 도구로 X). codeblock은 한 줄짜리 JSON이라 Read 시 토큰 폭발.
+- 게임 로직·UI 수정 = **`tools/deck/gen-slaydeck.mjs`(오케스트레이터 + codeblock Lua) 또는 `data/*.json`(데이터)을 수정** → 재생성 → 산출물은 통째로 커밋.
+  - **UI emit은 HUD별 모듈** `tools/deck/hud/*.mjs`(charselect·shop·combat·map·deckall·soulshop 등 16종), **codeblock 메서드(Lua)는 기능별 모듈** `tools/deck/cb/*.mjs`(boot·state·combat·hand·deckview·items·map·shop 등 17종, 메서드 161개를 연속런으로). **공유분**: UI 헬퍼·상수·데이터·lua 테이블 = `tools/deck/lib/ui-helpers.mjs`·`tools/deck/lib/data.mjs`, method/prop/codeblock 헬퍼·writeCodeblocks 상수 = `tools/deck/lib/codeblock.mjs`. 특정 화면 UI 수정은 `hud/<name>.mjs`, 특정 메서드 수정은 `cb/<name>.mjs`만(의존: orchestrator→{hud,cb}→lib 단방향). prop 103개는 오케스트레이터 writeCodeblocks에 유지. **cb 모듈은 원본 메서드 순서 보존이 바이트동일 조건** — 새 메서드는 해당 기능 모듈의 알맞은 위치에 추가하고 writeCodeblocks의 spread 순서 유지.
+  - 리팩터 시 **출력 바이트-동일 검증**: `node tools/deck/gen-slaydeck.mjs` 후 `node tools/verify/diffcheck.mjs [ref]`(워킹트리 vs ref(기본 HEAD) 줄바꿈 정규화 비교 — 산출물 경로를 명령줄에 노출 안 해 deny 회피). 산출물 ` M`은 보통 autocrlf churn이니 `git checkout --`로 복원.
+  - **머지 충돌(gen-slaydeck.mjs)**: 다른 브랜치가 단일체를 수정해 충돌나면, 그쪽 버전(`git checkout --theirs tools/deck/gen-slaydeck.mjs`)을 취해 **콘텐츠 마커 기반으로 재모듈화**(라인인덱스 X — 줄 추가에 안전·export 이름 자동 파생·`const x=[]` 직전 전문 상수 walk-back 포함) 후 `node tools/verify/diffcheck.mjs origin/main`으로 ui·codeblock 바이트-동일 확인(손실 0 증명). codeblock 메서드·patchCommon은 오케스트레이터 잔류라 그쪽 변경은 자동 보존됨.
+- **보조 생성기**(각자 자기 산출물의 단일 소스 — 위 표의 메인 `gen-slaydeck.mjs` 외):
+  - `tools/camera/gen-camera.mjs` → `MapCamera.codeblock` + map01~05 카메라 부착 (값 `data/camera.json`)
+  - `tools/map/gen-maps.mjs` → `map02~05` + `Global/SectorConfig.config` (map01 템플릿 클론)
+  - `tools/map/gen-lobby-map.mjs` → `map/lobby.map` + `SectorConfig.config`
+  - `tools/map/gen-map-encounters.mjs` → map01~05 노드 타입별 몬스터 그룹 재구성
+  - `tools/monster/gen-combat-monster.mjs` → `CombatMonster.codeblock` + map01~05 부착
+  - `tools/monster/freeze-turn-monsters.mjs` → 몬스터 `.model`·맵 AI 컴포넌트 제거
+  - `tools/player/gen-player-lock.mjs` → `PlayerLock.codeblock` + map01~05 부착
+  - `tools/player/gen-lobby-npc.mjs` → `LobbyNpc.codeblock`·`LobbyMobility.codeblock`
+  - `tools/player/freeze-turn-player.mjs` → `Global/DefaultPlayer.model` 이동 0 고정
+  - `tools/deck/gen-cardhand.mjs` → `DefaultGroup.ui` 카드핸드 보조 패처
 
 ## 2. 산출물 검증은 카운트로, 내용 출력 금지
 
@@ -43,6 +62,7 @@ grep -c "CalcPlayerAttack" RootDesk/MyDesk/SlayDeckController.codeblock
 
 - 브랜치 → 커밋(기능 단위) → push → **PR은 반드시 `node tools/git/gitea-pr.mjs`로** (인라인 `curl -d` 한글 본문은 Windows에서 CP949로 깨짐 — PR #34~41 사고).
   - 제목/본문은 UTF-8 spec JSON 파일로 작성 후 `create <spec.json>` / `merge <번호>`.
+  - PR 제목과 본문은 한국어로 작성한다.
 - 산출물 재생성 커밋은 소스 변경 커밋과 분리하거나, 메시지에 "산출물 재생성"을 명시.
 
 ## 5. 메이커(MSW) 연동 주의
@@ -59,3 +79,9 @@ grep -c "CalcPlayerAttack" RootDesk/MyDesk/SlayDeckController.codeblock
 |---|---|---|---|
 | 전투 규칙 | PlayCard·CalcPlayerAttack 등 | `tools/balance/sim-balance.mjs` | `node --test tools/balance/sim-balance.test.mjs` |
 | 맵 생성 | GenerateMap | `tools/map/rogue-map.mjs` | `node --test tools/map/rogue-map.test.mjs` |
+
+## 7. UI 숫자 표기
+
+- UI 텍스트에서는 정수값인 숫자에 `.0`을 붙이지 않는다. `1.0/1.0`이 아니라 `1/1`처럼 표시한다.
+- 생성기 내 Lua UI 코드에서 number 또는 숫자 문자열을 텍스트에 붙일 때는 `FormatNumber` 같은 포맷 헬퍼를 우선 사용한다.
+- 소수부가 플레이어에게 의미 있을 때만 소수점 표기를 유지한다.

RootDesk/MyDesk/LobbyMobility.codeblock

@@ -0,0 +1,60 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "codeblock://lobbymobility",
+  "ContentType": "x-mod/codeblock",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "CoreVersion": {
+        "Major": 0,
+        "Minor": 2
+      },
+      "ScriptVersion": {
+        "Major": 1,
+        "Minor": 0
+      },
+      "Description": "",
+      "Id": "LobbyMobility",
+      "Language": 1,
+      "Name": "LobbyMobility",
+      "Type": 1,
+      "Source": 0,
+      "Target": null,
+      "Properties": [
+        {
+          "Type": "number",
+          "DefaultValue": "0",
+          "SyncDirection": 0,
+          "Attributes": [],
+          "Name": "Tries"
+        }
+      ],
+      "Methods": [
+        {
+          "Return": {
+            "Type": "void",
+            "DefaultValue": null,
+            "SyncDirection": 0,
+            "Attributes": [],
+            "Name": null
+          },
+          "Arguments": [],
+          "Code": "self.Tries = 0\nlocal eventId = 0\nlocal function apply()\n\tself.Tries = self.Tries + 1\n\tlocal lp = _UserService.LocalPlayer\n\tif lp ~= nil and lp.PlayerControllerComponent ~= nil then\n\t\tlocal pc = lp.PlayerControllerComponent\n\t\tpc.Enable = true\n\t\tpc.FixedLookAt = 0\n\t\tlocal rb = lp.RigidbodyComponent\n\t\tif rb ~= nil then rb.WalkAcceleration = 0.7 end\n\t\tlocal mv = lp.MovementComponent\n\t\tif mv ~= nil then\n\t\t\tmv.InputSpeed = 1.4\n\t\t\tmv.JumpForce = 1.23\n\t\tend\n\t\tlocal cam = lp.CameraComponent\n\t\tif cam == nil then cam = _CameraService:GetCurrentCameraComponent() end\n\t\tif cam ~= nil then\n\t\t\tcam.ZoomRatio = 90\n\t\t\tcam.ConfineCameraArea = false\n\t\t\tcam.ScreenOffset = Vector2(0.5, 0.5)\n\t\t\tcam.CameraOffset = Vector2(0, 0)\n\t\tend\n\t\t_TimerService:ClearTimer(eventId)\n\telseif self.Tries > 50 then\n\t\t_TimerService:ClearTimer(eventId)\n\tend\nend\neventId = _TimerService:SetTimerRepeat(apply, 0.1)",
+          "Scope": 2,
+          "ExecSpace": 6,
+          "Attributes": [],
+          "Name": "OnBeginPlay"
+        }
+      ],
+      "EntityEventHandlers": []
+    }
+  }
+}

RootDesk/MyDesk/LobbyNpc.codeblock

@@ -0,0 +1,89 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "codeblock://lobbynpc",
+  "ContentType": "x-mod/codeblock",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "CoreVersion": {
+        "Major": 0,
+        "Minor": 2
+      },
+      "ScriptVersion": {
+        "Major": 1,
+        "Minor": 0
+      },
+      "Description": "",
+      "Id": "LobbyNpc",
+      "Language": 1,
+      "Name": "LobbyNpc",
+      "Type": 1,
+      "Source": 0,
+      "Target": null,
+      "Properties": [
+        {
+          "Type": "string",
+          "DefaultValue": "\"\"",
+          "SyncDirection": 0,
+          "Attributes": [],
+          "Name": "NpcId"
+        },
+        {
+          "Type": "string",
+          "DefaultValue": "\"\"",
+          "SyncDirection": 0,
+          "Attributes": [],
+          "Name": "MarkName"
+        },
+        {
+          "Type": "boolean",
+          "DefaultValue": "false",
+          "SyncDirection": 0,
+          "Attributes": [],
+          "Name": "InRange"
+        }
+      ],
+      "Methods": [
+        {
+          "Return": {
+            "Type": "void",
+            "DefaultValue": null,
+            "SyncDirection": 0,
+            "Attributes": [],
+            "Name": null
+          },
+          "Arguments": [],
+          "Code": "self.InRange = false\nlocal mark = _EntityService:GetEntityByPath(\"/maps/lobby/\" .. self.MarkName)\nif mark ~= nil then mark:SetVisible(false) end\nself.Entity:ConnectEvent(TouchEvent, function(e)\n\tself:Interact()\nend)\n_InputService:ConnectEvent(KeyDownEvent, function(e)\n\tif self.InRange and e.key == KeyboardKey.UpArrow then\n\t\tself:Interact()\n\tend\nend)\nlocal eventId = 0\nlocal function tick()\n\tlocal lp = _UserService.LocalPlayer\n\tif lp == nil then return end\n\tif mark == nil then mark = _EntityService:GetEntityByPath(\"/maps/lobby/\" .. self.MarkName) end\n\tlocal a = lp.TransformComponent.WorldPosition\n\tlocal b = self.Entity.TransformComponent.WorldPosition\n\tlocal d = Vector2.Distance(Vector2(a.x, a.y), Vector2(b.x, b.y))\n\tlocal near = d < 1.2\n\tif near ~= self.InRange then\n\t\tself.InRange = near\n\t\tif mark ~= nil then mark:SetVisible(near) end\n\tend\nend\neventId = _TimerService:SetTimerRepeat(tick, 0.15)",
+          "Scope": 2,
+          "ExecSpace": 6,
+          "Attributes": [],
+          "Name": "OnBeginPlay"
+        },
+        {
+          "Return": {
+            "Type": "void",
+            "DefaultValue": null,
+            "SyncDirection": 0,
+            "Attributes": [],
+            "Name": null
+          },
+          "Arguments": [],
+          "Code": "local c = _EntityService:GetEntityByPath(\"/common\")\nif c ~= nil and c.SlayDeckController ~= nil then\n\tc.SlayDeckController:OnLobbyNpcInteract(self.NpcId)\nend",
+          "Scope": 2,
+          "ExecSpace": 6,
+          "Attributes": [],
+          "Name": "Interact"
+        }
+      ],
+      "EntityEventHandlers": []
+    }
+  }
+}

RootDesk/MyDesk/MonsterAttack.codeblock

@@ -85,7 +85,7 @@
             "Name": null
           },
           "Arguments": [],
-          "Code": "local monster = self.Entity.Monster\nif not monster then\n\treturn\nend\n\nself.Shape = BoxShape(Vector2.zero, Vector2.one, 0)\n\n-- sprite 사이즈를 가져와 공격 영역으로 사용한다\n_ResourceService:PreloadAsync({self.Entity.SpriteRendererComponent.SpriteRUID}, function()\n\tlocal clip = _ResourceService:LoadAnimationClipAndWait(self.Entity.SpriteRendererComponent.SpriteRUID)\n\tlocal firstFrameSprite = clip.Frames[1].FrameSprite\n\tlocal firstSpriteSizeInPixel = Vector2(firstFrameSprite.Width, firstFrameSprite.Height)\n\tlocal ppu = firstFrameSprite.PixelPerUnit\n\n\tself.SpriteSize = firstSpriteSizeInPixel / ppu\n\tself.PositionOffset = (firstSpriteSizeInPixel / 2 - firstFrameSprite.PivotPixel:ToVector2()) / ppu\n\t\n\t_TimerService:SetTimerRepeat(function() \n\t\tif monster.IsDead == false then\n\t\t\tself:AttackNear()\n\t\tend\n\tend, self.AttackInterval)\nend)",
+          "Code": "local monster = self.Entity.Monster\nif not monster then\n\treturn\nend\n\nself.Shape = BoxShape(Vector2.zero, Vector2.one, 0)\n\n-- sprite 사이즈를 가져와 공격 영역으로 사용한다\n_ResourceService:PreloadAsync({self.Entity.SpriteRendererComponent.SpriteRUID}, function()\n\tif _ResourceService:GetTypeAndWait(self.Entity.SpriteRendererComponent.SpriteRUID) ~= ResourceType.AnimationClip then\n\t\treturn\n\tend\n\tlocal clip = _ResourceService:LoadAnimationClipAndWait(self.Entity.SpriteRendererComponent.SpriteRUID)\n\tif clip == nil then\n\t\treturn\n\tend\n\tlocal firstFrameSprite = clip.Frames[1].FrameSprite\n\tlocal firstSpriteSizeInPixel = Vector2(firstFrameSprite.Width, firstFrameSprite.Height)\n\tlocal ppu = firstFrameSprite.PixelPerUnit\n\n\tself.SpriteSize = firstSpriteSizeInPixel / ppu\n\tself.PositionOffset = (firstSpriteSizeInPixel / 2 - firstFrameSprite.PivotPixel:ToVector2()) / ppu\n\t\n\t_TimerService:SetTimerRepeat(function() \n\t\tif monster.IsDead == false then\n\t\t\tself:AttackNear()\n\t\tend\n\tend, self.AttackInterval)\nend)",
           "Scope": 2,
           "ExecSpace": 1,
           "Attributes": [],

RootDesk/MyDesk/PlayerLock.codeblock

@@ -47,7 +47,7 @@
             "Name": null
           },
           "Arguments": [],
-          "Code": "self.LockTries = 0\nlocal eventId = 0\nlocal function apply()\n\tself.LockTries = self.LockTries + 1\n\tlocal pc = nil\n\tlocal lp = _UserService.LocalPlayer\n\tif lp ~= nil then\n\t\tpc = lp.PlayerControllerComponent\n\tend\n\tif pc ~= nil then\n\t\tpc.LookDirectionX = 1\n\t\tpc.FixedLookAt = true\n\t\tpc.Enable = false\n\tend\n\tif pc ~= nil then\n\t\t_TimerService:ClearTimer(eventId)\n\telseif self.LockTries > 30 then\n\t\t_TimerService:ClearTimer(eventId)\n\tend\nend\neventId = _TimerService:SetTimerRepeat(apply, 0.1)",
+          "Code": "self.LockTries = 0\nlocal eventId = 0\nlocal function apply()\n\tself.LockTries = self.LockTries + 1\n\tlocal pc = nil\n\tlocal lp = _UserService.LocalPlayer\n\tif lp ~= nil then\n\t\tpc = lp.PlayerControllerComponent\n\tend\n\tif pc ~= nil then\n\t\tpc.LookDirectionX = 1\n\t\tpc.FixedLookAt = true\n\t\tpc.Enable = false\n\tend\n\tif lp ~= nil then\n\t\tif lp.RigidbodyComponent ~= nil then lp.RigidbodyComponent.WalkAcceleration = 0 end\n\t\tif lp.MovementComponent ~= nil then lp.MovementComponent.InputSpeed = 0; lp.MovementComponent.JumpForce = 0 end\n\tend\n\tif pc ~= nil then\n\t\t_TimerService:ClearTimer(eventId)\n\telseif self.LockTries > 30 then\n\t\t_TimerService:ClearTimer(eventId)\n\tend\nend\neventId = _TimerService:SetTimerRepeat(apply, 0.1)",
           "Scope": 2,
           "ExecSpace": 6,
           "Attributes": [],

RootDesk/MyDesk/archmage(fire_poison).sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://2d659478140c4b1c8f37febbb61bdaa0",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/2d659478140c4b1c8f37febbb61bdaa0/639171361295360405",
+      "upload_hash": "13E6D3B629261148095059F7C1D8EDC012C7A60422FC769ECB574A7C5A75759E",
+      "name": "archmage(fire_poison)",
+      "resource_guid": "2d659478140c4b1c8f37febbb61bdaa0",
+      "resource_version": "6a3022013e53f03801a4ac58"
+    }
+  }
+}

RootDesk/MyDesk/archmage(thun_cold).sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://ddd0a729328f452b9ff0802ab1f6f579",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/ddd0a729328f452b9ff0802ab1f6f579/639171361295458274",
+      "upload_hash": "7B874B7774FA37E570B16E369112EC467EEA5EC1395A32E4DF01FB6165062E67",
+      "name": "archmage(thun_cold)",
+      "resource_guid": "ddd0a729328f452b9ff0802ab1f6f579",
+      "resource_version": "6a3022012c6a274be88a0819"
+    }
+  }
+}

RootDesk/MyDesk/bandit.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://efa920e58d31426486ef974106e7dc8b",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/efa920e58d31426486ef974106e7dc8b/639171361295547945",
+      "upload_hash": "C4B0469A46B70C2356DC8B0F99D36FD9480BFDA5832E251960DD1FF30C201B7F",
+      "name": "bandit",
+      "resource_guid": "efa920e58d31426486ef974106e7dc8b",
+      "resource_version": "6a302201a81bed5f59770e23"
+    }
+  }
+}

RootDesk/MyDesk/bowmaster.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://93e615d645e948f5a76656bfdd9dce15",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/93e615d645e948f5a76656bfdd9dce15/639171361295501823",
+      "upload_hash": "A5A1263A9E1F5D58B0F985AC58DE7DDE1EA13E0CC5CEE56FC34C3FD792A8D39E",
+      "name": "bowmaster",
+      "resource_guid": "93e615d645e948f5a76656bfdd9dce15",
+      "resource_version": "6a302201a0766b148f66ec2c"
+    }
+  }
+}

RootDesk/MyDesk/cleric.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://3c752ffcd4984dcb9f04baab06544f02",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/3c752ffcd4984dcb9f04baab06544f02/639171361295496567",
+      "upload_hash": "ED1ABC3DBCB04FCBD365BAD0408C8CA1D2458FB337DBDEB4A7EC5DF1BAC32496",
+      "name": "cleric",
+      "resource_guid": "3c752ffcd4984dcb9f04baab06544f02",
+      "resource_version": "6a302201d03493c632770e41"
+    }
+  }
+}

RootDesk/MyDesk/darkknight.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://e207e6839a4a4bd0aab681bd296a609a",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/e207e6839a4a4bd0aab681bd296a609a/639171361295401732",
+      "upload_hash": "D5931943781C46611D43595594234BFB133F8BCCAA920C13BCA7E2F8AC9C09D0",
+      "name": "darkknight",
+      "resource_guid": "e207e6839a4a4bd0aab681bd296a609a",
+      "resource_version": "6a302201644d4c175c75d435"
+    }
+  }
+}

RootDesk/MyDesk/hero.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://0efbf37bb7414aea82b257781068372b",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/0efbf37bb7414aea82b257781068372b/639171361295431877",
+      "upload_hash": "DE22318162E1F93E7B90A0B6A59BE31FC76DEEC122914979915D6D575A4D99B5",
+      "name": "hero",
+      "resource_guid": "0efbf37bb7414aea82b257781068372b",
+      "resource_version": "6a302201c377d9630d82c463"
+    }
+  }
+}

RootDesk/MyDesk/hunter.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://fd460e6ee38a40e3b6b05580d00773b6",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/fd460e6ee38a40e3b6b05580d00773b6/639171361295408991",
+      "upload_hash": "B832DE85217EA6544BA4477F0DBA5D2148E4E392A170944336E0DA74E8D41961",
+      "name": "hunter",
+      "resource_guid": "fd460e6ee38a40e3b6b05580d00773b6",
+      "resource_version": "6a3022013d5de2eb0c7d2a51"
+    }
+  }
+}

RootDesk/MyDesk/mage.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://3b9ea1f066a744bb859df47fef817277",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/3b9ea1f066a744bb859df47fef817277/639171361295599801",
+      "upload_hash": "770C9D83241F8CE2C0EA8B742887D8351A580E2DE15A6380380653855A974F14",
+      "name": "mage",
+      "resource_guid": "3b9ea1f066a744bb859df47fef817277",
+      "resource_version": "6a302201cc7e89479f12a1ac"
+    }
+  }
+}

RootDesk/MyDesk/nightlord.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://994c64290e6d4248bd60aba03a595f72",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/994c64290e6d4248bd60aba03a595f72/639171361295422460",
+      "upload_hash": "A0B7146F6D8E9D72CEACDB7E21A2CD6EEBD4135554D3965B4E1C06BC98FC1211",
+      "name": "nightlord",
+      "resource_guid": "994c64290e6d4248bd60aba03a595f72",
+      "resource_version": "6a30220139613d284615a1e1"
+    }
+  }
+}

RootDesk/MyDesk/palladin.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://415d423954764b659574fe829f9aff52",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/415d423954764b659574fe829f9aff52/639171361329450040",
+      "upload_hash": "EB94BA457C18E04D87964201DD50042695A3C7F93651CBC8ED9509BDDE07F331",
+      "name": "palladin",
+      "resource_guid": "415d423954764b659574fe829f9aff52",
+      "resource_version": "6a302205a0766b148f66ec2d"
+    }
+  }
+}

RootDesk/MyDesk/pirate.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://94d6417c55da48e9861964c405991219",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/94d6417c55da48e9861964c405991219/639171361329410075",
+      "upload_hash": "EBEC4B43CDBB1759C0BC92C051252A7DF84E6B89C9C56ECBFEFF543A0E260889",
+      "name": "pirate",
+      "resource_guid": "94d6417c55da48e9861964c405991219",
+      "resource_version": "6a3022052c6a274be88a081a"
+    }
+  }
+}

RootDesk/MyDesk/shadower.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://06c1060586e3457f897f2c596eb5cd71",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/06c1060586e3457f897f2c596eb5cd71/639171361329387468",
+      "upload_hash": "42EE2E63508762E86391486107A23322E11038070F48851D03FE91255CF41596",
+      "name": "shadower",
+      "resource_guid": "06c1060586e3457f897f2c596eb5cd71",
+      "resource_version": "6a302205a81bed5f59770e24"
+    }
+  }
+}

RootDesk/MyDesk/singung.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://b2e099f2e5334705af122e3f88840ba7",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/b2e099f2e5334705af122e3f88840ba7/639171361329408374",
+      "upload_hash": "2AB66279D07E64A17CD2AD05BB03F732632805B0076278EC94F51C0227341CC5",
+      "name": "singung",
+      "resource_guid": "b2e099f2e5334705af122e3f88840ba7",
+      "resource_version": "6a302204c377d9630d82c464"
+    }
+  }
+}

RootDesk/MyDesk/warrior.sprite

@@ -0,0 +1,23 @@
+{
+  "Id": "",
+  "GameId": "",
+  "EntryKey": "sprite://28c88fdc5ab44f34a8b3fc1e19d4ce78",
+  "ContentType": "x-mod/sprite",
+  "Content": "",
+  "Usage": 0,
+  "UsePublish": 1,
+  "UseService": 0,
+  "CoreVersion": "26.5.0.0",
+  "StudioVersion": "0.1.0.0",
+  "DynamicLoading": 0,
+  "ContentProto": {
+    "Use": "Json",
+    "Json": {
+      "upload_keyname": "30/54/30542a379cb74d2d807104635740a8ea/sprite/28c88fdc5ab44f34a8b3fc1e19d4ce78/639171361330139251",
+      "upload_hash": "2929F452FBB26215631886FFB430EE6035D55EB42B1770E880C1B0A34D97BDA0",
+      "name": "warrior",
+      "resource_guid": "28c88fdc5ab44f34a8b3fc1e19d4ce78",
+      "resource_version": "6a30220539613d284615a1e2"
+    }
+  }
+}

data/cardframes.json

@@ -1,14 +1,39 @@
 {
   "frames": {
-    "warrior":  { "normal": "4bb57ef88ef449fdaf958f6cf37fe44b", "unique": "4f71c124c8bc4e13b5e9fad392995f68", "legend": "6d741a60c60743cb98ee740a1e2dbfed" },
-    "magician": { "normal": "d788d09f6f50467ebc67f01dec45f9e2", "unique": "f5def2e8022b4e59a17d3c16414034fe", "legend": "cff71f2e472041ce80c6fbd296f42e2d" },
-    "bandit":   { "normal": "9487b06867bc46269ed1d855420f457f", "unique": "b3081fb2fb1445fa90b12b01481a78ef", "legend": "c357d2daf31a489d95b8fa47e50dd879" }
+    "warrior": {
+      "normal": "4bb57ef88ef449fdaf958f6cf37fe44b",
+      "unique": "4f71c124c8bc4e13b5e9fad392995f68",
+      "legend": "6d741a60c60743cb98ee740a1e2dbfed"
+    },
+    "magician": {
+      "normal": "d788d09f6f50467ebc67f01dec45f9e2",
+      "unique": "f5def2e8022b4e59a17d3c16414034fe",
+      "legend": "cff71f2e472041ce80c6fbd296f42e2d"
+    },
+    "bandit": {
+      "normal": "9487b06867bc46269ed1d855420f457f",
+      "unique": "b3081fb2fb1445fa90b12b01481a78ef",
+      "legend": "c357d2daf31a489d95b8fa47e50dd879"
+    }
   },
   "classToFrame": {
-    "warrior": "warrior", "fighter": "warrior", "page": "warrior", "spearman": "warrior",
-    "magician": "magician", "firepoison": "magician", "icelightning": "magician", "cleric": "magician",
-    "thief": "bandit", "assassin": "bandit", "bandit": "bandit",
-    "curse": "bandit"
+    "warrior": "warrior",
+    "fighter": "warrior",
+    "page": "warrior",
+    "spearman": "warrior",
+    "magician": "magician",
+    "firepoison": "magician",
+    "icelightning": "magician",
+    "cleric": "magician",
+    "bandit": "bandit",
+    "curse": "bandit",
+    "shiv": "bandit",
+    "poisoner": "bandit",
+    "trickster": "bandit"
   },
-  "rewardWeights": { "normal": 70, "unique": 25, "legend": 5 }
+  "rewardWeights": {
+    "normal": 70,
+    "unique": 25,
+    "legend": 5
+  }
 }

data/characters.json

@@ -0,0 +1,7 @@
+{
+  "portraits": {
+    "warrior":  "28c88fdc5ab44f34a8b3fc1e19d4ce78",
+    "magician": "3b9ea1f066a744bb859df47fef817277",
+    "bandit":   "efa920e58d31426486ef974106e7dc8b"
+  }
+}

data/nodeicons.json

@@ -0,0 +1,11 @@
+{
+  "icons": {
+    "combat":   "f98db6823e894a4f90308d61f75894ac",
+    "elite":    "793ed8a757534b89a82f460747d2df24",
+    "boss":     "423056cdbbc04f4da131b9721c404d96",
+    "shop":     "da37e1fac55d455b9ade08569f09f798",
+    "rest":     "b86c1b0568bd45f3ae4a4b97e1b4a594",
+    "treasure": "f8a6d58e20f54e2ca899485055df1ce4"
+  },
+  "background": "ef89906dd9844fcbaafc0b2313812eca"
+}

docs/superpowers/plans/2026-06-14-lobby-map-npc.md

@@ -0,0 +1,524 @@
+# P15 — 로비 맵 + 월드 NPC 구현 계획
+
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:executing-plans. 설계: `docs/superpowers/specs/2026-06-14-lobby-map-npc-design.md`. 산출물(`map/*.map`,`ui/DefaultGroup.ui`,`*.codeblock`,`Global/*`)은 Read/Edit 금지 — 생성기 소스(`tools/`)만 수정 후 재생성. 검증은 `grep -c`(카운트)와 메이커 플레이테스트.
+
+**Goal:** UI 패널 로비를 폐기하고, 전용 물리 맵 `lobby`에 공식 메이플 NPC 4종을 월드 엔티티로 배치해 근접(↑키)·클릭으로 기능을 열며, 이동·공격 모션은 로비 맵에서만 풀린다.
+
+**Architecture:** 단일 소스(`tools/*` 생성기 + `data/*.json`) → 산출물 재생성. 신규 생성기 2개(`gen-lobby-map.mjs`=맵+NPC 엔티티, `gen-lobby-npc.mjs`=LobbyNpc+LobbyMobility codeblock) + `gen-slaydeck.mjs`(흐름·UI) + `gen-player-lock.mjs`(전투맵 이동 재잠금 보강) 수정. 기존 기능 패널(CharacterSelect/Codex/SoulShop/Board)·전투 흐름 재사용.
+
+**Tech Stack:** Node.js ESM 생성기, MSW Lua(codeblock), MSW MCP(플레이테스트·asset).
+
+**확정 사실(조사):**
+- gen-slaydeck 편집 지점: OnBeginPlay `2830-2840`, ShowLobby `2986-2993`, LobbyHud npcs배열 `2469-2474`+버튼루프 `2475-2524`, lobTexts `2433-2439`, Asc버튼 `2454-2468`, BindLobbyButtons `2997-3014`, ShowState `2906-2922`, StartRun `3199-3232`, EndRun `4391-4403`, TeleportToActMap `4373-4385`, PlayerAttackMotion `4491-4500`, guid prefix `244-245`, ACT_MAPS `2745`.
+- **1막 텔레포트 공백**: StartRun(`3199-3232`)에 map01 텔레포트가 없음 → `self:TeleportToActMap()` 추가 필요(`RenderPotions` 다음, `ShowMap` 직전). `TeleportToActMap`은 `maps[self.Floor]` 사용 + 가드 `if lp.CurrentMapName==target then return`(멱등).
+- **NPC 공식 RUID**(maplestory, 흰박스 위험 없음): 모험가 `122095fd155c4633867b0da4f375bc3c`, 사서 `4c264be6a64f4ac3970b2e6818d04e40`, 상인 `69987ccdc486423f8bedd786bd6cb5d9`, 안내원 `8a99bd87d667482cb1f3b2193f8a19c1`.
+- **MSW API**: 월드 클릭 = 엔티티에 `TouchReceiveComponent` + `self.Entity:ConnectEvent(TouchEvent, fn)`. 키 = `_InputService:ConnectEvent(KeyDownEvent, fn)` + `KeyboardKey.UpArrow`(273)/`Space`(32)/`LeftControl`. 거리 = `Vector2.Distance(Vector2(a.x,a.y),Vector2(b.x,b.y))`. 이동복원 = `pc.Enable=true; pc.FixedLookAt=false; mv.InputSpeed=<V>; mv.JumpForce=<J>`(client 공간). 표시토글 = `entity:SetVisible(bool)`.
+- **맵 생성 패턴**(gen-maps.mjs): `JSON.parse(readFileSync('map/map01.map'))` → deep clone → 경로 `/maps/map01`→`/maps/lobby` 치환 → GUID 재발급(+origin fixup) → `compOf(e,'MOD.Core.X')`로 컴포넌트 접근 → `writeFileSync('map/lobby.map', JSON.stringify(map,null,2))`. 배경=`/Background`의 `BackgroundComponent.TemplateRUID`, 타일=`/TileMap`의 `TileMapComponent.TileSetRUID={DataId}`. 컴포넌트 부착=`@components` push + `componentNames` CSV 둘 다. SectorConfig=`Sectors[0].entries`에 `map://lobby` push.
+- **codeblock 패턴**(gen-combat-monster.mjs): `prop()/method()` 팩토리 + 봉투(`CoreVersion:'26.5.0.0'`, `EntryKey:'codeblock://x'`) → `writeFileSync('RootDesk/MyDesk/X.codeblock', JSON.stringify(cb,null,2))`. 컨트롤러 호출=`_EntityService:GetEntityByPath("/common").SlayDeckController:Method(...)`. 폴 idiom=`_TimerService:SetTimerRepeat(fn,0.1)`+try카운트 가드+`:ClearTimer(id)`.
+
+---
+
+### Task 0: 메이커 사전 정찰 (이동값·키·바디 컴포넌트·스폰좌표 확정)
+
+**목적:** LobbyMobility의 이동 복원 수치·공격 키·바디 컴포넌트 종류·로비 스폰 좌표를 추측이 아니라 실측으로 확정. 산출물 작성 전 선행.
+
+- [ ] **Step 1:** 메이커가 켜져 있는지 확인하고 현재 빌드 플레이. `mcp__msw-maker-mcp__maker_play` → `maker_screenshot`로 현재 화면(UI 로비) 확인.
+
+- [ ] **Step 2:** execute_script로 LocalPlayer 컴포넌트·이동값·바디 종류 덤프:
+
+```lua
+local lp = _UserService.LocalPlayer
+local s = "pc="..tostring(lp.PlayerControllerComponent ~= nil)
+local mv = lp.MovementComponent
+if mv ~= nil then s = s.." InputSpeed="..tostring(mv.InputSpeed).." JumpForce="..tostring(mv.JumpForce) end
+s = s.." Rigidbody="..tostring(lp.RigidbodyComponent ~= nil)
+s = s.." Sideviewbody="..tostring(lp.SideviewbodyComponent ~= nil)
+local p = lp.TransformComponent.WorldPosition
+s = s.." pos=("..tostring(p.x)..","..tostring(p.y)..","..tostring(p.z)..")"
+s = s.." map="..tostring(lp.CurrentMapName)
+log(s)
+return s
+```
+
+Run via `maker_execute_script`. 기대: 현재 InputSpeed/JumpForce(0일 것), 어떤 바디 컴포넌트가 존재하는지(Rigidbody vs Sideviewbody), 현재 맵 이름·좌표.
+
+- [ ] **Step 3:** 이동 복원값 실측 — execute_script로 직접 켜 보고 걸어지는지 확인:
+
+```lua
+local lp = _UserService.LocalPlayer
+lp.PlayerControllerComponent.Enable = true
+lp.PlayerControllerComponent.FixedLookAt = false
+lp.MovementComponent.InputSpeed = 5
+lp.MovementComponent.JumpForce = 5
+return "applied: try walking with arrow keys"
+```
+
+`maker_keyboard_input`로 방향키를 눌러 실제 이동 여부 확인(screenshot 비교). 걸으면 InputSpeed 값 후보 = 5. 안 걸으면 RigidbodyComponent.WalkSpeed/WalkJump 등도 set해보고(아래) 동작하는 최소 set을 기록.
+
+```lua
+local rb = _UserService.LocalPlayer.RigidbodyComponent
+if rb ~= nil then rb.Enable = true end
+```
+
+- [ ] **Step 4:** 공격 키 enum 확정 — `mlua_api_retriever`(이미 검증됨: UpArrow=273, Space=32)에서 공격용 키 `LeftControl`의 정확한 enum 멤버명 확인(예: `KeyboardKey.LeftControl`). 확인 안 되면 공격 키를 `KeyboardKey.Space`로 폴백(이동 점프는 MSW 기본 Alt 가정).
+
+- [ ] **Step 5:** 결정 기록 — 이 plan 파일 하단 "정찰 결과" 섹션에 확정값 적기:
+  - `WALK_SPEED` = (Step3에서 걸어진 InputSpeed), `JUMP_FORCE` = (걸어진 JumpForce), `BODY_KIND` = Rigidbody|Sideviewbody|none, 추가 바디 set 필요 여부, `ATTACK_KEY` = LeftControl|Space, `LOBBY_SPAWN` = 적당한 지면 좌표(현재 map 좌표 참고, 예 `Vector3(0, 0.03, 0)`).
+  - 이후 Task에서 이 값을 JS 상수로 사용.
+
+- [ ] **Step 6:** `maker_stop`으로 플레이 종료(상태 churn 방지).
+
+---
+
+### Task 1: `gen-lobby-map.mjs` — 로비 맵 + NPC 엔티티 생성
+
+**Files:**
+- Create: `tools/map/gen-lobby-map.mjs`
+- Output(산출물, 직접 편집 금지): `map/lobby.map`, `Global/SectorConfig.config`(갱신)
+
+NPC 4종 + `!` 마크 4종을 월드 엔티티로 배치. 마크는 자식이 아니라 **형제 엔티티**(NPC 위 고정 위치, 정적이라 무방). 각 NPC에 `TouchReceiveComponent` + `script.LobbyNpc`(NpcId), 맵 루트에 `script.LobbyMobility` 부착.
+
+- [ ] **Step 1:** `tools/map/gen-maps.mjs`를 참고 헤더로 새 파일 생성. 상수:
+
+```js
+import { readFileSync, writeFileSync } from 'node:fs';
+
+const TEMPLATE = 'map/map01.map';
+const OUT = 'map/lobby.map';
+const SECTOR = 'Global/SectorConfig.config';
+const TOWN_BG = '<gen-maps.mjs BACKGROUNDS 풀에서 타운(헤네시스 등) RUID 1개 복사>'; // Task1 Step2에서 확정
+const NPCS = [
+  { name: 'NpcRun',   id: 'run',   x: -4.5, ruid: '122095fd155c4633867b0da4f375bc3c' },
+  { name: 'NpcCodex', id: 'codex', x: -1.5, ruid: '4c264be6a64f4ac3970b2e6818d04e40' },
+  { name: 'NpcShop',  id: 'shop',  x:  1.5, ruid: '69987ccdc486423f8bedd786bd6cb5d9' },
+  { name: 'NpcBoard', id: 'board', x:  4.5, ruid: '8a99bd87d667482cb1f3b2193f8a19c1' },
+];
+const MARK_RUID = '<Task1 Step2: asset_search로 "!" 말풍선/느낌표 공식 스프라이트 RUID, 못찾으면 NPC와 구분되는 작은 공식 스프라이트>';
+const NPC_Y = 0.0;       // 지면 (Task0 좌표 참고로 조정)
+const MARK_DY = 1.6;     // NPC 머리 위 오프셋
+
+function compOf(e, type) { return e.jsonString['@components'].find((c) => c['@type'] === type); }
+function lobbyGuid(idx) {
+  const n = (900000 + idx) >>> 0; // 기존 생성기와 충돌 없는 고유 오프셋
+  return `${n.toString(16).padStart(8,'0')}-0000-4000-8000-${n.toString(16).padStart(12,'0')}`;
+}
+```
+
+- [ ] **Step 2:** TOWN_BG·MARK_RUID 확정 — `gen-maps.mjs`를 열어 `BACKGROUNDS` 배열에서 타운 느낌 RUID 하나 골라 `TOWN_BG`에 박는다. MARK_RUID는 메이커 MCP `asset_search_resources`(source=maplestory, query "느낌표"/"balloon"/"emotion")로 1개 확정(못 찾으면 `!` 대신 작은 화살표/별 공식 스프라이트, 최후엔 NPC RUID 재사용+tint).
+
+- [ ] **Step 3:** 맵 로드·클론·정리(몬스터 제거)·배경:
+
+```js
+const map = JSON.parse(JSON.stringify(JSON.parse(readFileSync(TEMPLATE, 'utf8'))));
+map.EntryKey = 'map://lobby';
+let ents = map.ContentProto.Entities;
+const isMonster = (e) => typeof e.componentNames === 'string' && (e.componentNames.includes('script.Monster') || e.componentNames.includes('script.CombatMonster'));
+// 경로/이름 치환
+for (const e of ents) {
+  if (typeof e.path === 'string') e.path = e.path.replace('/maps/map01', '/maps/lobby');
+  if (e.jsonString) {
+    if (typeof e.jsonString.path === 'string') e.jsonString.path = e.jsonString.path.replace('/maps/map01', '/maps/lobby');
+    if (e.jsonString.name === 'map01') e.jsonString.name = 'lobby';
+  }
+  if ((e.path || '').endsWith('/Background')) { const bg = compOf(e, 'MOD.Core.BackgroundComponent'); if (bg) bg.TemplateRUID = TOWN_BG; }
+}
+// 몬스터 엔티티 제거 + PlayerLock/MapCamera는 유지(로비엔 PlayerLock 불필요하니 루트에서 제거)
+ents = ents.filter((e) => !isMonster(e));
+const root = ents.find((e) => e.path === '/maps/lobby');
+if (!root) throw new Error('[gen-lobby-map] 맵 루트 없음');
+// 로비엔 PlayerLock 컴포넌트가 있으면 제거(이동 잠금 방지)
+root.jsonString['@components'] = root.jsonString['@components'].filter((c) => c['@type'] !== 'script.PlayerLock');
+{ const names = (root.componentNames || '').split(',').filter((s) => s && s !== 'script.PlayerLock'); root.componentNames = names.join(','); }
+```
+
+- [ ] **Step 4:** NPC 엔티티 + 마크 엔티티 생성(몬스터 템플릿을 클론해 몬스터 컴포넌트 제거 후 재사용). 몬스터 템플릿은 클론 전에 원본 ents(`map.ContentProto.Entities`)에서 확보:
+
+```js
+const orig = JSON.parse(readFileSync(TEMPLATE, 'utf8')).ContentProto.Entities;
+const tmpl = orig.find((e) => typeof e.componentNames === 'string' && e.componentNames.includes('script.Monster'));
+if (!tmpl) throw new Error('[gen-lobby-map] 몬스터 템플릿(스프라이트 엔티티) 없음');
+let gi = 1;
+function makeSpriteEntity(name, x, y, ruid, extraComps, extraNames, visible) {
+  const m = JSON.parse(JSON.stringify(tmpl));
+  m.id = lobbyGuid(gi++);
+  m.path = `/maps/lobby/${name}`;
+  m.jsonString.path = m.path;
+  m.jsonString.name = name;
+  const o = m.jsonString.origin; if (o) { if (o.root_entity_id) o.root_entity_id = m.id; if (o.sub_entity_id) o.sub_entity_id = m.id; }
+  const tr = compOf(m, 'MOD.Core.TransformComponent'); if (tr) { tr.Position.x = x; tr.Position.y = y; }
+  const sp = compOf(m, 'MOD.Core.SpriteRendererComponent'); if (sp) sp.SpriteRUID = ruid;
+  // 몬스터/전투 컴포넌트 전부 제거
+  m.jsonString['@components'] = m.jsonString['@components'].filter((c) => !['script.Monster','script.CombatMonster'].includes(c['@type']));
+  let names = (m.componentNames || '').split(',').filter((s) => s && !['script.Monster','script.CombatMonster'].includes(s));
+  // StateAnimationComponent가 있으면 die/hit 시트 제거(정적 stand)
+  for (const [comp, props] of extraComps) { m.jsonString['@components'].push({ '@type': comp, Enable: true, ...props }); names.push(comp); }
+  names = names.concat(extraNames).filter(Boolean);
+  m.componentNames = names.join(',');
+  // 마크 숨김은 Enable=false 금지(SetVisible가 안 먹음). codeblock OnBeginPlay가 SetVisible(false)로 숨기므로
+  // 여기선 별도 처리 안 함. (한 프레임 깜빡임 우려 시 SpriteRendererComponent.Visible=false 시도 — 필드 확인 후.)
+  void visible;
+  return m;
+}
+const added = [];
+for (const npc of NPCS) {
+  // NPC: TouchReceiveComponent(자동맞춤) + script.LobbyNpc(NpcId)
+  added.push(makeSpriteEntity(npc.name, npc.x, NPC_Y, npc.ruid,
+    [['MOD.Core.TouchReceiveComponent', { AutoFitToSize: true }], ['script.LobbyNpc', { NpcId: npc.id, Tries: 0, InRange: false, MarkName: npc.name + 'Mark' }]],
+    ['MOD.Core.TouchReceiveComponent', 'script.LobbyNpc'], true));
+  // 마크: NPC 위, 기본 숨김
+  added.push(makeSpriteEntity(npc.name + 'Mark', npc.x, NPC_Y + MARK_DY, MARK_RUID, [], [], false));
+}
+ents = ents.concat(added);
+```
+
+> 주: `script.LobbyNpc` props(NpcId/MarkName 등)는 Task2의 codeblock 속성 정의와 **이름이 정확히 일치**해야 한다.
+
+- [ ] **Step 5:** 맵 루트에 `script.LobbyMobility` 부착 + 쓰기 + SectorConfig 등록:
+
+```js
+root.jsonString['@components'] = root.jsonString['@components'].filter((c) => c['@type'] !== 'script.LobbyMobility');
+root.jsonString['@components'].push({ '@type': 'script.LobbyMobility', Enable: true, Tries: 0 });
+{ const names = (root.componentNames || '').split(',').filter((s) => s && s !== 'script.LobbyMobility'); names.push('script.LobbyMobility'); root.componentNames = names.join(','); }
+map.ContentProto.Entities = ents;
+writeFileSync(OUT, JSON.stringify(map, null, 2), 'utf8');
+// SectorConfig: map://lobby 등록(멱등) + 시작 섹터를 lobby로
+const sector = JSON.parse(readFileSync(SECTOR, 'utf8'));
+const sec0 = sector.ContentProto.Json.Sectors[0];
+if (!sec0.entries.includes('map://lobby')) sec0.entries.push('map://lobby');
+writeFileSync(SECTOR, JSON.stringify(sector, null, 2), 'utf8');
+console.log('[gen-lobby-map] lobby.map 생성 + SectorConfig 등록 완료');
+```
+
+- [ ] **Step 6:** 실행 + 카운트 검증(내용 출력 금지):
+
+```bash
+node tools/map/gen-lobby-map.mjs
+grep -c "script.LobbyNpc" map/lobby.map        # 4 기대
+grep -c "script.LobbyMobility" map/lobby.map   # 1 기대
+grep -c "TouchReceiveComponent" map/lobby.map  # 4(+ 템플릿 잔존 가능) 기대
+grep -lc "map://lobby" Global/SectorConfig.config
+node tools/verify/count.mjs 2>/dev/null || true
+```
+
+기대: LobbyNpc=4, LobbyMobility=1. 어긋나면 생성기 수정.
+
+- [ ] **Step 7:** 커밋:
+
+```bash
+git add tools/map/gen-lobby-map.mjs map/lobby.map Global/SectorConfig.config
+git commit -m "feat(lobby): 로비 전용 맵 + NPC 4종 월드 엔티티 생성기 (P15)"
+```
+
+---
+
+### Task 2: `gen-lobby-npc.mjs` — LobbyNpc + LobbyMobility codeblock
+
+**Files:**
+- Create: `tools/player/gen-lobby-npc.mjs`
+- Output(산출물): `RootDesk/MyDesk/LobbyNpc.codeblock`, `RootDesk/MyDesk/LobbyMobility.codeblock`
+
+`gen-combat-monster.mjs`의 `prop()/method()`/봉투 패턴을 그대로 복사. **Lua 문자열은 실제 탭 들여쓰기 사용**(RULES.md 메모리: 실탭↔`\t` 혼재 금지 — 템플릿 리터럴 안 실제 탭).
+
+- [ ] **Step 1:** 헤더·팩토리(gen-combat-monster.mjs:9-17 복사) + 봉투 함수:
+
+```js
+import { writeFileSync } from 'node:fs';
+const WALK_SPEED = /* Task0 정찰값 */ 5;
+const JUMP_FORCE = /* Task0 정찰값 */ 5;
+const ATTACK_KEY = /* Task0: 'LeftControl' 또는 'Space' */ 'LeftControl';
+
+function prop(Type, Name, DefaultValue = 'nil') { return { Type, DefaultValue, SyncDirection: 0, Attributes: [], Name }; }
+function method(Name, Code, Arguments = [], ExecSpace = 6) {
+  return { Return: { Type: 'void', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: null }, Arguments, Code, Scope: 2, ExecSpace, Attributes: [], Name };
+}
+function writeCodeblock(id, name, properties, methods) {
+  const cb = { Id: '', GameId: '', EntryKey: `codeblock://${id.toLowerCase()}`, ContentType: 'x-mod/codeblock', Content: '', Usage: 0, UsePublish: 1, UseService: 0, CoreVersion: '26.5.0.0', StudioVersion: '', DynamicLoading: 0,
+    ContentProto: { Use: 'Json', Json: { CoreVersion: { Major: 0, Minor: 2 }, ScriptVersion: { Major: 1, Minor: 0 }, Description: '', Id: name, Language: 1, Name: name, Type: 1, Source: 0, Target: null, Properties: properties, Methods: methods, EntityEventHandlers: [] } } };
+  writeFileSync(`RootDesk/MyDesk/${name}.codeblock`, JSON.stringify(cb, null, 2), 'utf8');
+}
+```
+
+- [ ] **Step 2:** LobbyNpc codeblock — 근접 폴링 + 마크 토글 + Touch/Key → Interact. (아래 Lua의 들여쓰기는 실제 탭으로 입력)
+
+```js
+const npcInteract = method('Interact', `local c = _EntityService:GetEntityByPath("/common")
+if c ~= nil and c.SlayDeckController ~= nil then
+	c.SlayDeckController:OnLobbyNpcInteract(self.NpcId)
+end`);
+
+const npcBegin = method('OnBeginPlay', `self.Tries = 0
+self.InRange = false
+local mark = _EntityService:GetEntityByPath("/maps/lobby/" .. self.MarkName)
+if mark ~= nil then mark:SetVisible(false) end
+self.Entity:ConnectEvent(TouchEvent, function(e) self:Interact() end)
+_InputService:ConnectEvent(KeyDownEvent, function(e)
+	if self.InRange and e.key == KeyboardKey.UpArrow then self:Interact() end
+end)
+local eventId = 0
+local function tick()
+	local lp = _UserService.LocalPlayer
+	if lp == nil then return end
+	local a = lp.TransformComponent.WorldPosition
+	local b = self.Entity.TransformComponent.WorldPosition
+	local d = Vector2.Distance(Vector2(a.x, a.y), Vector2(b.x, b.y))
+	local near = d < 1.8
+	if near ~= self.InRange then
+		self.InRange = near
+		if mark ~= nil then mark:SetVisible(near) end
+	end
+end
+eventId = _TimerService:SetTimerRepeat(tick, 0.15)`);
+
+writeCodeblock('LobbyNpc', 'LobbyNpc', [
+  prop('string', 'NpcId', '""'),
+  prop('string', 'MarkName', '""'),
+  prop('boolean', 'InRange', 'false'),
+  prop('number', 'Tries', '0'),
+], [npcBegin, npcInteract]);
+```
+
+- [ ] **Step 3:** LobbyMobility codeblock — 이동 복원 + 공격 키. (들여쓰기 실제 탭)
+
+```js
+const mobBegin = method('OnBeginPlay', `self.Tries = 0
+local eventId = 0
+local function apply()
+	self.Tries = self.Tries + 1
+	local lp = _UserService.LocalPlayer
+	if lp ~= nil and lp.PlayerControllerComponent ~= nil then
+		local pc = lp.PlayerControllerComponent
+		pc.Enable = true
+		pc.FixedLookAt = false
+		local mv = lp.MovementComponent
+		if mv ~= nil then
+			mv.InputSpeed = ${WALK_SPEED}
+			mv.JumpForce = ${JUMP_FORCE}
+		end
+		local rb = lp.RigidbodyComponent
+		if rb ~= nil then rb.Enable = true end
+		_TimerService:ClearTimer(eventId)
+	elseif self.Tries > 50 then
+		_TimerService:ClearTimer(eventId)
+	end
+end
+eventId = _TimerService:SetTimerRepeat(apply, 0.1)
+_InputService:ConnectEvent(KeyDownEvent, function(e)
+	if e.key == KeyboardKey.${ATTACK_KEY} then
+		local c = _EntityService:GetEntityByPath("/common")
+		if c ~= nil and c.SlayDeckController ~= nil then
+			c.SlayDeckController:PlayerAttackMotion()
+		end
+	end
+end)`);
+
+writeCodeblock('LobbyMobility', 'LobbyMobility', [prop('number', 'Tries', '0')], [mobBegin]);
+console.log('[gen-lobby-npc] LobbyNpc/LobbyMobility codeblock 생성 완료');
+```
+
+- [ ] **Step 4:** 실행 + 카운트 검증:
+
+```bash
+node tools/player/gen-lobby-npc.mjs
+grep -c "OnLobbyNpcInteract" RootDesk/MyDesk/LobbyNpc.codeblock      # >=1
+grep -c "PlayerAttackMotion" RootDesk/MyDesk/LobbyMobility.codeblock # >=1
+ls -la RootDesk/MyDesk/LobbyNpc.codeblock RootDesk/MyDesk/LobbyMobility.codeblock
+```
+
+- [ ] **Step 5:** 커밋:
+
+```bash
+git add tools/player/gen-lobby-npc.mjs RootDesk/MyDesk/LobbyNpc.codeblock RootDesk/MyDesk/LobbyMobility.codeblock
+git commit -m "feat(lobby): LobbyNpc(근접·클릭 상호작용)·LobbyMobility(이동·공격 해제) codeblock (P15)"
+```
+
+---
+
+### Task 3: `gen-player-lock.mjs` — 전투맵 이동 재잠금 보강 (방어)
+
+**Files:** Modify `tools/player/gen-player-lock.mjs`
+
+로비에서 푼 이동이 텔레포트 후 전투맵에 누설돼도, 전투맵 PlayerLock이 런타임으로 MovementComponent를 0으로 재설정해 확실히 잠그도록 보강.
+
+- [ ] **Step 1:** `gen-player-lock.mjs`의 PlayerLock Lua에서 `pc.Enable = false` 직후 라인을 추가(생성기 내 해당 Lua 템플릿 리터럴, 실제 탭 들여쓰기):
+
+```lua
+pc.Enable = false
+local mv = lp.MovementComponent
+if mv ~= nil then mv.InputSpeed = 0; mv.JumpForce = 0 end
+```
+
+(정확한 삽입 지점은 `gen-player-lock.mjs`에서 `pc.Enable`가 들어간 Lua 문자열. `LocalPlayer.PlayerControllerComponent`를 `lp`로 잡는 변수명이 기존 코드와 일치하는지 확인 — 다르면 기존 변수명 사용.)
+
+- [ ] **Step 2:** 재생성 + 카운트:
+
+```bash
+node tools/player/gen-player-lock.mjs
+grep -c "InputSpeed = 0" RootDesk/MyDesk/PlayerLock.codeblock   # >=1 기대(파일명은 생성기 출력명 확인)
+```
+
+- [ ] **Step 3:** 커밋:
+
+```bash
+git add tools/player/gen-player-lock.mjs RootDesk/MyDesk/PlayerLock.codeblock map/map0*.map
+git commit -m "fix(lobby): 전투맵 PlayerLock에 이동값 런타임 0 재설정 보강 (P15)"
+```
+
+---
+
+### Task 4: `gen-slaydeck.mjs` — 흐름·UI 통합
+
+**Files:** Modify `tools/deck/gen-slaydeck.mjs`
+
+- [ ] **Step 1:** guid prefix 등록(`244-245`) — 신규 prefix 불필요(LobbyHud 슬림화만, 기존 `lob` 재사용). 확인만.
+
+- [ ] **Step 2:** ACT_MAPS 아래(`2745`)에 로비 상수 추가:
+
+```js
+const ACT_MAPS = ['map01', 'map02', 'map03', 'map04', 'map05'];
+const LOBBY_MAP = 'lobby';
+const LOBBY_SPAWN = 'Vector3(0, 0.03, 0)'; // Task0 정찰 좌표로 조정
+```
+
+- [ ] **Step 3:** LobbyHud 슬림화 — `npcs` 배열(`2469-2474`)과 버튼 생성 루프(`2475-2524`) **삭제**. `lobTexts`(`2433-2439`)는 SoulLabel/AscLabel + 안내문(Hint)만 남기고 Title/Subtitle은 "마을" 정도로 축소 or 제거. AscMinus/AscPlus(`2454-2468`)는 유지. → LobbyHud가 상단 정보바(영혼/승천)만 남음.
+
+- [ ] **Step 4:** BindLobbyButtons(`2997-3014`) — NPC 4개 `bindClick` 라인 **삭제**(NpcRun/NpcCodex/NpcShop/NpcBoard). AscMinus/AscPlus/BoardHud.Close/SoulShopHud.Close bindClick은 유지.
+
+- [ ] **Step 5:** ShowLobby(`2986-2993`) — 끝에 로비 맵 텔레포트 추가:
+
+```js
+method('ShowLobby', `self.SelectedClass = ""
+self:RenderAscension()
+self:RenderSoulLabel()
+self:ShowState("lobby")
+self:SetEntityEnabled("/ui/DefaultGroup/BoardHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/SoulShopHud", false)
+self:BindLobbyButtons()
+self:BindMenuButtons()
+self:GoLobbyMap()`),
+```
+
+- [ ] **Step 6:** 신규 method `GoLobbyMap`(ShowLobby 근처에 추가, ExecSpace 기본):
+
+```js
+method('GoLobbyMap', `self.LobbyTpTries = 0
+local eventId = 0
+local function go()
+	self.LobbyTpTries = self.LobbyTpTries + 1
+	local lp = _UserService.LocalPlayer
+	if lp ~= nil then
+		if lp.CurrentMapName ~= "${LOBBY_MAP}" then
+			_TeleportService:TeleportToMapPosition(lp, ${LOBBY_SPAWN}, "${LOBBY_MAP}")
+		end
+		_TimerService:ClearTimer(eventId)
+	elseif self.LobbyTpTries > 50 then
+		_TimerService:ClearTimer(eventId)
+	end
+end
+eventId = _TimerService:SetTimerRepeat(go, 0.1)`),
+```
+
+- [ ] **Step 7:** 신규 method `OnLobbyNpcInteract`(인자 id) — NPC codeblock이 호출:
+
+```js
+method('OnLobbyNpcInteract', `if self.RunActive == true then return end
+if id == "run" then
+	self:ShowCharacterSelect()
+elseif id == "codex" then
+	self:ShowCodex()
+elseif id == "shop" then
+	self:ShowSoulShop()
+elseif id == "board" then
+	self:ShowBoard()
+end`, [{ Type: 'string', DefaultValue: '""', SyncDirection: 0, Attributes: [], Name: 'id' }]),
+```
+
+(인자 객체 형태는 기존 `EndRun`의 `text` 인자/`ShowState`의 `state` 인자 정의를 참고해 동일 구조로.)
+
+- [ ] **Step 8:** StartRun(`3199-3232`) — `RenderPotions()` 다음, `ShowMap()` 직전에 1막 텔레포트 추가:
+
+```js
+// ... self:RenderPotions() (기존) 다음 줄에
+self:TeleportToActMap()
+// ... self:ShowMap() (기존)
+```
+
+(StartRun의 Lua 문자열 내부에 `self:TeleportToActMap()` 한 줄 삽입. Floor=1이 이미 세팅돼 map01 타깃.)
+
+- [ ] **Step 9:** EndRun(`4391-4403`) 복귀 — 기존 타이머 `self:ShowLobby()`가 GoLobbyMap을 호출하므로 **별도 변경 불필요**(ShowLobby가 로비 맵 텔레포트 포함). 확인만.
+
+- [ ] **Step 10:** 재생성 + 카운트 검증:
+
+```bash
+node tools/deck/gen-slaydeck.mjs
+grep -c "OnLobbyNpcInteract" RootDesk/MyDesk/SlayDeckController.codeblock   # >=1 (이 파일엔 정의만; 호출은 LobbyNpc.codeblock)
+grep -c "GoLobbyMap" RootDesk/MyDesk/SlayDeckController.codeblock           # >=2 (정의+ShowLobby 호출)
+grep -c "TeleportToActMap" RootDesk/MyDesk/SlayDeckController.codeblock     # >=3 (정의+ContinueAfterBoss+StartRun)
+grep -c "NpcRun" ui/DefaultGroup.ui                                         # 0 기대(버튼-행 제거됨)
+```
+
+- [ ] **Step 11:** 커밋:
+
+```bash
+git add tools/deck/gen-slaydeck.mjs ui/DefaultGroup.ui RootDesk/MyDesk/SlayDeckController.codeblock Global/common.gamelogic map/lobby.map map/map0*.map
+git commit -m "feat(lobby): 로비 맵 흐름 통합 — OnBeginPlay/EndRun 텔레포트·NPC 상호작용 디스패치·StartRun map01 텔레포트·LobbyHud 슬림화 (P15)"
+```
+
+---
+
+### Task 5: 미러/회귀 테스트
+
+전투 규칙·맵 그래프 알고리즘 미변경 → 미러 동기화 불필요. 기존 테스트 회귀만 확인.
+
+- [ ] **Step 1:** 기존 테스트 실행:
+
+```bash
+node --test tools/balance/sim-balance.test.mjs
+node --test tools/map/rogue-map.test.mjs
+```
+
+기대: 전부 PASS(이번 변경은 전투/맵그래프 무관이라 회귀 없어야 함).
+
+- [ ] **Step 2:** `git status --short`로 의도치 않은 산출물 변경 없는지 확인(산출물 diff는 보지 않음).
+
+---
+
+### Task 6: 메이커 플레이테스트 검증
+
+- [ ] **Step 1:** git 상태 정리 후 메이커에서 **로컬 워크스페이스 refresh**(RULES.md §5 — 안 하면 stale 상태가 디스크 덮어씀). `maker_refresh_workspace` → 빌드 콘솔 0 에러 확인(`maker_logs`).
+
+- [ ] **Step 2:** `maker_play` → `maker_screenshot`. 검증 시나리오(스크린샷·로그로):
+  1. 월드 시작 → **로비 맵에 스폰**(타운 배경, NPC 4명 보임), 방향키로 **이동됨**, 공격 키로 **공격 모션** 나옴.
+  2. NPC 근접 → 머리 위 `!` 표시 → `↑`키로 기능 패널 오픈. NPC `maker_mouse_input` 클릭으로도 오픈(버튼 클릭 불가 메모리 주의 — 월드 엔티티 TouchEvent라 mouse_input 좌표 클릭 시도, 안 되면 ↑키 경로로 검증).
+  3. 모험가→직업선택→런 시작 → **map01로 텔레포트**, 이동/공격 **잠김**. 1막 전투 몬스터 정상 등장(CurrentMapName 필터 통과).
+  4. 사서→도감, 상인→영혼상점, 안내원→게시판 각각 오픈/닫기.
+  5. 런 종료(빠른 패배 유도: execute_script로 `c.Combat.PlayerHp=0` 등 or 정상 진행) → 4초 후 **로비 맵 복귀**, 이동/공격 재해제.
+  6. 상단 미니 HUD에 영혼/승천 표시 정상.
+
+- [ ] **Step 2b:** 실패 시 디버깅 — 이동 안 됨→Task0 값 재확認/RigidbodyComponent 추가 set, 클릭 안 됨→TouchReceiveComponent 필드/근접↑키 폴백, 몬스터 안 나옴→StartRun 텔레포트·spawn 좌표 확인. 생성기 수정→재생성→refresh→재플레이.
+
+- [ ] **Step 3:** `maker_stop`. 스크린샷을 사용자에게 공유.
+
+---
+
+### Task 7: PR
+
+- [ ] **Step 1:** push:
+
+```bash
+git push -u origin feature/p15-lobby-map-npc
+```
+
+- [ ] **Step 2:** PR spec JSON(UTF-8) 작성 후 `node tools/git/gitea-pr.mjs create <spec.json>` (RULES.md §4 — 인라인 curl 한글 금지). 제목 예: "feat: P15 — 로비 맵 + 월드 NPC(근접·클릭) + 로비 전용 이동·공격". 본문에 변경 요약·검증 결과·스크린샷 언급.
+
+- [ ] **Step 3:** 사용자에게 PR 번호 보고 + 머지 여부 확인.
+
+---
+
+## 정찰 결과 (Task0 실측 완료)
+- **이동 레버 = `RigidbodyComponent.WalkAcceleration` (freeze가 0으로 만든 값). 복원값 0.7로 이동·점프 정상 확인** (InputSpeed/JumpForce는 무관 — WalkSpeed=1.4·WalkJump=1.23는 freeze가 안 건드림).
+  - 이동 해제 = `pc.Enable=true; pc.FixedLookAt=false; rb.WalkAcceleration=0.7` (rb.Enable는 이미 true).
+- BODY_KIND = Rigidbody가 구동(Sideviewbody도 존재하나 WalkSpeed=nil). 추가 바디 set 불필요.
+- ATTACK_KEY = `LeftControl` (KeyboardKey.LeftControl 유효, PlayerAttackMotion() 호출 정상).
+- 상호작용 키 = `UpArrow` 유효. 클릭 = TouchReceiveComponent+TouchEvent.
+- 현재 플레이어 위치 map01 (-5,-0.039,0) → LOBBY_SPAWN = `Vector3(-5, 0.03, 0)`. NPC x = -3 / -0.5 / 2 / 4.5, 근접 임계 1.2.
+- TOWN_BG = Task1에서 gen-maps BACKGROUNDS 풀에서 선택, MARK_RUID = Task1 asset 검색.

docs/superpowers/plans/2026-06-15-node-map-ui.md

@@ -0,0 +1,227 @@
+# 노드 맵 UI 강화 구현 계획
+
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:executing-plans. 설계: `docs/superpowers/specs/2026-06-15-node-map-ui-design.md`. 산출물(`ui/DefaultGroup.ui`·`*.codeblock`)은 Read/Edit 금지 — `tools/deck/gen-slaydeck.mjs` 소스·`data/*.json`만 수정 후 재생성. 검증은 `node tools/verify/count.mjs`(카운트)와 메이커 플레이테스트.
+
+**Goal:** 맵 노드 선택 화면(MapHud)을 단색 박스+텍스트 → 공식 메이플 아이콘 노드 + 배경 이미지로 강화하고, 아이콘/배경 RUID를 `data/nodeicons.json`로 외부화해 교체를 쉽게 한다.
+
+**Architecture:** 단일 소스(`data/nodeicons.json` + `tools/deck/gen-slaydeck.mjs`) → 산출물 재생성. 노드 = 아이콘 스프라이트(타입별 ImageRUID 런타임 주입, 상태는 Color 틴트), 배경 = MapHud 루트 이미지 + 반투명 오버레이. 절차 랜덤 배치·간선·버튼 바인딩 불변.
+
+**Tech Stack:** Node.js ESM 생성기, MSW Lua(codeblock).
+
+**확정 RUID** (공식 maplestory, 썸네일 검수): combat=`f98db6823e894a4f90308d61f75894ac`, elite=`793ed8a757534b89a82f460747d2df24`, boss=`423056cdbbc04f4da131b9721c404d96`, shop=`da37e1fac55d455b9ade08569f09f798`, rest=`b86c1b0568bd45f3ae4a4b97e1b4a594`, treasure=`f8a6d58e20f54e2ca899485055df1ce4`, background=`d84241f17de344a097f5b96ac914f1d2`.
+
+**현재 코드 기준선**(gen-slaydeck.mjs): MapHud emit `1662~1763`(루트 `1664`, pushMapNode `1696`, 그리드 `1727`, 도트 displayOrder 1), RenderMapNode `5615~5677`, luaFramesTable `72`, OnBeginPlay 주입 `2906`, StartRun 주입 `3361`, CardFrames prop `2854`, CHEST 상수 `84`, sprite 헬퍼 `297`(dataId→ImageRUID, type 0=이미지).
+
+---
+
+### Task 1: `data/nodeicons.json` + 생성기 로드·검증·직렬화
+
+**Files:** Create `data/nodeicons.json` · Modify `tools/deck/gen-slaydeck.mjs`
+
+- [ ] **Step 1:** `data/nodeicons.json` 생성:
+
+```json
+{
+  "icons": {
+    "combat":   "f98db6823e894a4f90308d61f75894ac",
+    "elite":    "793ed8a757534b89a82f460747d2df24",
+    "boss":     "423056cdbbc04f4da131b9721c404d96",
+    "shop":     "da37e1fac55d455b9ade08569f09f798",
+    "rest":     "b86c1b0568bd45f3ae4a4b97e1b4a594",
+    "treasure": "f8a6d58e20f54e2ca899485055df1ce4"
+  },
+  "background": "d84241f17de344a097f5b96ac914f1d2"
+}
+```
+
+- [ ] **Step 2:** `gen-slaydeck.mjs` CHEST 상수(`85`) 아래에 로드+검증 추가:
+
+```js
+// 노드 맵 아이콘/배경 (공식 maplestory RUID, data/nodeicons.json 단일 소스 — 교체 시 이 파일만 수정 후 재생성)
+const NODEICONS = JSON.parse(readFileSync('data/nodeicons.json', 'utf8'));
+for (const t of ['combat', 'elite', 'boss', 'shop', 'rest', 'treasure']) {
+  if (!/^[0-9a-f]{32}$/.test((NODEICONS.icons || {})[t] || '')) throw new Error(`[gen-slaydeck] nodeicons.json icons.${t} RUID 누락/형식오류`);
+}
+if (!/^[0-9a-f]{32}$/.test(NODEICONS.background || '')) throw new Error('[gen-slaydeck] nodeicons.json background RUID 누락/형식오류');
+```
+
+- [ ] **Step 3:** `luaFramesTable`(`77`) 직후에 직렬화 헬퍼 추가:
+
+```js
+function luaNodeIconsTable() {
+  const rows = Object.entries(NODEICONS.icons).map(([t, ruid]) => `\t${t} = ${luaStr(ruid)},`).join('\n');
+  return `self.NodeIcons = {\n${rows}\n}`;
+}
+```
+
+- [ ] **Step 4:** prop 선언 추가 — `prop('any', 'CardFrames'),`(`2854`) 아래에 `prop('any', 'NodeIcons'),`.
+
+- [ ] **Step 5:** OnBeginPlay 주입 — `2906`의 `${luaFramesTable()}` 줄 **아래**에 `${luaNodeIconsTable()}` 추가. StartRun 주입(`3361`)의 `${luaFramesTable()}` 아래에도 동일 추가.
+
+- [ ] **Step 6:** 로드 검증(아직 산출물 미변경이라 생성만 확인):
+
+```bash
+node -e "const n=require('./data/nodeicons.json'); console.log('icons',Object.keys(n.icons).join(','),'| bg',n.background.length)"
+```
+기대: `icons combat,elite,boss,shop,rest,treasure | bg 32`
+
+- [ ] **Step 7:** 커밋:
+
+```bash
+git add data/nodeicons.json tools/deck/gen-slaydeck.mjs
+git commit -m "feat(node-map): nodeicons.json 외부화 + 생성기 로드·검증·NodeIcons 직렬화"
+```
+
+---
+
+### Task 2: MapHud emit — 배경 이미지 + 오버레이 + 아이콘 노드
+
+**Files:** Modify `tools/deck/gen-slaydeck.mjs`
+
+- [ ] **Step 1:** MapHud 루트 sprite(`1673`)를 **배경 이미지**로 변경:
+
+```js
+      sprite({ dataId: NODEICONS.background, color: { r: 1, g: 1, b: 1, a: 1 }, type: 0, raycast: false }),
+```
+
+- [ ] **Step 2:** 루트 push(`1677` `map.push(mapHud);`) 직후, Title push 앞에 **반투명 오버레이 자식** 추가:
+
+```js
+  map.push(entity({
+    id: guid('map', 990),
+    path: '/ui/DefaultGroup/MapHud/Overlay',
+    modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.04, g: 0.05, b: 0.09, a: 0.5 }, type: 1, raycast: true }),
+    ],
+  }));
+```
+(guid 'map',990 은 노드 그리드·도트가 쓰는 mapN(2~약189)보다 충분히 높아 충돌 없음. 빌드 끝 id 유일성 검증이 잡아줌.)
+
+- [ ] **Step 3:** Title displayOrder를 오버레이(0) 위로 — Title 엔티티(`1684` `displayOrder: 0,`)를 `displayOrder: 2,`로 변경.
+
+- [ ] **Step 4:** `pushMapNode`(`1696~1726`) — 노드 본체를 **아이콘**으로 + Label 자식 제거:
+  - 본체 sprite(`1707`)를 `sprite({ color: { r: 1, g: 1, b: 1, a: 1 }, type: 0, raycast: true }),`로 변경(단색 박스 → 이미지, 런타임에 ImageRUID 주입).
+  - Label 자식 push 블록(`1713~1725`, `map.push(entity({ ... /Label ... }))` 전체)을 **삭제**.
+
+- [ ] **Step 5:** 노드 크기 키움 — 그리드 호출(`1729`)의 `{ x: 56, y: 56 }`을 `{ x: 64, y: 64 }`로, 보스 호출(`1732`)의 `{ x: 72, y: 72 }`을 `{ x: 88, y: 88 }`로 변경.
+
+- [ ] **Step 6:** 커밋(아직 RenderMapNode 미수정 — 다음 Task와 함께 재생성/검증):
+
+```bash
+git add tools/deck/gen-slaydeck.mjs
+git commit -m "feat(node-map): MapHud 배경 이미지+오버레이, 노드 아이콘화(라벨 제거·확대)"
+```
+
+---
+
+### Task 3: RenderMapNode Lua — ImageRUID + 상태 틴트
+
+**Files:** Modify `tools/deck/gen-slaydeck.mjs`
+
+- [ ] **Step 1:** `RenderMapNode` 메서드 본문(`5615~5677`)을 아래로 **교체**(타입별 박스색/라벨 → 아이콘 ImageRUID + 상태 틴트). Lua 들여쓰기는 기존과 동일하게 실제 탭:
+
+```lua
+local base = "/ui/DefaultGroup/MapHud/Node_" .. id
+local e = _EntityService:GetEntityByPath(base)
+if e == nil then
+	return
+end
+local node = self.MapNodes[id]
+if node == nil then
+	e.Enable = false
+	return
+end
+e.Enable = true
+local ruid = self.NodeIcons[node.type]
+if ruid == nil then
+	ruid = self.NodeIcons["combat"]
+end
+if e.SpriteGUIRendererComponent ~= nil and ruid ~= nil then
+	e.SpriteGUIRendererComponent.ImageRUID = ruid
+end
+local reachable = self:IsReachable(id)
+local visited = false
+if self.VisitedNodes ~= nil then
+	for i = 1, #self.VisitedNodes do
+		if self.VisitedNodes[i] == id then visited = true end
+	end
+end
+if e.SpriteGUIRendererComponent ~= nil then
+	if id == self.CurrentNodeId then
+		e.SpriteGUIRendererComponent.Color = Color(1, 0.82, 0.3, 1)
+	elseif visited == true then
+		e.SpriteGUIRendererComponent.Color = Color(0.5, 0.5, 0.55, 0.9)
+	elseif reachable == true then
+		e.SpriteGUIRendererComponent.Color = Color(1, 1, 1, 1)
+	else
+		e.SpriteGUIRendererComponent.Color = Color(0.4, 0.4, 0.45, 0.45)
+	end
+end
+if e.ButtonComponent ~= nil then
+	e.ButtonComponent.Enable = reachable
+end
+```
+(메서드 시그니처 `[{Type:'string',...,Name:'id'}]`는 유지. `self:SetText(base.."/Label", ...)` 호출은 라벨 제거로 사라짐 — RenderMapDots/RenderMap는 불변.)
+
+- [ ] **Step 2:** 재생성:
+
+```bash
+node tools/deck/gen-slaydeck.mjs
+```
+기대: "Slay deck UI and combat codeblocks generated."
+
+- [ ] **Step 3:** 카운트 검증(내용 출력 금지, node fs):
+
+```bash
+node -e "const fs=require('fs');const cb=fs.readFileSync('RootDesk/MyDesk/SlayDeckController.codeblock','utf8');const ui=fs.readFileSync('ui/DefaultGroup.ui','utf8');const c=(s,p)=>(s.match(new RegExp(p,'g'))||[]).length;console.log('NodeIcons inject:',c(cb,'self.NodeIcons ='),'(>=2: OnBeginPlay+StartRun)','| ImageRUID in RenderMapNode:',c(cb,'NodeIcons\\\\[node.type\\\\]'),'| UI MapHud/Overlay:',c(ui,'MapHud/Overlay'),'(1)','| UI Label nodes(0 기대):',c(ui,'Node_r1c1/Label'),'| bg RUID:',c(ui,'d84241f17de344a097f5b96ac914f1d2'));"
+```
+기대: NodeIcons inject ≥2, ImageRUID ≥1, Overlay 1, Label 0, bg RUID ≥1.
+
+- [ ] **Step 4:** 커밋:
+
+```bash
+git add tools/deck/gen-slaydeck.mjs ui/DefaultGroup.ui RootDesk/MyDesk/SlayDeckController.codeblock
+git commit -m "feat(node-map): RenderMapNode 아이콘 ImageRUID+상태 틴트, 재생성"
+```
+
+---
+
+### Task 4: 미러/회귀 테스트
+
+- [ ] **Step 1:** 전투/맵그래프 미러 미변경 확인 — 테스트 실행:
+
+```bash
+node --test tools/balance/sim-balance.test.mjs tools/map/rogue-map.test.mjs
+```
+기대: 전부 PASS(이 변경은 UI만, 전투/맵그래프 무관).
+
+- [ ] **Step 2:** `git status --short`로 의도치 않은 산출물 변경 없는지 확인.
+
+---
+
+### Task 5: 메이커 플레이테스트
+
+- [ ] **Step 1:** `maker_refresh_workspace` → `maker_logs build`로 빌드 에러 0 확인(기존 BuySoulUnlock Info 경고는 무관).
+
+- [ ] **Step 2:** `maker_play` → 런 시작(`SelectClass`+`StartNewGame`) → 맵 화면 `maker_screenshot`. 검증:
+  - 배경 이미지(리스항구) + 어두운 오버레이 위에 노드들.
+  - 노드가 **타입별 아이콘**(주황버섯/골렘/발록/돈주머니/모닥불/상자)으로 표시, 라벨 텍스트 없음.
+  - 상태 틴트: 현재=금색, 도달가능=원색(밝게), 잠김=어둡고 흐릿.
+  - 도달 가능 노드 클릭 시 진행(`PickNode`/마우스). 랜덤 배치 정상.
+  - 아이콘 잘림/왜곡 점검(특히 보스 발록·골렘). 잘리면 해당 노드 size 또는 아이콘 RUID 조정.
+
+- [ ] **Step 2b:** 실패 시 디버깅 — 흰박스→RUID/리로드 확인, 아이콘 안 뜸→ImageRUID 주입·NodeIcons 시드 확인, 가독성→오버레이 알파/틴트 튜닝. 생성기 수정→재생성→refresh→재플레이.
+
+- [ ] **Step 3:** `maker_stop`. 스크린샷 사용자 공유.
+
+---
+
+### Task 6: PR
+
+- [ ] **Step 1:** `git push -u origin feature/node-map-ui`(인증 실패 시 `GCM_INTERACTIVE=never GIT_TERMINAL_PROMPT=0 git push`로 재시도).
+- [ ] **Step 2:** UTF-8 spec JSON 작성 후 `node tools/git/gitea-pr.mjs create <spec.json>`. 제목 "feat: 노드 맵 UI 강화 — 아이콘 노드 + 배경 이미지(nodeicons.json 외부화)".
+- [ ] **Step 3:** 사용자에게 PR 번호 보고. (변경 용이성: `data/nodeicons.json` RUID만 바꾸고 `node tools/deck/gen-slaydeck.mjs` 재실행하면 교체됨을 명시.)

docs/superpowers/plans/2026-06-16-charselect-images-back.md

@@ -0,0 +1,205 @@
+# 직업 선택 캐릭터 이미지 + 뒤로가기 — 구현 계획
+
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:executing-plans 로 태스크 단위 구현. 단계는 `- [ ]` 체크박스.
+
+**Goal:** CharacterSelectHud의 단색 박스를 캐릭터 이미지 카드로 바꾸고(선택 시 금색 테두리), 뒤로가기 버튼으로 로비 복귀를 추가한다.
+
+**Architecture:** 단일 생성기 `tools/deck/gen-slaydeck.mjs` 수정 + `data/characters.json` 신설(초상화 RUID 단일 소스). 이미지는 생성 시 `sprite({dataId})`로 주입, 선택 표시는 기존 `RenderCharacterSelect`의 Button Color를 금색으로. 뒤로가기는 ShopHud 나가기 패턴 재사용 → `ShowLobby()`. 산출물(ui/codeblock) 재생성.
+
+**Tech Stack:** Node ESM 생성기, MSW Lua codeblock, MSW UI JSON. 검증=카운트+메이커 플레이테스트(이 저장소는 단위테스트 대신 카운트/플레이테스트).
+
+**확정 RUID (메이커 임포트 완료, `.sprite`에서 추출):**
+- warrior `28c88fdc5ab44f34a8b3fc1e19d4ce78`
+- magician `3b9ea1f066a744bb859df47fef817277`
+- bandit `efa920e58d31426486ef974106e7dc8b`
+
+---
+
+### Task 1: `data/characters.json` + 생성기 로드·검증
+
+**Files:**
+- Create: `data/characters.json`
+- Modify: `tools/deck/gen-slaydeck.mjs:91-96` 인접(NODEICONS 로드 블록 뒤)
+
+- [ ] **Step 1:** `data/characters.json` 작성
+```json
+{
+  "portraits": {
+    "warrior":  "28c88fdc5ab44f34a8b3fc1e19d4ce78",
+    "magician": "3b9ea1f066a744bb859df47fef817277",
+    "bandit":   "efa920e58d31426486ef974106e7dc8b"
+  }
+}
+```
+
+- [ ] **Step 2:** gen-slaydeck.mjs NODEICONS 검증 블록(`:96`) 바로 뒤에 로드+fail-fast 검증 추가
+```js
+// 캐릭터 선택 초상화 (메이커 임포트 RUID, data/characters.json 단일 소스 — 교체 시 이 파일만 수정 후 재생성)
+const CHARS = JSON.parse(readFileSync('data/characters.json', 'utf8'));
+for (const c of ['warrior', 'magician', 'bandit']) {
+  if (!/^[0-9a-f]{32}$/.test((CHARS.portraits || {})[c] || '')) throw new Error(`[gen-slaydeck] characters.json portraits.${c} RUID 누락/형식오류`);
+}
+```
+
+- [ ] **Step 3:** 생성기 실행해 에러 없는지 확인(아직 UI 미사용이라 출력 동일)
+```
+node tools/deck/gen-slaydeck.mjs
+```
+Expected: 성공 메시지 1줄, throw 없음.
+
+---
+
+### Task 2: CharacterSelectHud — 카드 이미지화 (classCards 루프)
+
+**Files:** Modify `tools/deck/gen-slaydeck.mjs:2516-2540` (Portrait/Desc 블록), `:2503-2515` (Name)
+
+카드 본체 `{key}Button`(2490-2502)·DeckButton(2567-2580)·StartButton·click 바인딩 경로는 **불변**. `cls.tint`/`cls.desc`는 더는 안 쓰이나 배열 정의는 그대로 둬도 무방.
+
+- [ ] **Step 1:** `Name`(2503-2515) 위치를 하단으로 — `transform`의 `pos: { x: 0, y: 108 }` → `pos: { x: 0, y: -137 }`. (displayOrder 0 유지) — 텍스트는 그대로(금색).
+
+- [ ] **Step 2:** `Portrait` 엔티티(2516-2527)를 **`Art` 이미지로 교체**. 경로·guid·sprite 변경:
+```js
+    select.push(entity({
+      id: guid('menu', 200 + i),
+      path: `${base}/Art`,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 0,
+      components: [
+        transform({ parentW: 270, parentH: 330, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 258, y: 318 }, pos: { x: 0, y: 0 } }),
+        sprite({ dataId: CHARS.portraits[cls.classId], color: { r: 1, g: 1, b: 1, a: 1 }, type: 0, raycast: false }),
+      ],
+    }));
+```
+(258×318, 6px 인셋 → 부모 Button 색이 테두리로 보임. type:0=이미지 풀, raycast off=클릭은 부모 Button으로.)
+
+- [ ] **Step 3:** `Desc` 엔티티(2528-2540) **삭제**(emit 안 함).
+
+- [ ] **Step 4:** `Name` 뒤에 반투명 하단 배너 `NameBanner` 추가(displayOrder 1, Art 위·Name 아래). Name의 displayOrder를 2로 올림.
+```js
+    select.push(entity({
+      id: guid('menu', 210 + i),
+      path: `${base}/NameBanner`,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 1,
+      components: [
+        transform({ parentW: 270, parentH: 330, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 258, y: 60 }, pos: { x: 0, y: -137 } }),
+        sprite({ color: { r: 0, g: 0, b: 0, a: 0.55 }, type: 1, raycast: false }),
+      ],
+    }));
+```
+그리고 Name 엔티티의 `displayOrder: 0` → `displayOrder: 2`로.
+
+- [ ] **Step 5:** 생성 + 카운트 검증
+```
+node tools/deck/gen-slaydeck.mjs
+node tools/verify/count.mjs ui "CharacterSelectHud/WarriorButton/Art" "CharacterSelectHud/MageButton/Art" "CharacterSelectHud/ThiefButton/Art"
+grep -c "28c88fdc5ab44f34a8b3fc1e19d4ce78" ui/DefaultGroup.ui   # warrior RUID 1
+```
+Expected: Art 3개 존재, RUID 등장. (count.mjs 없으면 `grep -c '/Art"' ui/DefaultGroup.ui`.)
+
+---
+
+### Task 3: RenderCharacterSelect — 선택 = 금색 테두리
+
+**Files:** Modify `tools/deck/gen-slaydeck.mjs:3362-3394`
+
+- [ ] **Step 1:** 선택 시 색을 금색으로. 세 군데 `Color(0.28, 0.36, 0.46, 1)` → `Color(1, 0.82, 0.3, 1)` (미선택 `Color(0.16, 0.2, 0.26, 1)`는 유지). Status 텍스트 로직 불변.
+  - `gen-slaydeck.mjs`에서 `Color(0.28, 0.36, 0.46, 1)` 를 `Color(1, 0.82, 0.3, 1)` 로 (RenderCharacterSelect 내 3회) 치환.
+
+- [ ] **Step 2:** 생성 + 확인
+```
+node tools/deck/gen-slaydeck.mjs
+grep -c "Color(1, 0.82, 0.3, 1)" RootDesk/MyDesk/SlayDeckController.codeblock   # 증가 확인(기존 사용처 + 3)
+```
+
+---
+
+### Task 4: 뒤로가기 버튼 + 바인딩
+
+**Files:** Modify `tools/deck/gen-slaydeck.mjs` — CharacterSelectHud emit(StartButton 뒤 `:2595` 직후), BindMenuButtons(`:3158` 뒤), prop 선언부
+
+- [ ] **Step 1:** StartButton emit(2582-2595) 직후에 BackButton emit 추가(StartButton 패턴 복제, 좌상단 배치)
+```js
+  select.push(entity({
+    id: guid('menu', 230),
+    path: '/ui/DefaultGroup/CharacterSelectHud/BackButton',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 22,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 180, y: 56 }, pos: { x: -800, y: 430 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.15, g: 0.2, b: 0.26, a: 1 }, type: 1, raycast: true }),
+      button(),
+      text({ value: '← 뒤로', fontSize: 26, bold: true, color: GOLD, alignment: 0 }),
+    ],
+  }));
+```
+
+- [ ] **Step 2:** BindMenuButtons(StartGameHandler 블록 `:3151-3158` 뒤)에 BackButton 바인딩 추가
+```lua
+local charBack = _EntityService:GetEntityByPath("/ui/DefaultGroup/CharacterSelectHud/BackButton")
+if charBack ~= nil and charBack.ButtonComponent ~= nil then
+	if self.CharBackHandler ~= nil then
+		charBack:DisconnectEvent(ButtonClickEvent, self.CharBackHandler)
+		self.CharBackHandler = nil
+	end
+	self.CharBackHandler = charBack:ConnectEvent(ButtonClickEvent, function() self:ShowLobby() end)
+end
+```
+(이 Lua는 BindMenuButtons 메서드 본문 문자열 끝에 삽입. 실제 탭/`\t` 스타일은 해당 메서드 본문 규칙을 따른다 — BindMenuButtons는 실탭 사용.)
+
+- [ ] **Step 3:** prop `CharBackHandler` 선언 추가. 기존 핸들러 prop 목록(예: `StartGameHandler`/`NewGameHandler` 등 `prop('any','...')` 선언부)을 grep으로 찾아 같은 형식으로 `CharBackHandler` 추가.
+```
+grep -n "StartGameHandler" tools/deck/gen-slaydeck.mjs   # prop 선언 위치 확인
+```
+
+- [ ] **Step 4:** 생성 + 검증
+```
+node tools/deck/gen-slaydeck.mjs
+node tools/verify/count.mjs ui "CharacterSelectHud/BackButton"        # 1
+grep -c "CharBackHandler" RootDesk/MyDesk/SlayDeckController.codeblock # ≥2 (선언+바인딩+해제)
+```
+
+---
+
+### Task 5: 산출물 재생성 커밋 + .sprite 커밋 + 플레이테스트
+
+**Files:** `ui/DefaultGroup.ui`, `RootDesk/MyDesk/SlayDeckController.codeblock`(재생성), `RootDesk/MyDesk/*.sprite`(임포트)
+
+- [ ] **Step 1:** 최종 재생성 + git status로 의도 외 변경 없는지 확인
+```
+node tools/deck/gen-slaydeck.mjs
+git status --short
+```
+Expected: 변경 = gen-slaydeck.mjs, data/characters.json, ui/DefaultGroup.ui, SlayDeckController.codeblock (+ common.gamelogic은 churn이면 내용 동일 시 git checkout 복원). untracked = 임포트 .sprite.
+
+- [ ] **Step 2:** 소스 커밋(생성기+데이터) → 산출물 커밋(재생성 명시) → .sprite 커밋 분리
+```
+git add tools/deck/gen-slaydeck.mjs data/characters.json
+git commit -m "feat(charselect): 직업 카드 캐릭터 이미지 + 뒤로가기 (소스)"
+git add ui/DefaultGroup.ui RootDesk/MyDesk/SlayDeckController.codeblock
+git commit -m "chore: 산출물 재생성 (charselect 이미지+뒤로가기)"
+git add "RootDesk/MyDesk/warrior.sprite" "RootDesk/MyDesk/mage.sprite" "RootDesk/MyDesk/bandit.sprite"
+git commit -m "chore(assets): 캐릭터 초상화 스프라이트 임포트(전사/법사/도적)"
+```
+(2차전직 아트 12종 .sprite는 별도 — 향후 2차 전직 선택 이미지용. 사용자 의사 확인 후 커밋/보류.)
+
+- [ ] **Step 3:** 메이커 플레이테스트(사용자 워크스페이스 reload 후): 로비 NPC→직업 선택 진입→3 카드에 캐릭터 이미지 표시→클릭 시 금색 테두리·Status 갱신→시작 시 그 직업으로 런→뒤로가기 시 로비 복귀. 빌드 콘솔 0 에러.
+  - 이미지 비율 왜곡/잘림 보이면 Art size(258×318) 조정.
+  - 뒤로가기 시 재텔레포트 jolt 보이면 BackButton 바인딩을 `self:ShowState("lobby")`로 축소.
+
+- [ ] **Step 4:** push + PR (`node tools/git/gitea-pr.mjs create <spec.json>`, UTF-8).
+
+---
+
+## Self-Review
+
+- **스펙 커버리지**: 이미지 적용(T1,T2) · 선택→진행 연결(기존 SelectClass/StartNewGame 불변, T2가 클릭경로 보존) · 선택 금색 테두리(T3) · 뒤로가기→로비(T4) · characters.json 단일소스(T1) · 검증/플레이테스트(T5). 누락 없음.
+- **플레이스홀더**: RUID·좌표·색·Lua 전부 구체값. count.mjs 부재 시 grep 대체 명시.
+- **타입 일관성**: `CHARS.portraits[classId]`(classId=warrior/magician/bandit, classCards.classId와 일치). 핸들러 `CharBackHandler` 일관. Art/NameBanner guid(200+i/210+i/230) 미사용 번호.
+- **리스크**: 이미지 비율(T5 Step3 조정), ShowLobby 재텔레포트(T5 Step3 폴백 ShowState), 메이커 reload 필수(산출물 디스크 반영).

docs/superpowers/plans/2026-06-16-codeblock-modularization.md

@@ -0,0 +1,127 @@
+# Phase 1b — codeblock 메서드 모듈화 구현 계획
+
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:executing-plans 로 태스크 단위 구현. 단계는 `- [ ]` 체크박스.
+
+**Goal:** `gen-slaydeck.mjs` `writeCodeblocks()`의 메서드 161개를 연속-런 모듈 `cb/*.mjs`로 분리하되 출력 `SlayDeckController.codeblock`은 바이트 동일.
+
+**Architecture:** 단방향 의존 orchestrator→cb→lib. method/prop/codeblock 헬퍼+공유상수를 `lib/codeblock.mjs`로. 메서드는 **원본 순서 보존**을 위해 기능 버킷이 아닌 **연속 구간**으로 나눠 `writeCodeblocks`가 순서대로 spread-concat. prop 103개는 오케스트레이터 유지.
+
+**Tech Stack:** Node ESM. 검증 = `diffcheck`(codeblock 바이트 동일) + 미러 `node --test`.
+
+**의존:** Phase 1(#70)의 모듈 gen-slaydeck 위에 스택(`feature/cb-modularization`). #70 머지 후 main에 리베이스.
+
+---
+
+## 🔑 검증 게이트 (모든 Task 공통)
+각 추출 후:
+```
+node tools/deck/gen-slaydeck.mjs
+node tools/verify/diffcheck.mjs
+```
+**합격**: `RootDesk/MyDesk/SlayDeckController.codeblock`(+ui·common) **IDENTICAL**. 워킹트리 ` M`은 autocrlf churn → `git checkout --`로 복원, **산출물은 커밋 안 함**(소스만).
+
+---
+
+### Task 1: `lib/codeblock.mjs` — 헬퍼 + 공유 상수 추출
+
+**Files:** Create `tools/deck/lib/codeblock.mjs`; Modify `tools/deck/gen-slaydeck.mjs`
+
+- [ ] **Step 1:** `lib/codeblock.mjs` 생성. gen-slaydeck.mjs에서 이동:
+  - 함수: `prop`·`method`·`codeblock` (정의 본문 그대로).
+  - `writeCodeblocks` 지역 상수 9개(현 `:292-300`): `RUN_LENGTH`(5) `GOLD_PER_WIN`(25) `CARD_PRICE`(30) `REST_HEAL`(30) `RELIC_PRICE`(60) `ACT_COUNT`(5) `ACT_MAPS`(['map01'..'map05']) `LOBBY_MAP`('lobby') `LOBBY_SPAWN`('Vector3(-5, 0.03, 0)'). → writeCodeblocks 본문에서 제거(import로 대체).
+  - 끝에 `export { prop, method, codeblock, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN };`
+  - ⚠️ `prop`/`method`/`codeblock`이 다른 헬퍼(없음 — 순수)·데이터를 참조하지 않는지 확인. 참조 시 함께 import.
+
+- [ ] **Step 2:** gen-slaydeck.mjs에 `import { prop, method, codeblock, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from './lib/codeblock.mjs';` 추가(기존 lib import 옆).
+
+- [ ] **Step 3:** 검증 게이트 → codeblock IDENTICAL → churn 복원.
+
+- [ ] **Step 4:** 커밋
+```
+git add tools/deck/lib/codeblock.mjs tools/deck/gen-slaydeck.mjs
+git commit -m "refactor(cb): lib/codeblock.mjs로 헬퍼·상수 추출 (출력 바이트 동일)"
+```
+
+---
+
+### 메서드 추출 공통 레시피 (Task 2~의 각 런)
+
+`writeCodeblocks`의 `const combat = codeblock('SlayDeckController','SlayDeckController', [<props>], [\n  method('OnBeginPlay', …),\n  method('ReqLoadAscension', …),\n  … 161개 …\n])` 에서 메서드 배열을 런별로 분리:
+1. `tools/deck/cb/<name>.mjs` 생성:
+```js
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { /* lib/data.mjs 전체 — 자동 파생 */ } from '../lib/data.mjs';
+import { /* lib/ui-helpers.mjs 전체 — 자동 파생 */ } from '../lib/ui-helpers.mjs';
+
+export const <name>Methods = [
+  method('<First>', `…`, …),
+  …,                              // ← 원본 method() 호출 verbatim 이동
+  method('<Last>', `…`, …),
+];
+```
+2. writeCodeblocks의 해당 런 method() 호출 스팬을 제거하고, methods 배열을 spread로 교체:
+   `codeblock(…, [<props>], [ ...bootMethods, ...stateMethods, …, ...shopMethods ])`.
+3. **검증 게이트**(codeblock IDENTICAL) → churn 복원 → 커밋.
+4. ⚠️ 메서드가 writeCodeblocks 지역변수/다른 메서드를 **JS레벨로 참조**하면(드묾) undefined throw/diffcheck로 노출 → 그 변수도 lib로 옮기거나 인자화.
+- import 이름은 lib export에서 **자동 파생**(누락 방지). 메서드 본문은 Lua 문자열이라 보간(`${RUN_LENGTH}`·`${luaCardsTable(...)}`)만 JS평가.
+
+### 런 → 모듈 경계 (원본 순서, 161개)
+| 모듈 | export | 첫 메서드 → 끝 메서드 | 수 |
+|---|---|---|---|
+| `cb/boot.mjs` | `bootMethods` | `OnBeginPlay` → `AscStartHpPenalty` | 11 |
+| `cb/state.mjs` | `stateMethods` | `HideGameHud` → `CloseBoard` | 12 |
+| `cb/soul.mjs` | `soulMethods` | `ShowSoulShop` → `ApplySoulUnlocks` | 11 |
+| `cb/charselect.mjs` | `charSelectMethods` | `ShowCharacterSelect` → `SetEntityEnabled` | 5 |
+| `cb/run.mjs` | `runMethods` | `StartRun` → `ReviveMonsterEntity` | 6 |
+| `cb/deckturn.mjs` | `deckTurnMethods` | `Shuffle` → `RenderPiles` | 8 |
+| `cb/deckview.mjs` | `deckViewMethods` | `OpenDeckInspect` → `ApplyAllDeckCardVisual` | 12 |
+| `cb/hand.mjs` | `handMethods` | `GetHandSlotX` → `SelectDiscardSlot` | 18 |
+| `cb/combat.mjs` | `combatMethods` | `PlayCard` → `ContinueAfterBoss` | 20 |
+| `cb/jobs.mjs` | `jobMethods` | `ShowJobChoice` → `SetJob` | 5 |
+| `cb/runend.mjs` | `runEndMethods` | `TeleportToActMap` → `EndRun` | 3 |
+| `cb/render.mjs` | `renderMethods` | `BuffsLabel` → `RenderRun` | 12 |
+| `cb/reward.mjs` | `rewardMethods` | `CardPool` → `PickReward` | 4 |
+| `cb/items.mjs` | `itemMethods` | `HasRelic` → `RenderRelics` | 12 |
+| `cb/tooltip.mjs` | `tooltipMethods` | `BuildCardKeywordTooltip` → `HideTooltip` | 6 |
+| `cb/map.mjs` | `mapMethods` | `ShowMap` → `PickNode` | 7 |
+| `cb/shop.mjs` | `shopMethods` | `ShowShop` → `OpenChest` | 9 |
+
+최종 concat 순서(= 원본): `[ ...bootMethods, ...stateMethods, ...soulMethods, ...charSelectMethods, ...runMethods, ...deckTurnMethods, ...deckViewMethods, ...handMethods, ...combatMethods, ...jobMethods, ...runEndMethods, ...renderMethods, ...rewardMethods, ...itemMethods, ...tooltipMethods, ...mapMethods, ...shopMethods ]`.
+
+---
+
+### Task 2: 런 추출 배치 A (말단부터 — 위험 낮은 순)
+**Files:** Create `cb/shop.mjs map.mjs tooltip.mjs items.mjs reward.mjs`; Modify gen-slaydeck.mjs
+
+- [ ] 레시피로 **shop → map → tooltip → items → reward** 추출·검증·커밋(런 1개당 또는 묶음당 게이트 통과 필수).
+
+### Task 3: 런 추출 배치 B
+**Files:** Create `cb/render.mjs runend.mjs jobs.mjs combat.mjs`; Modify gen-slaydeck.mjs
+- [ ] 레시피로 **render → runend → jobs → combat** 추출·검증·커밋.
+
+### Task 4: 런 추출 배치 C
+**Files:** Create `cb/hand.mjs deckview.mjs deckturn.mjs run.mjs`; Modify gen-slaydeck.mjs
+- [ ] 레시피로 **hand → deckview → deckturn → run** 추출·검증·커밋.
+
+### Task 5: 런 추출 배치 D (앞부분 — 마지막)
+**Files:** Create `cb/charselect.mjs soul.mjs state.mjs boot.mjs`; Modify gen-slaydeck.mjs
+- [ ] 레시피로 **charselect → soul → state → boot** 추출·검증·커밋. 완료 후 writeCodeblocks는 props 배열 + `[ ...17 spreads ]` + write만 남아야 함.
+
+---
+
+### Task 6: 마무리 — RULES + 회귀 + PR
+
+**Files:** Modify `RULES.md`
+
+- [ ] **Step 1:** RULES §1의 gen-slaydeck 모듈 설명에 `tools/deck/cb/*.mjs`(메서드)·`tools/deck/lib/codeblock.mjs`(헬퍼·상수) 추가. 단일소스 표/보조 생성기 일관성 유지.
+- [ ] **Step 2:** 회귀: `node --test tools/balance/sim-balance.test.mjs` · `node --test tools/map/rogue-map.test.mjs` (exit 0).
+- [ ] **Step 3:** 최종 재생성 + 검증 게이트(누적 codeblock IDENTICAL). `git status --short` 산출물 변경 없음.
+- [ ] **Step 4:** RULES 커밋 → push → PR(`node tools/git/gitea-pr.mjs create <spec.json>`, UTF-8). PR 제목·본문 한국어(RULES §4).
+
+---
+
+## Self-Review
+- **스펙 커버리지**: lib/codeblock(T1) · 메서드 17런 모듈화(T2~5) · prop 유지(범위 명시) · 바이트동일 게이트(공통) · RULES(T6) · 미러회귀(T6). 누락 없음.
+- **플레이스홀더**: 런 경계는 첫/끝 메서드로 구체 지정(161개 합), 상수 9개 명시, import 자동 파생. "verbatim 이동"은 리팩터 특성(바이트 검증이 정확성 보장).
+- **타입 일관성**: export명(`xMethods`)↔concat spread 일치. lib/codeblock export↔orchestrator/cb import 일치.
+- **리스크**: 메서드 JS레벨 외부참조 → diffcheck/throw 즉시 노출, 증분으로 범위 최소. 단방향 의존 순환 없음.

docs/superpowers/plans/2026-06-16-generator-modularization.md

@@ -0,0 +1,169 @@
+# 생성기 모듈화 (Phase 1) 구현 계획
+
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:executing-plans 로 태스크 단위 구현. 단계는 `- [ ]` 체크박스.
+
+**Goal:** `tools/deck/gen-slaydeck.mjs`(~6,200줄)의 공유 인프라와 UI emit 16종을 `lib/`·`hud/` 모듈로 분리하되 출력 산출물은 바이트 동일로 유지한다.
+
+**Architecture:** 단방향 의존 — `gen-slaydeck.mjs`(오케스트레이터) → `hud/*.mjs`(HUD별 build 함수) → `lib/*.mjs`(헬퍼·상수·데이터). `guid(prefix,n)`가 순수 함수라 모듈화해도 emit 순서만 보존하면 출력 불변. codeblock 메서드는 이번 범위 제외.
+
+**Tech Stack:** Node ESM. 검증 = **바이트 동일 재생성**(git diff 빈 결과) + 미러 `node --test`.
+
+---
+
+## 🔑 검증 게이트 (모든 Task 공통)
+
+각 추출 후 반드시:
+```
+node tools/deck/gen-slaydeck.mjs        # 성공 메시지 1줄, throw 없음
+git status --short
+```
+**합격 기준**: `ui/DefaultGroup.ui`·`RootDesk/MyDesk/SlayDeckController.codeblock`이 **변경 안 됨**(git status에 안 뜸). `Global/common.gamelogic`만 ` M`이면 LF churn → `git checkout -- Global/common.gamelogic`.
+- 만약 ui/codeblock이 ` M`로 뜨면 **추출 중 실수**(참조 누락/순서 변경) → `git diff --stat`로 어느 산출물인지 보고 되돌려 원인 수정. (RULES상 산출물 content는 안 봄 — 소스 diff로 원인 파악.)
+
+---
+
+## 파일 구조 (목표)
+```
+tools/deck/
+  gen-slaydeck.mjs   # 오케스트레이터: import → 데이터 로드(lib) → upsertUi(hud 호출) → writeCodeblocks → patchCommon
+  lib/
+    data.mjs         # 데이터 로드·검증·luaXxxTable·frameRuid·게임상수
+    ui-helpers.mjs   # guid/transform/sprite/button/text/entity/scrollLayoutGroup/cardFaceLayout/applySortingOverride
+                     #   + UI 상수 + uiPath/sectionRoot/isGeneratedUiEntity/appendUiSection
+  hud/
+    deckhud.mjs deckinspect.mjs deckall.mjs combat.mjs reward.mjs map.mjs
+    shop.mjs rest.mjs treasure.mjs jobchoice.mjs jobselect.mjs mainmenu.mjs
+    charselect.mjs lobby.mjs board.mjs soulshop.mjs
+```
+
+---
+
+### Task 1: `lib/data.mjs` — 데이터·게임상수·lua 테이블 추출
+
+**Files:** Create `tools/deck/lib/data.mjs`; Modify `tools/deck/gen-slaydeck.mjs`(상단 데이터/lua 블록 → import)
+
+- [ ] **Step 1:** `lib/data.mjs` 생성. gen-slaydeck.mjs에서 아래를 **잘라 이동**(정의 본문 그대로):
+  - 데이터 로드+검증: `CARDS`(:3) `ENEMIES`(:4) `CLASSES`(:7~17) `JOBS`(:19~40) `SOUL_UNLOCKS`(:42~47) `CARDFRAMES`+검증(:57~68) `RARITIES`(:58) `NODEICONS`+검증(:92~96) `CHARS`+검증(:99~103) `CAM`(:105) `RELICS`+검증(:107~) `POTIONS`+검증(:118~)
+  - 게임 상수: `MAP_ROWS`(:84) `MAP_COLS`(:85) `CHEST_CLOSED_RUID`(:88) `CHEST_OPEN_RUID`(:89)
+  - 함수: `luaSoulShopTable`(:48) `frameRuid`(:69) `luaFramesTable`(:72) `luaNodeIconsTable`(:78) `luaRelicsTable` `luaPotionsTable` `luaIntentsArray` `luaEnemiesTable` `luaStr` `luaJobsTable` `luaCardsTable` `luaDeckTable`
+  - 맨 위 `import { readFileSync } from 'node:fs';`, 맨 끝 `export { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, NODEICONS, CHARS, CAM, RELICS, POTIONS, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable };`
+  - ⚠️ `luaNodeIconsTable`는 `luaStr`를 쓰므로 `luaStr`도 같이 이동. `luaFramesTable`도 `luaStr` 사용. 상호 참조는 같은 모듈 내라 OK.
+
+- [ ] **Step 2:** gen-slaydeck.mjs 상단에 `import { CARDS, ENEMIES, ... , luaDeckTable } from './lib/data.mjs';` 추가(이동한 정의 위치에).
+
+- [ ] **Step 3:** 검증 게이트 실행 → ui/codeblock 0 변경 확인 → common.gamelogic churn 복원.
+
+- [ ] **Step 4:** 커밋
+```
+git add tools/deck/lib/data.mjs tools/deck/gen-slaydeck.mjs
+git commit -m "refactor(gen): lib/data.mjs로 데이터·lua 테이블 추출 (출력 불변)"
+```
+
+---
+
+### Task 2: `lib/ui-helpers.mjs` — UI 헬퍼·상수 추출
+
+**Files:** Create `tools/deck/lib/ui-helpers.mjs`; Modify `tools/deck/gen-slaydeck.mjs`
+
+- [ ] **Step 1:** `lib/ui-helpers.mjs` 생성. gen-slaydeck.mjs에서 이동:
+  - UI 상수: `UI_FILE`(:190) `COMMON_FILE`(:191) `UI_ROOT`(:192) `GENERATED_UI_SECTIONS`(:193) `UI_APPEND_ORDER`(:211) `DISABLED_STOCK_CONTROLS`(:229) `TRANSPARENT DARK GOLD ATTACK DEFEND SKILL`(:231~236) `DAMAGE_DIGIT_RUIDS`(:237) `DAMAGE_POP_*`(:249~252) `MAX_MONSTERS`(:254) `HEAD_OFFSET_Y`(:255) `HP_BAR_W`(:257) `WHITE`(:258) `CARD_NAME_TEXT CARD_DESC_TEXT`(:259~260) `CARD_W CARD_H CARD_SPACING CARD_XS`(:276~279) `ALIGN_CENTER ALIGN_BOTTOM_CENTER`(:281~282)
+  - 헬퍼: `cardFaceLayout`(:264) `guid`(:284) `transform`(:292) `sprite`(:317) `button`(:353) `text`(:378) `scrollLayoutGroup`(:405) `popupLayerFor`(:437) `uiOrderFor`(:443) `displayOrderFor`(:452) `applySortingOverride`(:456) `entity`(:472) `uiPath`(:504) `sectionRoot`(:508) `isGeneratedUiEntity`(:512) `appendUiSection`(:516)
+  - `export { ... }` 전부.
+  - ⚠️ COMMON_FILE은 patchCommon(:6125)도 사용 → export 필요. UI_APPEND_ORDER·GENERATED_UI_SECTIONS는 upsertUi가 사용.
+
+- [ ] **Step 2:** gen-slaydeck.mjs에 `import { ... } from './lib/ui-helpers.mjs';` 추가.
+
+- [ ] **Step 3:** 검증 게이트 → 0 변경 → churn 복원.
+
+- [ ] **Step 4:** 커밋 `git commit -m "refactor(gen): lib/ui-helpers.mjs로 UI 헬퍼·상수 추출 (출력 불변)"`
+
+---
+
+### HUD 추출 공통 레시피 (Task 3~6에 반복 적용)
+
+각 HUD는 현재 `upsertUi()` 안에서 `const <v> = []; const add = (e) => <v>.push(e); add(entity(...)); …; emit('<Name>', <v>);` 형태다. 추출 절차:
+1. `tools/deck/hud/<name>.mjs` 생성: `import { guid, entity, transform, sprite, button, text, GOLD, ... } from '../lib/ui-helpers.mjs';` + 필요한 데이터는 `'../lib/data.mjs'`. `export function build<Name>() { const e = []; const add = (x)=>e.push(x); add(entity(...)); …; return e; }` — **본문은 기존 라인 그대로 이동**(emit 호출 줄만 제외).
+2. upsertUi에서 해당 블록을 `emit('<Name>', build<Name>());` 한 줄로 치환.
+3. **검증 게이트**(ui/codeblock 0 변경) → churn 복원 → 커밋.
+4. ⚠️ 옮긴 블록이 upsertUi 지역변수(`byPath`/`ui`/`cards`/`previewIds`)를 참조하면 안 됨(HUD 섹션은 헬퍼·데이터만 씀이 확인됨). 참조 시 바이트 diff로 즉시 드러남 → 그 변수를 인자로 받도록 조정.
+
+추출 대상(순서·소스 라인·emit명·모듈):
+
+| 모듈 | emit | 소스(블록 시작~emit줄) |
+|---|---|---|
+| `hud/deckhud.mjs` → `buildDeckHud` | DeckHud | `:693`(`const hud=[]`)~`:808` |
+| `hud/deckinspect.mjs` → `buildDeckInspect` | DeckInspectHud | `:810`~`:942` |
+| `hud/deckall.mjs` → `buildDeckAll` | DeckAllHud | `:944`~`:1097` |
+| `hud/combat.mjs` → `buildCombat` | CombatHud | `:1100`~`:1587` |
+| `hud/reward.mjs` → `buildReward` | RewardHud | `:1589`~`:1681` |
+| `hud/map.mjs` → `buildMap` | MapHud | `:1684`~`:1839` |
+| `hud/shop.mjs` → `buildShop` | ShopHud | `:1841`~`:2038` |
+| `hud/rest.mjs` → `buildRest` | RestHud | `:2040`~`:2095` |
+| `hud/treasure.mjs` → `buildTreasure` | TreasureHud | `:2098`~`:2181` |
+| `hud/jobchoice.mjs` → `buildJobChoice` | JobChoiceHud | `:2184`~`:2229` |
+| `hud/jobselect.mjs` → `buildJobSelect` | JobSelectHud | `:2231`~`:2314` |
+| `hud/mainmenu.mjs` → `buildMainMenu` | MainMenu | `:2316`~`:2616` |
+| `hud/charselect.mjs` → `buildCharSelect` | CharacterSelectHud | `:2437`~`:2617`(`select[0]…enable=false` 포함) |
+| `hud/lobby.mjs` → `buildLobby` | LobbyHud | `:2620`~`:2672` |
+| `hud/board.mjs` → `buildBoard` | BoardHud | `:2675`~`:2727` |
+| `hud/soulshop.mjs` → `buildSoulShop` | SoulShopHud | `:2729`~`:2814` |
+
+⚠️ MainMenu/CharacterSelectHud는 `const menu=[]`(:2316)·`const select=[]`(:2437)로 인접 정의 후 `emit('MainMenu', menu); emit('CharacterSelectHud', select);`가 :2616~2617에 연속. 각각 별 모듈로 분리, emit 두 줄로. `select[0].jsonString.enable=false`(:2596)는 buildCharSelect 내부에서 `e[0].jsonString.enable=false`로.
+⚠️ **CardHand 스톡카드 in-place upsert(`:557~691`)는 추출 안 함** — 기존 .ui 엔티티를 변형하는 특수 로직이라 upsertUi에 잔류(import만 정리).
+
+---
+
+### Task 3: HUD 추출 배치 A (말단부터 — 위험 낮은 순)
+**Files:** Create `hud/soulshop.mjs board.mjs lobby.mjs charselect.mjs`; Modify gen-slaydeck.mjs
+
+- [ ] **Step 1~4:** 레시피로 **soulshop → board → lobby → charselect** 순서로 하나씩 추출·검증·커밋(HUD 1개당 커밋 1개 권장, 배치로 묶어도 무방). 각 추출 후 검증 게이트 통과 필수.
+  - charselect는 P15/이번 작업으로 검증된 화면이라 패턴 안정. `e[0].jsonString.enable=false` 처리 확인.
+
+---
+
+### Task 4: HUD 추출 배치 B
+**Files:** Create `hud/mainmenu.mjs jobselect.mjs jobchoice.mjs treasure.mjs rest.mjs`; Modify gen-slaydeck.mjs
+
+- [ ] **Step 1~4:** 레시피로 **mainmenu → jobselect → jobchoice → treasure → rest** 추출·검증·커밋.
+
+---
+
+### Task 5: HUD 추출 배치 C
+**Files:** Create `hud/shop.mjs map.mjs reward.mjs`; Modify gen-slaydeck.mjs
+
+- [ ] **Step 1~4:** 레시피로 **shop → map → reward** 추출·검증·커밋.
+
+---
+
+### Task 6: HUD 추출 배치 D (대형 — 마지막)
+**Files:** Create `hud/combat.mjs deckall.mjs deckinspect.mjs deckhud.mjs`; Modify gen-slaydeck.mjs
+
+- [ ] **Step 1~4:** 레시피로 **deckhud → deckinspect → deckall → combat** 추출·검증·커밋. combat(~487줄)이 가장 크니 마지막. 추출 후 upsertUi는 데이터 준비 + CardHand upsert + `emit('X', buildX())` 16줄 + 병합만 남아야 함.
+
+---
+
+### Task 7: 마무리 — RULES 동기화 + 회귀 + PR
+
+**Files:** Modify `RULES.md`
+
+- [ ] **Step 1:** RULES.md §1 보조 생성기/단일소스 표에 반영: `tools/deck/gen-slaydeck.mjs`(오케스트레이터)·`tools/deck/lib/*.mjs`(공유)·`tools/deck/hud/*.mjs`(HUD별)가 함께 `ui/DefaultGroup.ui`·`SlayDeckController.codeblock`의 단일 소스임을 명시.
+
+- [ ] **Step 2:** 회귀 테스트(무영향 확인)
+```
+node --test tools/balance/sim-balance.test.mjs
+node --test tools/map/rogue-map.test.mjs
+```
+Expected: 전부 pass(37/0, 9/0).
+
+- [ ] **Step 3:** 최종 재생성 + 전체 검증 게이트 → ui/codeblock 0 변경(누적) 최종 확인. `git status --short`에 산출물 변경 없음.
+
+- [ ] **Step 4:** RULES 커밋 → push → PR(`node tools/git/gitea-pr.mjs create <spec.json>`, UTF-8).
+
+---
+
+## Self-Review
+
+- **스펙 커버리지**: lib/data·ui-helpers(T1,T2) · HUD 16종 모듈화(T3~6) · 바이트 동일 게이트(공통 게이트, 매 Task) · codeblock 제외(범위 명시) · RULES 동기화(T7) · 미러 회귀(T7). 누락 없음.
+- **플레이스홀더**: 이동 대상은 라인 범위로 구체 지정, 검증 명령·합격기준 명시, export/import 목록 구체. "본문 그대로 이동"은 리팩터 특성상 코드 재타이핑 대신 정확한 소스 위치 지정(바이트 검증이 정확성 보장).
+- **타입 일관성**: build 함수명·emit명·모듈 경로 표로 고정. data.mjs/ui-helpers.mjs export ↔ gen-slaydeck import 일치.
+- **리스크**: 상수/헬퍼 참조 누락 → 바이트 diff 또는 throw로 즉시 노출. 증분 추출로 실패 범위 최소화. 단방향 의존(orchestrator→hud→lib)로 순환 없음.

docs/superpowers/specs/2026-06-14-lobby-map-npc-design.md

@@ -0,0 +1,104 @@
+# 로비 맵 + 월드 NPC 설계 (P15)
+
+작성일: 2026-06-14
+브랜치: `feature/p15-lobby-map-npc`
+
+## 목표
+
+기존 **UI 패널 로비**(P14-8 `LobbyHud` — 색칠된 `UIButton` 4개 행)를 폐기하고,
+**전용 로비 맵**에 **월드 NPC 엔티티 4종**을 배치한다. NPC를 누르면 각 기능이 실행되며,
+플레이어 **이동·공격 모션은 로비 맵에서만** 풀린다(전투/런 맵에서는 기존대로 잠김 유지).
+
+요청 원문: "로비를 UI로 만들지 말고, map을 추가해서 로비에 각각 기능을 할 수 있는 npc를 추가하고,
+그 npc를 누르면 각 기능을 할 수 있도록 추가. 플레이어는 반드시 로비맵에서만 이동과 공격 모션을 풀어줘."
+
+## 확정된 결정 (브레인스토밍)
+
+| 항목 | 결정 |
+|---|---|
+| NPC 상호작용 | **근접 프롬프트+키(Up/Space) AND 직접 클릭** 둘 다 지원 |
+| NPC 기능 | **기존 4종 유지** + 외형을 **정식 maplestory NPC 스프라이트(공식 RUID)** 로 교체 |
+| 로비 맵 | **새 전용 로비 맵 추가**(`map/lobby.map`), 런 맵(map01~) 인덱스 불변 |
+
+## 현재 상태 (조사 결과)
+
+- **로비 = UI 패널** `LobbyHud`. NPC 4종은 색칠 `UIButton`, 전부 `tools/deck/gen-slaydeck.mjs`에 하드코딩.
+  - `NpcRun`(모험가→런 시작), `NpcCodex`(사서→카드 도감), `NpcShop`(상인→영혼 상점), `NpcBoard`(안내원→게시판).
+  - 정의 ~`gen-slaydeck.mjs:2469-2487`, 클릭 바인딩 `BindLobbyButtons()` ~`2997-3014`.
+  - 기능 진입 메서드: `ShowCharacterSelect()`(~3147), `ShowCodex()`, `ShowSoulShop()`, `ShowBoard()` — **재사용 대상**.
+- **이동/공격 이중 잠금**:
+  - `tools/player/freeze-turn-player.mjs` → `Global/DefaultPlayer.model` speed/jump/accel = 0 (**전역**).
+  - `tools/player/gen-player-lock.mjs` → `PlayerLock` codeblock(`pc.Enable=false`, `FixedLookAt=true`)를 map01~05에 주입.
+  - 공격은 순수 모션 `PlayerAttackMotion()`(StateComponent ATTACK→IDLE), 필드 몬스터와 무관(전투는 데이터 배열 UI 전투).
+  - 플레이어 스폰: `TeleportToActMap()` → `Vector3(-6, 0.03, 0)`, Floor별 map 선택.
+- **맵 파이프라인**: map01 = 저작 템플릿, map02~05 = 복제 생성. 포털 없이 `TeleportToMapPosition` 전환.
+  - `Global/SectorConfig.config`의 valid 목록에 맵 등록(현재 gen-maps.mjs가 갱신).
+  - 컴포넌트 부착 패턴: `gen-combat-monster.mjs`가 맵 몬스터에 `script.CombatMonster`를 붙이고, 해당 codeblock이 OnBeginPlay에서 `/common` 컨트롤러에 자가등록.
+- **흐름**: `OnBeginPlay`→`ShowLobby()`(UI). `EndRun(text)`→4초 후 `ShowLobby()`.
+
+## 접근법
+
+**A. 새 로비 맵 + 월드 NPC 엔티티 (채택)** — 맵 템플릿 복제 재사용, NPC를 월드 엔티티로 배치하고
+각 NPC의 codeblock이 근접+클릭을 감지해 **기존 기능 패널**을 띄움. 이동/공격 해제는 로비 맵 전용 codeblock.
+전투맵은 손대지 않아 잠금 유지. (B: 몬스터 배치기 재활용 → 로직 혼재로 비채택. C: 화면고정 UI 버튼 → 거부된 "UI 로비"라 제외.)
+
+## 상세 설계
+
+### 1) 로비 맵 — `tools/map/gen-lobby-map.mjs` → `map/lobby.map`
+- map01 템플릿 deep clone → 경로 `/maps/lobby`로 치환, GUID 재발급(결정론 시드).
+- 마을/타운 배경 RUID + 타일셋 적용. **`script.Monster`/`script.CombatMonster` 엔티티 전부 제거**(전투 없음).
+- NPC 4종을 x축으로 벌려 월드 엔티티로 배치. 각 NPC:
+  - 스프라이트 = 공식 maplestory NPC RUID(계정 업로드 금지 — 흰 박스). 구현 단계에서 asset 검색으로 4개 확정.
+  - `script.LobbyNpc` 컴포넌트 + `NpcId`(`run`/`codex`/`shop`/`board`) + 머리 위 이름/`!` 프롬프트용 텍스트 노드.
+- 플레이어 스폰 지점(맵 중앙-좌측).
+- `Global/SectorConfig.config` valid 목록에 `map://lobby` 추가 — **SectorConfig 단일 소유자는 gen-maps.mjs**로 유지하고 lobby 항목을 그 상수에 포함(두 생성기 충돌 방지).
+
+### 2) NPC 상호작용 — `tools/player/gen-lobby-npc.mjs` → `LobbyNpc` codeblock
+- **근접+키**: 매 틱(타이머) 로컬 플레이어와의 x거리 측정 → 임계 거리 내면 `!` 프롬프트 노드 활성 + `Up`/`Space` 입력 시 트리거.
+- **직접 클릭**: NPC 엔티티 클릭/터치 → 동일 트리거. (MSW 월드 엔티티 클릭 API는 구현 시 `mlua_api_retriever`로 확정: 엔티티 TouchEvent vs 스크린 오버레이 버튼 중 검증된 방식.)
+- 트리거 시 `_EntityService:GetEntityByPath("/common").SlayDeckController:OnLobbyNpcInteract(NpcId)` 호출(경로 기반 크로스 codeblock — CombatMonster 자가등록과 동일 패턴).
+- 한 번에 하나만 상호작용(다른 패널 열려 있으면 무시).
+
+### 3) 이동·공격 잠금 해제 (로비 맵 한정) — `LobbyMobility` codeblock
+- **`map/lobby.map`에만** 주입(전투맵 PlayerLock/전역 freeze는 불변).
+- OnBeginPlay 런타임 복원: 로컬 플레이어 `MovementComponent`(InputSpeed/JumpForce) 정상값, `PlayerController.Enable=true`, `FixedLookAt=false`.
+- 공격 입력(키/클릭) → 기존 `PlayerAttackMotion()`(코스메틱) 바인딩. **필드 타격 없음**.
+- 전투맵 텔레포트 시 모델 기본값(speed=0)+PlayerLock 재적용 → **"로비맵에서만"을 구조적으로 보장**.
+- 런타임 이동/공격 복원 정확한 API는 구현 단계에서 `mlua_api_retriever`로 확정.
+- 생성기 배치는 `gen-lobby-npc.mjs`에 함께 둘지 별도 `gen-lobby-unlock.mjs`로 분리할지는 계획에서 결정(둘 다 lobby 맵 전용 codeblock).
+
+### 4) 흐름 통합 — `tools/deck/gen-slaydeck.mjs`
+- **OnBeginPlay**: `ShowLobby()`(UI) → **로비 맵 텔레포트** + 경량 "lobby" 상태(전투/상점/맵 HUD 숨김).
+- **EndRun**: 4초 후 `ShowLobby()` → **로비 맵 텔레포트 복귀**.
+- **OnLobbyNpcInteract(id)** 신규: `run`→`ShowCharacterSelect()`, `codex`→`ShowCodex()`, `shop`→`ShowSoulShop()`, `board`→`ShowBoard()`(전부 기존 메서드 재사용, 패널은 로비 맵 위 팝업).
+- **제거**: `LobbyHud` 버튼-행 허브 패널 + `BindLobbyButtons`.
+- **유지**: 영혼 포인트·승천 표시는 화면 모서리 **미니 HUD**(정보 표시 필요). 기능 패널 4종은 NPC 트리거.
+- 런 시작(`StartRun`/`TeleportToActMap`)·전투 흐름은 불변.
+
+### 5) 미러/테스트 영향
+- 이동/공격 해제·NPC 배치는 **전투 규칙도 맵 그래프 생성 알고리즘도 아님** → `sim-balance.mjs`/`rogue-map.mjs` JS 미러 동기화 **불필요**(RULES.md §6은 그 둘만 요구).
+- 검증(카운트만): `lobby.map` 내 NPC 엔티티 수, 산출물의 `LobbyNpc`/`LobbyMobility`/`OnLobbyNpcInteract` 개수, SectorConfig `map://lobby` 존재. 내용 출력 금지.
+- 동작 검증: 메이커 플레이테스트.
+
+## 검증 시나리오 (메이커)
+1. 월드 시작 → **로비 맵에 스폰**, 이동 가능, 공격 모션 가능.
+2. NPC 근접 → `!` 프롬프트 → `Up/Space`로 기능 패널 오픈. 직접 클릭으로도 오픈.
+3. 4종 각각: 모험가→직업선택→런 시작, 사서→도감, 상인→영혼상점, 안내원→게시판.
+4. 런 시작 → map01 텔레포트, **이동/공격 잠김**.
+5. 런 종료(클리어/패배) → **로비 맵 복귀**, 이동/공격 재해제.
+6. 미니 HUD에 영혼/승천 표시 정상.
+
+## 리스크
+- MSW 런타임 이동 재활성 API 가용성 → 계획 단계 `mlua_api_retriever` 검증.
+- MSW 월드 엔티티 클릭 감지 방식 → 동일 검증(불가 시 근접+키만으로 폴백, 직접 클릭은 스크린 오버레이 버튼으로 구현).
+- 텔레포트 복귀 좌표/스폰 위치 정합.
+- 메이커 stale 상태 — git pull 후 로컬 워크스페이스 reload 필수(RULES.md §5).
+
+## 생성기/파일 변경 요약
+| 파일 | 변경 |
+|---|---|
+| `tools/map/gen-lobby-map.mjs` | **신규** — lobby.map(배경/타일/NPC 엔티티/스폰), SectorConfig 조율 |
+| `tools/player/gen-lobby-npc.mjs` | **신규** — LobbyNpc 상호작용 codeblock(+LobbyMobility 또는 분리) |
+| `tools/deck/gen-slaydeck.mjs` | OnBeginPlay/EndRun 로비맵 전환, OnLobbyNpcInteract, 버튼-행 허브 제거, 미니 HUD |
+| `Global/SectorConfig.config` | map://lobby 등록(생성 산출물) |
+| `map/lobby.map`, `ui/DefaultGroup.ui`, `*.codeblock` | 재생성 산출물 |

docs/superpowers/specs/2026-06-15-node-map-ui-design.md

@@ -0,0 +1,96 @@
+# 노드 맵 UI 강화 설계
+
+작성일: 2026-06-15
+브랜치: `feature/node-map-ui`
+
+## 목표
+
+맵 노드 선택 화면(`MapHud`)을 **단색 박스+텍스트** → **공식 메이플 아이콘 노드 + 배경 이미지**로 강화한다.
+절차 랜덤 배치·간선·진행 로직은 그대로. 아이콘/배경은 **`data/nodeicons.json` 한 파일로 외부화**해 나중에 RUID만 바꿔 재생성하면 교체되도록 한다.
+
+요청 원문: "노드 창이 단순 네모 박스안에 텍스트 … 백그라운드 이미지 삽입하고 특정 아이콘을 지정해서 노드로 … 랜덤 배치 … 노드 맵 UI 강화. 내가 나중에 변경할 수도 있으니 변경이 쉽게 가능하도록."
+
+## 확정된 결정 (브레인스토밍)
+
+| 항목 | 결정 |
+|---|---|
+| 노드 표현 | **아이콘만**(박스 제거). 상태는 아이콘 틴트로 |
+| 배경 | **공식 메이플 배경 이미지** + 반투명 어두운 오버레이 |
+| 아이콘 세트 | 사용자 확정(아래 표). 공식 maplestory RUID, 썸네일 검수 완료 |
+| 변경 용이성 | 모든 RUID를 `data/nodeicons.json`로 외부화 → 편집+재생성으로 교체 |
+
+### 확정 아이콘/배경 (공식 maplestory, 흰박스 위험 없음)
+
+| 노드 타입 | 아이콘 | RUID |
+|---|---|---|
+| combat(전투) | 주황버섯 | `f98db6823e894a4f90308d61f75894ac` |
+| elite(엘리트) | 돌골렘(Stumpy) | `793ed8a757534b89a82f460747d2df24` |
+| boss(보스) | 주니어 발록 | `423056cdbbc04f4da131b9721c404d96` |
+| shop(상점) | 보라 돈주머니 | `da37e1fac55d455b9ade08569f09f798` |
+| rest(휴식) | 모닥불 | `b86c1b0568bd45f3ae4a4b97e1b4a594` |
+| treasure(보물) | 금별 보물상자 | `f8a6d58e20f54e2ca899485055df1ce4` |
+| **background** | 리스항구 | `d84241f17de344a097f5b96ac914f1d2` |
+
+## 현재 구조 (조사 결과)
+
+- `MapHud` 루트 = 1920×1080 **단색** 패널(`gen-slaydeck.mjs:1664`, 배경 이미지 없음) + 타이틀.
+- 노드 = `pushMapNode(id,pos,size,label)`(`:1696`) — `Node_{id}` 단색 박스(56×56, 보스 72×72) + `Label` 텍스트 자식. 그리드 `r1c1~r6c4`(24) + `boss`(`:1727`).
+- 타입 6종: combat/elite/shop/rest/treasure/boss. 타입→색/라벨은 **Lua `RenderMapNode`**(`:5626~5677`)가 런타임에 박스 `Color` + Label 텍스트로 채움. 상태 4단(현재 금색/방문 회색/도달 타입색/잠김 어둡게).
+- 절차 생성 `GenerateMap`(`:5505`) → `self.MapNodes[id]={type,row,col,next}`, id `r{r}c{c}`가 UI 엔티티와 1:1. 버튼 바인딩(`:3597`)은 경로 기반.
+- 이미지 주입 패턴: emit `sprite({dataId: RUID, type:0})`(`sprite()` 헬퍼 `:297`) / 런타임 `e.SpriteGUIRendererComponent.ImageRUID = "<ruid>"`(`ApplyCardFace :4089`, chest `:5874`). 카드 프레임은 `data/cardframes.json`→`luaFramesTable()`(`:72`)→`self.CardFrames` Lua 테이블.
+
+## 상세 설계
+
+### 1) `data/nodeicons.json` (신설 — 단일 소스)
+```json
+{
+  "icons": {
+    "combat":   "f98db6823e894a4f90308d61f75894ac",
+    "elite":    "793ed8a757534b89a82f460747d2df24",
+    "boss":     "423056cdbbc04f4da131b9721c404d96",
+    "shop":     "da37e1fac55d455b9ade08569f09f798",
+    "rest":     "b86c1b0568bd45f3ae4a4b97e1b4a594",
+    "treasure": "f8a6d58e20f54e2ca899485055df1ce4"
+  },
+  "background": "d84241f17de344a097f5b96ac914f1d2"
+}
+```
+- 사용자가 나중에 RUID만 바꾸고 `node tools/deck/gen-slaydeck.mjs` 재실행하면 교체됨. (README/주석에 명시.)
+
+### 2) `gen-slaydeck.mjs` — 로드·검증·직렬화
+- 상단에서 `NODEICONS = JSON.parse(readFileSync('data/nodeicons.json'))` 로드.
+- **fail-fast 검증**: `icons`에 6타입(combat/elite/boss/shop/rest/treasure) 전부 존재 + 32hex RUID, `background` 존재. 누락 시 throw(카드프레임 검증과 동일 패턴).
+- `luaNodeIconsTable()` 헬퍼: `self.NodeIcons = { combat="...", ... }` Lua 테이블 문자열. OnBeginPlay init에 주입(CardFrames 패턴, `:2906/3361` 인접). `prop('any','NodeIcons')` 선언.
+
+### 3) MapHud emit 변경
+- **배경 자식 `MapHud/Bg`**: 루트 직후 push. `uisprite`, 1920×1080, `dataId = NODEICONS.background`, `type:0`, 흰색, `raycast:false`, displayOrder 최하(0). 항상 enable.
+- **루트 오버레이**: 기존 루트 단색을 **반투명 어두운 오버레이**로(예: `{r:0.04,g:0.05,b:0.08,a:0.55}`)— 배경이 비치되 노드 가독성 확보. raycast 유지(뒤 월드 클릭 차단).
+- **`pushMapNode` → 아이콘 노드**: `Node_{id}` 본체를 박스 대신 **아이콘 스프라이트**로 — `sprite({ color:{1,1,1,1}, type:0, raycast:true })`(emit 시 dataId 미지정, 런타임에 타입별 ImageRUID 주입) + `button()`. **`Label` 자식 제거**(아이콘만). 노드 크기 키움: 그리드 64×64, 보스 88×88. (좌표 헬퍼 `nodeX/nodeY`·그리드 생성 루프·버튼 바인딩은 불변.)
+
+### 4) RenderMapNode Lua 변경
+- 타입→박스색/라벨 매핑(`:5630~5656`) 제거. 대신:
+  - `e.SpriteGUIRendererComponent.ImageRUID = self.NodeIcons[type]` (없으면 combat 폴백).
+  - 상태별 `Color` 틴트(박스가 아니라 **아이콘**에):
+    - 현재(`CurrentNodeId`): `Color(1, 0.82, 0.3, 1)` 금색
+    - 도달가능: `Color(1, 1, 1, 1)` 원색 + `ButtonComponent.Enable=true`
+    - 방문: `Color(0.5, 0.5, 0.55, 0.9)` 회색
+    - 잠김: `Color(0.4, 0.4, 0.45, 0.45)` 어둡고 반투명 + 버튼 비활성
+- `SetText(.../Label ...)` 호출 제거(라벨 없음). 간선 도트(`RenderMapDots`)·`RenderMap` 루프는 불변.
+
+### 5) 미러/테스트 영향
+- 전투 규칙·맵 그래프 알고리즘 **미변경** → `sim-balance`/`rogue-map` 미러 동기화 불필요.
+- 검증(카운트): `MapHud/Bg` 1개, `NodeIcons` 주입, 노드 ImageRUID 주입 코드 존재, 6 RUID 등장. 내용 출력 금지(`tools/verify/count.mjs`).
+- 동작: 메이커 플레이테스트(아이콘 렌더·상태 틴트·랜덤 배치·노드 클릭 진행).
+
+## 리스크
+- **아이콘 비정사각/큰 스프라이트** → 64px UI에서 잘림/왜곡 가능(보스 발록은 확인됨, 골렘·버섯은 정사각 양호). type 0 렌더의 aspect 처리 확인, 필요 시 노드별 size 패딩 조정.
+- **아이콘만 상태 가독성**: 잠김/방문 틴트 대비가 약하면 플레이테스트로 알파/명도 튜닝.
+- **배경 오버레이 알파**: 너무 밝으면 노드가 묻힘 — 0.5~0.65 사이 튜닝.
+- 흰박스: 전부 공식 maplestory(검증) — 위험 없음. 단 로컬 워크스페이스 reload 필요.
+
+## 변경 파일 요약
+| 파일 | 변경 |
+|---|---|
+| `data/nodeicons.json` | **신설** — 아이콘 6 + 배경 RUID (단일 소스) |
+| `tools/deck/gen-slaydeck.mjs` | 로드·검증·luaNodeIconsTable, MapHud Bg/오버레이, pushMapNode 아이콘화, RenderMapNode ImageRUID+틴트 |
+| `ui/DefaultGroup.ui`·`SlayDeckController.codeblock` | 재생성 산출물 |

docs/superpowers/specs/2026-06-16-charselect-images-back-design.md

@@ -0,0 +1,105 @@
+# 직업 선택 — 캐릭터 이미지 + 뒤로가기 설계
+
+작성일: 2026-06-16
+브랜치: `feature/charselect-images`
+
+## 목표
+
+런 시작 시 띄우는 **캐릭터(직업) 선택 화면**(`CharacterSelectHud`)을 두 가지로 개선한다:
+1. 직업 3종(전사/도적/마법사)을 지금의 **단색 네모 박스** → **각 직업 캐릭터 이미지 카드**로. 이미지를 선택하면 그 직업으로 런 진행(기존 연결 유지).
+2. 직업 선택 화면에 **뒤로가기** 버튼 추가 → 로비로 복귀.
+
+요청 원문: "런 시작 시, 직업 선택 창을 뒤로가기도 가능하게 추가. 각 직업별로 지금은 네모 박스인데 각각 이미지(warrior/mage/bandit.png) 추가해서 적용하고, 선택했을 때 그 캐릭터로 진행하도록 연결."
+
+## 확정된 결정 (브레인스토밍)
+
+| 항목 | 결정 |
+|---|---|
+| 이미지 RUID 확보 | **사용자가 메이커에서 3 PNG 로컬 임포트** → `.sprite`+RUID(P13 카드프레임과 동일). MCP/계정 업로드는 흰박스라 불가 |
+| 이미지 배치 | **카드 전체를 이미지로**, 이름은 하단 배너, 선택 시 **금색 테두리** |
+| 뒤로가기 대상 | **로비로** (`ShowLobby()`) — 로비 NPC에서 진입하므로 |
+
+### 소스 이미지 (사용자 임포트 대상)
+- 전사: `C:\Users\jaeoh\Desktop\workspace\source\images\maple\character\warrior.png` (~1.05MB)
+- 법사: `…\mage.png` (~1.28MB)
+- 도적: `…\bandit.png` (~1.0MB)
+
+세 PNG는 현재 워크스페이스 미임포트(코드 미참조). 기존 `RootDesk/MyDesk/*_normal|unique|legend.sprite`는 P13 **카드 프레임**이지 캐릭터 초상화가 아니다.
+
+## 현재 구조 (조사 결과)
+
+- **CLASSES** 상수 `gen-slaydeck.mjs:7-11` — `warrior{label,maxHp}`, `bandit`, `magician`.
+- **CharacterSelectHud emit** `:2432-2598`. `classCards` 배열 `:2482-2486` (key Warrior/Thief/Mage, classId warrior/bandit/magician, x −360/0/360, tint). 각 카드(270×330)의 자식: `Name`(상단, 108), `Portrait`(142×142 색상 tint, `:2524-2525` 부근), `Desc`(하단 −105), `LockBody`/`LockShackle`(비활성 직업용). 별도 `…DeckButton`(덱 보기)·`StartButton`.
+- **선택 로직**: 클릭 바인딩 `BindMenuButtons` 내 `:3100/3108/3116` → `SelectClass(classId)` `:3358-3361`(=`self.SelectedClass=…`+`RenderCharacterSelect()`). 시작 `:3151-3157` → `StartNewGame` `:3395-3399`(미선택 가드 후 `StartRun()`).
+- **RenderCharacterSelect** `:3362-3394` — 선택 카드 밝게/미선택 어둡게 + Status 텍스트.
+- **진입/전환**: `ShowState` `:3062-3078`가 HUD 토글. 진입 = 로비 NPC `OnLobbyNpcInteract` `:3199-3203`(런 비활성 시 `ShowCharacterSelect()` `:3355-3357`) 및 (사실상 미사용) MainMenu `:3092`. `ShowLobby` `:3175`. 게임은 OnBeginPlay→`ShowLobby`로 부팅(로비 허브).
+- **emit 헬퍼**: `entity():466`, `transform():286`, `sprite():311`(`dataId`로 ImageRUID 주입 가능), `button():347`, `text():372`, `guid()`.
+- **이미지 외부화 패턴**: 카드프레임은 `data/cardframes.json` → `luaFramesTable()`(`:72` 부근) → `self.CardFrames` Lua 테이블 + 런타임 `ApplyCardFace` `:4167-4202`가 `e.SpriteGUIRendererComponent.ImageRUID=ruid` 주입. 생성 시 주입은 `sprite({dataId})`.
+
+## 상세 설계
+
+### 1) `data/characters.json` (신설 — 단일 소스)
+```json
+{
+  "portraits": {
+    "warrior":  "<32hex RUID>",
+    "magician": "<32hex RUID>",
+    "bandit":   "<32hex RUID>"
+  }
+}
+```
+- 사용자 임포트 후 `RootDesk/MyDesk/*.sprite`에서 RUID를 읽어 채운다(파일명은 임포트 시 결정 — `warrior.sprite` 등으로 매칭, 모호하면 사용자 확인).
+- 나중에 이미지 교체 = 이 파일 RUID만 바꿔 재생성.
+
+### 2) `gen-slaydeck.mjs` — 로드·검증·주입
+- 상단에서 `const CHARS = JSON.parse(readFileSync('data/characters.json','utf8'))` 로드(cardframes 로드 패턴 인접).
+- **fail-fast 검증**: `portraits`에 `warrior`/`magician`/`bandit` 3키 존재 + 각 값이 32hex. 누락 시 throw.
+- 카드 Art 이미지는 **생성 시 `dataId` 주입**(런타임 테이블 불필요). 즉 `classCards`의 classId로 `CHARS.portraits[classId]`를 조회해 Art 스프라이트 `dataId`에 박는다.
+
+### 3) CharacterSelectHud — 카드 전체 이미지화 (`:2432-2598`, `classCards` emit 루프)
+각 직업 카드 구조를 다음으로 변경(엔티티 경로 `…/{key}Button`·클릭 바인딩은 **불변**):
+- `{key}Button`(270×330): 클릭 가능한 **테두리 프레임**. sprite Color = 미선택 어둡게(`0.16,0.2,0.26,1`)/선택 금색(`1,0.82,0.3,1`). raycast on, `button()` 유지.
+- 신규 자식 `Art`(약 258×318, 6px 인셋, center): `sprite({ dataId: CHARS.portraits[classId], type:1, raycast:false })` — 캐릭터 이미지 풀블리드. (테두리가 이미지 뒤로 6px 보임 → 금색 테두리 효과.)
+- `Name`(하단 배너): 반투명 어두운 띠 sprite(예: `0,0,0,0.55`, 270×54, 하단) + 금색 텍스트. 기존 `Name` 재배치.
+- **제거**: 기존 색상 `Portrait` 박스, `Desc` 텍스트(선택 레이아웃에 없음).
+- `LockBody`/`LockShackle`: 비활성 직업용으로 유지(현재 3직업 모두 enabled라 표시 안 됨).
+
+### 4) `RenderCharacterSelect` Lua 변경 (`:3362-3394`)
+- 기존 "박스 밝게/어둡게"를 **테두리(=`{key}Button` sprite Color) 금색/어둡게**로 교체. 선택된 classId의 카드만 `Color(1,0.82,0.3,1)`, 나머지 `Color(0.16,0.2,0.26,1)`.
+- Art 이미지는 생성 시 고정 주입이라 런타임 변경 없음. Status 텍스트 로직은 유지.
+
+### 5) 뒤로가기 버튼
+- 신규 `CharacterSelectHud/BackButton`(ShopHud `Leave` 패턴 재사용 `:2020-2031`): 좌상단(예: `pos {x:-820,y:430}`, 180×56), text "← 뒤로", DARK sprite + `button()`.
+- `BindMenuButtons`에 바인딩 추가(ShopHud Leave 바인딩 패턴 `:3715-3717`): `back:ConnectEvent(ButtonClickEvent, function() self:ShowLobby() end)`. 핸들러 prop 저장(재바인딩 시 해제).
+- `ShowCharacterSelect`/`SelectClass`/`StartNewGame`/`StartRun` 로직 불변.
+
+### 6) GUID 네임스페이스
+- 신규 엔티티(Art·NameBanner·BackButton)는 CharacterSelect용 기존 prefix에 번호 추가. 미등록 prefix면 ns 바이트 등록(생성기 끝 id 유일성 검증이 충돌 잡음).
+
+## 흐름
+
+```
+로비(맵) ──NPC 상호작용──> ShowCharacterSelect (HUD 오버레이)
+  카드3=캐릭터 이미지, 클릭 → SelectClass → 금색 테두리
+  [시작] → StartNewGame(가드) → StartRun (그 직업으로)
+  [← 뒤로] → ShowLobby() → 로비 HUD 복귀
+```
+
+## 미러/테스트 영향
+- 전투규칙·맵생성 **미변경** → `sim-balance`/`rogue-map` 미러 동기화 불필요.
+- 카운트 검증: `CharacterSelectHud/.../Art` ImageRUID 3개, `BackButton` 1개, characters.json 3 RUID 등장(`tools/verify/count.mjs` 또는 `grep -c`).
+- 메이커 플레이테스트: 로비 NPC→3 이미지 표시→클릭 금색 테두리→시작 그 직업으로 진행→뒤로 로비 복귀.
+
+## 리스크
+- **이미지 임포트 선행 의존**: RUID가 있어야 생성기 실행 가능. 사용자 임포트 완료 후 진행(임포트 무관한 코드 골격은 먼저 작성 가능).
+- **이미지 비율**: PNG가 세로 초상화면 258×318(≈0.81 비율)에서 잘리거나 여백 — 임포트 후 스크린샷으로 인셋/사이즈 조정.
+- **`ShowLobby()` 재텔레포트**: 이미 로비 맵 위라 `GoLobbyMap` 재호출 시 위치/카메라 jolt 가능 → 보이면 뒤로가기를 `ShowState("lobby")`로 축소(플레이테스트 확인).
+- 흰박스: 공식 절차(로컬 임포트)면 렌더됨. reload 필수.
+
+## 변경 파일 요약
+| 파일 | 변경 |
+|---|---|
+| `data/characters.json` | **신설** — 직업 3종 초상화 RUID(단일 소스) |
+| `tools/deck/gen-slaydeck.mjs` | characters.json 로드·검증, CharacterSelectHud 카드 이미지화(Art/NameBanner), RenderCharacterSelect 테두리 선택표시, BackButton emit+바인딩 |
+| `RootDesk/MyDesk/*.sprite` (×3) | 사용자 임포트 산출물(커밋) |
+| `ui/DefaultGroup.ui`·`SlayDeckController.codeblock` | 재생성 산출물 |

docs/superpowers/specs/2026-06-16-codeblock-modularization-design.md

@@ -0,0 +1,69 @@
+# Phase 1b — codeblock 메서드 모듈화 설계
+
+작성일: 2026-06-16
+브랜치: `feature/cb-modularization` (Phase 1 `feature/gen-modularization`/PR #70 위에 스택)
+
+## 목표
+
+Phase 1에서 UI emit을 모듈화한 데 이어, `gen-slaydeck.mjs`의 **codeblock 메서드 161개(~3,200줄)**를 기능별 모듈로 분리한다. 출력 `RootDesk/MyDesk/SlayDeckController.codeblock`은 **바이트 동일**(순수 소스 리팩터·무위험). 하이브리드 UI 로드맵 (a) 유지보수 정리의 완결.
+
+## 현재 구조 (조사 결과)
+
+- `writeCodeblocks()`(현 `gen-slaydeck.mjs:291`)가 단일 호출로 codeblock을 만든다:
+  `const combat = codeblock('SlayDeckController', 'SlayDeckController', [<prop 103개>], [<method 161개>])` (`:301`~`:3617`, ~3,300줄).
+- 헬퍼: `prop()`·`method()`·`codeblock()` (현 `:240`~`:290` 부근, 오케스트레이터 잔류분).
+- `writeCodeblocks` 지역 상수: `RUN_LENGTH`·`GOLD_PER_WIN`·`CARD_PRICE`·`REST_HEAL`·`RELIC_PRICE`·`ACT_COUNT`·`ACT_MAPS`·`LOBBY_MAP`·`LOBBY_SPAWN` 등 — 메서드 Lua 문자열 보간에 쓰임.
+- 메서드 본문은 **Lua 문자열**. JS 보간(`${RUN_LENGTH}`·`${luaCardsTable(CARDS.cards)}`·`${CAM.zoomRatio}` 등)은 모듈 로드 시점에 평가됨 → 모듈은 보간에 쓰는 상수/데이터/헬퍼를 import해야 한다.
+- 161 메서드 이름(순서): OnBeginPlay → [ascension 10종] → HideGameHud·ShowState·ShowMainMenu·BindMenuButtons·ShowLobby… → [soul 12종] → [character/job] → StartRun·StartCombat·[combat 다수] → [deck/hand] → [deckview] → [motion] → [relics/potions] → [tooltip] → [reward] → [map] → [shop/rest/treasure]. 자연스러운 **연속 런(run)**으로 묶임.
+
+## 상세 설계
+
+### 핵심 제약: 바이트 동일 → 메서드 순서 보존
+`codeblock`의 methods 배열은 **순서가 직렬화에 반영**된다. 따라서 모듈은 "기능 버킷"이 아니라 **원본 161-메서드 시퀀스의 연속 구간**으로 나눈다(구간을 그 테마로 명명). `writeCodeblocks`가 모듈 배열을 **원본 순서대로 concat** → 바이트 동일. (Phase 1 HUD 분리와 동일 원리: HUD도 upsertUi 내 연속이었음.)
+
+### 목표 파일 구조
+```
+tools/deck/
+  gen-slaydeck.mjs   # 오케스트레이터: writeCodeblocks()가 codeblock(…, [props], [...m1, ...m2, …]) concat
+  lib/
+    codeblock.mjs    # 신설 — prop()·method()·codeblock() 헬퍼 + writeCodeblocks 지역 상수
+                     #   (RUN_LENGTH·GOLD_PER_WIN·CARD_PRICE·REST_HEAL·RELIC_PRICE·ACT_COUNT·ACT_MAPS·LOBBY_MAP·LOBBY_SPAWN …)
+  cb/                # 신설 — 메서드 연속구간 모듈 (각 `export const xMethods = [ method(...), … ]`)
+    state.mjs ascension.mjs soul.mjs jobs.mjs run.mjs combat.mjs
+    deck.mjs deckview.mjs motion.mjs items.mjs tooltip.mjs reward.mjs shop.mjs … (~12-14, 실제 런 경계로 확정)
+```
+
+### 모듈 계약
+- 각 `cb/<name>.mjs`: `export const <name>Methods = [ method('A', \`…\`, …), method('B', …), … ];` — **메서드 호출 verbatim 이동**.
+- import: `lib/codeblock.mjs`(method·prop·codeblock·상수), `lib/data.mjs`(CARDS·luaCardsTable·luaStr·CAM 등 보간용). UI 헬퍼는 메서드 보간에 거의 안 쓰임(필요 구간만 `lib/ui-helpers.mjs`).
+- `writeCodeblocks()`(오케스트레이터): `codeblock('SlayDeckController','SlayDeckController', [ ...props ], [ ...stateMethods, ...ascensionMethods, … ])` — concat 순서 = 원본 순서.
+
+### 범위/결정
+- **메서드 161개만 모듈화.** **prop 103개는 오케스트레이터에 단일 리스트로 유지** — 한 줄짜리라 분리 가치 낮고 prop↔feature 매핑 모호(추후 필요시 별도). 게임 로직·Lua **무변경**(순수 소스 리팩터).
+- 공유 헬퍼(method/prop/codeblock) + writeCodeblocks 지역 상수 → `lib/codeblock.mjs`. (이 상수들이 메서드 모듈 보간에 필요하므로 lib로.)
+
+### 검증 (안전망)
+- 구간 추출마다 `node tools/deck/gen-slaydeck.mjs` → `node tools/verify/diffcheck.mjs` → `SlayDeckController.codeblock` **IDENTICAL**(`ui`·`common` 무영향이나 함께 확인). 증분(구간 1~2개씩) + 커밋.
+- 미러 테스트 `sim-balance`·`rogue-map` 무영향(회귀 확인차 실행).
+- 전투규칙·맵생성 Lua 미변경 → 미러 동기화 불필요.
+
+### 미러/하네스
+- RULES §1의 gen-slaydeck 단일소스에 `cb/`·`lib/codeblock.mjs` 추가 반영.
+
+## 범위 밖
+- prop 모듈화(추후).
+- Phase 2(메이커 UIGroup 파일럿).
+- 게임 동작·데이터 변경.
+
+## 리스크
+- 메서드가 writeCodeblocks **지역변수/다른 메서드 정의를 JS레벨로 참조**하면(드묾 — 대부분 Lua 문자열 내 `self:Method()` 런타임 호출이라 JS-무관) 추출 시 undefined → diffcheck/throw로 즉시 노출 → 그 구간만 인자/상수 조정.
+- 모듈 import는 ui-helpers처럼 export 이름 자동 파생로 누락 방지. 단방향 의존 orchestrator→cb→lib(순환 없음).
+
+## 변경 파일 요약
+| 파일 | 변경 |
+|---|---|
+| `tools/deck/lib/codeblock.mjs` | **신설** — prop/method/codeblock 헬퍼 + 공유 상수 |
+| `tools/deck/cb/*.mjs` (~12-14) | **신설** — 메서드 연속구간 모듈 |
+| `tools/deck/gen-slaydeck.mjs` | writeCodeblocks를 import+concat로 축소(메서드 본문 → 모듈) |
+| `RULES.md` | §1에 cb/·lib/codeblock 반영 |
+| `SlayDeckController.codeblock`·`ui`·`common` | **무변경**(바이트 동일이 합격 기준) |

docs/superpowers/specs/2026-06-16-generator-modularization-design.md

@@ -0,0 +1,80 @@
+# 생성기 모듈화 (Phase 1) + 하이브리드 UI 로드맵 설계
+
+작성일: 2026-06-16
+브랜치: `feature/gen-modularization`
+
+## 배경 / 동기
+
+`DefaultGroup.ui`에 모든 UI(캐릭터 선택·상점·전체 덱·전투…)가 들어 있어, 사용자가 (a) **생성기 코드 유지보수**와 (b) **메이커에서 기능별 시각 편집**을 원함.
+
+핵심 제약(브레인스토밍에서 확정): MSW에서 "Layer"는 렌더 z순서일 뿐 논리 분리 도구가 아니고, 실제 UI 그룹 단위는 **UIGroup**(`.ui` 파일 = UIGroup, 현재 Default/Popup/Toast 3개). 그리고 **같은 UI를 '생성'과 '메이커 수동 편집' 둘 다로 둘 수 없음**(재생성이 수동 편집을 덮어씀).
+
+→ **소유 모델 = 하이브리드·단계적**(사용자 승인): 정적 레이아웃은 메이커 저작(시각 편집), 동적 내용은 컨트롤러가 런타임 주입. 단, 한 번에 안 하고 단계적으로.
+
+## 로드맵 (단계적 — 각 Phase가 자체 spec→plan)
+
+- **Phase 1 (이 문서)**: `gen-slaydeck.mjs`(~6,200줄)의 **UI emit을 기능별 모듈로 분리**. 출력 `.ui`/`codeblock` **바이트 동일**(순수 리팩터·무위험). (a) 충족 + (b) 토대(화면별 파일).
+- **Phase 2 (후속 spec)**: 화면 1개(**캐릭터 선택**) 파일럿 — 정적 레이아웃을 메이커 저작 UIGroup으로 이관, 생성기는 그 화면 emit 중단, `SlayDeckController`가 경로로 내용(이미지·텍스트) 주입. (b) 패턴 검증.
+- **Phase 3 (후속 spec)**: 검증되면 상점·전체덱 등으로 확장.
+
+## 현재 구조 (조사 결과)
+
+- **공유 인프라**(~48–530): `luaSoulShopTable`/`luaFramesTable`/`luaNodeIconsTable`/`luaRelicsTable`/`luaPotionsTable`/`luaIntentsArray`/`luaEnemiesTable`/`luaStr`/`luaJobsTable`/`luaCardsTable`/`luaDeckTable`/`frameRuid`/`cardFaceLayout`/`guid`/`transform`/`sprite`/`button`/`text`/`scrollLayoutGroup`/`entity`/`uiPath`/`sectionRoot`/`isGeneratedUiEntity`/`appendUiSection`. 데이터 로드 상수(CARDS/CHARS/ENEMIES/RELICS/POTIONS/CARDFRAMES/NODEICONS/CAM) 및 색·치수 상수(GOLD/WHITE/TRANSPARENT/ALIGN_*/CARD_W/CARD_H 등).
+- **`guid(prefix, n)`은 순수 함수**(`:284`, 내부 카운터 없음; ns는 prefix→바이트 매핑). **모듈 호출 순서와 무관하게 동일 guid** → 분리해도 바이트 동일.
+- **`upsertUi()`**(`:529`)가 UI 오케스트레이터: 기존 `DefaultGroup.ui` 로드 → 생성 섹션 필터(stock 보존) → 로컬 `emit(section, entities)` 클로저로 누적 → CardHand 스톡카드 in-place upsert(`:565–691`, 특수) → HUD별 `const x=[]; const add=…; add(entity(...)); …; emit('X', x)` → (말미) 병합·기록.
+- **HUD emit 16종(순서·라인)**: DeckHud(`:808`) · DeckInspectHud(`:942`) · DeckAllHud(`:1097`) · CombatHud(`:1587`) · RewardHud(`:1681`) · MapHud(`:1839`) · ShopHud(`:2038`) · RestHud(`:2095`) · TreasureHud(`:2181`) · JobChoiceHud(`:2229`) · JobSelectHud(`:2314`) · MainMenu(`:2616`) · CharacterSelectHud(`:2617`) · LobbyHud(`:2672`) · BoardHud(`:2727`) · SoulShopHud(`:2814`). **각 섹션은 서로의 지역변수 비참조**(헬퍼·데이터 상수만 사용).
+- **codeblock 메서드**(`prop`/`method`/`codeblock`/`writeCodeblocks` `:2836–6124`, ~3,200줄) + **patchCommon**(`:6125`). **Phase 1 범위 제외.**
+
+## Phase 1 상세 설계
+
+### 목표 파일 구조
+```
+tools/deck/
+  gen-slaydeck.mjs        # 오케스트레이터(축소): import lib+hud → 데이터 로드 → upsertUi(HUD 모듈 순차) → writeCodeblocks → patchCommon
+  lib/
+    ui-helpers.mjs        # guid, transform, sprite, button, text, entity, scrollLayoutGroup,
+                          #   상수(GOLD/WHITE/TRANSPARENT/ALIGN_*/CARD_W/CARD_H/UI_ROOT 등), cardFaceLayout,
+                          #   uiPath/sectionRoot/isGeneratedUiEntity/appendUiSection
+    data.mjs              # CARDS/CHARS/ENEMIES/RELICS/POTIONS/CARDFRAMES/NODEICONS/CAM 로드·검증
+                          #   + luaXxxTable·frameRuid
+  hud/
+    deckhud.mjs deckinspect.mjs deckall.mjs combat.mjs reward.mjs map.mjs
+    shop.mjs rest.mjs treasure.mjs jobchoice.mjs jobselect.mjs mainmenu.mjs
+    charselect.mjs lobby.mjs board.mjs soulshop.mjs
+```
+
+### 모듈 계약
+- 각 `hud/<name>.mjs`: `export function build<Name>()` → 자기 HUD 엔티티 배열 반환. 필요한 헬퍼·상수·데이터는 `lib/`에서 **import**(거대 deps 객체 전달 금지).
+- `upsertUi()`(오케스트레이터에 잔류)는 기존 **순서 그대로** `emit('DeckHud', buildDeckHud())` … `emit('SoulShopHud', buildSoulShop())` 호출. `emit`·섹션 병합 로직 불변.
+- **CardHand 스톡카드 in-place upsert**(`:565–691`)는 기존 `.ui` 엔티티를 변형하는 특수 로직 → 오케스트레이터(또는 `hud/cardhand.mjs`)에 그대로 유지. import 경계만 정리.
+
+### 바이트 동일 불변식 (가장 중요)
+- 리팩터는 **출력 변경 0**이 목표. 보장 근거: guid 순수·emit 순서·entity 구성 모두 보존, 로직 이동만.
+- **합격 기준**: 리팩터 후 `node tools/deck/gen-slaydeck.mjs` → `git diff` 결과가 **`ui/DefaultGroup.ui`·`SlayDeckController.codeblock`에 0 변경**(`Global/common.gamelogic`은 LF churn만 허용 → `git checkout`).
+
+### 증분 실행 전략
+- 한 번에 16개 다 옮기지 말고 **HUD 1~2개씩 추출 → 재생성 → `git diff` 빈 결과 확인 → 커밋** 반복. 첫 추출(예: SoulShopHud 같은 말단 + lib 골격) 성공 후 패턴 반복.
+- lib 추출(헬퍼·상수·데이터) 먼저 → 그 다음 HUD 모듈을 하나씩 lib import로 전환.
+
+### 미러/테스트·하네스
+- 전투규칙·맵생성 Lua **무변경** → `sim-balance`/`rogue-map` 미러 동기화 불필요(회귀 확인차 `node --test` 실행).
+- **RULES 동기화**: 생성기가 다중 파일이 되므로 RULES §1 "단일 소스"/보조 생성기 표를 `tools/deck/`(gen-slaydeck + lib/ + hud/)로 갱신.
+
+## 범위 밖 (명시)
+- codeblock 메서드(`method()` ~3,200줄) 분리 — 더 크고 (b)와 무관·리스크↑. 원하면 별도 **Phase 1b** spec.
+- 게임 동작·데이터·런타임 로직 변경. (순수 소스 리팩터)
+- UIGroup 분할·메이커 저작 이관 — Phase 2 이후.
+
+## 리스크
+- 클로저 참조(헬퍼/상수)를 import로 전환하는 광범위·기계적 수정 — 누락 시 런타임 throw 또는 출력 diff로 **즉시** 노출(바이트 검증이 안전망).
+- 상수 정의 위치 산재(CARD_W·GOLD·UI_ROOT 등 top-level) — lib로 이동 시 누락 주의. 추출 전 `grep`으로 전체 상수 인벤토리 작성.
+- ESM 순환 import 주의(lib는 hud를 import하지 않음 — 단방향: orchestrator→hud→lib).
+
+## 변경 파일 요약
+| 파일 | 변경 |
+|---|---|
+| `tools/deck/lib/ui-helpers.mjs`, `lib/data.mjs` | **신설** — 공유 헬퍼·상수·데이터 |
+| `tools/deck/hud/*.mjs` (16) | **신설** — HUD별 build 함수 |
+| `tools/deck/gen-slaydeck.mjs` | 오케스트레이터로 축소(데이터/UI emit 본문 → 모듈로 이동, import·호출만) |
+| `RULES.md` | §1 보조 생성기/단일소스 표에 lib/·hud/ 반영 |
+| `ui/DefaultGroup.ui`·`SlayDeckController.codeblock` | **무변경**(바이트 동일이 합격 기준) |

tools/balance/sim-balance.mjs

@@ -108,9 +108,10 @@ export function simulateCombat(data, rng, stats) {
   if (monsters.length === 0) return { win: true, turns: 0, playerHpRemaining: PLAYER_HP };
   let drawPile = shuffle(starterDeck, rng);
   let discard = [];
+  const exhaust = [];
   let hand = [];
   let pHp = PLAYER_HP, pBlock = 0;
-  let pStr = 0, pWeak = 0, pVuln = 0;
+  let pStr = 0, pDex = 0, pThorns = 0, pWeak = 0, pVuln = 0;
   const powers = [];
   const mob = monsters.map((m) => ({
     name: m.name, hp: m.maxHp, maxHp: m.maxHp, block: 0, str: 0, weak: 0, vuln: 0, poison: 0,
@@ -124,10 +125,94 @@ export function simulateCombat(data, rng, stats) {
       if (drawPile.length === 0) break;
       const card = drawPile.pop();
       // 손패 10장 상한 — 초과 드로는 자동 버림 (Lua DrawCards 동기화)
-      if (hand.length >= 10) discard.push(card); else hand.push(card);
+      if (hand.length >= 10) {
+        discard.push(card);
+        triggerSly(card);
+      } else hand.push(card);
+    }
+  }
+  function addCardsToHand(id, n) {
+    for (let k = 0; k < n; k++) {
+      if (hand.length >= 10) discard.push(id);
+      else hand.push(id);
     }
   }
   const aliveList = () => mob.filter((m) => m.alive);
+  function resolveCardEffects(id, c, costSpent, recordStats = true) {
+    const alive = aliveList();
+    let dmg = 0;
+    let blockGained = 0;
+    if (c.kind === 'Attack') {
+      if (alive.length && c.damage) {
+        const target = chooseTarget(alive, calcAttack(c.damage || 0, pStr, pWeak, 0));
+        if (c.weak) target.weak += c.weak;
+        if (c.vuln) target.vuln += c.vuln;
+        const hitN = c.hits || 1;
+        let totalNv = 0;
+        for (let h = 0; h < hitN; h++) totalNv += calcAttack(c.damage || 0, pStr, pWeak, 0);
+        dmg = totalNv;
+        if (c.aoe === true) {
+          for (const m2 of aliveList()) {
+            const d2 = m2.vuln > 0 ? Math.floor(totalNv * 1.5) : totalNv;
+            const r2 = applyDamage(m2.hp, m2.block, d2);
+            m2.hp = r2.hp; m2.block = r2.block;
+            if (m2.hp <= 0) m2.alive = false;
+          }
+        } else {
+          dmg = target.vuln > 0 ? Math.floor(totalNv * 1.5) : totalNv;
+          if (c.pierce === true) {
+            target.hp -= dmg;
+            if (target.hp < 0) target.hp = 0;
+          } else {
+            const r = applyDamage(target.hp, target.block, dmg);
+            target.hp = r.hp; target.block = r.block;
+          }
+          if (target.hp <= 0) target.alive = false;
+        }
+      }
+      if (c.block) { blockGained = Math.max(0, c.block + pDex); pBlock += blockGained; }
+    } else if (c.kind === 'Power') {
+      if (recordStats) powers.push(id);
+    } else {
+      if (c.block) { blockGained = Math.max(0, c.block + pDex); pBlock += blockGained; }
+      if ((c.weak || c.vuln || c.poison) && alive.length) {
+        const target = chooseTarget(alive, 0);
+        if (c.weak) target.weak += c.weak;
+        if (c.vuln) target.vuln += c.vuln;
+        if (c.poison) target.poison += c.poison;
+      }
+    }
+    if (c.strength) pStr += c.strength;
+    if (c.dex) pDex += c.dex;
+    if (c.thorns) pThorns += c.thorns;
+    if (c.selfVuln) pVuln += c.selfVuln;
+    if (c.heal) pHp = Math.min(pHp + c.heal, PLAYER_HP);
+    if (c.draw) draw(c.draw);
+    if (c.addShiv && !c.discard && c.discardAll !== true) addCardsToHand('Shiv', c.addShiv);
+    if (recordStats && stats) stats[id] = bump(stats[id], costSpent, dmg, blockGained);
+  }
+  function triggerSly(id) {
+    const c = cards[id];
+    if (!c?.sly) return;
+    resolveCardEffects(id, c, 0, false);
+  }
+  function discardHandCard(idx, trigger = true) {
+    const [id] = hand.splice(idx, 1);
+    if (!id) return;
+    discard.push(id);
+    if (trigger) triggerSly(id);
+  }
+  function applyDiscardEffects(c) {
+    let discarded = 0;
+    if (c.discardAll) {
+      while (hand.length) { discardHandCard(hand.length - 1, true); discarded++; }
+    } else if (c.discard) {
+      const n = Math.min(c.discard, hand.length);
+      for (let i = 0; i < n; i++) { discardHandCard(hand.length - 1, true); discarded++; }
+    }
+    if (c.addShiv && (c.discard || c.discardAll === true)) addCardsToHand('Shiv', c.addShiv);
+    if (c.addShivPerDiscard === true) addCardsToHand('Shiv', discarded);
+  }
 
   while (turns < MAX_TURNS) {
     turns++;
@@ -140,8 +225,9 @@ export function simulateCombat(data, rng, stats) {
       if (pc.powerEffect === 'strengthPerTurn') pStr += pc.value;
       else if (pc.powerEffect === 'energyPerTurn') energyBonus += pc.value;
       else if (pc.powerEffect === 'blockPerTurn') pBlock += pc.value;
+      if (pc.turnStartShiv) addCardsToHand('Shiv', pc.turnStartShiv);
     }
-    let energy = ENERGY + energyBonus; hand = []; draw(HAND_SIZE);
+    let energy = ENERGY + energyBonus; draw(HAND_SIZE);
     while (true) {
       const alive = aliveList();
       if (alive.length === 0) break;
@@ -149,66 +235,24 @@ export function simulateCombat(data, rng, stats) {
       if (idx < 0) break;
       const id = hand[idx], c = cards[id];
       energy -= c.cost;
-      if (c.kind === 'Attack') {
-        const target = chooseTarget(alive, calcAttack(c.damage || 0, pStr, pWeak, 0));
-        // 카드 디버프는 피해보다 먼저 적용 — Lua PlayCard(즉시 부여) + 지연 데미지(0.35s) 동기화
-        if (c.weak) target.weak += c.weak;
-        if (c.vuln) target.vuln += c.vuln;
-        // 다단히트: 타격마다 힘·약화 적용 합산, 취약은 합산값에 1회 (Lua 동기화)
-        const hitN = c.hits || 1;
-        let totalNv = 0;
-        for (let h = 0; h < hitN; h++) totalNv += calcAttack(c.damage || 0, pStr, pWeak, 0);
-        let dmg = totalNv; // 통계 보고용 (aoe는 1대상 기준)
-        if (c.aoe === true) {
-          // 전체 공격 — 대상마다 취약/방어 개별 적용 (Lua PlayAoeFx 동기화)
-          for (const m2 of aliveList()) {
-            const d2 = m2.vuln > 0 ? Math.floor(totalNv * 1.5) : totalNv;
-            const r2 = applyDamage(m2.hp, m2.block, d2);
-            m2.hp = r2.hp; m2.block = r2.block;
-            if (m2.hp <= 0) m2.alive = false;
-          }
-        } else {
-          dmg = target.vuln > 0 ? Math.floor(totalNv * 1.5) : totalNv;
-          if (c.pierce === true) {
-            target.hp -= dmg; // 방어 무시
-            if (target.hp < 0) target.hp = 0;
-          } else {
-            const r = applyDamage(target.hp, target.block, dmg);
-            target.hp = r.hp; target.block = r.block;
-          }
-          if (target.hp <= 0) target.alive = false;
-        }
-        if (c.block) pBlock += c.block;
-        if (c.strength) pStr += c.strength;
-        if (c.selfVuln) pVuln += c.selfVuln;
-        if (c.heal) pHp = Math.min(pHp + c.heal, PLAYER_HP);
-        if (stats) stats[id] = bump(stats[id], c.cost, dmg, c.block || 0);
-      } else if (c.kind === 'Power') {
-        if (c.powerEffect) powers.push(id);
-        if (stats) stats[id] = bump(stats[id], c.cost, 0, 0);
-      } else {
-        pBlock += c.block || 0;
-        if (c.strength) pStr += c.strength;
-        if (c.selfVuln) pVuln += c.selfVuln;
-        if (c.heal) pHp = Math.min(pHp + c.heal, PLAYER_HP);
-        if (c.weak || c.vuln || c.poison) {
-          const target = chooseTarget(alive, 0);
-          if (c.weak) target.weak += c.weak;
-          if (c.vuln) target.vuln += c.vuln;
-          if (c.poison) target.poison += c.poison;
-        }
-        if (stats) stats[id] = bump(stats[id], c.cost, 0, c.block || 0);
-      }
+      resolveCardEffects(id, c, c.cost);
       hand.splice(idx, 1);
-      if (c.kind !== 'Power') discard.push(id); // 파워는 소멸 — Lua 동기화
-      if (c.draw) draw(c.draw);
+      if (c.exhaust === true || String(c.desc || '').includes('소멸.')) exhaust.push(id);
+      else if (c.kind !== 'Power') discard.push(id);
+      applyDiscardEffects(c);
       if (aliveList().length === 0) return { win: true, turns, playerHpRemaining: pHp };
     }
     // 화상(endTurnDamage) — 손패에 있으면 턴 종료 시 피해 (Lua EndPlayerTurn 동기화)
     let burn = 0;
     for (const hid of hand) { const hc = cards[hid]; if (hc && hc.endTurnDamage) burn += hc.endTurnDamage; }
     if (burn > 0) { pHp -= burn; if (pHp < 0) pHp = 0; }
-    discard.push(...hand); hand = [];
+    const kept = [];
+    for (const hid of hand) {
+      const hc = cards[hid];
+      if (hc?.retain === true) kept.push(hid);
+      else discard.push(hid);
+    }
+    hand = kept;
     if (pHp <= 0) return { win: false, turns, playerHpRemaining: 0 };
     // 플레이어 디버프 감소 — Lua EndPlayerTurn 동기화 (적 행동 전)
     if (pWeak > 0) pWeak--;
@@ -227,7 +271,12 @@ export function simulateCombat(data, rng, stats) {
       if (it) {
         if (it.kind === 'Attack') {
           const atk = calcAttack(it.value, m.str, m.weak, pVuln);
+          const beforeHp = pHp;
           const r = applyDamage(pHp, pBlock, atk); pHp = r.hp; pBlock = r.block;
+          if (beforeHp > pHp && pThorns > 0) {
+            m.hp -= pThorns;
+            if (m.hp <= 0) m.alive = false;
+          }
         } else if (it.kind === 'Defend') { m.block += it.value; }
         else if (it.kind === 'Debuff') {
           if (it.effect === 'weak') pWeak += it.value;

tools/balance/sim-balance.test.mjs

@@ -375,3 +375,89 @@ test('simulateCombat: endTurnDamage(화상)이 턴 종료 시 누적 피해', ()
   assert.equal(r.win, false);
   assert.notEqual(r.draw, true);
 });
+
+test("simulateCombat: sly discarded card resolves for free", () => {
+  const data = {
+    cards: {
+      Toss: { name: "Toss", cost: 1, kind: "Skill", discardAll: true },
+      SlyHit: { name: "SlyHit", cost: 99, kind: "Attack", damage: 10, sly: true },
+      Blank: { name: "Blank", cost: 99, kind: "Skill", block: 0 },
+    },
+    starterDeck: ["Toss", "SlyHit", "Blank", "Blank", "Blank"],
+    monsters: [{ name: "Dummy", maxHp: 10, intents: [{ kind: "Defend", value: 0 }] }],
+  };
+  const r = simulateCombat(data, mulberry32(1));
+  assert.equal(r.win, true);
+  assert.equal(r.turns, 1);
+});
+
+test("simulateCombat: retain keeps card in hand across turns", () => {
+  const data = {
+    cards: {
+      Boost: { name: "Boost", cost: 3, kind: "Power", powerEffect: "energyPerTurn", value: 98 },
+      Hold: { name: "Hold", cost: 100, kind: "Attack", damage: 10, retain: true },
+      Blank: { name: "Blank", cost: 99, kind: "Skill", block: 0 },
+    },
+    starterDeck: ["Blank", "Blank", "Blank", "Blank", "Blank", "Boost", "Hold", "Blank", "Blank", "Blank"],
+    monsters: [{ name: "Dummy", maxHp: 10, intents: [{ kind: "Defend", value: 0 }] }],
+  };
+  const r = simulateCombat(data, () => 0.999999);
+  assert.equal(r.win, true);
+  assert.equal(r.turns, 2);
+});
+
+test("simulateCombat: exhaust cards do not return through discard reshuffle", () => {
+  const data = {
+    cards: {
+      BurnOut: { name: "BurnOut", cost: 1, kind: "Attack", damage: 10, exhaust: true },
+    },
+    starterDeck: ["BurnOut"],
+    monsters: [{ name: "Dummy", maxHp: 12, intents: [{ kind: "Defend", value: 0 }] }],
+  };
+  const r = simulateCombat(data, mulberry32(1));
+  assert.equal(r.win, false);
+  assert.equal(r.draw, true);
+});
+
+test("simulateCombat: dex increases block gained from cards", () => {
+  const data = {
+    cards: {
+      Footwork: { name: "Footwork", cost: 1, kind: "Power", dex: 2 },
+      Defend: { name: "Defend", cost: 1, kind: "Skill", block: 5 },
+    },
+    starterDeck: ["Footwork", "Defend"],
+    monsters: [{ name: "Dummy", maxHp: 99, intents: [{ kind: "Attack", value: 6 }] }],
+  };
+  const r = simulateCombat(data, () => 0.999999);
+  assert.equal(r.win, false);
+  assert.equal(r.draw, true);
+  assert.equal(r.playerHpRemaining, 80);
+});
+
+test("simulateCombat: thorns reflects unblocked attack damage", () => {
+  const data = {
+    cards: {
+      Spikes: { name: "Spikes", cost: 1, kind: "Power", thorns: 4 },
+    },
+    starterDeck: ["Spikes"],
+    monsters: [{ name: "Dummy", maxHp: 4, intents: [{ kind: "Attack", value: 1 }] }],
+  };
+  const r = simulateCombat(data, () => 0.999999);
+  assert.equal(r.win, true);
+  assert.equal(r.turns, 1);
+  assert.equal(r.playerHpRemaining, 79);
+});
+
+test("simulateCombat: addShiv creates shuriken cards in hand", () => {
+  const data = {
+    cards: {
+      MakeShiv: { name: "MakeShiv", cost: 0, kind: "Skill", addShiv: 2 },
+      Shiv: { name: "표창", cost: 0, kind: "Attack", damage: 4, exhaust: true },
+    },
+    starterDeck: ["MakeShiv"],
+    monsters: [{ name: "Dummy", maxHp: 8, intents: [{ kind: "Attack", value: 0 }] }],
+  };
+  const r = simulateCombat(data, () => 0.999999);
+  assert.equal(r.win, true);
+  assert.equal(r.turns, 1);
+});

tools/deck/cb/boot.mjs

@@ -0,0 +1,73 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const bootMethods = [
+    method('OnBeginPlay', `${luaCardsTable(CARDS.cards)}
+${luaFramesTable()}
+${luaNodeIconsTable()}
+${luaSoulShopTable(SOUL_UNLOCKS)}
+self.SoulUnlocks = {}
+self.SoulPoints = self.SoulPoints or 0
+self:ShowLobby()
+local lp = _UserService.LocalPlayer
+if lp ~= nil then
+	self:ReqLoadAscension(lp.PlayerComponent.UserId)
+	self:ReqLoadSouls(lp.PlayerComponent.UserId)
+end
+_InputService:ConnectEvent(KeyDownEvent, function(e)
+	if e.key == KeyboardKey.LeftControl then
+		local lp2 = _UserService.LocalPlayer
+		if lp2 ~= nil and lp2.CurrentMapName == "${LOBBY_MAP}" and self.RunActive ~= true then
+			self:PlayerAttackMotion()
+		end
+	end
+end)`),
+    method('ReqLoadAscension', `local ds = _DataStorageService:GetUserDataStorage(userId)
+local errCode, value = ds:GetAndWait("ascensionUnlocked")
+local n = 0
+if errCode == 0 and value ~= nil and value ~= "" then
+	n = tonumber(value) or 0
+end
+self:RecvAscension(n, userId)`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'userId' }], 5),
+    method('RecvAscension', `self.AscensionUnlocked = n
+if self.AscensionLevel > self.AscensionUnlocked then
+	self.AscensionLevel = self.AscensionUnlocked
+end
+self:RenderAscension()`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'n' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'userId' },
+    ], 6),
+    method('SaveAscension', `local ds = _DataStorageService:GetUserDataStorage(userId)
+ds:SetAndWait("ascensionUnlocked", tostring(n))`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'n' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'userId' },
+    ], 5),
+    method('AdjustAscension', `local v = self.AscensionLevel + delta
+if v < 0 then v = 0 end
+if v > self.AscensionUnlocked then v = self.AscensionUnlocked end
+self.AscensionLevel = v
+self:RenderAscension()`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'delta' }]),
+    method('RenderAscension', `self:SetText("/ui/DefaultGroup/MainMenu/AscLabel", "승천 " .. string.format("%d", self.AscensionLevel) .. " / 해금 " .. string.format("%d", self.AscensionUnlocked))
+self:SetText("/ui/DefaultGroup/LobbyHud/AscLabel", "승천 " .. string.format("%d", self.AscensionLevel) .. " / 해금 " .. string.format("%d", self.AscensionUnlocked))`),
+    method('AscHpMult', `local m = 1
+if self.AscensionLevel >= 1 then m = m + 0.1 end
+if self.AscensionLevel >= 6 then m = m + 0.1 end
+return m`, [], 0, 'number'),
+    method('AscAtkMult', `local m = 1
+if self.AscensionLevel >= 2 then m = m + 0.1 end
+if self.AscensionLevel >= 7 then m = m + 0.1 end
+return m`, [], 0, 'number'),
+    method('AscEliteBonus', `local b = 0
+if self.AscensionLevel >= 4 then b = b + 0.2 end
+if self.AscensionLevel >= 9 then b = b + 0.2 end
+return b`, [], 0, 'number'),
+    method('AscGoldMult', `local m = 1
+if self.AscensionLevel >= 5 then m = m - 0.25 end
+if self.AscensionLevel >= 10 then m = m - 0.25 end
+return m`, [], 0, 'number'),
+    method('AscStartHpPenalty', `local p = 0
+if self.AscensionLevel >= 3 then p = p + 10 end
+if self.AscensionLevel >= 8 then p = p + 10 end
+return p`, [], 0, 'number'),
+];

tools/deck/cb/charselect.mjs

@@ -0,0 +1,58 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const charSelectMethods = [
+    method('ShowCharacterSelect', `self.SelectedClass = ""
+self:ShowState("charselect")
+self:RenderCharacterSelect()`),
+    method('SelectClass', `self.SelectedClass = className
+self:RenderCharacterSelect()`, [
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'className' },
+    ]),
+    method('RenderCharacterSelect', `local warrior = _EntityService:GetEntityByPath("/ui/DefaultGroup/CharacterSelectHud/WarriorButton")
+if warrior ~= nil and warrior.SpriteGUIRendererComponent ~= nil then
+	if self.SelectedClass == "warrior" then
+		warrior.SpriteGUIRendererComponent.Color = Color(1, 0.82, 0.3, 1)
+	else
+		warrior.SpriteGUIRendererComponent.Color = Color(0.16, 0.2, 0.26, 1)
+	end
+end
+local mage = _EntityService:GetEntityByPath("/ui/DefaultGroup/CharacterSelectHud/MageButton")
+if mage ~= nil and mage.SpriteGUIRendererComponent ~= nil then
+	if self.SelectedClass == "magician" then
+		mage.SpriteGUIRendererComponent.Color = Color(1, 0.82, 0.3, 1)
+	else
+		mage.SpriteGUIRendererComponent.Color = Color(0.16, 0.2, 0.26, 1)
+	end
+end
+local thief = _EntityService:GetEntityByPath("/ui/DefaultGroup/CharacterSelectHud/ThiefButton")
+if thief ~= nil and thief.SpriteGUIRendererComponent ~= nil then
+	if self.SelectedClass == "bandit" then
+		thief.SpriteGUIRendererComponent.Color = Color(1, 0.82, 0.3, 1)
+	else
+		thief.SpriteGUIRendererComponent.Color = Color(0.16, 0.2, 0.26, 1)
+	end
+end
+if self.SelectedClass == "warrior" then
+	self:SetText("/ui/DefaultGroup/CharacterSelectHud/Status", "전사 선택됨")
+elseif self.SelectedClass == "bandit" then
+	self:SetText("/ui/DefaultGroup/CharacterSelectHud/Status", "도적 선택됨")
+elseif self.SelectedClass == "magician" then
+	self:SetText("/ui/DefaultGroup/CharacterSelectHud/Status", "마법사 선택됨")
+else
+	self:SetText("/ui/DefaultGroup/CharacterSelectHud/Status", "직업을 선택하고 시작하세요")
+end`),
+    method('StartNewGame', `if self.SelectedClass ~= "warrior" and self.SelectedClass ~= "bandit" and self.SelectedClass ~= "magician" then
+	self:SetText("/ui/DefaultGroup/CharacterSelectHud/Status", "직업을 먼저 선택하세요")
+	return
+end
+self:StartRun()`),
+    method('SetEntityEnabled', `local e = _EntityService:GetEntityByPath(path)
+if e ~= nil then
+	e.Enable = enabled
+end`, [
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'path' },
+      { Type: 'boolean', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'enabled' },
+    ]),
+];

tools/deck/cb/combat.mjs

@@ -0,0 +1,480 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const combatMethods = [
+    method('PlayCard', `if self:IsDiscardSelecting() == true then
+	self:SelectDiscardSlot(slot)
+	return
+end
+if self.CombatOver == true or self.FxBusy == true or self.TurnBusy == true then
+	return
+end
+if self.Hand == nil then
+	return
+end
+local cardId = self.Hand[slot]
+if cardId == nil then
+	return
+end
+local c = self.Cards[cardId]
+if c == nil then
+	return
+end
+if c.unplayable == true then
+	self:Toast("사용할 수 없는 카드입니다")
+	return
+end
+if self.Energy < c.cost then
+	self:Toast("에너지가 부족합니다")
+	return
+end
+self.Energy = self.Energy - c.cost
+self:ResolveCardEffects(cardId, c, false)
+table.remove(self.Hand, slot)
+if c.exhaust == true then
+	if self.ExhaustPile == nil then self.ExhaustPile = {} end
+	table.insert(self.ExhaustPile, cardId)
+elseif c.kind ~= "Power" then
+	table.insert(self.DiscardPile, cardId)
+end
+self:RenderHand(false)
+self:RenderPiles()
+self:RenderCombat()
+if self:BeginDiscardSelection(c) == true then
+	return
+end
+self:RenderHand(false)
+self:RenderPiles()
+self:RenderCombat()
+self:CheckCombatEnd()`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
+    method('OnCardButton', `if self:IsDiscardSelecting() == true then
+	self:SelectDiscardSlot(slot)
+end`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
+    method('FindMonsterAtTouch', `local best = 0
+local bestDist = 200
+for i = 1, #self.Monsters do
+	local m = self.Monsters[i]
+	if m.alive == true and m.entity ~= nil and isvalid(m.entity) and m.entity.TransformComponent ~= nil then
+		local wp = m.entity.TransformComponent.WorldPosition
+		local sp = _UILogic:WorldToScreenPosition(Vector2(wp.x, wp.y + 0.7))
+		local dx = sp.x - touchPoint.x
+		local dy = sp.y - touchPoint.y
+		local d = math.sqrt(dx * dx + dy * dy)
+		if d < bestDist then
+			bestDist = d
+			best = i
+		end
+	end
+end
+return best`, [{ Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'touchPoint' }], 0, 'number'),
+    method('RenderTargetFrames', `local dragActive = self.DragTargetIndex ~= nil and self.DragTargetIndex > 0
+local shownTarget = self.TargetIndex
+if dragActive == true then shownTarget = self.DragTargetIndex end
+for i = 1, #self.Monsters do
+	local m = self.Monsters[i]
+	local active = false
+	if m ~= nil and m.alive == true and i == shownTarget then active = true end
+	self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/MonsterSlot" .. tostring(i) .. "/TargetFrame", active)
+	self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/MonsterSlot" .. tostring(i) .. "/TargetMarker", active and dragActive)
+	self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/MonsterSlot" .. tostring(i) .. "/TargetMarker/Label", active and dragActive)
+end`),
+    method('OnCardDragBegin', `if self.CombatOver == true or self.FxBusy == true or self.TurnBusy == true then
+	return
+end
+if self.Hand == nil or self.Hand[slot] == nil then
+	return
+end
+if self.CardHoverTweenId ~= nil and self.CardHoverTweenId ~= 0 then
+	_TimerService:ClearTimer(self.CardHoverTweenId)
+	self.CardHoverTweenId = 0
+end
+for i = 1, 10 do
+	local e = _EntityService:GetEntityByPath("/ui/DefaultGroup/CardHand/Card" .. tostring(i))
+	if e ~= nil and e.UITransformComponent ~= nil then
+		e.UITransformComponent.UIScale = Vector3(1, 1, 1)
+		e.UITransformComponent.anchoredPosition = Vector2(self:GetHandSlotX(i), 0)
+	end
+end
+self.DragSlot = slot
+self.DragTargetIndex = 0
+self:RenderTargetFrames()`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
+    method('OnCardDrag', `if self.DragSlot ~= slot then
+	return
+end
+local e = _EntityService:GetEntityByPath("/ui/DefaultGroup/CardHand/Card" .. tostring(slot))
+if e ~= nil and e.UITransformComponent ~= nil then
+	local ui = _UILogic:ScreenToUIPosition(touchPoint)
+	e.UITransformComponent.anchoredPosition = Vector2(ui.x, ui.y + 360)
+end
+local cardId = self.Hand[slot]
+local c = nil
+if cardId ~= nil then c = self.Cards[cardId] end
+if c ~= nil and c.kind == "Attack" then
+	local best = self:FindMonsterAtTouch(touchPoint)
+	if best ~= self.DragTargetIndex then
+		self.DragTargetIndex = best
+		self:RenderTargetFrames()
+	end
+end`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' },
+      { Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'touchPoint' },
+    ]),
+    method('OnCardDragEnd', `if self.DragSlot ~= slot then
+	return
+end
+self.DragSlot = 0
+local e = _EntityService:GetEntityByPath("/ui/DefaultGroup/CardHand/Card" .. tostring(slot))
+if e ~= nil and e.UITransformComponent ~= nil then
+	e.UITransformComponent.anchoredPosition = Vector2(self:GetHandSlotX(slot), 0)
+	e.UITransformComponent.UIScale = Vector3(1, 1, 1)
+end
+self:ResolveCardDrop(slot, touchPoint)`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' },
+      { Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'touchPoint' },
+    ]),
+    method('ResolveCardDrop', `if self:IsDiscardSelecting() == true then
+	self:SelectDiscardSlot(slot)
+	return
+end
+if self.CombatOver == true or self.FxBusy == true or self.TurnBusy == true then
+	return
+end
+local cardId = self.Hand[slot]
+if cardId == nil then
+	return
+end
+local c = self.Cards[cardId]
+if c == nil then
+	return
+end
+if c.kind == "Attack" then
+	local best = self.DragTargetIndex or 0
+	if best <= 0 then best = self:FindMonsterAtTouch(touchPoint) end
+	self.DragTargetIndex = 0
+	if best > 0 then
+		self.TargetIndex = best
+		self:PlayCard(slot)
+		self:RenderTargetFrames()
+	else
+		self:RenderTargetFrames()
+	end
+else
+	self.DragTargetIndex = 0
+	self:RenderTargetFrames()
+	local ui = _UILogic:ScreenToUIPosition(touchPoint)
+	if ui.y > -180 then
+		self:PlayCard(slot)
+	end
+end`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' },
+      { Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'touchPoint' },
+    ]),
+    method('Toast', `log(message)`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'message' }]),
+    method('DealDamageToTarget', `local m = self.Monsters[self.TargetIndex]
+if m == nil or m.alive ~= true then
+	m = nil
+	for i = 1, #self.Monsters do
+		if self.Monsters[i].alive == true then m = self.Monsters[i]; self.TargetIndex = i; break end
+	end
+end
+if m == nil then
+	return
+end
+local dmg = amount
+if m.vuln > 0 then
+	dmg = math.floor(dmg * 1.5)
+end
+if m.block > 0 and pierce ~= true then
+	local absorbed = math.min(m.block, dmg)
+	m.block = m.block - absorbed
+	dmg = dmg - absorbed
+end
+m.hp = m.hp - dmg
+self:MonsterHitMotion(m.slot)
+if m.hp <= 0 then
+	m.hp = 0
+	self:KillMonster(m.slot)
+end`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'amount' },
+      { Type: 'boolean', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'pierce' },
+    ]),
+    method('PlayAttackFx', `local m = self.Monsters[targetIndex]
+if m == nil or m.alive ~= true or m.entity == nil or not isvalid(m.entity) then
+	self:DealDamageToTarget(damage, pierce)
+	self:RenderCombat()
+	self:CheckCombatEnd()
+	return
+end
+self.FxBusy = true
+local fx = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/SkillFx")
+if fx ~= nil then
+	if fx.SpriteGUIRendererComponent ~= nil and image ~= nil and image ~= "" then
+		fx.SpriteGUIRendererComponent.ImageRUID = image
+	end
+	if fx.UITransformComponent ~= nil and m.entity.TransformComponent ~= nil then
+		local wp = m.entity.TransformComponent.WorldPosition
+		local sp = _UILogic:WorldToScreenPosition(Vector2(wp.x, wp.y + 0.7))
+		fx.UITransformComponent.anchoredPosition = _UILogic:ScreenToUIPosition(sp)
+	end
+	fx.Enable = true
+end
+_TimerService:SetTimerOnce(function()
+	if fx ~= nil then fx.Enable = false end
+	self.FxBusy = false
+	local shown = damage
+	local mt = self.Monsters[targetIndex]
+	if mt ~= nil and mt.alive == true and mt.vuln > 0 then
+		shown = math.floor(damage * 1.5)
+	end
+	self:DealDamageToTarget(damage, pierce)
+	self:ShowDmgPop(targetIndex, shown)
+	self:RenderCombat()
+	self:CheckCombatEnd()
+end, 0.35)`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'targetIndex' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'image' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'damage' },
+      { Type: 'boolean', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'pierce' },
+    ]),
+    method('PlayAoeFx', `self.FxBusy = true
+local fx = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/SkillFx")
+if fx ~= nil then
+	if fx.SpriteGUIRendererComponent ~= nil and image ~= nil and image ~= "" then
+		fx.SpriteGUIRendererComponent.ImageRUID = image
+	end
+	if fx.UITransformComponent ~= nil then
+		fx.UITransformComponent.anchoredPosition = Vector2(300, 60)
+	end
+	fx.Enable = true
+end
+_TimerService:SetTimerOnce(function()
+	if fx ~= nil then fx.Enable = false end
+	self.FxBusy = false
+	for i = 1, #self.Monsters do
+		local m = self.Monsters[i]
+		if m ~= nil and m.alive == true then
+			local dmg = damage
+			if m.vuln > 0 then
+				dmg = math.floor(dmg * 1.5)
+			end
+			if m.block > 0 then
+				local absorbed = math.min(m.block, dmg)
+				m.block = m.block - absorbed
+				dmg = dmg - absorbed
+			end
+			m.hp = m.hp - dmg
+			self:ShowDmgPop(i, dmg)
+			self:MonsterHitMotion(i)
+			if m.hp <= 0 then
+				m.hp = 0
+				self:KillMonster(m.slot)
+			end
+		end
+	end
+	self:RenderCombat()
+	self:CheckCombatEnd()
+end, 0.35)`, [
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'image' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'damage' },
+    ]),
+    method('KillMonster', `local m = self.Monsters[slot]
+if m == nil then
+	return
+end
+m.alive = false
+if m.entity ~= nil and isvalid(m.entity) then
+	local ent = m.entity
+	_TimerService:SetTimerOnce(function() if isvalid(ent) then ent:SetVisible(false) end end, 0.4)
+end
+self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/MonsterSlot" .. tostring(slot), false)
+for i = 1, #self.Monsters do
+	if self.Monsters[i].alive == true then self.TargetIndex = i; break end
+end`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
+    method('DealDamageToPlayer', `local dmg = amount
+if self.PlayerBlock > 0 then
+	local absorbed = math.min(self.PlayerBlock, dmg)
+	self.PlayerBlock = self.PlayerBlock - absorbed
+	dmg = dmg - absorbed
+end
+if dmg > 0 then
+	self.PlayerHp = self.PlayerHp - dmg
+	local reflect = self.PlayerThorns or 0
+	if self:HasRelic("bronzeScales") then
+		reflect = reflect + 3
+	end
+	if reflect > 0 and attackerSlot ~= nil and attackerSlot > 0 then
+		local am = self.Monsters[attackerSlot]
+		if am ~= nil and am.alive == true then
+			am.hp = am.hp - reflect
+			self:ShowDmgPop(am.slot, reflect)
+			self:MonsterHitMotion(am.slot)
+			if am.hp <= 0 then
+				am.hp = 0
+				self:KillMonster(am.slot)
+			end
+		end
+	end
+	if self:HasRelic("selfFormingClay") then
+		self.ClayBlockNext = self.ClayBlockNext + 3
+	end
+	if self:HasRelic("centennialPuzzle") and self.FirstHpLossDone == false then
+		self.FirstHpLossDone = true
+		self:DrawCards(3)
+		self:RenderHand(false)
+	end
+end
+if self.PlayerHp < 0 then
+	self.PlayerHp = 0
+end`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'amount' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'attackerSlot' },
+    ]),
+    method('EnemyTurn', `self.TurnBusy = true
+self:EnemyActStep(1)`),
+    method('EnemyActStep', `local idx = 0
+for i = fromIndex, #self.Monsters do
+	if self.Monsters[i].alive == true then idx = i; break end
+end
+if idx == 0 or self.PlayerHp <= 0 then
+	self:FinishEnemyTurn()
+	return
+end
+local m = self.Monsters[idx]
+local base = "/ui/DefaultGroup/CombatHud/MonsterSlot" .. tostring(idx)
+self:SetEntityEnabled(base .. "/ActFrame", true)
+_TimerService:SetTimerOnce(function()
+	if m.poison ~= nil and m.poison > 0 then
+		m.hp = m.hp - m.poison
+		self:ShowDmgPop(idx, m.poison)
+		self:MonsterHitMotion(idx)
+		m.poison = m.poison - 1
+		if m.hp <= 0 then
+			m.hp = 0
+			self:KillMonster(m.slot)
+			self:RenderCombat()
+			self:SetEntityEnabled(base .. "/ActFrame", false)
+			_TimerService:SetTimerOnce(function() self:EnemyActStep(idx + 1) end, 0.15)
+			return
+		end
+	end
+	m.block = 0
+	local intent = m.intents[m.intentIdx]
+	if intent ~= nil then
+		if intent.kind == "Attack" then
+			self:MonsterLunge(idx)
+			local atk = intent.value + m.str
+			if m.weak > 0 then
+				atk = math.floor(atk * 0.75)
+			end
+			if self.PlayerVuln > 0 then
+				atk = math.floor(atk * 1.5)
+			end
+			local before = self.PlayerHp
+			self:DealDamageToPlayer(atk, idx)
+			self:ShowPlayerDmgPop(before - self.PlayerHp)
+			self:PlayerHitMotion()
+		elseif intent.kind == "Defend" then
+			m.block = m.block + intent.value
+		elseif intent.kind == "Debuff" then
+			if intent.effect == "weak" then
+				self.PlayerWeak = self.PlayerWeak + intent.value
+			elseif intent.effect == "vuln" then
+				self.PlayerVuln = self.PlayerVuln + intent.value
+			end
+		elseif intent.kind == "AddCard" then
+			local cnt = intent.count or 1
+			for ci = 1, cnt do
+				table.insert(self.DiscardPile, intent.card)
+			end
+			self:RenderPiles()
+			local cn = intent.card
+			local cc = self.Cards[intent.card]
+			if cc ~= nil then cn = cc.name end
+			self:Toast(m.name .. ": " .. cn .. " 추가!")
+		end
+	end
+	if #m.intents > 0 then
+		m.intentIdx = math.random(1, #m.intents)
+	end
+	if m.weak > 0 then m.weak = m.weak - 1 end
+	if m.vuln > 0 then m.vuln = m.vuln - 1 end
+	self:RenderCombat()
+	self:SetEntityEnabled(base .. "/ActFrame", false)
+	_TimerService:SetTimerOnce(function() self:EnemyActStep(idx + 1) end, 0.15)
+end, 0.45)`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'fromIndex' }]),
+    method('FinishEnemyTurn', `self.TurnBusy = false
+self:CheckCombatEnd()
+if self.CombatOver == true then
+	return
+end
+_TimerService:SetTimerOnce(function() self:StartPlayerTurn() end, 0.45)`),
+    method('ClearCombatCards', `self.DrawPile = {}
+self.DiscardPile = {}
+self.ExhaustPile = {}
+self.Hand = {}
+self.DiscardSelectRemaining = 0
+self.DiscardSelectTotal = 0
+self.DiscardPostShiv = 0
+self.DiscardShivPerPick = 0
+self:UpdateDiscardPrompt()
+self:RenderHand(false)
+self:RenderPiles()`),
+    method('CheckCombatEnd', `local anyAlive = false
+for i = 1, #self.Monsters do
+	if self.Monsters[i].alive == true then anyAlive = true; break end
+end
+if anyAlive == false then
+	self.CombatOver = true
+	self:ClearCombatCards()
+	self.Gold = self.Gold + math.floor(${GOLD_PER_WIN} * self:AscGoldMult())
+	self:ApplyRelics("combatEnd")
+	self:ApplyRelics("combatReward")
+	self:MaybeDropPotion()
+	self:RenderRun()
+	local node = self.MapNodes[self.CurrentNodeId]
+	if node ~= nil and node.type == "elite" then
+		self.Gold = self.Gold + 15
+		local nid = self:PickNewRelic()
+		if nid ~= "" then
+			self:AddRelic(nid)
+			local nr = self.Relics[nid]
+			if nr ~= nil then
+				self:Toast("유물 획득: " .. nr.name)
+			end
+		end
+	end
+	if node ~= nil and node.type == "boss" then
+		if self.PlayerJob == "" and self.Floor < self.RunLength then
+			self:ShowJobChoice()
+		else
+			if self.PlayerJob ~= "" then self:AwardSouls(1) end
+			local bid = self:PickNewRelic()
+			if bid ~= "" then
+				self:AddRelic(bid)
+				local br = self.Relics[bid]
+				if br ~= nil then
+					self:Toast("유물 획득: " .. br.name)
+				end
+			end
+			self:ContinueAfterBoss()
+		end
+	else
+		self:OfferReward()
+	end
+elseif self.PlayerHp <= 0 then
+	self.CombatOver = true
+	self:EndRun("패배...")
+end`),
+    method('ContinueAfterBoss', `if self.Floor < self.RunLength then
+	self.Floor = self.Floor + 1
+	self.CurrentNodeId = ""
+	self.CurrentEnemyId = ""
+	self:GenerateMap()
+	self:RenderRun()
+	self:TeleportToActMap()
+	self:ShowMap()
+else
+	self:EndRun("런 클리어!")
+end`),
+];

tools/deck/cb/deckturn.mjs

@@ -0,0 +1,344 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const deckTurnMethods = [
+    method('Shuffle', `if list == nil then
+\treturn
+end
+for i = #list, 2, -1 do
+\tlocal j = math.random(1, i)
+\tlist[i], list[j] = list[j], list[i]
+end`, [{ Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'list' }]),
+    method('BindButtons', `local endTurn = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckHud/EndTurnButton")
+if endTurn ~= nil and endTurn.ButtonComponent ~= nil then
+	if self.EndTurnHandler ~= nil then
+		endTurn:DisconnectEvent(ButtonClickEvent, self.EndTurnHandler)
+		self.EndTurnHandler = nil
+	end
+	self.EndTurnHandler = endTurn:ConnectEvent(ButtonClickEvent, function() self:EndPlayerTurn() end)
+end
+local drawPile = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckHud/DrawPile")
+if drawPile ~= nil and drawPile.ButtonComponent ~= nil then
+	if self.DrawPileHandler ~= nil then
+		drawPile:DisconnectEvent(ButtonClickEvent, self.DrawPileHandler)
+		self.DrawPileHandler = nil
+	end
+	self.DrawPileHandler = drawPile:ConnectEvent(ButtonClickEvent, function() self:OpenDeckInspect("draw") end)
+end
+local discardPile = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckHud/DiscardPile")
+if discardPile ~= nil and discardPile.ButtonComponent ~= nil then
+	if self.DiscardPileHandler ~= nil then
+		discardPile:DisconnectEvent(ButtonClickEvent, self.DiscardPileHandler)
+		self.DiscardPileHandler = nil
+	end
+	self.DiscardPileHandler = discardPile:ConnectEvent(ButtonClickEvent, function() self:OpenDeckInspect("discard") end)
+end
+local exhaustPile = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckHud/ExhaustPile")
+if exhaustPile ~= nil and exhaustPile.ButtonComponent ~= nil then
+	if self.ExhaustPileHandler ~= nil then
+		exhaustPile:DisconnectEvent(ButtonClickEvent, self.ExhaustPileHandler)
+		self.ExhaustPileHandler = nil
+	end
+	self.ExhaustPileHandler = exhaustPile:ConnectEvent(ButtonClickEvent, function() self:OpenDeckInspect("exhaust") end)
+end
+local inspectClose = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckInspectHud/Close")
+if inspectClose ~= nil and inspectClose.ButtonComponent ~= nil then
+	if self.DeckInspectCloseHandler ~= nil then
+		inspectClose:DisconnectEvent(ButtonClickEvent, self.DeckInspectCloseHandler)
+		self.DeckInspectCloseHandler = nil
+	end
+	self.DeckInspectCloseHandler = inspectClose:ConnectEvent(ButtonClickEvent, function() self:CloseDeckInspect() end)
+end
+local allDeckButton = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/TopBar/AllDeckButton")
+if allDeckButton ~= nil and allDeckButton.ButtonComponent ~= nil then
+	if self.AllDeckHandler ~= nil then
+		allDeckButton:DisconnectEvent(ButtonClickEvent, self.AllDeckHandler)
+		self.AllDeckHandler = nil
+	end
+	self.AllDeckHandler = allDeckButton:ConnectEvent(ButtonClickEvent, function() self:OpenAllDeck() end)
+end
+local allDeckClose = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud/Close")
+if allDeckClose ~= nil and allDeckClose.ButtonComponent ~= nil then
+	if self.AllDeckCloseHandler ~= nil then
+		allDeckClose:DisconnectEvent(ButtonClickEvent, self.AllDeckCloseHandler)
+		self.AllDeckCloseHandler = nil
+	end
+	self.AllDeckCloseHandler = allDeckClose:ConnectEvent(ButtonClickEvent, function() self:CloseAllDeck() end)
+end
+self:BindClassDeckTabs()
+for i = 1, 10 do
+	local cardEntity = _EntityService:GetEntityByPath("/ui/DefaultGroup/CardHand/Card" .. tostring(i))
+	if cardEntity ~= nil and cardEntity.UITouchReceiveComponent ~= nil then
+		local cardPath = "/ui/DefaultGroup/CardHand/Card" .. tostring(i)
+		cardEntity:ConnectEvent(UITouchEnterEvent, function() self:SetCardHover(cardPath, true) end)
+		cardEntity:ConnectEvent(UITouchExitEvent, function() self:SetCardHover(cardPath, false) end)
+		cardEntity:ConnectEvent(UITouchBeginDragEvent, function(ev) self:OnCardDragBegin(i) end)
+		cardEntity:ConnectEvent(UITouchDragEvent, function(ev) self:OnCardDrag(i, ev.TouchPoint) end)
+		cardEntity:ConnectEvent(UITouchEndDragEvent, function(ev) self:OnCardDragEnd(i, ev.TouchPoint) end)
+		cardEntity:ConnectEvent(UITouchEnterEvent, function() self:HoverCard(i) end)
+		cardEntity:ConnectEvent(UITouchExitEvent, function() self:UnhoverCard(i) end)
+		if cardEntity.ButtonComponent ~= nil then
+			cardEntity:ConnectEvent(ButtonClickEvent, function() self:OnCardButton(i) end)
+		end
+	end
+end
+for i = 1, 3 do
+	local rc = _EntityService:GetEntityByPath("/ui/DefaultGroup/RewardHud/Reward" .. tostring(i))
+	if rc ~= nil and rc.ButtonComponent ~= nil then
+		rc:ConnectEvent(ButtonClickEvent, function() self:PickReward(i) end)
+		if rc.UITouchReceiveComponent ~= nil then
+			local cardPath = "/ui/DefaultGroup/RewardHud/Reward" .. tostring(i)
+			rc:ConnectEvent(UITouchEnterEvent, function() self:SetCardHover(cardPath, true) end)
+			rc:ConnectEvent(UITouchExitEvent, function() self:SetCardHover(cardPath, false) end)
+		end
+	end
+end
+local skip = _EntityService:GetEntityByPath("/ui/DefaultGroup/RewardHud/Skip")
+if skip ~= nil and skip.ButtonComponent ~= nil then
+	skip:ConnectEvent(ButtonClickEvent, function() self:PickReward(0) end)
+end
+local mapNodeIds = {}
+for r = 1, ${MAP_ROWS} do
+	for c = 1, ${MAP_COLS} do
+		table.insert(mapNodeIds, "r" .. tostring(r) .. "c" .. tostring(c))
+	end
+end
+table.insert(mapNodeIds, "boss")
+for i = 1, #mapNodeIds do
+	local nid = mapNodeIds[i]
+	local mn = _EntityService:GetEntityByPath("/ui/DefaultGroup/MapHud/Node_" .. nid)
+	if mn ~= nil and mn.ButtonComponent ~= nil then
+		mn:ConnectEvent(ButtonClickEvent, function() self:PickNode(nid) end)
+	end
+end
+for i = 1, 3 do
+	local sc = _EntityService:GetEntityByPath("/ui/DefaultGroup/ShopHud/Card" .. tostring(i))
+	if sc ~= nil and sc.ButtonComponent ~= nil then
+		sc:ConnectEvent(ButtonClickEvent, function() self:BuyCard(i) end)
+		if sc.UITouchReceiveComponent ~= nil then
+			local cardPath = "/ui/DefaultGroup/ShopHud/Card" .. tostring(i)
+			sc:ConnectEvent(UITouchEnterEvent, function() self:SetCardHover(cardPath, true) end)
+			sc:ConnectEvent(UITouchExitEvent, function() self:SetCardHover(cardPath, false) end)
+		end
+	end
+end
+local shopLeave = _EntityService:GetEntityByPath("/ui/DefaultGroup/ShopHud/Leave")
+if shopLeave ~= nil and shopLeave.ButtonComponent ~= nil then
+	shopLeave:ConnectEvent(ButtonClickEvent, function() self:LeaveNode() end)
+end
+local shopRelic = _EntityService:GetEntityByPath("/ui/DefaultGroup/ShopHud/Relic")
+if shopRelic ~= nil and shopRelic.ButtonComponent ~= nil then
+	shopRelic:ConnectEvent(ButtonClickEvent, function() self:BuyRelic() end)
+end
+local restLeave = _EntityService:GetEntityByPath("/ui/DefaultGroup/RestHud/Leave")
+if restLeave ~= nil and restLeave.ButtonComponent ~= nil then
+	restLeave:ConnectEvent(ButtonClickEvent, function() self:LeaveNode() end)
+end
+for i = 1, ${MAX_MONSTERS} do
+	local ms = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/MonsterSlot" .. tostring(i))
+	if ms ~= nil and ms.ButtonComponent ~= nil then
+		ms:ConnectEvent(ButtonClickEvent, function() self:SetTarget(i) end)
+	end
+end
+for i = 1, 10 do
+	local rs = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/TopBar/RelicSlot" .. tostring(i))
+	if rs ~= nil and rs.UITouchReceiveComponent ~= nil then
+		local idx = i
+		rs:ConnectEvent(UITouchEnterEvent, function()
+			local rid = nil
+			if self.RunRelics ~= nil then rid = self.RunRelics[idx] end
+			if rid ~= nil and self.Relics[rid] ~= nil then
+				self:ShowTooltip(self.Relics[rid].name, self.Relics[rid].desc, -240 + (idx - 1) * 48)
+			end
+		end)
+		rs:ConnectEvent(UITouchExitEvent, function() self:HideTooltip() end)
+	end
+end
+for i = 1, 5 do
+	local ps = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/TopBar/PotionSlot" .. tostring(i))
+	if ps ~= nil and ps.UITouchReceiveComponent ~= nil then
+		local idx = i
+		ps:ConnectEvent(UITouchEnterEvent, function()
+			local pid = nil
+			if self.RunPotions ~= nil then pid = self.RunPotions[idx] end
+			if pid ~= nil and self.Potions[pid] ~= nil then
+				self:ShowTooltip(self.Potions[pid].name, self.Potions[pid].desc, 240 + (idx - 1) * 44)
+			end
+		end)
+		ps:ConnectEvent(UITouchExitEvent, function() self:HideTooltip() end)
+		ps:ConnectEvent(UITouchDownEvent, function() self:OpenPotionMenu(idx) end)
+	end
+end
+local pmUse = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/PotionMenu/Use")
+if pmUse ~= nil and pmUse.ButtonComponent ~= nil then
+	pmUse:ConnectEvent(ButtonClickEvent, function() self:UsePotion() end)
+end
+local pmToss = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/PotionMenu/Toss")
+if pmToss ~= nil and pmToss.ButtonComponent ~= nil then
+	pmToss:ConnectEvent(ButtonClickEvent, function() self:TossPotion() end)
+end
+local pmClose = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/PotionMenu/Close")
+if pmClose ~= nil and pmClose.ButtonComponent ~= nil then
+	pmClose:ConnectEvent(ButtonClickEvent, function() self:ClosePotionMenu() end)
+end
+local shopPotion = _EntityService:GetEntityByPath("/ui/DefaultGroup/ShopHud/Potion")
+if shopPotion ~= nil and shopPotion.ButtonComponent ~= nil then
+	shopPotion:ConnectEvent(ButtonClickEvent, function() self:BuyPotion() end)
+end
+local chest = _EntityService:GetEntityByPath("/ui/DefaultGroup/TreasureHud/Chest")
+if chest ~= nil and chest.ButtonComponent ~= nil then
+	chest:ConnectEvent(ButtonClickEvent, function() self:OpenChest() end)
+end
+local treasureLeave = _EntityService:GetEntityByPath("/ui/DefaultGroup/TreasureHud/Leave")
+if treasureLeave ~= nil and treasureLeave.ButtonComponent ~= nil then
+	treasureLeave:ConnectEvent(ButtonClickEvent, function() self:LeaveNode() end)
+end
+local jcRelic = _EntityService:GetEntityByPath("/ui/DefaultGroup/JobChoiceHud/RelicButton")
+if jcRelic ~= nil and jcRelic.ButtonComponent ~= nil then
+	jcRelic:ConnectEvent(ButtonClickEvent, function() self:PickJobReward("relic") end)
+end
+local jcJob = _EntityService:GetEntityByPath("/ui/DefaultGroup/JobChoiceHud/JobButton")
+if jcJob ~= nil and jcJob.ButtonComponent ~= nil then
+	jcJob:ConnectEvent(ButtonClickEvent, function() self:PickJobReward("job") end)
+end
+for i = 1, 3 do
+	local slotIdx = i
+	local jb = _EntityService:GetEntityByPath("/ui/DefaultGroup/JobSelectHud/Job_slot" .. tostring(i))
+	if jb ~= nil and jb.ButtonComponent ~= nil then
+		jb:ConnectEvent(ButtonClickEvent, function()
+			if self.JobOpts ~= nil and self.JobOpts[slotIdx] ~= nil then
+				self:SetJob(self.JobOpts[slotIdx].id)
+			end
+		end)
+	end
+end`),
+    method('StartPlayerTurn', `self.Turn = self.Turn + 1
+self.Energy = self.MaxEnergy
+self:ApplyRelics("turnStart")
+self.PlayerBlock = 0
+if self.ClayBlockNext > 0 then
+	self.PlayerBlock = self.PlayerBlock + self.ClayBlockNext
+	self.ClayBlockNext = 0
+end
+if self.PlayerPowers ~= nil then
+	for i = 1, #self.PlayerPowers do
+		local pc = self.Cards[self.PlayerPowers[i]]
+		if pc ~= nil then
+			if pc.powerEffect == "strengthPerTurn" then
+				self.PlayerStr = self.PlayerStr + pc.value
+			elseif pc.powerEffect == "energyPerTurn" then
+				self.Energy = self.Energy + pc.value
+			elseif pc.powerEffect == "blockPerTurn" then
+				self.PlayerBlock = self.PlayerBlock + pc.value
+			end
+			if pc.turnStartShiv ~= nil then
+				self:AddCardsToHand("Shiv", pc.turnStartShiv)
+			end
+		end
+	end
+end
+self:DrawCards(5)
+self:RenderHand(true)
+self:RenderCombat()`),
+    method('EndPlayerTurn', `if self.CombatOver == true or self.FxBusy == true or self.TurnBusy == true then
+	return
+end
+if self:IsDiscardSelecting() == true then
+	self:Toast("버릴 카드를 먼저 선택하세요")
+	return
+end
+local burn = 0
+for bi = 1, #self.Hand do
+\tlocal hc = self.Cards[self.Hand[bi]]
+\tif hc ~= nil and hc.endTurnDamage ~= nil then burn = burn + hc.endTurnDamage end
+end
+if burn > 0 then
+\tself.PlayerHp = self.PlayerHp - burn
+\tif self.PlayerHp < 0 then self.PlayerHp = 0 end
+\tself:ShowPlayerDmgPop(burn)
+\tself:RenderCombat()
+end
+local kept = {}
+for i = 1, #self.Hand do
+\tlocal cardId = self.Hand[i]
+\tlocal c = self.Cards[cardId]
+\tif c ~= nil and c.retain == true then
+\t\ttable.insert(kept, cardId)
+\telse
+\t\ttable.insert(self.DiscardPile, cardId)
+\tend
+end
+self.Hand = kept
+if self.PlayerWeak > 0 then self.PlayerWeak = self.PlayerWeak - 1 end
+if self.PlayerVuln > 0 then self.PlayerVuln = self.PlayerVuln - 1 end
+self:RenderHand(false)
+self:RenderPiles()
+self:EnemyTurn()`),
+    method('DrawCards', `local drawnSlots = {}
+for i = 1, amount do
+\tif #self.DrawPile <= 0 then
+\t\tself:RecycleDiscardIntoDraw()
+\tend
+\tif #self.DrawPile <= 0 then
+\t\tbreak
+\tend
+\tlocal cardId = table.remove(self.DrawPile)
+\tif #self.Hand >= 10 then
+\t\ttable.insert(self.DiscardPile, cardId)
+\t\tself:TriggerSly(cardId)
+\telse
+\t\ttable.insert(self.Hand, cardId)
+\t\tif #self.Hand <= 5 then
+\t\t\ttable.insert(drawnSlots, #self.Hand)
+\t\tend
+\tend
+end
+self:RenderPiles()
+if animate == true and #drawnSlots > 0 then
+\tself:RenderHand(false)
+\tlocal drawStart = Vector2(-590, 8)
+\tfor i = 1, #drawnSlots do
+\t\tlocal slot = drawnSlots[i]
+\t\tself:AnimateCardFrom(slot, drawStart, Vector2(self:GetHandSlotX(slot), 0), 0.08 + i * 0.045)
+\tend
+end`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'amount' },
+      { Type: 'boolean', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'animate' },
+    ]),
+    method('AddCardsToHand', `if self.Hand == nil then
+	self.Hand = {}
+end
+if self.DiscardPile == nil then
+	self.DiscardPile = {}
+end
+for i = 1, amount do
+	if #self.Hand >= 10 then
+		table.insert(self.DiscardPile, cardId)
+	else
+		table.insert(self.Hand, cardId)
+	end
+end
+self:RenderHand(false)
+self:RenderPiles()`, [
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'cardId' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'amount' },
+    ]),
+    method('RecycleDiscardIntoDraw', `if self.DiscardPile == nil or #self.DiscardPile <= 0 then
+\treturn
+end
+self.DrawPile = {}
+for i = 1, #self.DiscardPile do
+\tself.DrawPile[i] = self.DiscardPile[i]
+end
+self.DiscardPile = {}
+self:Shuffle(self.DrawPile)`),
+    method('RenderPiles', `self:SetText("/ui/DefaultGroup/DeckHud/DrawPile/Count", self:FormatNumber(#self.DrawPile))
+self:SetText("/ui/DefaultGroup/DeckHud/DiscardPile/Count", self:FormatNumber(#self.DiscardPile))
+self:SetText("/ui/DefaultGroup/DeckHud/ExhaustPile/Count", self:FormatNumber(#(self.ExhaustPile or {})))
+self:SetText("/ui/DefaultGroup/DeckHud/EnergyOrb/Value", string.format("%d", self.Energy) .. "/" .. string.format("%d", self.MaxEnergy))
+local inspect = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckInspectHud")
+if inspect ~= nil and inspect.Enable == true and self.DeckInspectKind ~= "" then
+	self:OpenDeckInspect(self.DeckInspectKind)
+end`),
+];

tools/deck/cb/deckview.mjs

@@ -0,0 +1,229 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const deckViewMethods = [
+    method('OpenDeckInspect', `self.DeckInspectKind = kind
+if self.DeckAllOpen == true then
+	self.DeckAllOpen = false
+	local allHud = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud")
+	if allHud ~= nil then
+		allHud.Enable = false
+	end
+end
+local pile = {}
+local title = ""
+if kind == "discard" then
+	pile = self.DiscardPile or {}
+	title = "버린 덱"
+elseif kind == "exhaust" then
+	pile = self.ExhaustPile or {}
+	title = "소멸 덱"
+else
+	pile = self.DrawPile or {}
+	title = "뽑을 덱"
+end
+self:RenderDeckInspect(pile, title)
+local hud = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckInspectHud")
+if hud ~= nil then
+	hud.Enable = true
+end`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'kind' }]),
+    method('CloseDeckInspect', `self.DeckInspectKind = ""
+local hud = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckInspectHud")
+if hud ~= nil then
+	hud.Enable = false
+end`),
+    method('RenderDeckInspect', `local count = 0
+if pile ~= nil then
+	count = #pile
+end
+local suffix = " (" .. tostring(count) .. ")"
+if count > 60 then
+	suffix = suffix .. " - 60장까지 표시"
+end
+self:SetText("/ui/DefaultGroup/DeckInspectHud/Title", title .. suffix)
+local empty = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckInspectHud/Empty")
+if empty ~= nil then
+	empty.Enable = count <= 0
+end
+for i = 1, 60 do
+	local e = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckInspectHud/Grid/Card" .. tostring(i))
+	if e ~= nil then
+		local cardId = nil
+		if pile ~= nil then
+			cardId = pile[i]
+		end
+		if cardId == nil then
+			e.Enable = false
+		else
+			e.Enable = true
+			self:ApplyInspectCardVisual(i, cardId)
+		end
+	end
+end`, [
+      { Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'pile' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'title' },
+    ]),
+    method('ApplyInspectCardVisual', `self:ApplyCardFace("/ui/DefaultGroup/DeckInspectHud/Grid/Card" .. tostring(slot), cardId)`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'cardId' },
+    ]),
+    method('BindClassDeckTabs', `local warriorTab = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud/WarriorTab")
+if warriorTab ~= nil and warriorTab.ButtonComponent ~= nil then
+	if self.WarriorDeckTabHandler ~= nil then
+		warriorTab:DisconnectEvent(ButtonClickEvent, self.WarriorDeckTabHandler)
+		self.WarriorDeckTabHandler = nil
+	end
+	self.WarriorDeckTabHandler = warriorTab:ConnectEvent(ButtonClickEvent, function() self:SetClassDeckTab("warrior") end)
+end
+local thiefTab = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud/ThiefTab")
+if thiefTab ~= nil and thiefTab.ButtonComponent ~= nil then
+	if self.ThiefDeckTabHandler ~= nil then
+		thiefTab:DisconnectEvent(ButtonClickEvent, self.ThiefDeckTabHandler)
+		self.ThiefDeckTabHandler = nil
+	end
+	self.ThiefDeckTabHandler = thiefTab:ConnectEvent(ButtonClickEvent, function() self:SetClassDeckTab("bandit") end)
+end
+local mageTab = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud/MageTab")
+if mageTab ~= nil and mageTab.ButtonComponent ~= nil then
+	if self.MageDeckTabHandler ~= nil then
+		mageTab:DisconnectEvent(ButtonClickEvent, self.MageDeckTabHandler)
+		self.MageDeckTabHandler = nil
+	end
+	self.MageDeckTabHandler = mageTab:ConnectEvent(ButtonClickEvent, function() self:SetClassDeckTab("magician") end)
+end`),
+    method('OpenClassDeck', `self.CodexMode = false
+self.ClassDeckMode = true
+self.DeckAllOpen = true
+self:SetClassDeckTab(className)
+local hud = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud")
+if hud ~= nil then
+	hud.Enable = true
+end`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'className' }]),
+    method('SetClassDeckTab', `if self.ClassDeckMode ~= true then
+	return
+end
+self.ClassDeckCards = {}
+self.ClassDeckTitle = "직업 덱"
+if className ~= "warrior" and className ~= "magician" and className ~= "bandit" then
+	className = "bandit"
+end
+self.ClassDeckClass = className
+local allowed = {}
+if className == "warrior" then
+	allowed["warrior"] = true
+	allowed["fighter"] = true
+	allowed["page"] = true
+	allowed["spearman"] = true
+	self.ClassDeckTitle = "전사 전체 덱"
+elseif className == "magician" then
+	allowed["magician"] = true
+	allowed["firepoison"] = true
+	allowed["icelightning"] = true
+	allowed["cleric"] = true
+	self.ClassDeckTitle = "마법사 전체 덱"
+else
+	allowed["bandit"] = true
+	allowed["shiv"] = true
+	allowed["poisoner"] = true
+	allowed["trickster"] = true
+	self.ClassDeckTitle = "도적 전체 덱"
+end
+for id, c in pairs(self.Cards) do
+	if c ~= nil and c.curse ~= true and allowed[c.class] == true then
+		table.insert(self.ClassDeckCards, id)
+	end
+end
+table.sort(self.ClassDeckCards, function(a, b)
+	local ca = self.Cards[a]
+	local cb = self.Cards[b]
+	local na = a
+	local nb = b
+	if ca ~= nil and ca.name ~= nil then na = ca.name end
+	if cb ~= nil and cb.name ~= nil then nb = cb.name end
+	if na == nb then return a < b end
+	return na < nb
+end)
+self:RenderAllDeck()
+self:RenderClassDeckTabs()`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'className' }]),
+    method('RenderClassDeckTabs', `local tabs = {
+	{ path = "/ui/DefaultGroup/DeckAllHud/WarriorTab", cls = "warrior" },
+	{ path = "/ui/DefaultGroup/DeckAllHud/ThiefTab", cls = "bandit" },
+	{ path = "/ui/DefaultGroup/DeckAllHud/MageTab", cls = "magician" },
+}
+for i = 1, #tabs do
+	local e = _EntityService:GetEntityByPath(tabs[i].path)
+	if e ~= nil then
+		e.Enable = self.ClassDeckMode == true
+		if e.SpriteGUIRendererComponent ~= nil then
+			if self.ClassDeckClass == tabs[i].cls then
+				e.SpriteGUIRendererComponent.Color = Color(0.22, 0.28, 0.34, 1)
+			else
+				e.SpriteGUIRendererComponent.Color = Color(0.11, 0.13, 0.16, 1)
+			end
+		end
+	end
+end`),
+    method('OpenAllDeck', `local inspectHud = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckInspectHud")
+if inspectHud ~= nil then
+	inspectHud.Enable = false
+end
+self.DeckInspectKind = ""
+self.ClassDeckMode = false
+self.ClassDeckClass = ""
+self:RenderClassDeckTabs()
+self.DeckAllOpen = true
+self:RenderAllDeck()
+local hud = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud")
+if hud ~= nil then
+	hud.Enable = true
+end`),
+    method('CloseAllDeck', `self.DeckAllOpen = false
+local hud = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud")
+if hud ~= nil then
+	hud.Enable = false
+end
+if self.ClassDeckMode == true then
+	self.ClassDeckMode = false
+	self.ClassDeckCards = {}
+	self.ClassDeckTitle = ""
+	self.ClassDeckClass = ""
+end
+self:RenderClassDeckTabs()
+if self.CodexMode == true then
+	self.CodexMode = false
+	self:ShowLobby()
+end`),
+    method('RenderAllDeck', `local pile = self.RunDeck or {}
+local title = "모든 덱"
+if self.ClassDeckMode == true then
+	pile = self.ClassDeckCards or {}
+	title = self.ClassDeckTitle
+elseif self.CodexMode == true then
+	pile = self.CodexCards or {}
+	title = "카드 도감"
+end
+local count = #pile
+self:SetText("/ui/DefaultGroup/DeckAllHud/Title", title .. " (" .. tostring(count) .. ")")
+self:RenderClassDeckTabs()
+local empty = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud/Empty")
+if empty ~= nil then
+	empty.Enable = count <= 0
+end
+for i = 1, 120 do
+	local e = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud/Grid/Card" .. tostring(i))
+	if e ~= nil then
+		local cardId = pile[i]
+		if cardId == nil then
+			e.Enable = false
+		else
+			e.Enable = true
+			self:ApplyAllDeckCardVisual(i, cardId)
+		end
+	end
+end`),
+    method('ApplyAllDeckCardVisual', `self:ApplyCardFace("/ui/DefaultGroup/DeckAllHud/Grid/Card" .. tostring(slot), cardId)`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'cardId' },
+    ]),
+];

tools/deck/cb/hand.mjs

@@ -0,0 +1,401 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const handMethods = [
+    method('GetHandSlotX', `local n = 0
+if self.Hand ~= nil then
+	n = #self.Hand
+end
+if n <= 0 then
+	return 0
+end
+local spacing = 175
+if n > 8 then spacing = math.floor(1400 / n) end
+local startX = -((n - 1) * spacing) / 2
+return startX + (slot - 1) * spacing`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }], 0, 'number'),
+    method('RenderHand', `local n = #self.Hand
+local spacing = 175
+if n > 8 then spacing = math.floor(1400 / n) end
+local startX = -((n - 1) * spacing) / 2
+local drawStart = Vector2(-590, 8)
+for i = 1, 10 do
+\tlocal cardEntity = _EntityService:GetEntityByPath("/ui/DefaultGroup/CardHand/Card" .. tostring(i))
+\tif cardEntity ~= nil then
+\t\tlocal cardId = self.Hand[i]
+\t\tif cardId == nil then
+\t\t\tcardEntity.Enable = false
+\t\telse
+\t\t\tcardEntity.Enable = true
+\t\t\tif cardEntity.UITransformComponent ~= nil then cardEntity.UITransformComponent.UIScale = Vector3(1, 1, 1) end
+\t\t\tself:ApplyCardVisual(i, cardId)
+\t\t\tlocal tx = self:GetHandSlotX(i)
+\t\t\tif animate == true then
+\t\t\t\tself:AnimateCardFrom(i, drawStart, Vector2(tx, 0), 0.16 + i * 0.03)
+\t\t\telse
+\t\t\t\tif cardEntity.UITransformComponent ~= nil then cardEntity.UITransformComponent.anchoredPosition = Vector2(tx, 0) end
+\t\t\tend
+\t\tend
+\tend
+end
+self:RenderPiles()`, [{ Type: 'boolean', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'animate' }]),
+    method('ApplyCardFace', `local c = self.Cards[cardId]
+if c == nil then
+	c = { name = cardId, cost = 0, desc = "", kind = "Skill", class = "warrior", rarity = "normal" }
+end
+local e = _EntityService:GetEntityByPath(base)
+if e ~= nil and e.SpriteGUIRendererComponent ~= nil then
+	if e.UITransformComponent ~= nil then
+		e.UITransformComponent.UIScale = Vector3(1, 1, 1)
+	end
+	local frames = self.CardFrames[self.ClassToFrame[c.class] or "warrior"]
+	local ruid = nil
+	if frames ~= nil then
+		ruid = frames[c.rarity or "normal"]
+	end
+	if ruid ~= nil then
+		e.SpriteGUIRendererComponent.ImageRUID = ruid
+		e.SpriteGUIRendererComponent.Color = Color(1, 1, 1, 1)
+	end
+end
+self:SetText(base .. "/Cost", string.format("%d", c.cost))
+self:SetText(base .. "/Name", c.name)
+self:SetText(base .. "/Desc", c.desc)
+local art = _EntityService:GetEntityByPath(base .. "/Art")
+if art ~= nil then
+	if c.image ~= nil and c.image ~= "" then
+		art.Enable = true
+		if art.SpriteGUIRendererComponent ~= nil then
+			art.SpriteGUIRendererComponent.ImageRUID = c.image
+		end
+	else
+		art.Enable = false
+	end
+end`, [
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'base' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'cardId' },
+    ]),
+    method('SetCardHover', `local prefix = ""
+local count = 0
+local xs = {}
+local baseY = 0
+local hoverIndex = 0
+local push = 110
+if string.find(path, "/ui/DefaultGroup/CardHand/Card") == 1 then
+	if self.DragSlot ~= nil and self.DragSlot > 0 then
+		return
+	end
+	prefix = "/ui/DefaultGroup/CardHand/Card"
+	count = 0
+	if self.Hand ~= nil then count = #self.Hand end
+	for i = 1, count do
+		xs[i] = self:GetHandSlotX(i)
+	end
+	baseY = 0
+	hoverIndex = tonumber(string.match(path, "Card(%d+)")) or 0
+elseif string.find(path, "/ui/DefaultGroup/RewardHud/Reward") == 1 then
+	prefix = "/ui/DefaultGroup/RewardHud/Reward"
+	count = 3
+	xs = { -300, 0, 300 }
+	baseY = 0
+	hoverIndex = tonumber(string.match(path, "Reward(%d+)")) or 0
+elseif string.find(path, "/ui/DefaultGroup/ShopHud/Card") == 1 then
+	prefix = "/ui/DefaultGroup/ShopHud/Card"
+	count = 3
+	xs = { -300, 0, 300 }
+	baseY = 20
+	hoverIndex = tonumber(string.match(path, "Card(%d+)")) or 0
+end
+if count <= 0 then
+	return
+end
+if self.CardHoverTweenId ~= nil and self.CardHoverTweenId ~= 0 then
+	_TimerService:ClearTimer(self.CardHoverTweenId)
+	self.CardHoverTweenId = 0
+end
+local items = {}
+for i = 1, count do
+	local e = _EntityService:GetEntityByPath(prefix .. tostring(i))
+	if e ~= nil and e.UITransformComponent ~= nil then
+		local tr = e.UITransformComponent
+		local tx = xs[i]
+		local ty = baseY
+		local sc = 1
+		if hover == true and hoverIndex > 0 then
+			if i == hoverIndex and e.Enable == true then
+				sc = 1.5
+			elseif i < hoverIndex then
+				tx = tx - push
+			elseif i > hoverIndex then
+				tx = tx + push
+			end
+		end
+		table.insert(items, { tr = tr, sx = tr.anchoredPosition.x, sy = tr.anchoredPosition.y, ss = tr.UIScale.x, tx = tx, ty = ty, ts = sc })
+	end
+end
+local elapsed = 0
+local duration = 0.12
+local eventId = 0
+eventId = _TimerService:SetTimerRepeat(function()
+	elapsed = elapsed + 1 / 60
+	local t = math.min(elapsed / duration, 1)
+	local eased = _TweenLogic:Ease(0, 1, 1, EaseType.SineEaseOut, t)
+	for i = 1, #items do
+		local it = items[i]
+		local x = it.sx + (it.tx - it.sx) * eased
+		local y = it.sy + (it.ty - it.sy) * eased
+		local s = it.ss + (it.ts - it.ss) * eased
+		it.tr.anchoredPosition = Vector2(x, y)
+		it.tr.UIScale = Vector3(s, s, 1)
+	end
+	if t >= 1 then
+		_TimerService:ClearTimer(eventId)
+		if self.CardHoverTweenId == eventId then
+			self.CardHoverTweenId = 0
+		end
+	end
+end, 1 / 60)
+self.CardHoverTweenId = eventId`, [
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'path' },
+      { Type: 'boolean', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'hover' },
+    ]),
+    method('ApplyCardVisual', `self:ApplyCardFace("/ui/DefaultGroup/CardHand/Card" .. tostring(slot), cardId)`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'cardId' },
+    ]),
+    method('SetText', `local entity = _EntityService:GetEntityByPath(path)
+if entity ~= nil and entity.TextComponent ~= nil then
+\tentity.TextComponent.Text = value
+end`, [
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'path' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'value' },
+    ]),
+    method('FormatNumber', `if value == nil then
+	return ""
+end
+local n = tonumber(value)
+if n == nil then
+	return tostring(value)
+end
+if math.abs(n - math.floor(n)) < 0.00001 then
+	return string.format("%d", math.floor(n))
+end
+return tostring(n)`, [{ Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'value' }], 0, 'string'),
+    method('AnimateCardFrom', `local cardEntity = _EntityService:GetEntityByPath("/ui/DefaultGroup/CardHand/Card" .. tostring(slot))
+if cardEntity == nil or cardEntity.UITransformComponent == nil then
+\treturn
+end
+local tr = cardEntity.UITransformComponent
+tr.anchoredPosition = fromPos
+local elapsed = 0
+local eventId = 0
+eventId = _TimerService:SetTimerRepeat(function()
+\telapsed = elapsed + 1 / 60
+\tlocal t = math.min(elapsed / duration, 1)
+\tlocal eased = _TweenLogic:Ease(0, 1, 1, EaseType.SineEaseOut, t)
+\ttr.anchoredPosition = Vector2(fromPos.x + (toPos.x - fromPos.x) * eased, fromPos.y + (toPos.y - fromPos.y) * eased)
+\tif t >= 1 then
+\t\t_TimerService:ClearTimer(eventId)
+\tend
+end, 1 / 60)`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' },
+      { Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'fromPos' },
+      { Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'toPos' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'duration' },
+    ]),
+    method('AddCardBlock', `local amount = base or 0
+if amount > 0 and self.PlayerDex ~= nil then
+	amount = amount + self.PlayerDex
+end
+if amount < 0 then
+	amount = 0
+end
+self.PlayerBlock = self.PlayerBlock + amount
+return amount`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'base' }], 0, 'number'),
+    method('CalcPlayerAttack', `local base2 = base
+self.FightAttackCount = self.FightAttackCount + 1
+if self.FightAttackCount == 1 and self:HasRelic("akabeko") then
+	base2 = base2 + 8
+end
+local dmg = base2 + self.PlayerStr
+if self:HasRelic("penNib") and self.FightAttackCount % 10 == 0 then
+	dmg = dmg * 2
+end
+if self.PlayerWeak > 0 then
+	dmg = math.floor(dmg * 0.75)
+end
+if dmg > 0 and dmg < 5 and self:HasRelic("boot") then
+	dmg = 5
+end
+if dmg < 0 then
+	dmg = 0
+end
+return dmg`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'base' }], 0, 'number'),
+    method('ResolveCardEffects', `if c == nil then
+	return
+end
+if c.kind == "Attack" then
+	if c.damage ~= nil then
+		self:PlayerAttackMotion()
+		local total = 0
+		local hitN = c.hits or 1
+		for h = 1, hitN do
+			total = total + self:CalcPlayerAttack(c.damage)
+		end
+		if c.aoe == true then
+			self:PlayAoeFx(c.fx or c.image, total)
+		else
+			self:PlayAttackFx(self.TargetIndex, c.fx or c.image, total, c.pierce == true)
+		end
+	end
+	if c.block ~= nil then
+		self:AddCardBlock(c.block)
+	end
+	if free ~= true then
+		self:ApplyRelics("cardPlayed")
+	end
+elseif c.kind == "Skill" then
+	if c.block ~= nil then
+		self:AddCardBlock(c.block)
+	end
+elseif c.kind == "Power" then
+	if free ~= true then
+		table.insert(self.PlayerPowers, cardId)
+	end
+end
+if c.strength ~= nil then
+	self.PlayerStr = self.PlayerStr + c.strength
+end
+if c.dex ~= nil then
+	self.PlayerDex = self.PlayerDex + c.dex
+end
+if c.thorns ~= nil then
+	self.PlayerThorns = self.PlayerThorns + c.thorns
+end
+if c.selfVuln ~= nil then
+	self.PlayerVuln = self.PlayerVuln + c.selfVuln
+end
+if c.heal ~= nil then
+	self.PlayerHp = math.min(self.PlayerHp + c.heal, self.PlayerMaxHp)
+end
+if c.weak ~= nil or c.vuln ~= nil or c.poison ~= nil then
+	local tm = self.Monsters[self.TargetIndex]
+	if tm == nil or tm.alive ~= true then
+		for i = 1, #self.Monsters do
+			if self.Monsters[i].alive == true then tm = self.Monsters[i]; self.TargetIndex = i; break end
+		end
+	end
+	if tm ~= nil and tm.alive == true then
+		if c.weak ~= nil then tm.weak = tm.weak + c.weak end
+		if c.poison ~= nil then tm.poison = (tm.poison or 0) + c.poison end
+		if c.vuln ~= nil then
+			tm.vuln = tm.vuln + c.vuln
+			if self:HasRelic("championBelt") then
+				tm.weak = tm.weak + 1
+			end
+		end
+	end
+end
+if c.draw ~= nil then
+	self:DrawCards(c.draw, true)
+end
+if c.addShiv ~= nil and c.discard == nil and c.discardAll ~= true then
+	self:AddCardsToHand("Shiv", c.addShiv)
+end`, [
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'cardId' },
+      { Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'c' },
+      { Type: 'boolean', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'free' },
+    ]),
+    method('TriggerSly', `local c = self.Cards[cardId]
+if c == nil or c.sly ~= true then
+	return
+end
+self:Toast("교활 발동: " .. c.name)
+self:ResolveCardEffects(cardId, c, true)`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'cardId' }]),
+    method('DiscardHandCard', `if self.Hand == nil then
+	return
+end
+local cardId = self.Hand[slot]
+if cardId == nil then
+	return
+end
+table.remove(self.Hand, slot)
+table.insert(self.DiscardPile, cardId)
+if triggerSly == true then
+	self:TriggerSly(cardId)
+end`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' },
+      { Type: 'boolean', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'triggerSly' },
+    ]),
+    method('IsDiscardSelecting', `return self.DiscardSelectRemaining ~= nil and self.DiscardSelectRemaining > 0`, [], 0, 'boolean'),
+    method('UpdateDiscardPrompt', `local e = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/DiscardPrompt")
+if e == nil then
+	return
+end
+if self:IsDiscardSelecting() == true then
+	local picked = self.DiscardSelectTotal - self.DiscardSelectRemaining
+	self:SetText("/ui/DefaultGroup/CombatHud/DiscardPrompt", "버릴 카드 선택 " .. self:FormatNumber(picked + 1) .. "/" .. self:FormatNumber(self.DiscardSelectTotal))
+	e.Enable = true
+else
+	e.Enable = false
+end`),
+    method('BeginDiscardSelection', `if c == nil or self.Hand == nil then
+	return false
+end
+local n = 0
+if c.discardAll == true then
+	n = #self.Hand
+elseif c.discard ~= nil then
+	n = math.min(c.discard, #self.Hand)
+end
+if n <= 0 then
+	return false
+end
+self.DiscardSelectRemaining = n
+self.DiscardSelectTotal = n
+self.DiscardPostShiv = 0
+self.DiscardShivPerPick = 0
+if c.addShiv ~= nil then
+	self.DiscardPostShiv = c.addShiv
+end
+if c.addShivPerDiscard == true then
+	self.DiscardShivPerPick = 1
+end
+self:UpdateDiscardPrompt()
+self:Toast("버릴 카드를 선택하세요")
+return true`, [{ Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'c' }], 0, 'boolean'),
+    method('FinishDiscardSelection', `self.DiscardSelectRemaining = 0
+self.DiscardSelectTotal = 0
+local shivCount = self.DiscardPostShiv or 0
+self.DiscardPostShiv = 0
+self.DiscardShivPerPick = 0
+self:UpdateDiscardPrompt()
+if shivCount > 0 then
+	self:AddCardsToHand("Shiv", shivCount)
+end
+self:RenderHand(false)
+self:RenderPiles()
+self:RenderCombat()
+self:CheckCombatEnd()`),
+    method('SelectDiscardSlot', `if self:IsDiscardSelecting() ~= true then
+	return false
+end
+if self.Hand == nil or self.Hand[slot] == nil then
+	return true
+end
+local discarded = self.Hand[slot]
+self:DiscardHandCard(slot, true)
+if discarded ~= nil and self.DiscardShivPerPick ~= nil and self.DiscardShivPerPick > 0 then
+	self.DiscardPostShiv = (self.DiscardPostShiv or 0) + self.DiscardShivPerPick
+end
+self.DiscardSelectRemaining = self.DiscardSelectRemaining - 1
+if self.DiscardSelectRemaining <= 0 or #self.Hand <= 0 then
+	self:FinishDiscardSelection()
+else
+	self:UpdateDiscardPrompt()
+	self:RenderHand(false)
+	self:RenderPiles()
+	self:RenderCombat()
+end
+return true`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }], 0, 'boolean'),
+];

tools/deck/cb/items.mjs

@@ -0,0 +1,213 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const itemMethods = [
+    method('HasRelic', `if self.RunRelics == nil then
+	return false
+end
+for i = 1, #self.RunRelics do
+	if self.RunRelics[i] == id then
+		return true
+	end
+end
+return false`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'id' }], 0, 'boolean'),
+    method('ApplyRelics', `if self.RunRelics == nil then
+	return
+end
+for i = 1, #self.RunRelics do
+	local r = self.Relics[self.RunRelics[i]]
+	if r ~= nil and r.hook == hook then
+		if r.effect == "block" then
+			self.PlayerBlock = self.PlayerBlock + r.value
+		elseif r.effect == "energy" then
+			self.Energy = self.Energy + r.value
+		elseif r.effect == "strength" then
+			self.PlayerStr = self.PlayerStr + r.value
+		elseif r.effect == "draw" then
+			self:DrawCards(r.value)
+			self:RenderHand(false)
+		elseif r.effect == "heal" or r.effect == "healOnAttack" or r.effect == "healOnWin" then
+			self.PlayerHp = self.PlayerHp + r.value
+			if self.PlayerHp > self.PlayerMaxHp then
+				self.PlayerHp = self.PlayerMaxHp
+			end
+		elseif r.effect == "healIfLow" then
+			if self.PlayerHp * 2 <= self.PlayerMaxHp then
+				self.PlayerHp = self.PlayerHp + r.value
+				if self.PlayerHp > self.PlayerMaxHp then
+					self.PlayerHp = self.PlayerMaxHp
+				end
+			end
+		elseif r.effect == "gold" then
+			self.Gold = self.Gold + r.value
+		end
+	end
+end`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'hook' }]),
+    method('AddRelic', `if self.RunRelics == nil then
+	self.RunRelics = {}
+end
+table.insert(self.RunRelics, id)
+local r = self.Relics[id]
+if r ~= nil and r.hook == "passive" then
+	if r.effect == "potionSlots" then
+		self.PotionSlots = r.value
+		self:RenderPotions()
+	elseif r.effect == "maxHp" then
+		self.PlayerMaxHp = self.PlayerMaxHp + r.value
+		self.PlayerHp = self.PlayerHp + r.value
+	end
+end
+self:RenderRelics()`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'id' }]),
+    method('PickNewRelic', `local pool = {}
+for i = 1, #self.RelicPool do
+	if self:HasRelic(self.RelicPool[i]) == false then
+		table.insert(pool, self.RelicPool[i])
+	end
+end
+if #pool == 0 then
+	self.Gold = self.Gold + 25
+	self:Toast("유물을 모두 모았습니다! 메소 +25")
+	return ""
+end
+return pool[math.random(1, #pool)]`, [], 0, 'string'),
+    method('AddPotion', `if self.RunPotions == nil then
+	self.RunPotions = {}
+end
+if #self.RunPotions >= self.PotionSlots then
+	self:Toast("물약 슬롯이 가득 찼습니다")
+	return false
+end
+table.insert(self.RunPotions, pid)
+self:RenderPotions()
+return true`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'pid' }], 0, 'boolean'),
+    method('MaybeDropPotion', `if math.random() > ${POTIONS.dropChance} then
+	return
+end
+local keys = {}
+for pid, _ in pairs(self.Potions) do
+	table.insert(keys, pid)
+end
+table.sort(keys)
+local pid = keys[math.random(1, #keys)]
+if self:AddPotion(pid) == true then
+	local p = self.Potions[pid]
+	self:Toast("물약 획득: " .. p.name)
+end`),
+    method('RenderPotions', `for i = 1, 5 do
+	local base = "/ui/DefaultGroup/CombatHud/TopBar/PotionSlot" .. tostring(i)
+	local e = _EntityService:GetEntityByPath(base)
+	if e ~= nil and e.SpriteGUIRendererComponent ~= nil then
+		local pid = nil
+		if self.RunPotions ~= nil then
+			pid = self.RunPotions[i]
+		end
+		if pid ~= nil and self.Potions[pid] ~= nil then
+			e.SpriteGUIRendererComponent.ImageRUID = self.Potions[pid].icon
+			e.SpriteGUIRendererComponent.Color = Color(1, 1, 1, 1)
+		elseif i > self.PotionSlots then
+			e.SpriteGUIRendererComponent.ImageRUID = ""
+			e.SpriteGUIRendererComponent.Color = Color(0.1, 0.1, 0.12, 0.85)
+		else
+			e.SpriteGUIRendererComponent.ImageRUID = ""
+			e.SpriteGUIRendererComponent.Color = Color(0.22, 0.25, 0.3, 0.9)
+		end
+	end
+end`),
+    method('OpenPotionMenu', `if self.RunPotions == nil or self.RunPotions[slot] == nil then
+	return
+end
+self.PotionMenuSlot = slot
+local pid = self.RunPotions[slot]
+local p = self.Potions[pid]
+if p ~= nil then
+	self:SetText("/ui/DefaultGroup/CombatHud/PotionMenu/Title", p.name .. " — " .. p.desc)
+end
+self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/PotionMenu", true)`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
+    method('ClosePotionMenu', `self.PotionMenuSlot = 0
+self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/PotionMenu", false)`),
+    method('UsePotion', `if self.PotionMenuSlot <= 0 then
+	return
+end
+if self.CombatOver == true or self.TurnBusy == true or self.FxBusy == true then
+	self:Toast("지금은 사용할 수 없습니다")
+	return
+end
+local combat = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud")
+local hand = _EntityService:GetEntityByPath("/ui/DefaultGroup/CardHand")
+if combat == nil or combat.Enable ~= true or hand == nil or hand.Enable ~= true then
+	self:Toast("전투 중에만 사용할 수 있습니다")
+	return
+end
+local pid = self.RunPotions[self.PotionMenuSlot]
+if pid == nil then
+	return
+end
+local p = self.Potions[pid]
+if p == nil then
+	return
+end
+if p.effect == "heal" then
+	self.PlayerHp = math.min(self.PlayerHp + p.value, self.PlayerMaxHp)
+elseif p.effect == "damage" then
+	self:DealDamageToTarget(p.value, false)
+	self:ShowDmgPop(self.TargetIndex, p.value)
+elseif p.effect == "strength" then
+	self.PlayerStr = self.PlayerStr + p.value
+elseif p.effect == "block" then
+	self.PlayerBlock = self.PlayerBlock + p.value
+elseif p.effect == "energy" then
+	self.Energy = self.Energy + p.value
+elseif p.effect == "weak" then
+	local tm = self.Monsters[self.TargetIndex]
+	if tm ~= nil and tm.alive == true then
+		tm.weak = tm.weak + p.value
+	end
+end
+table.remove(self.RunPotions, self.PotionMenuSlot)
+self:Toast("물약 사용: " .. p.name)
+self:ClosePotionMenu()
+self:RenderPotions()
+self:RenderPiles()
+self:RenderCombat()
+self:CheckCombatEnd()`),
+    method('TossPotion', `if self.PotionMenuSlot <= 0 then
+	return
+end
+local pid = self.RunPotions[self.PotionMenuSlot]
+if pid ~= nil then
+	local p = self.Potions[pid]
+	table.remove(self.RunPotions, self.PotionMenuSlot)
+	if p ~= nil then
+		self:Toast("물약 버림: " .. p.name)
+	end
+end
+self:ClosePotionMenu()
+self:RenderPotions()`),
+    method('RenderRelics', `local count = 0
+if self.RunRelics ~= nil then
+	count = #self.RunRelics
+end
+for i = 1, 10 do
+	local base = "/ui/DefaultGroup/CombatHud/TopBar/RelicSlot" .. tostring(i)
+	local e = _EntityService:GetEntityByPath(base)
+	if e ~= nil and e.SpriteGUIRendererComponent ~= nil then
+		local rid = nil
+		if self.RunRelics ~= nil then
+			rid = self.RunRelics[i]
+		end
+		if rid ~= nil and self.Relics[rid] ~= nil and (i < 10 or count <= 10) then
+			e.SpriteGUIRendererComponent.ImageRUID = self.Relics[rid].icon
+			e.SpriteGUIRendererComponent.Color = Color(1, 1, 1, 1)
+		else
+			e.SpriteGUIRendererComponent.ImageRUID = ""
+			e.SpriteGUIRendererComponent.Color = Color(0.15, 0.16, 0.2, 0.6)
+		end
+	end
+end
+local of = ""
+if count > 10 then
+	of = "+" .. tostring(count - 9)
+end
+self:SetText("/ui/DefaultGroup/CombatHud/TopBar/RelicOverflow", of)`),
+];

tools/deck/cb/jobs.mjs

@@ -0,0 +1,79 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const jobMethods = [
+    method('ShowJobChoice', `self:SetEntityEnabled("/ui/DefaultGroup/CardHand", false)
+self:SetEntityEnabled("/ui/DefaultGroup/DeckHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/JobChoiceHud", true)`),
+    method('PickJobReward', `self:SetEntityEnabled("/ui/DefaultGroup/JobChoiceHud", false)
+if kind == "relic" then
+	local bid = self:PickNewRelic()
+	if bid ~= "" then
+		self:AddRelic(bid)
+		local br = self.Relics[bid]
+		if br ~= nil then
+			self:Toast("유물 획득: " .. br.name)
+		end
+	end
+	self:ContinueAfterBoss()
+else
+	self:ShowJobSelect()
+end`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'kind' }]),
+    method('ShowJobSelect', `local opts = self.Jobs[self.SelectedClass]
+if opts == nil then
+	opts = self.Jobs["warrior"]
+end
+self.JobOpts = opts
+for i = 1, 3 do
+	local base = "/ui/DefaultGroup/JobSelectHud/Job_slot" .. tostring(i)
+	local o = opts[i]
+	if o ~= nil then
+		self:SetEntityEnabled(base, true)
+		self:SetText(base .. "/Name", o.name)
+		self:SetText(base .. "/Desc", o.desc)
+		local sc = self.Cards[o.starter]
+		if sc ~= nil then
+			self:SetText(base .. "/Starter", "대표 카드: " .. sc.name)
+		end
+	else
+		self:SetEntityEnabled(base, false)
+	end
+end
+self:SetEntityEnabled("/ui/DefaultGroup/JobSelectHud", true)`),
+    method('JobLabel', `if self.PlayerJob ~= "" and self.Jobs ~= nil then
+	for cls, list in pairs(self.Jobs) do
+		for i = 1, #list do
+			if list[i].id == self.PlayerJob then
+				return list[i].name
+			end
+		end
+	end
+end
+if self.SelectedClass == "warrior" then
+	return "전사"
+elseif self.SelectedClass == "bandit" then
+	return "도적"
+elseif self.SelectedClass == "magician" then
+	return "마법사"
+end
+return "플레이어"`, [], 0, 'string'),
+    method('SetJob', `self.PlayerJob = jobId
+local starter = ""
+local opts = self.Jobs[self.SelectedClass] or {}
+for i = 1, #opts do
+	if opts[i].id == jobId then
+		starter = opts[i].starter
+	end
+end
+if starter ~= "" then
+	table.insert(self.RunDeck, starter)
+	local sc = self.Cards[starter]
+	if sc ~= nil then
+		self:Toast("2차 전직: " .. self:JobLabel() .. "! 신규 카드 — " .. sc.name)
+	end
+end
+self:SetText("/ui/DefaultGroup/CombatHud/PlayerPanel/Name", self:JobLabel())
+self:SetEntityEnabled("/ui/DefaultGroup/JobSelectHud", false)
+self:ContinueAfterBoss()`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'jobId' }]),
+];

tools/deck/cb/map.mjs

@@ -0,0 +1,230 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const mapMethods = [
+    method('ShowMap', `self:ShowState("map")
+self:RenderMap()`),
+    method('GenerateMap', `-- 절차 생성 — tools/map/rogue-map.mjs(JS 미러)와 로직 동기화 유지
+self.MapNodes = {}
+self.MapStart = {}
+self.VisitedNodes = {}
+self.Depth = 0
+self.MapNodes["boss"] = { type = "boss", row = ${MAP_ROWS} + 1, col = 0, next = {} }
+local cols = { 1, 2, 3, 4 }
+for i = #cols, 2, -1 do
+	local j = math.random(1, i)
+	cols[i], cols[j] = cols[j], cols[i]
+end
+local starts = { cols[1], cols[2], math.random(1, ${MAP_COLS}), math.random(1, ${MAP_COLS}) }
+for p = 1, 4 do
+	local c = starts[p]
+	local sid = "r1c" .. tostring(c)
+	if self.MapNodes[sid] == nil then
+		self.MapNodes[sid] = { type = "combat", row = 1, col = c, next = {} }
+	end
+	local found = false
+	for i = 1, #self.MapStart do
+		if self.MapStart[i] == sid then found = true end
+	end
+	if found == false then
+		table.insert(self.MapStart, sid)
+	end
+	for r = 1, ${MAP_ROWS} - 1 do
+		local nc = c + math.random(-1, 1)
+		if nc < 1 then nc = 1 end
+		if nc > ${MAP_COLS} then nc = ${MAP_COLS} end
+		local nid = "r" .. tostring(r + 1) .. "c" .. tostring(nc)
+		if self.MapNodes[nid] == nil then
+			self.MapNodes[nid] = { type = "combat", row = r + 1, col = nc, next = {} }
+		end
+		local fid = "r" .. tostring(r) .. "c" .. tostring(c)
+		local dup = false
+		for i = 1, #self.MapNodes[fid].next do
+			if self.MapNodes[fid].next[i] == nid then dup = true end
+		end
+		if dup == false then
+			table.insert(self.MapNodes[fid].next, nid)
+		end
+		c = nc
+	end
+	local lid = "r" .. tostring(${MAP_ROWS}) .. "c" .. tostring(c)
+	local bdup = false
+	for i = 1, #self.MapNodes[lid].next do
+		if self.MapNodes[lid].next[i] == "boss" then bdup = true end
+	end
+	if bdup == false then
+		table.insert(self.MapNodes[lid].next, "boss")
+	end
+end
+for r = 3, ${MAP_ROWS} do
+	for c = 1, ${MAP_COLS} do
+		local id = "r" .. tostring(r) .. "c" .. tostring(c)
+		local node = self.MapNodes[id]
+		if node ~= nil then
+			-- 부모 노드 타입 수집 (rest/shop/elite 는 부모와 같은 타입 연속 금지)
+			local parentTypes = {}
+			for pid, pn in pairs(self.MapNodes) do
+				if pn.row == r - 1 then
+					for i = 1, #pn.next do
+						if pn.next[i] == id then parentTypes[pn.type] = true end
+					end
+				end
+			end
+			local w
+			if r == ${MAP_ROWS} then
+				w = { { "rest", 50 }, { "combat", 25 }, { "shop", 10 }, { "elite", 8 }, { "treasure", 7 } }
+			elseif r >= 4 then
+				w = { { "combat", 45 }, { "elite", 16 }, { "shop", 12 }, { "rest", 12 }, { "treasure", 15 } }
+			else
+				w = { { "combat", 45 }, { "shop", 12 }, { "rest", 12 } }
+			end
+			local total = 0
+			for i = 1, #w do
+				local t = w[i][1]
+				if (t == "elite" or t == "rest" or t == "shop") and parentTypes[t] == true then
+					w[i][2] = 0
+				end
+				total = total + w[i][2]
+			end
+			local roll = math.random() * total
+			local acc = 0
+			for i = 1, #w do
+				acc = acc + w[i][2]
+				if roll <= acc then
+					node.type = w[i][1]
+					break
+				end
+			end
+		end
+	end
+end`),
+    method('IsReachable', `local list
+if self.CurrentNodeId == "" then
+	list = self.MapStart
+else
+	local node = self.MapNodes[self.CurrentNodeId]
+	if node == nil then
+		return false
+	end
+	list = node.next
+end
+for i = 1, #list do
+	if list[i] == id then
+		return true
+	end
+end
+return false`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'id' }], 0, 'boolean'),
+    method('RenderMapNode', `local base = "/ui/DefaultGroup/MapHud/Node_" .. id
+local e = _EntityService:GetEntityByPath(base)
+if e == nil then
+	return
+end
+local node = self.MapNodes[id]
+if node == nil then
+	e.Enable = false
+	return
+end
+e.Enable = true
+local ruid = self.NodeIcons[node.type]
+if ruid == nil then
+	ruid = self.NodeIcons["combat"]
+end
+if e.SpriteGUIRendererComponent ~= nil and ruid ~= nil then
+	e.SpriteGUIRendererComponent.ImageRUID = ruid
+end
+local reachable = self:IsReachable(id)
+local visited = false
+if self.VisitedNodes ~= nil then
+	for i = 1, #self.VisitedNodes do
+		if self.VisitedNodes[i] == id then visited = true end
+	end
+end
+if e.SpriteGUIRendererComponent ~= nil then
+	if id == self.CurrentNodeId then
+		e.SpriteGUIRendererComponent.Color = Color(1, 0.82, 0.3, 1)
+	elseif visited == true then
+		e.SpriteGUIRendererComponent.Color = Color(0.5, 0.5, 0.55, 0.9)
+	elseif reachable == true then
+		e.SpriteGUIRendererComponent.Color = Color(1, 1, 1, 1)
+	else
+		e.SpriteGUIRendererComponent.Color = Color(0.68, 0.68, 0.72, 0.85)
+	end
+end
+if e.ButtonComponent ~= nil then
+	e.ButtonComponent.Enable = reachable
+end`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'id' }]),
+    method('RenderMapDots', `local node = self.MapNodes[fromId]
+local has = false
+if node ~= nil then
+	for i = 1, #node.next do
+		if node.next[i] == toId then has = true end
+	end
+end
+for k = 1, 3 do
+	local d = _EntityService:GetEntityByPath("/ui/DefaultGroup/MapHud/Dot_" .. dotId .. "_" .. tostring(k))
+	if d ~= nil then
+		d.Enable = has
+		if has == true and d.SpriteGUIRendererComponent ~= nil then
+			if fromId == self.CurrentNodeId then
+				d.SpriteGUIRendererComponent.Color = Color(0.95, 0.8, 0.3, 1)
+			else
+				d.SpriteGUIRendererComponent.Color = Color(0.5, 0.5, 0.55, 0.8)
+			end
+		end
+	end
+end`, [
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'dotId' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'fromId' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'toId' },
+    ]),
+    method('RenderMap', `for r = 1, ${MAP_ROWS} do
+	for c = 1, ${MAP_COLS} do
+		self:RenderMapNode("r" .. tostring(r) .. "c" .. tostring(c))
+	end
+end
+self:RenderMapNode("boss")
+for r = 1, ${MAP_ROWS} - 1 do
+	for c = 1, ${MAP_COLS} do
+		local fid = "r" .. tostring(r) .. "c" .. tostring(c)
+		for c2 = c - 1, c + 1 do
+			if c2 >= 1 and c2 <= ${MAP_COLS} then
+				self:RenderMapDots(fid .. "_" .. tostring(c2), fid, "r" .. tostring(r + 1) .. "c" .. tostring(c2))
+			end
+		end
+	end
+end
+for c = 1, ${MAP_COLS} do
+	local fid = "r" .. tostring(${MAP_ROWS}) .. "c" .. tostring(c)
+	self:RenderMapDots(fid .. "_b", fid, "boss")
+end
+`),
+    method('PickNode', `if self.RunActive ~= true then
+	return
+end
+if self:IsReachable(id) ~= true then
+	return
+end
+self.CurrentNodeId = id
+if self.VisitedNodes == nil then
+	self.VisitedNodes = {}
+end
+table.insert(self.VisitedNodes, id)
+local hud = _EntityService:GetEntityByPath("/ui/DefaultGroup/MapHud")
+if hud ~= nil then
+	hud.Enable = false
+end
+local node = self.MapNodes[id]
+self.Depth = node.row
+self:RenderRun()
+if node.type == "shop" then
+	self:ShowShop()
+elseif node.type == "rest" then
+	self:ShowRest()
+elseif node.type == "treasure" then
+	self:ShowTreasure()
+else
+	self.CurrentEnemyId = ""
+	self:StartCombat()
+end`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'id' }]),
+];

tools/deck/cb/render.mjs

@@ -0,0 +1,308 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const renderMethods = [
+    method('BuffsLabel', `local parts = {}
+if str ~= nil and str > 0 then table.insert(parts, "힘+" .. tostring(str)) end
+if weak ~= nil and weak > 0 then table.insert(parts, "약화" .. tostring(weak)) end
+if vuln ~= nil and vuln > 0 then table.insert(parts, "취약" .. tostring(vuln)) end
+if poison ~= nil and poison > 0 then table.insert(parts, "독" .. tostring(poison)) end
+return table.concat(parts, " ")`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'str' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'weak' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'vuln' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'poison' },
+    ], 0, 'string'),
+    method('RenderCombat', `for i = 1, ${MAX_MONSTERS} do
+	local base = "/ui/DefaultGroup/CombatHud/MonsterSlot" .. tostring(i)
+	local m = self.Monsters[i]
+	if m ~= nil and m.alive == true then
+		self:SetEntityEnabled(base, true)
+		self:SetText(base .. "/Name", m.name)
+		self:SetText(base .. "/Hp", string.format("%d", m.hp) .. "/" .. string.format("%d", m.maxHp))
+		local intent = m.intents[m.intentIdx]
+		local t = ""
+		if intent ~= nil then
+			if intent.kind == "Attack" then
+				local atk = intent.value + m.str
+				if m.weak > 0 then atk = math.floor(atk * 0.75) end
+				if self.PlayerVuln > 0 then atk = math.floor(atk * 1.5) end
+				t = "공격 " .. tostring(atk)
+			elseif intent.kind == "Defend" then t = "방어 " .. tostring(intent.value)
+			elseif intent.kind == "Debuff" then
+				if intent.effect == "weak" then t = "약화 " .. tostring(intent.value) .. " 부여"
+				else t = "취약 " .. tostring(intent.value) .. " 부여" end
+			elseif intent.kind == "AddCard" then
+				t = "저주 카드 추가"
+			end
+		end
+		self:SetText(base .. "/Intent", t)
+		local dragActive = self.DragTargetIndex ~= nil and self.DragTargetIndex > 0
+		local shownTarget = self.TargetIndex
+		if dragActive == true then shownTarget = self.DragTargetIndex end
+		self:SetEntityEnabled(base .. "/TargetFrame", i == shownTarget)
+		self:SetEntityEnabled(base .. "/TargetMarker", i == shownTarget and dragActive)
+		self:SetEntityEnabled(base .. "/TargetMarker/Label", i == shownTarget and dragActive)
+		local intentEntity = _EntityService:GetEntityByPath(base .. "/Intent")
+		if intentEntity ~= nil and intentEntity.TextComponent ~= nil and intent ~= nil then
+			if intent.kind == "Attack" then
+				intentEntity.TextComponent.FontColor = Color(1, 0.45, 0.35, 1)
+			elseif intent.kind == "Debuff" then
+				intentEntity.TextComponent.FontColor = Color(0.8, 0.5, 1, 1)
+			elseif intent.kind == "AddCard" then
+				intentEntity.TextComponent.FontColor = Color(0.6, 0.85, 0.4, 1)
+			else
+				intentEntity.TextComponent.FontColor = Color(0.5, 0.75, 1, 1)
+			end
+		end
+		self:SetHpBar(base .. "/HpBarFill", m.hp, m.maxHp, ${HP_BAR_W})
+		self:SetEntityEnabled(base .. "/BlockBadge", m.block > 0)
+		self:SetText(base .. "/BlockBadge/Value", string.format("%d", m.block))
+		self:SetText(base .. "/Buffs", self:BuffsLabel(m.str, m.weak, m.vuln, m.poison or 0))
+	else
+		self:SetEntityEnabled(base, false)
+	end
+end
+self:SetText("/ui/DefaultGroup/CombatHud/PlayerPanel/HpText", string.format("%d", self.PlayerHp) .. "/" .. string.format("%d", self.PlayerMaxHp))
+self:SetHpBar("/ui/DefaultGroup/CombatHud/PlayerPanel/HpBarFill", self.PlayerHp, self.PlayerMaxHp, 220)
+self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/PlayerPanel/BlockBadge", self.PlayerBlock > 0)
+self:SetText("/ui/DefaultGroup/CombatHud/PlayerPanel/BlockBadge/Value", string.format("%d", self.PlayerBlock))
+local pb = self:BuffsLabel(self.PlayerStr, self.PlayerWeak, self.PlayerVuln, 0)
+if self.PlayerDex ~= nil and self.PlayerDex > 0 then
+	if pb ~= "" then pb = pb .. " " end
+	pb = pb .. "민첩+" .. tostring(self.PlayerDex)
+end
+if self.PlayerThorns ~= nil and self.PlayerThorns > 0 then
+	if pb ~= "" then pb = pb .. " " end
+	pb = pb .. "가시" .. tostring(self.PlayerThorns)
+end
+if self.PlayerPowers ~= nil and #self.PlayerPowers > 0 then
+	local names = {}
+	for i = 1, #self.PlayerPowers do
+		local pc = self.Cards[self.PlayerPowers[i]]
+		if pc ~= nil then table.insert(names, pc.name) end
+	end
+	if pb ~= "" then pb = pb .. " · " end
+	pb = pb .. table.concat(names, " ")
+end
+self:SetText("/ui/DefaultGroup/CombatHud/PlayerPanel/Buffs", pb)
+self:RenderRun()`),
+    method('ShowDmgPop', `local slotKey = string.format("%d", math.floor(slot or 0))
+local base = "/ui/DefaultGroup/CombatHud/DmgPop" .. slotKey
+local pop = _EntityService:GetEntityByPath(base)
+if pop == nil then
+	return
+end
+self.DmgPopSeq = (self.DmgPopSeq or 0) + 1
+local popSeq = self.DmgPopSeq
+self:SetText(base, "")
+local damageDigitRuids = { ${DAMAGE_DIGIT_RUIDS.map(luaStr).join(', ')} }
+local shown = tostring(math.max(0, math.floor(amount)))
+if string.len(shown) > ${DAMAGE_POP_MAX_DIGITS} then
+  shown = string.sub(shown, 1, ${DAMAGE_POP_MAX_DIGITS})
+end
+local digits = {}
+for i = 1, string.len(shown) do
+  table.insert(digits, tonumber(string.sub(shown, i, i)) or 0)
+end
+local totalW = #digits * ${DAMAGE_POP_DIGIT_W} + math.max(0, #digits - 1) * ${DAMAGE_POP_DIGIT_SPACING}
+local startX = -totalW / 2 + ${DAMAGE_POP_DIGIT_W} / 2
+for i = 1, ${DAMAGE_POP_MAX_DIGITS} do
+  self:SetEntityEnabled(base .. "/Digit" .. tostring(i), false)
+end
+for i = 1, ${DAMAGE_POP_MAX_DIGITS} do
+  local digitPath = base .. "/Digit" .. tostring(i)
+  local digitEntity = _EntityService:GetEntityByPath(digitPath)
+  if digitEntity ~= nil and digitEntity.SpriteGUIRendererComponent ~= nil then
+    if digits[i] ~= nil then
+      digitEntity.SpriteGUIRendererComponent.ImageRUID = damageDigitRuids[digits[i] + 1]
+      digitEntity.SpriteGUIRendererComponent.Color = Color(1, 1, 1, 1)
+      if digitEntity.UITransformComponent ~= nil then
+        digitEntity.UITransformComponent.anchoredPosition = Vector2(startX + (i - 1) * (${DAMAGE_POP_DIGIT_W} + ${DAMAGE_POP_DIGIT_SPACING}), 0)
+      end
+      self:SetEntityEnabled(digitPath, true)
+    else
+      self:SetEntityEnabled(digitPath, false)
+    end
+  end
+end
+local popPos = nil
+local m = self.Monsters[slot]
+if m ~= nil and m.entity ~= nil and isvalid(m.entity) and m.entity.TransformComponent ~= nil then
+  local wp = m.entity.TransformComponent.WorldPosition
+  local screen = _UILogic:WorldToScreenPosition(Vector2(wp.x, wp.y + ${HEAD_OFFSET_Y + 0.45}))
+  popPos = _UILogic:ScreenToUIPosition(screen)
+else
+  local slotEntity = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/MonsterSlot" .. slotKey)
+  if slotEntity ~= nil and slotEntity.UITransformComponent ~= nil then
+    local sp = slotEntity.UITransformComponent.anchoredPosition
+    popPos = Vector2(sp.x, sp.y + 76)
+  end
+end
+if pop ~= nil and pop.UITransformComponent ~= nil then
+  if popPos ~= nil then
+    pop.UITransformComponent.anchoredPosition = popPos
+  else
+    pop.UITransformComponent.anchoredPosition = Vector2(0, 120)
+  end
+end
+self:SetEntityEnabled(base, true)
+for i = 1, 6 do
+  _TimerService:SetTimerOnce(function()
+    if self.DmgPopSeq ~= popSeq then
+      return
+    end
+    local p = _EntityService:GetEntityByPath(base)
+    if p ~= nil and p.UITransformComponent ~= nil then
+      local cur = p.UITransformComponent.anchoredPosition
+      p.UITransformComponent.anchoredPosition = Vector2(cur.x, cur.y + 7)
+    end
+  end, 0.045 * i)
+end
+_TimerService:SetTimerOnce(function()
+  if self.DmgPopSeq ~= popSeq then
+    return
+  end
+  self:SetEntityEnabled(base, false)
+end, 0.48)`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'amount' },
+    ]),
+    method('ShowPlayerDmgPop', `local base = "/ui/DefaultGroup/CombatHud/PlayerPanel/DmgPop"
+if amount > 0 then
+	self:SetText(base, "-" .. string.format("%d", amount))
+else
+	self:SetText(base, "막음")
+end
+self:SetEntityEnabled(base, true)
+_TimerService:SetTimerOnce(function() self:SetEntityEnabled(base, false) end, 0.6)`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'amount' }]),
+    method('PlayerAttackMotion', `local lp = _UserService.LocalPlayer
+if lp == nil then
+	return
+end
+if lp.StateComponent == nil then
+	return
+end
+pcall(function() lp.StateComponent:ChangeState("ATTACK") end)
+_TimerService:SetTimerOnce(function()
+	if lp ~= nil and isvalid(lp) and lp.StateComponent ~= nil then
+		pcall(function() lp.StateComponent:ChangeState("IDLE") end)
+	end
+end, 0.5)`),
+    method('PlayerHitMotion', `local lp = _UserService.LocalPlayer
+if lp == nil then
+	return
+end
+if lp.StateComponent ~= nil then
+	pcall(function() lp.StateComponent:ChangeState("HIT") end)
+end
+local tr = lp.TransformComponent
+if tr == nil then
+	return
+end
+local p = tr.Position
+tr.Position = Vector3(p.x - 0.15, p.y, p.z)
+_TimerService:SetTimerOnce(function()
+	if lp ~= nil and isvalid(lp) and lp.TransformComponent ~= nil then
+		lp.TransformComponent.Position = Vector3(p.x, p.y, p.z)
+	end
+end, 0.15)`),
+    method('MonsterLunge', `local m = self.Monsters[idx]
+if m == nil or m.alive ~= true or m.entity == nil or not isvalid(m.entity) then
+	return
+end
+if m.motionBusy == true then
+	return
+end
+m.motionBusy = true
+local e = m.entity
+local tr = e.TransformComponent
+if tr == nil then
+	m.motionBusy = false
+	return
+end
+local p = tr.Position
+tr.Position = Vector3(p.x - 0.35, p.y, p.z)
+_TimerService:SetTimerOnce(function()
+	if isvalid(e) and e.TransformComponent ~= nil then
+		e.TransformComponent.Position = Vector3(p.x, p.y, p.z)
+	end
+	m.motionBusy = false
+end, 0.18)`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'idx' }]),
+    method('MonsterHitMotion', `local m = self.Monsters[slot]
+if m == nil or m.alive ~= true or m.entity == nil or not isvalid(m.entity) then
+	return
+end
+local e = m.entity
+if m.hitClip ~= nil and e.SpriteRendererComponent ~= nil then
+	e.SpriteRendererComponent.SpriteRUID = m.hitClip
+	_TimerService:SetTimerOnce(function()
+		if isvalid(e) and e.SpriteRendererComponent ~= nil and m.alive == true and m.standClip ~= nil then
+			e.SpriteRendererComponent.SpriteRUID = m.standClip
+		end
+	end, 0.5)
+else
+	if m.motionBusy == true then
+		return
+	end
+	m.motionBusy = true
+	local tr = e.TransformComponent
+	if tr == nil then
+		m.motionBusy = false
+		return
+	end
+	local p = tr.Position
+	local seq = { 0.12, -0.12, 0 }
+	for i = 1, #seq do
+		local dx = seq[i]
+		_TimerService:SetTimerOnce(function()
+			if isvalid(e) and e.TransformComponent ~= nil then
+				e.TransformComponent.Position = Vector3(p.x + dx, p.y, p.z)
+			end
+			if i == #seq then
+				m.motionBusy = false
+			end
+		end, 0.06 * i)
+	end
+end`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
+    method('SetHpBar', `local e = _EntityService:GetEntityByPath(path)
+if e == nil or e.UITransformComponent == nil then
+	return
+end
+local ratio = 0
+if maxHp > 0 then ratio = hp / maxHp end
+if ratio < 0 then ratio = 0 end
+local w = width * ratio
+e.UITransformComponent.RectSize = Vector2(w, 14)`, [
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'path' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'hp' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'maxHp' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'width' },
+    ]),
+    method('PositionMonsterSlot', `local m = self.Monsters[slot]
+if m == nil or m.entity == nil or not isvalid(m.entity) then
+	return
+end
+local tr = m.entity.TransformComponent
+if tr == nil then
+	return
+end
+local wp = tr.WorldPosition
+local screen = _UILogic:WorldToScreenPosition(Vector2(wp.x, wp.y + ${HEAD_OFFSET_Y}))
+local uipos = _UILogic:ScreenToUIPosition(screen)
+local e = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/MonsterSlot" .. tostring(slot))
+if e ~= nil and e.UITransformComponent ~= nil then
+	e.UITransformComponent.anchoredPosition = uipos
+end`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
+    method('SetTarget', `if self.Monsters[slot] ~= nil and self.Monsters[slot].alive == true then
+	self.TargetIndex = slot
+	self:RenderCombat()
+end`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
+    method('RenderRun', `local floorText = "막 " .. string.format("%d", self.Floor) .. "/" .. string.format("%d", self.RunLength) .. " · " .. string.format("%d", self.Depth) .. "층"
+if self.AscensionLevel > 0 then
+	floorText = floorText .. " · 승천" .. string.format("%d", self.AscensionLevel)
+end
+self:SetText("/ui/DefaultGroup/CombatHud/TopBar/Floor", floorText)
+self:SetText("/ui/DefaultGroup/CombatHud/TopBar/Gold", "메소 " .. string.format("%d", self.Gold))`),
+];

tools/deck/cb/reward.mjs

@@ -0,0 +1,55 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const rewardMethods = [
+    method('CardPool', `local pool = {}
+for id, c in pairs(self.Cards) do
+	if c.token ~= true and (c.class == self.SelectedClass or (self.PlayerJob ~= "" and c.class == self.PlayerJob)) then
+		table.insert(pool, id)
+	end
+end
+table.sort(pool)
+return pool`, [], 0, 'any'),
+    method('OfferReward', `self:SetEntityEnabled("/ui/DefaultGroup/CardHand", false)
+self:SetEntityEnabled("/ui/DefaultGroup/DeckHud", false)
+local pool = self:CardPool()
+local byRarity = {}
+for _, id in ipairs(pool) do
+	local r = self.Cards[id].rarity or "normal"
+	if byRarity[r] == nil then byRarity[r] = {} end
+	table.insert(byRarity[r], id)
+end
+self.RewardChoices = {}
+for i = 1, 3 do
+	local roll = math.random(1, 100)
+	local want = "normal"
+	if roll > 95 then want = "legend" elseif roll > 70 then want = "unique" end
+	local bucket = byRarity[want]
+	if bucket == nil or #bucket == 0 then bucket = pool end
+	self.RewardChoices[i] = bucket[math.random(1, #bucket)]
+	self:ApplyRewardVisual(i, self.RewardChoices[i])
+end
+local hud = _EntityService:GetEntityByPath("/ui/DefaultGroup/RewardHud")
+if hud ~= nil then
+	hud.Enable = true
+end`),
+    method('ApplyRewardVisual', `self:ApplyCardFace("/ui/DefaultGroup/RewardHud/Reward" .. tostring(slot), cardId)`, [
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'cardId' },
+    ]),
+    method('PickReward', `if self.CombatOver ~= true or self.RunActive ~= true then
+	return
+end
+if slot ~= 0 and self.RewardChoices ~= nil then
+	local id = self.RewardChoices[slot]
+	if id ~= nil then
+		table.insert(self.RunDeck, id)
+	end
+end
+local hud = _EntityService:GetEntityByPath("/ui/DefaultGroup/RewardHud")
+if hud ~= nil then
+	hud.Enable = false
+end
+self:ShowMap()`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
+];

tools/deck/cb/run.mjs

@@ -0,0 +1,207 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const runMethods = [
+    method('StartRun', `if self.SelectedClass == "magician" then
+	self.PlayerMaxHp = ${CLASSES.magician.maxHp}
+self.RunDeck = { ${CARDS.starterDecks.magician.map(luaStr).join(', ')} }
+elseif self.SelectedClass == "bandit" then
+	self.PlayerMaxHp = ${CLASSES.bandit.maxHp}
+	self.RunDeck = { ${CARDS.starterDecks.bandit.map(luaStr).join(', ')} }
+else
+	self.PlayerMaxHp = ${CLASSES.warrior.maxHp}
+	self.RunDeck = { ${CARDS.starterDecks.warrior.map(luaStr).join(', ')} }
+end
+self.PlayerMaxHp = self.PlayerMaxHp - self:AscStartHpPenalty()
+self.PlayerHp = self.PlayerMaxHp
+self.Gold = 0
+self.Floor = 1
+self.RunLength = ${ACT_COUNT}
+self.RunActive = true
+self.RunRelics = {}
+self.RunPotions = {}
+self.PotionSlots = ${POTIONS.baseSlots}
+${luaPotionsTable(POTIONS.potions)}
+${luaRelicsTable(RELICS.relics)}
+self.RelicPool = { ${RELICS.relicPool.map(luaStr).join(', ')} }
+${luaEnemiesTable(ENEMIES.enemies)}
+self.CurrentNodeId = ""
+self.CurrentEnemyId = ""
+self.PlayerJob = ""
+${luaJobsTable(JOBS)}
+${luaFramesTable()}
+${luaNodeIconsTable()}
+self:GenerateMap()
+self:BindButtons()
+self:AddRelic("${RELICS.startingRelic}")
+self:ApplySoulUnlocks()
+self:RenderPotions()
+self:TeleportToActMap()
+self:ShowMap()`),
+    method('KickCombatCamera', `local cam = nil
+local lp = _UserService.LocalPlayer
+if lp ~= nil then cam = lp.CameraComponent end
+if cam == nil then cam = _CameraService:GetCurrentCameraComponent() end
+if cam ~= nil then cam.ConfineCameraArea = false end
+_TimerService:SetTimerOnce(function()
+	local cc = nil
+	local lp2 = _UserService.LocalPlayer
+	if lp2 ~= nil then cc = lp2.CameraComponent end
+	if cc == nil then cc = _CameraService:GetCurrentCameraComponent() end
+	if cc ~= nil then
+		cc.ZoomRatio = ${CAM.zoomRatio}
+		cc.CameraOffset = Vector2(${CAM.cameraOffsetX}, ${CAM.cameraOffsetY})
+		cc.ScreenOffset = Vector2(${CAM.screenOffsetX}, ${CAM.screenOffsetY})
+		cc.ConfineCameraArea = true
+	end
+end, 0.2)`),
+    method('StartCombat', `self:ShowState("combat")
+self:KickCombatCamera()
+self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/Result", false)
+self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/PotionMenu", false)
+self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/TooltipBox", false)
+self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/DiscardPrompt", false)
+self:SetText("/ui/DefaultGroup/CombatHud/PlayerPanel/Name", self:JobLabel())
+self.MaxEnergy = 3
+self.Turn = 0
+self.PlayerBlock = 0
+self.PlayerStr = 0
+self.PlayerDex = 0
+self.PlayerThorns = 0
+self.PlayerWeak = 0
+self.PlayerVuln = 0
+self.PlayerPowers = {}
+self.FightAttackCount = 0
+self.DmgPopSeq = 0
+self.FirstHpLossDone = false
+self.ClayBlockNext = 0
+self.DiscardSelectRemaining = 0
+self.DiscardSelectTotal = 0
+self.DiscardPostShiv = 0
+self.DiscardShivPerPick = 0
+self.CombatOver = false
+self.DiscardPile = {}
+self.ExhaustPile = {}
+self.Hand = {}
+${luaCardsTable(CARDS.cards)}
+self.DrawPile = {}
+for i = 1, #self.RunDeck do
+	self.DrawPile[i] = self.RunDeck[i]
+end
+self:Shuffle(self.DrawPile)
+self:BuildMonsters()
+self:RenderCombat()
+self:StartPlayerTurn()
+self:ApplyRelics("combatStart")
+self:RenderCombat()`),
+    method('RegisterMonster', `if self.Registered == nil then
+	self.Registered = {}
+end
+local g = group
+if g == nil or g == "" then g = "combat" end
+local mp = mapName
+if mp == nil then mp = "" end
+table.insert(self.Registered, { entity = monster, enemyId = enemyId, group = g, map = mp })`, [
+      { Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'monster' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'enemyId' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'group' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'mapName' },
+    ]),
+    method('BuildMonsters', `self.Monsters = {}
+local g = "combat"
+local node = self.MapNodes[self.CurrentNodeId]
+if node ~= nil and node.type ~= nil then g = node.type end
+local pmap = ""
+local lp = _UserService.LocalPlayer
+if lp ~= nil and lp.CurrentMapName ~= nil then pmap = lp.CurrentMapName end
+local reg = self.Registered or {}
+for i = 1, #reg do
+	if reg[i].entity ~= nil and isvalid(reg[i].entity) then
+		reg[i].entity:SetVisible(false)
+	end
+end
+local byGroup = {}
+for i = 1, #reg do
+	local r = reg[i]
+	if r.entity ~= nil and isvalid(r.entity) and (r.map == nil or r.map == "" or pmap == "" or r.map == pmap) then
+		local gg = r.group
+		if gg == nil or gg == "" then gg = "combat" end
+		if byGroup[gg] == nil then byGroup[gg] = {} end
+		local x = 0
+		if r.entity.TransformComponent ~= nil then
+			x = r.entity.TransformComponent.WorldPosition.x
+		end
+		table.insert(byGroup[gg], { entity = r.entity, enemyId = r.enemyId, x = x })
+	end
+end
+-- 노드 타입별 랜덤 구성: 일반 1~3 / 엘리트 1+일반0~2 / 보스 1
+local chosen = {}
+local function takeFrom(key, k)
+	local src = byGroup[key] or {}
+	local pool = {}
+	for i = 1, #src do pool[i] = src[i] end
+	self:Shuffle(pool)
+	local taken = 0
+	for i = 1, #pool do
+		if taken >= k then break end
+		table.insert(chosen, pool[i])
+		taken = taken + 1
+	end
+end
+if g == "boss" then
+	takeFrom("boss", 1)
+elseif g == "elite" then
+	takeFrom("elite", 1)
+	takeFrom("combat", math.random(0, 2))
+else
+	takeFrom("combat", math.random(1, 3))
+end
+if #chosen == 0 then takeFrom(g, 1) end
+if #chosen == 0 then takeFrom("combat", 1) end
+table.sort(chosen, function(a, b) return a.x < b.x end)
+local mult = 1 + (self.Floor - 1) * 0.45
+if g == "elite" or g == "boss" then
+	mult = mult + self:AscEliteBonus()
+end
+local n = #chosen
+if n > ${MAX_MONSTERS} then n = ${MAX_MONSTERS} end
+for i = 1, n do
+	local item = chosen[i]
+	local e = self.Enemies[item.enemyId]
+	if e == nil then e = { name = item.enemyId, maxHp = 10, intents = { { kind = "Attack", value = 5 } } } end
+	local intents = {}
+	for k = 1, #e.intents do
+		local v = e.intents[k].value or 0
+		if e.intents[k].kind == "Attack" then
+			v = math.floor(v * mult * self:AscAtkMult())
+		elseif e.intents[k].kind ~= "Debuff" then
+			v = math.floor(v * mult)
+		end
+		intents[k] = { kind = e.intents[k].kind, value = v, effect = e.intents[k].effect, card = e.intents[k].card, count = e.intents[k].count }
+	end
+	local maxHp = math.floor(e.maxHp * mult * self:AscHpMult())
+	local hitClip = nil
+	local standClip = nil
+	if item.entity.StateAnimationComponent ~= nil then
+		pcall(function()
+			hitClip = item.entity.StateAnimationComponent.ActionSheet["hit"]
+			standClip = item.entity.StateAnimationComponent.ActionSheet["stand"]
+		end)
+	end
+	local startIdx = 1
+	if #intents > 0 then startIdx = math.random(1, #intents) end
+	self.Monsters[i] = { entity = item.entity, enemyId = item.enemyId, name = e.name,
+		hp = maxHp, maxHp = maxHp, block = 0, str = 0, weak = 0, vuln = 0, poison = 0,
+		hitClip = hitClip, standClip = standClip, motionBusy = false,
+		intents = intents, intentIdx = startIdx, alive = true, slot = i }
+	self:ReviveMonsterEntity(item.entity)
+	self:PositionMonsterSlot(i)
+end
+self.TargetIndex = 1`),
+    method('ReviveMonsterEntity', `if monster == nil or not isvalid(monster) then
+	return
+end
+monster:SetEnable(true)
+monster:SetVisible(true)`, [{ Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'monster' }]),
+];

tools/deck/cb/runend.mjs

@@ -0,0 +1,37 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const runEndMethods = [
+    method('TeleportToActMap', `local maps = { ${ACT_MAPS.map((m) => `"${m}"`).join(', ')} }
+local target = maps[self.Floor]
+if target == nil then
+	return
+end
+local lp = _UserService.LocalPlayer
+if lp == nil then
+	return
+end
+if lp.CurrentMapName == target then
+	return
+end
+_TeleportService:TeleportToMapPosition(lp, Vector3(-6, 0.03, 0), target)`),
+    method('ShowResult', `self:SetText("/ui/DefaultGroup/CombatHud/Result", text)
+local entity = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/Result")
+if entity ~= nil then
+	entity.Enable = true
+end`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'text' }]),
+    method('EndRun', `local msg = text
+if text == "런 클리어!" and self.AscensionLevel >= self.AscensionUnlocked and self.AscensionUnlocked < 10 then
+	self.AscensionUnlocked = self.AscensionUnlocked + 1
+	local lp = _UserService.LocalPlayer
+	if lp ~= nil then
+		self:SaveAscension(self.AscensionUnlocked, lp.PlayerComponent.UserId)
+	end
+	self:RenderAscension()
+	msg = "런 클리어! 승천 " .. string.format("%d", self.AscensionUnlocked) .. " 해금!"
+end
+self:ShowResult(msg)
+self.RunActive = false
+_TimerService:SetTimerOnce(function() self:ShowLobby() end, 4)`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'text' }]),
+];

tools/deck/cb/shop.mjs

@@ -0,0 +1,173 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const shopMethods = [
+    method('ShowShop', `local pool = self:CardPool()
+self.ShopChoices = {}
+self.ShopBought = { false, false, false }
+for i = 1, 3 do
+	self.ShopChoices[i] = pool[math.random(1, #pool)]
+end
+self.ShopRelic = self.RelicPool[math.random(1, #self.RelicPool)]
+self.ShopRelicBought = false
+local pkeys = {}
+for pid, _ in pairs(self.Potions) do
+	table.insert(pkeys, pid)
+end
+table.sort(pkeys)
+self.ShopPotion = pkeys[math.random(1, #pkeys)]
+self.ShopPotionBought = false
+self:RenderShop()
+self:ShowState("shop")`),
+    method('RenderShop', `self:SetText("/ui/DefaultGroup/ShopHud/Gold", "메소 " .. string.format("%d", self.Gold))
+for i = 1, 3 do
+	local cid = self.ShopChoices[i]
+	local c = self.Cards[cid]
+	local base = "/ui/DefaultGroup/ShopHud/Card" .. tostring(i)
+	if c ~= nil then
+		self:ApplyCardFace(base, cid)
+		self:SetText(base .. "/Price", string.format("%d", ${CARD_PRICE}) .. " 메소")
+		local e = _EntityService:GetEntityByPath(base)
+		if e ~= nil and e.SpriteGUIRendererComponent ~= nil then
+			if self.ShopBought[i] == true then
+				e.SpriteGUIRendererComponent.Color = Color(0.2, 0.22, 0.26, 0.6)
+			end
+		end
+	end
+end
+local rr = self.Relics[self.ShopRelic]
+if rr ~= nil then
+	self:SetText("/ui/DefaultGroup/ShopHud/Relic/Label", rr.name .. " — " .. rr.desc)
+	self:SetText("/ui/DefaultGroup/ShopHud/Relic/Price", string.format("%d", ${RELIC_PRICE}) .. " 메소")
+	local re = _EntityService:GetEntityByPath("/ui/DefaultGroup/ShopHud/Relic")
+	if re ~= nil and re.SpriteGUIRendererComponent ~= nil then
+		if self.ShopRelicBought == true then
+			re.SpriteGUIRendererComponent.Color = Color(0.2, 0.22, 0.26, 0.6)
+		else
+			re.SpriteGUIRendererComponent.Color = Color(0.7, 0.55, 0.85, 1)
+		end
+	end
+end
+local pp = self.Potions[self.ShopPotion]
+if pp ~= nil then
+	self:SetText("/ui/DefaultGroup/ShopHud/Potion/Label", pp.name .. " — " .. pp.desc)
+	self:SetText("/ui/DefaultGroup/ShopHud/Potion/Price", string.format("%d", ${POTIONS.shopPrice}) .. " 메소")
+	local pe = _EntityService:GetEntityByPath("/ui/DefaultGroup/ShopHud/Potion")
+	if pe ~= nil and pe.SpriteGUIRendererComponent ~= nil then
+		if self.ShopPotionBought == true then
+			pe.SpriteGUIRendererComponent.Color = Color(0.2, 0.22, 0.26, 0.6)
+		else
+			pe.SpriteGUIRendererComponent.Color = Color(0.45, 0.7, 0.55, 1)
+		end
+	end
+end`),
+    method('BuyRelic', `if self.ShopRelicBought == true then
+	return
+end
+if self.Gold < ${RELIC_PRICE} then
+	return
+end
+self.Gold = self.Gold - ${RELIC_PRICE}
+self:AddRelic(self.ShopRelic)
+self.ShopRelicBought = true
+self:RenderShop()
+self:RenderRun()`),
+    method('BuyPotion', `if self.ShopPotionBought == true then
+	return
+end
+if self.Gold < ${POTIONS.shopPrice} then
+	return
+end
+if self.RunPotions ~= nil and #self.RunPotions >= self.PotionSlots then
+	self:Toast("물약 슬롯이 가득 찼습니다")
+	return
+end
+if self:AddPotion(self.ShopPotion) == true then
+	self.Gold = self.Gold - ${POTIONS.shopPrice}
+	self.ShopPotionBought = true
+end
+self:RenderShop()
+self:RenderRun()`),
+    method('BuyCard', `if self.ShopBought == nil or self.ShopBought[slot] == true then
+	return
+end
+if self.Gold < ${CARD_PRICE} then
+	return
+end
+self.Gold = self.Gold - ${CARD_PRICE}
+table.insert(self.RunDeck, self.ShopChoices[slot])
+self.ShopBought[slot] = true
+self:RenderShop()
+self:RenderRun()`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
+    method('ShowRest', `local old = self.PlayerHp
+self.PlayerHp = self.PlayerHp + ${REST_HEAL}
+if self.PlayerHp > self.PlayerMaxHp then
+	self.PlayerHp = self.PlayerMaxHp
+end
+local healed = self.PlayerHp - old
+self:SetText("/ui/DefaultGroup/RestHud/Info", "HP " .. string.format("%d", old) .. " → " .. string.format("%d", self.PlayerHp) .. " (+" .. string.format("%d", healed) .. ")")
+self:RenderCombat()
+self:ShowState("rest")`),
+    method('LeaveNode', `local s = _EntityService:GetEntityByPath("/ui/DefaultGroup/ShopHud")
+if s ~= nil then
+	s.Enable = false
+end
+local r = _EntityService:GetEntityByPath("/ui/DefaultGroup/RestHud")
+if r ~= nil then
+	r.Enable = false
+end
+local t = _EntityService:GetEntityByPath("/ui/DefaultGroup/TreasureHud")
+if t ~= nil then
+	t.Enable = false
+end
+self:ShowMap()`),
+    method('ShowTreasure', `self.ChestOpened = false
+local chest = _EntityService:GetEntityByPath("/ui/DefaultGroup/TreasureHud/Chest")
+if chest ~= nil then
+	if chest.SpriteGUIRendererComponent ~= nil then
+		chest.SpriteGUIRendererComponent.ImageRUID = "${CHEST_CLOSED_RUID}"
+	end
+	if chest.UITransformComponent ~= nil then
+		chest.UITransformComponent.anchoredPosition = Vector2(0, 40)
+	end
+end
+self:SetEntityEnabled("/ui/DefaultGroup/TreasureHud/Reward", false)
+self:SetEntityEnabled("/ui/DefaultGroup/TreasureHud/Hint", true)
+self:ShowState("treasure")`),
+    method('OpenChest', `if self.ChestOpened == true then
+	return
+end
+self.ChestOpened = true
+self:SetEntityEnabled("/ui/DefaultGroup/TreasureHud/Hint", false)
+local chest = _EntityService:GetEntityByPath("/ui/DefaultGroup/TreasureHud/Chest")
+local steps = { 10, -10, 8, -8, 5, 0 }
+for i = 1, #steps do
+	local dx = steps[i]
+	_TimerService:SetTimerOnce(function()
+		if chest ~= nil and isvalid(chest) and chest.UITransformComponent ~= nil then
+			chest.UITransformComponent.anchoredPosition = Vector2(dx, 40)
+		end
+	end, 0.08 * i)
+end
+_TimerService:SetTimerOnce(function()
+	if chest ~= nil and isvalid(chest) and chest.SpriteGUIRendererComponent ~= nil then
+		chest.SpriteGUIRendererComponent.ImageRUID = "${CHEST_OPEN_RUID}"
+	end
+	local g = 40 + math.random(0, 20)
+	local nid = self:PickNewRelic()
+	local msg = ""
+	if nid ~= "" then
+		self:AddRelic(nid)
+		local nr = self.Relics[nid]
+		msg = "유물 획득: " .. nr.name .. " · 메소 +" .. tostring(g)
+	else
+		g = g + 30
+		msg = "메소 +" .. tostring(g)
+	end
+	self.Gold = self.Gold + g
+	self:RenderRun()
+	self:SetText("/ui/DefaultGroup/TreasureHud/Reward", msg)
+	self:SetEntityEnabled("/ui/DefaultGroup/TreasureHud/Reward", true)
+end, 0.55)`),
+];

tools/deck/cb/soul.mjs

@@ -0,0 +1,114 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const soulMethods = [
+    method('ShowSoulShop', `self:RenderSoulLabel()
+self:RenderSoulShop()
+self:BindSoulShopButtons()
+self:SetEntityEnabled("/ui/DefaultGroup/SoulShopHud", true)`),
+    method('CloseSoulShop', `self:SetEntityEnabled("/ui/DefaultGroup/SoulShopHud", false)`),
+    method('ReqLoadSouls', `local ds = _DataStorageService:GetUserDataStorage(userId)
+local e1, pts = ds:GetAndWait("soulPoints")
+local e2, unl = ds:GetAndWait("soulUnlocks")
+local p = 0
+if e1 == 0 and pts ~= nil and pts ~= "" then p = tonumber(pts) or 0 end
+local u = ""
+if e2 == 0 and unl ~= nil then u = unl end
+self:RecvSouls(p, u, userId)`, [{ Type: "string", DefaultValue: null, SyncDirection: 0, Attributes: [], Name: "userId" }], 5),
+    method('RecvSouls', `self.SoulPoints = p
+self.SoulUnlocks = {}
+if u ~= nil and u ~= "" then
+	for key in string.gmatch(u, "([^,]+)") do
+		self.SoulUnlocks[key] = true
+	end
+end
+self:RenderSoulLabel()`, [{ Type: "number", DefaultValue: null, SyncDirection: 0, Attributes: [], Name: "p" }, { Type: "string", DefaultValue: null, SyncDirection: 0, Attributes: [], Name: "u" }, { Type: "string", DefaultValue: null, SyncDirection: 0, Attributes: [], Name: "userId" }], 6),
+    method('SaveSouls', `local ds = _DataStorageService:GetUserDataStorage(userId)
+ds:SetAndWait("soulPoints", tostring(p))
+ds:SetAndWait("soulUnlocks", u)`, [{ Type: "number", DefaultValue: null, SyncDirection: 0, Attributes: [], Name: "p" }, { Type: "string", DefaultValue: null, SyncDirection: 0, Attributes: [], Name: "u" }, { Type: "string", DefaultValue: null, SyncDirection: 0, Attributes: [], Name: "userId" }], 5),
+    method('SerializeUnlocks', `local parts = {}
+if self.SoulUnlocks ~= nil then
+	for k, v in pairs(self.SoulUnlocks) do
+		if v == true then table.insert(parts, k) end
+	end
+end
+return table.concat(parts, ",")`, [], 0, 'string'),
+    method('AwardSouls', `self.SoulPoints = (self.SoulPoints or 0) + n
+local lp = _UserService.LocalPlayer
+if lp ~= nil then
+	self:SaveSouls(self.SoulPoints, self:SerializeUnlocks(), lp.PlayerComponent.UserId)
+end
+self:RenderSoulLabel()`, [{ Type: "number", DefaultValue: null, SyncDirection: 0, Attributes: [], Name: "n" }]),
+    method('BuySoulUnlock', `local d = nil
+if self.SoulShopDef ~= nil then d = self.SoulShopDef[slot] end
+if d == nil then return end
+if self.SoulUnlocks ~= nil and self.SoulUnlocks[d.key] == true then
+	self:Toast("이미 보유 중입니다")
+	return
+end
+if (self.SoulPoints or 0) < d.cost then
+	self:Toast("영혼이 부족합니다")
+	return
+end
+self.SoulPoints = self.SoulPoints - d.cost
+if self.SoulUnlocks == nil then self.SoulUnlocks = {} end
+self.SoulUnlocks[d.key] = true
+local lp = _UserService.LocalPlayer
+if lp ~= nil then
+	self:SaveSouls(self.SoulPoints, self:SerializeUnlocks(), lp.PlayerComponent.UserId)
+end
+self:Toast(d.name .. " 해금!")
+self:RenderSoulLabel()
+self:RenderSoulShop()`, [{ Type: "number", DefaultValue: null, SyncDirection: 0, Attributes: [], Name: "slot" }]),
+    method('RenderSoulShop', `local defs = self.SoulShopDef or {}
+for i = 1, 4 do
+	local base = "/ui/DefaultGroup/SoulShopHud/Item" .. tostring(i)
+	local d = defs[i]
+	if d == nil then
+		self:SetEntityEnabled(base, false)
+	else
+		self:SetEntityEnabled(base, true)
+		self:SetText(base .. "/Name", d.name)
+		self:SetText(base .. "/Desc", d.desc)
+		local owned = self.SoulUnlocks ~= nil and self.SoulUnlocks[d.key] == true
+		if owned then
+			self:SetText(base .. "/Status", "보유 중")
+		elseif (self.SoulPoints or 0) >= d.cost then
+			self:SetText(base .. "/Status", tostring(d.cost) .. " 영혼 · 구매")
+		else
+			self:SetText(base .. "/Status", tostring(d.cost) .. " 영혼 · 부족")
+		end
+	end
+end`),
+    method('BindSoulShopButtons', `if self.SoulShopBound == true then
+	return
+end
+self.SoulShopBound = true
+for i = 1, 4 do
+	local idx = i
+	local e = _EntityService:GetEntityByPath("/ui/DefaultGroup/SoulShopHud/Item" .. tostring(i))
+	if e ~= nil and e.ButtonComponent ~= nil then
+		e:ConnectEvent(ButtonClickEvent, function() self:BuySoulUnlock(idx) end)
+	end
+end`),
+    method('ApplySoulUnlocks', `if self.SoulUnlocks == nil then return end
+if self.SoulUnlocks["meso"] == true then self.Gold = self.Gold + 60 end
+if self.SoulUnlocks["hp"] == true then
+	self.PlayerMaxHp = self.PlayerMaxHp + 15
+	self.PlayerHp = self.PlayerMaxHp
+end
+if self.SoulUnlocks["trim"] == true then
+	for i = 1, #self.RunDeck do
+		local cid = self.RunDeck[i]
+		if cid == "Defend" or cid == "MagicGuard" or cid == "DarkSight" then
+			table.remove(self.RunDeck, i)
+			break
+		end
+	end
+end
+if self.SoulUnlocks["relic"] == true then
+	local nid = self:PickNewRelic()
+	if nid ~= "" then self:AddRelic(nid) end
+end`),
+];

tools/deck/cb/state.mjs

@@ -0,0 +1,193 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const stateMethods = [
+    method('HideGameHud', `self:SetEntityEnabled("/ui/DefaultGroup/Button_Attack", false)
+self:SetEntityEnabled("/ui/DefaultGroup/Button_Jump", false)
+self:SetEntityEnabled("/ui/DefaultGroup/UIJoystick", false)
+self:SetEntityEnabled("/ui/DefaultGroup/DeckHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/CardHand", false)
+self:SetEntityEnabled("/ui/DefaultGroup/CombatHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/RewardHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/MapHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/ShopHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/RestHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/TreasureHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/JobChoiceHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/JobSelectHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/DeckInspectHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/DeckAllHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/LobbyHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/BoardHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/SoulShopHud", false)`),
+    method('ShowState', `self:HideGameHud()
+self:SetEntityEnabled("/ui/DefaultGroup/MainMenu", state == "menu")
+self:SetEntityEnabled("/ui/DefaultGroup/CharacterSelectHud", state == "charselect")
+self:SetEntityEnabled("/ui/DefaultGroup/LobbyHud", state == "lobby")
+if state == "map" then
+	self:SetEntityEnabled("/ui/DefaultGroup/MapHud", true)
+elseif state == "combat" then
+	self:SetEntityEnabled("/ui/DefaultGroup/CombatHud", true)
+	self:SetEntityEnabled("/ui/DefaultGroup/DeckHud", true)
+	self:SetEntityEnabled("/ui/DefaultGroup/CardHand", true)
+elseif state == "shop" then
+	self:SetEntityEnabled("/ui/DefaultGroup/ShopHud", true)
+elseif state == "rest" then
+	self:SetEntityEnabled("/ui/DefaultGroup/RestHud", true)
+elseif state == "treasure" then
+	self:SetEntityEnabled("/ui/DefaultGroup/TreasureHud", true)
+end`, [{ Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'state' }]),
+    method('ShowMainMenu', `self.SelectedClass = ""
+self:RenderAscension()
+self:ShowState("menu")
+self:SetText("/ui/DefaultGroup/MainMenu/Title", "메이플 덱 어드벤처")
+self:SetText("/ui/DefaultGroup/MainMenu/Subtitle", "캐릭터를 고르고 덱을 만들어 모험을 시작하세요")
+self:SetText("/ui/DefaultGroup/MainMenu/NewGameButton", "새 게임")
+self:BindMenuButtons()`),
+    method('BindMenuButtons', `local buttonEntity = _EntityService:GetEntityByPath("/ui/DefaultGroup/MainMenu/NewGameButton")
+if buttonEntity ~= nil and buttonEntity.ButtonComponent ~= nil then
+	if self.NewGameHandler ~= nil then
+		buttonEntity:DisconnectEvent(ButtonClickEvent, self.NewGameHandler)
+		self.NewGameHandler = nil
+	end
+	self.NewGameHandler = buttonEntity:ConnectEvent(ButtonClickEvent, function() self:ShowCharacterSelect() end)
+end
+local warrior = _EntityService:GetEntityByPath("/ui/DefaultGroup/CharacterSelectHud/WarriorButton")
+if warrior ~= nil and warrior.ButtonComponent ~= nil then
+	if self.WarriorSelectHandler ~= nil then
+		warrior:DisconnectEvent(ButtonClickEvent, self.WarriorSelectHandler)
+		self.WarriorSelectHandler = nil
+	end
+	self.WarriorSelectHandler = warrior:ConnectEvent(ButtonClickEvent, function() self:SelectClass("warrior") end)
+end
+local thief = _EntityService:GetEntityByPath("/ui/DefaultGroup/CharacterSelectHud/ThiefButton")
+if thief ~= nil and thief.ButtonComponent ~= nil then
+	if self.ThiefSelectHandler ~= nil then
+		thief:DisconnectEvent(ButtonClickEvent, self.ThiefSelectHandler)
+		self.ThiefSelectHandler = nil
+	end
+	self.ThiefSelectHandler = thief:ConnectEvent(ButtonClickEvent, function() self:SelectClass("bandit") end)
+end
+local mage = _EntityService:GetEntityByPath("/ui/DefaultGroup/CharacterSelectHud/MageButton")
+if mage ~= nil and mage.ButtonComponent ~= nil then
+	if self.MageSelectHandler ~= nil then
+		mage:DisconnectEvent(ButtonClickEvent, self.MageSelectHandler)
+		self.MageSelectHandler = nil
+	end
+	self.MageSelectHandler = mage:ConnectEvent(ButtonClickEvent, function() self:SelectClass("magician") end)
+end
+local allDeckClose = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud/Close")
+if allDeckClose ~= nil and allDeckClose.ButtonComponent ~= nil then
+	if self.AllDeckCloseHandler ~= nil then
+		allDeckClose:DisconnectEvent(ButtonClickEvent, self.AllDeckCloseHandler)
+		self.AllDeckCloseHandler = nil
+	end
+	self.AllDeckCloseHandler = allDeckClose:ConnectEvent(ButtonClickEvent, function() self:CloseAllDeck() end)
+end
+self:BindClassDeckTabs()
+local start = _EntityService:GetEntityByPath("/ui/DefaultGroup/CharacterSelectHud/StartButton")
+if start ~= nil and start.ButtonComponent ~= nil then
+	if self.StartGameHandler ~= nil then
+		start:DisconnectEvent(ButtonClickEvent, self.StartGameHandler)
+		self.StartGameHandler = nil
+	end
+	self.StartGameHandler = start:ConnectEvent(ButtonClickEvent, function() self:StartNewGame() end)
+end
+local charBack = _EntityService:GetEntityByPath("/ui/DefaultGroup/CharacterSelectHud/BackButton")
+if charBack ~= nil and charBack.ButtonComponent ~= nil then
+	if self.CharBackHandler ~= nil then
+		charBack:DisconnectEvent(ButtonClickEvent, self.CharBackHandler)
+		self.CharBackHandler = nil
+	end
+	self.CharBackHandler = charBack:ConnectEvent(ButtonClickEvent, function() self:ShowLobby() end)
+end
+local ascMinus = _EntityService:GetEntityByPath("/ui/DefaultGroup/MainMenu/AscMinus")
+if ascMinus ~= nil and ascMinus.ButtonComponent ~= nil then
+	if self.AscMinusHandler ~= nil then
+		ascMinus:DisconnectEvent(ButtonClickEvent, self.AscMinusHandler)
+		self.AscMinusHandler = nil
+	end
+	self.AscMinusHandler = ascMinus:ConnectEvent(ButtonClickEvent, function() self:AdjustAscension(-1) end)
+end
+local ascPlus = _EntityService:GetEntityByPath("/ui/DefaultGroup/MainMenu/AscPlus")
+if ascPlus ~= nil and ascPlus.ButtonComponent ~= nil then
+	if self.AscPlusHandler ~= nil then
+		ascPlus:DisconnectEvent(ButtonClickEvent, self.AscPlusHandler)
+		self.AscPlusHandler = nil
+	end
+	self.AscPlusHandler = ascPlus:ConnectEvent(ButtonClickEvent, function() self:AdjustAscension(1) end)
+end`),
+    method('ShowLobby', `self.SelectedClass = ""
+self:RenderAscension()
+self:RenderSoulLabel()
+self:ShowState("lobby")
+self:SetEntityEnabled("/ui/DefaultGroup/BoardHud", false)
+self:SetEntityEnabled("/ui/DefaultGroup/SoulShopHud", false)
+self:BindLobbyButtons()
+self:BindMenuButtons()
+self:GoLobbyMap()`),
+    method('GoLobbyMap', `self.LobbyTpTries = 0
+local eventId = 0
+local function go()
+	self.LobbyTpTries = self.LobbyTpTries + 1
+	local lp = _UserService.LocalPlayer
+	if lp ~= nil then
+		if lp.CurrentMapName ~= "${LOBBY_MAP}" then
+			_TeleportService:TeleportToMapPosition(lp, ${LOBBY_SPAWN}, "${LOBBY_MAP}")
+		end
+		_TimerService:ClearTimer(eventId)
+	elseif self.LobbyTpTries > 50 then
+		_TimerService:ClearTimer(eventId)
+	end
+end
+eventId = _TimerService:SetTimerRepeat(go, 0.1)`),
+    method('OnLobbyNpcInteract', `if self.RunActive == true then
+	return
+end
+if id == "run" then
+	self:ShowCharacterSelect()
+elseif id == "codex" then
+	self:ShowCodex()
+elseif id == "shop" then
+	self:ShowSoulShop()
+elseif id == "board" then
+	self:ShowBoard()
+end`, [{ Type: 'string', DefaultValue: '""', SyncDirection: 0, Attributes: [], Name: 'id' }]),
+    method('RenderSoulLabel', `local s = self.SoulPoints or 0
+self:SetText("/ui/DefaultGroup/LobbyHud/SoulLabel", "영혼 " .. string.format("%d", s))
+self:SetText("/ui/DefaultGroup/SoulShopHud/Souls", "영혼 " .. string.format("%d", s))`),
+    method('BindLobbyButtons', `if self.LobbyBound == true then
+	return
+end
+self.LobbyBound = true
+local function bindClick(path, fn)
+	local e = _EntityService:GetEntityByPath(path)
+	if e ~= nil and e.ButtonComponent ~= nil then
+		e:ConnectEvent(ButtonClickEvent, fn)
+	end
+end
+bindClick("/ui/DefaultGroup/LobbyHud/AscMinus", function() self:AdjustAscension(-1) end)
+bindClick("/ui/DefaultGroup/LobbyHud/AscPlus", function() self:AdjustAscension(1) end)
+bindClick("/ui/DefaultGroup/BoardHud/Close", function() self:CloseBoard() end)
+bindClick("/ui/DefaultGroup/SoulShopHud/Close", function() self:CloseSoulShop() end)`),
+    method('ShowCodex', `self.CodexMode = true
+self.ClassDeckMode = true
+local close = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud/Close")
+if close ~= nil and close.ButtonComponent ~= nil then
+	if self.AllDeckCloseHandler ~= nil then
+		close:DisconnectEvent(ButtonClickEvent, self.AllDeckCloseHandler)
+	end
+	self.AllDeckCloseHandler = close:ConnectEvent(ButtonClickEvent, function() self:CloseAllDeck() end)
+end
+self:BindClassDeckTabs()
+self:SetEntityEnabled("/ui/DefaultGroup/LobbyHud", false)
+self:SetClassDeckTab("warrior")
+local hud = _EntityService:GetEntityByPath("/ui/DefaultGroup/DeckAllHud")
+if hud ~= nil then
+	hud.Enable = true
+end
+self:RenderAllDeck()`),
+    method('ShowBoard', `self:SetEntityEnabled("/ui/DefaultGroup/BoardHud", true)`),
+    method('CloseBoard', `self:SetEntityEnabled("/ui/DefaultGroup/BoardHud", false)`),
+];

tools/deck/cb/tooltip.mjs

@@ -0,0 +1,115 @@
+import { method, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN } from '../lib/codeblock.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, CARDFRAMES, RARITIES, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, POTIONS, luaSoulShopTable, frameRuid, luaFramesTable, luaNodeIconsTable, luaRelicsTable, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+
+export const tooltipMethods = [
+    method('BuildCardKeywordTooltip', `if c == nil then
+	return ""
+end
+local lines = {}
+local function add(name, desc)
+	for i = 1, #lines do
+		if string.find(lines[i], name .. ":", 1, true) == 1 then
+			return
+		end
+	end
+	table.insert(lines, name .. ": " .. desc)
+end
+local cardDesc = c.desc or ""
+if c.sly == true or string.find(cardDesc, "교활", 1, true) ~= nil then
+	add("교활", "버려지면 비용 없이 사용됩니다.")
+end
+if c.retain == true or string.find(cardDesc, "보존", 1, true) ~= nil then
+	add("보존", "턴 종료 시 버려지지 않고 손에 남습니다.")
+end
+if c.dex ~= nil and c.dex > 0 or string.find(cardDesc, "민첩", 1, true) ~= nil then
+	add("민첩", "카드로 얻는 방어도가 증가합니다.")
+end
+if c.thorns ~= nil and c.thorns > 0 or string.find(cardDesc, "가시", 1, true) ~= nil then
+	add("가시", "피해를 받으면 공격자에게 반사 피해를 줍니다.")
+end
+if c.exhaust == true or string.find(cardDesc, "소멸.", 1, true) ~= nil then
+	add("소멸", "사용 후 소멸 덱으로 이동해 이번 전투 동안 다시 나오지 않습니다.")
+end
+if string.find(cardDesc, "선천성", 1, true) ~= nil then
+	add("선천성", "전투 시작 시 손패에 들어옵니다.")
+end
+if c.vuln ~= nil and c.vuln > 0 then
+	add("취약", "받는 공격 피해가 50% 증가합니다.")
+end
+if c.weak ~= nil and c.weak > 0 then
+	add("약화", "주는 공격 피해가 25% 감소합니다.")
+end
+if c.poison ~= nil and c.poison > 0 then
+	add("중독", "턴 시작 시 체력을 잃고 수치가 1 감소합니다.")
+end
+if c.pierce == true then
+	add("관통", "방어도를 무시하고 피해를 줍니다.")
+end
+if c.aoe == true then
+	add("전체", "모든 적에게 적용됩니다.")
+end
+if c.kind == "Power" then
+	add("파워", "사용하면 전투 동안 지속 효과로 남습니다.")
+end
+if c.unplayable == true then
+	add("저주", "사용할 수 없고 손패를 방해합니다.")
+end
+local out = ""
+for i = 1, #lines do
+	if i > 1 then out = out .. "\\n" end
+	out = out .. lines[i]
+end
+return out`, [{ Type: 'any', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'c' }], 0, 'string'),
+    method('HoverCard', `if self.DragSlot ~= nil and self.DragSlot > 0 then
+	return
+end
+local cardId = self.Hand[slot]
+if cardId == nil then
+	return
+end
+local e = _EntityService:GetEntityByPath("/ui/DefaultGroup/CardHand/Card" .. tostring(slot))
+local tx = 0
+if e ~= nil and e.UITransformComponent ~= nil then
+	tx = e.UITransformComponent.anchoredPosition.x
+	e.UITransformComponent.UIScale = Vector3(1.3, 1.3, 1)
+end
+local c = self.Cards[cardId]
+if c ~= nil then
+	local tip = self:BuildCardKeywordTooltip(c)
+	if tip ~= "" then
+		local tipX = tx + 270
+		if tx > 180 then tipX = tx - 270 end
+		if tipX > 760 then tipX = tx - 270 end
+		if tipX < -760 then tipX = tx + 270 end
+		self:ShowTooltipAt("키워드", tip, tipX, 90)
+	else
+		self:HideTooltip()
+	end
+end`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
+    method('UnhoverCard', `local e = _EntityService:GetEntityByPath("/ui/DefaultGroup/CardHand/Card" .. tostring(slot))
+if e ~= nil and e.UITransformComponent ~= nil then
+	e.UITransformComponent.UIScale = Vector3(1, 1, 1)
+end
+self:HideTooltip()`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
+    method('ShowTooltip', `self:ShowTooltipAt(name, desc, x, 400)`, [
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'name' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'desc' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'x' },
+    ]),
+    method('ShowTooltipAt', `self:SetText("/ui/DefaultGroup/CombatHud/TooltipBox/Name", name)
+self:SetText("/ui/DefaultGroup/CombatHud/TooltipBox/Desc", desc)
+local e = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/TooltipBox")
+if e ~= nil then
+	if e.UITransformComponent ~= nil then
+		e.UITransformComponent.anchoredPosition = Vector2(x, y)
+	end
+	e.Enable = true
+end`, [
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'name' },
+      { Type: 'string', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'desc' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'x' },
+      { Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'y' },
+    ]),
+    method('HideTooltip', `self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/TooltipBox", false)`),
+];

tools/deck/hud/board.mjs

@@ -0,0 +1,58 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildBoard() {
+  const board = [];
+  let brdId = 0;
+  const boardRoot = entity({
+    id: guid('brd', brdId++),
+    path: '/ui/DefaultGroup/BoardHud',
+    modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 14,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.05, g: 0.06, b: 0.09, a: 0.95 }, type: 1, raycast: true }),
+    ],
+  });
+  boardRoot.jsonString.enable = false;
+  board.push(boardRoot);
+  board.push(entity({
+    id: guid('brd', brdId++),
+    path: '/ui/DefaultGroup/BoardHud/Title',
+    modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 700, y: 60 }, pos: { x: 0, y: 400 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '게시판', fontSize: 44, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  board.push(entity({
+    id: guid('brd', brdId++),
+    path: '/ui/DefaultGroup/BoardHud/Body',
+    modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1100, y: 520 }, pos: { x: 0, y: 20 } }),
+      sprite({ color: { r: 0.1, g: 0.12, b: 0.16, a: 0.9 }, type: 1 }),
+      text({ value: '· 카드는 직업/등급에 따라 보상 확률이 다릅니다.\n· 몬스터는 매 턴 정해진 행동 중 하나를 무작위로 합니다.\n· 일부 몬스터는 덱에 저주 카드(상처/화상)를 넣습니다.\n· 손패는 최대 10장, 초과분은 자동으로 버려집니다.\n· 2차 전직 후 보스를 잡으면 영혼이 쌓입니다.\n· 영혼은 상인 NPC에서 덱빌딩 해금에 사용합니다.', fontSize: 24, bold: false, color: { r: 0.86, g: 0.9, b: 0.94, a: 1 }, alignment: 0 }),
+    ],
+  }));
+  board.push(entity({
+    id: guid('brd', brdId++),
+    path: '/ui/DefaultGroup/BoardHud/Close',
+    modelId: 'uibutton', entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 2,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 200, y: 60 }, pos: { x: 0, y: -380 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.2, g: 0.24, b: 0.3, a: 1 }, type: 1, raycast: true }),
+      button(),
+      text({ value: '닫기', fontSize: 28, bold: true, color: WHITE, alignment: 4 }),
+    ],
+  }));
+  return board;
+}

tools/deck/hud/charselect.mjs

@@ -0,0 +1,171 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildCharSelect() {
+  const select = [];
+  select.push(entity({
+    id: guid('menu', 100),
+    path: '/ui/DefaultGroup/CharacterSelectHud',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 21,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.05, g: 0.07, b: 0.11, a: 1 }, type: 1, raycast: true }),
+    ],
+  }));
+  select.push(entity({
+    id: guid('menu', 190),
+    path: '/ui/DefaultGroup/CharacterSelectHud/OpaqueBackdrop',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: TRANSPARENT, type: 1, raycast: false }),
+    ],
+  }));
+  select.push(entity({
+    id: guid('menu', 101),
+    path: '/ui/DefaultGroup/CharacterSelectHud/Title',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 760, y: 72 }, pos: { x: 0, y: 355 }, align: ALIGN_CENTER }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '\uCE90\uB9AD\uD130 \uC120\uD0DD', fontSize: 42, bold: true, color: GOLD, alignment: 0 }),
+    ],
+  }));
+  select.push(entity({
+    id: guid('menu', 102),
+    path: '/ui/DefaultGroup/CharacterSelectHud/Status',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 2,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 680, y: 44 }, pos: { x: 0, y: 298 }, align: ALIGN_CENTER }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '\uC804\uC0AC\uB97C \uC120\uD0DD\uD558\uACE0 \uC2DC\uC791\uD558\uC138\uC694', fontSize: 22, color: { r: 0.86, g: 0.9, b: 0.94, a: 1 }, alignment: 0 }),
+    ],
+  }));
+  const classCards = [
+    { key: 'Warrior', classId: 'warrior', label: '\uC804\uC0AC', desc: '\uAC15\uD55C \uACF5\uACA9\uACFC \uBC29\uC5B4', x: -360, enabled: true, tint: { r: 0.74, g: 0.32, b: 0.28, a: 1 } },
+    { key: 'Thief', classId: 'bandit', label: '\uB3C4\uC801', desc: '\uB3C5\u00B7\uB2E8\uAC80\u00B7\uB4DC\uB85C\uC6B0', x: 0, enabled: true, tint: { r: 0.26, g: 0.5, b: 0.34, a: 1 } },
+    { key: 'Mage', classId: 'magician', label: '\uB9C8\uBC95\uC0AC', desc: '\uB9C8\uBC95 \uC6D0\uAC70\uB9AC \uB51C\uB7EC', x: 360, enabled: true, tint: { r: 0.3, g: 0.4, b: 0.75, a: 1 } },
+  ];
+  for (let i = 0; i < classCards.length; i++) {
+    const cls = classCards[i];
+    const base = `/ui/DefaultGroup/CharacterSelectHud/${cls.key}Button`;
+    select.push(entity({
+      id: guid('menu', 110 + i),
+      path: base,
+      modelId: 'uibutton',
+      entryId: 'UIButton',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent',
+      displayOrder: 10 + i,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 270, y: 330 }, pos: { x: cls.x, y: 40 }, align: ALIGN_CENTER }),
+        sprite({ color: cls.enabled ? { r: 0.16, g: 0.2, b: 0.26, a: 1 } : { r: 0.11, g: 0.12, b: 0.14, a: 1 }, type: 1, raycast: cls.enabled }),
+        button({ enabled: cls.enabled }),
+      ],
+    }));
+    select.push(entity({
+      id: guid('menu', 200 + i),
+      path: `${base}/Art`,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 0,
+      components: [
+        transform({ parentW: 270, parentH: 330, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 258, y: 318 }, pos: { x: 0, y: 0 } }),
+        sprite({ dataId: CHARS.portraits[cls.classId], color: { r: 1, g: 1, b: 1, a: 1 }, type: 0, raycast: false }),
+      ],
+    }));
+    select.push(entity({
+      id: guid('menu', 210 + i),
+      path: `${base}/NameBanner`,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 1,
+      components: [
+        transform({ parentW: 270, parentH: 330, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 258, y: 60 }, pos: { x: 0, y: -137 } }),
+        sprite({ color: { r: 0, g: 0, b: 0, a: 0.55 }, type: 1, raycast: false }),
+      ],
+    }));
+    select.push(entity({
+      id: guid('menu', 120 + i),
+      path: `${base}/Name`,
+      modelId: 'uitext',
+      entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 2,
+      components: [
+        transform({ parentW: 270, parentH: 330, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 230, y: 54 }, pos: { x: 0, y: -137 } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value: cls.label, fontSize: 34, bold: true, color: cls.enabled ? GOLD : { r: 0.55, g: 0.58, b: 0.62, a: 1 }, alignment: 4 }),
+      ],
+    }));
+    if (!cls.enabled) {
+      select.push(entity({
+        id: guid('menu', 150 + i),
+        path: `${base}/LockBody`,
+        modelId: 'uisprite',
+        entryId: 'UISprite',
+        componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+        displayOrder: 3,
+        components: [
+          transform({ parentW: 270, parentH: 330, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 76, y: 58 }, pos: { x: 0, y: 4 } }),
+          sprite({ color: { r: 0.78, g: 0.69, b: 0.42, a: 1 }, type: 1 }),
+        ],
+      }));
+      select.push(entity({
+        id: guid('menu', 160 + i),
+        path: `${base}/LockShackle`,
+        modelId: 'uisprite',
+        entryId: 'UISprite',
+        componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+        displayOrder: 4,
+        components: [
+          transform({ parentW: 270, parentH: 330, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 54, y: 42 }, pos: { x: 0, y: 48 } }),
+          sprite({ color: { r: 0.78, g: 0.69, b: 0.42, a: 1 }, type: 1 }),
+        ],
+      }));
+    }
+  }
+  select.push(entity({
+    id: guid('menu', 180),
+    path: '/ui/DefaultGroup/CharacterSelectHud/StartButton',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 20,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 220, y: 68 }, pos: { x: 720, y: -360 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.15, g: 0.2, b: 0.26, a: 1 }, type: 1, raycast: true }),
+      button(),
+      text({ value: '\uC2DC\uC791', fontSize: 30, bold: true, color: GOLD, alignment: 0 }),
+    ],
+  }));
+  select.push(entity({
+    id: guid('menu', 230),
+    path: '/ui/DefaultGroup/CharacterSelectHud/BackButton',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 22,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 180, y: 56 }, pos: { x: -800, y: 430 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.15, g: 0.2, b: 0.26, a: 1 }, type: 1, raycast: true }),
+      button(),
+      text({ value: '\u2190 \uB4A4\uB85C', fontSize: 26, bold: true, color: GOLD, alignment: 0 }),
+    ],
+  }));
+  select[0].jsonString.enable = false;
+  return select;
+}

tools/deck/hud/combat.mjs

@@ -0,0 +1,494 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildCombat() {
+  const PANEL_BG = { r: 0.08, g: 0.09, b: 0.11, a: 0.78 };
+  const combat = [];
+  combat.push(entity({
+    id: guid('cmb', 0),
+    path: '/ui/DefaultGroup/CombatHud',
+    modelId: 'uiempty',
+    entryId: 'UIEmpty',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 4,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: TRANSPARENT }),
+    ],
+  }));
+  const SLOT_W = 140, SLOT_H = 96;
+  for (let i = 1; i <= MAX_MONSTERS; i++) {
+    const base = `/ui/DefaultGroup/CombatHud/MonsterSlot${i}`;
+    const slot = entity({
+      id: guid('cmb', 40 + i),
+      path: base,
+      modelId: 'uisprite', entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent',
+      displayOrder: 20 + i,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: SLOT_W, y: SLOT_H }, pos: { x: (i - 2.5) * 320, y: 300 } }),
+        sprite({ color: { r: 0, g: 0, b: 0, a: 0.0001 }, type: 1, raycast: true }),
+        button(),
+      ],
+    });
+    slot.jsonString.enable = false;
+    combat.push(slot);
+    const targetFrame = entity({
+      id: guid('cmb', 220 + i), path: `${base}/TargetFrame`, modelId: 'uisprite', entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 0,
+      components: [
+        transform({ parentW: SLOT_W, parentH: SLOT_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: SLOT_W + 16, y: SLOT_H + 12 }, pos: { x: 0, y: 0 } }),
+        sprite({ color: { r: 0.95, g: 0.78, b: 0.25, a: 0.28 }, type: 1 }),
+      ],
+    });
+    targetFrame.jsonString.enable = false;
+    combat.push(targetFrame);
+    const targetMarker = entity({
+      id: guid('cmb', 360 + i), path: `${base}/TargetMarker`, modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 9,
+      components: [
+        transform({ parentW: SLOT_W, parentH: SLOT_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 116, y: 116 }, pos: { x: 0, y: 2 } }),
+        sprite({ color: { r: 0.95, g: 0.08, b: 0.05, a: 0.92 }, type: 1 }),
+        text({ value: '+', fontSize: 72, bold: true, color: { r: 1, g: 0.94, b: 0.28, a: 1 }, alignment: 4, outlineWidth: 4 }),
+      ],
+    });
+    targetMarker.jsonString.enable = false;
+    combat.push(targetMarker);
+    const targetLabel = entity({
+      id: guid('cmb', 370 + i), path: `${base}/TargetMarker/Label`, modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 10,
+      components: [
+        transform({ parentW: 116, parentH: 116, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 112, y: 28 }, pos: { x: 0, y: -52 } }),
+        sprite({ color: { r: 0.08, g: 0.02, b: 0.02, a: 0.86 }, type: 1 }),
+        text({ value: 'TARGET', fontSize: 18, bold: true, color: { r: 1, g: 0.94, b: 0.28, a: 1 }, alignment: 4, outlineWidth: 3 }),
+      ],
+    });
+    targetLabel.jsonString.enable = false;
+    combat.push(targetLabel);
+    const actFrame = entity({
+      id: guid('cmb', 240 + i), path: `${base}/ActFrame`, modelId: 'uisprite', entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 0,
+      components: [
+        transform({ parentW: SLOT_W, parentH: SLOT_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: SLOT_W + 16, y: SLOT_H + 12 }, pos: { x: 0, y: 0 } }),
+        sprite({ color: { r: 0.95, g: 0.3, b: 0.25, a: 0.3 }, type: 1 }),
+      ],
+    });
+    actFrame.jsonString.enable = false;
+    combat.push(actFrame);
+    combat.push(entity({
+      id: guid('cmb', 60 + i), path: `${base}/Name`, modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 1,
+      components: [
+        transform({ parentW: SLOT_W, parentH: SLOT_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: SLOT_W, y: 30 }, pos: { x: 0, y: 34 } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value: '', fontSize: 22, bold: true, color: GOLD, alignment: 4 }),
+      ],
+    }));
+    combat.push(entity({
+      id: guid('cmb', 80 + i), path: `${base}/Hp`, modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 2,
+      components: [
+        transform({ parentW: SLOT_W, parentH: SLOT_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: SLOT_W, y: 26 }, pos: { x: 0, y: 6 } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value: '', fontSize: 20, bold: true, color: { r: 1, g: 1, b: 1, a: 1 }, alignment: 4 }),
+      ],
+    }));
+    combat.push(entity({
+      id: guid('cmb', 100 + i), path: `${base}/HpBarBg`, modelId: 'uisprite', entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 3,
+      components: [
+        transform({ parentW: SLOT_W, parentH: SLOT_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: HP_BAR_W, y: 14 }, pos: { x: 0, y: -14 } }),
+        sprite({ color: { r: 0.18, g: 0.05, b: 0.06, a: 1 }, type: 1 }),
+      ],
+    }));
+    combat.push(entity({
+      id: guid('cmb', 120 + i), path: `${base}/HpBarFill`, modelId: 'uisprite', entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 4,
+      components: [
+        transform({ parentW: SLOT_W, parentH: SLOT_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0, y: 0.5 }, size: { x: HP_BAR_W, y: 14 }, pos: { x: -HP_BAR_W / 2, y: -14 } }),
+        sprite({ color: { r: 0.86, g: 0.35, b: 0.32, a: 1 }, type: 1 }),
+      ],
+    }));
+    combat.push(entity({
+      id: guid('cmb', 140 + i), path: `${base}/Intent`, modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 5,
+      components: [
+        transform({ parentW: SLOT_W, parentH: SLOT_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: SLOT_W + 40, y: 24 }, pos: { x: 0, y: -36 } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value: '', fontSize: 17, bold: true, color: { r: 1, g: 0.72, b: 0.5, a: 1 }, alignment: 4 }),
+      ],
+    }));
+    const dmgPopBase = `/ui/DefaultGroup/CombatHud/DmgPop${i}`;
+    const dmgPop = entity({
+      id: guid('cmb', 250 + i), path: dmgPopBase, modelId: 'uisprite', entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 80 + i,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 192, y: 56 }, pos: { x: 0, y: 0 } }),
+        sprite({ color: TRANSPARENT, type: 1 }),
+      ],
+    });
+    dmgPop.jsonString.enable = false;
+    combat.push(dmgPop);
+    for (let d = 0; d < DAMAGE_POP_MAX_DIGITS; d++) {
+      combat.push(entity({
+        id: guid('cmb', 380 + i * 10 + d), path: `${dmgPopBase}/Digit${d + 1}`, modelId: 'uisprite', entryId: 'UISprite',
+        componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+        displayOrder: 90 + i,
+        components: [
+          transform({ parentW: 192, parentH: 56, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: DAMAGE_POP_DIGIT_W, y: DAMAGE_POP_DIGIT_H }, pos: { x: 0, y: 0 } }),
+          sprite({ dataId: DAMAGE_DIGIT_RUIDS[0], color: { r: 1, g: 1, b: 1, a: 1 }, type: 0 }),
+        ],
+      }));
+    }
+    const mBlockBadge = entity({
+      id: guid('cmb', 270 + i), path: `${base}/BlockBadge`, modelId: 'uisprite', entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 6,
+      components: [
+        transform({ parentW: SLOT_W, parentH: SLOT_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 40, y: 36 }, pos: { x: -HP_BAR_W / 2 - 30, y: -14 } }),
+        sprite({ color: { r: 0.32, g: 0.5, b: 0.85, a: 1 }, type: 1 }),
+      ],
+    });
+    mBlockBadge.jsonString.enable = false;
+    combat.push(mBlockBadge);
+    combat.push(entity({
+      id: guid('cmb', 280 + i), path: `${base}/BlockBadge/Value`, modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 0,
+      components: [
+        transform({ parentW: 40, parentH: 36, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 40, y: 32 }, pos: { x: 0, y: 0 } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value: '0', fontSize: 17, bold: true, color: { r: 1, g: 1, b: 1, a: 1 }, alignment: 4 }),
+      ],
+    }));
+    combat.push(entity({
+      id: guid('cmb', 290 + i), path: `${base}/Buffs`, modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 7,
+      components: [
+        transform({ parentW: SLOT_W, parentH: SLOT_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: SLOT_W + 60, y: 22 }, pos: { x: 0, y: -58 } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value: '', fontSize: 15, bold: true, color: { r: 0.85, g: 0.65, b: 1, a: 1 }, alignment: 4 }),
+      ],
+    }));
+  }
+  const PP = '/ui/DefaultGroup/CombatHud/PlayerPanel';
+  combat.push(entity({
+    id: guid('cmb', 210), path: PP, modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 5,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 300, y: 96 }, pos: { x: -760, y: -494 }, align: ALIGN_CENTER }),
+      sprite({ color: PANEL_BG, type: 1 }),
+    ],
+  }));
+  combat.push(entity({
+    id: guid('cmb', 211), path: `${PP}/Name`, modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 300, parentH: 96, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 280, y: 28 }, pos: { x: 0, y: 28 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '플레이어', fontSize: 18, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  combat.push(entity({
+    id: guid('cmb', 212), path: `${PP}/HpBarBg`, modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 300, parentH: 96, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 220, y: 16 }, pos: { x: 16, y: -6 } }),
+      sprite({ color: { r: 0.18, g: 0.05, b: 0.06, a: 1 }, type: 1 }),
+    ],
+  }));
+  combat.push(entity({
+    id: guid('cmb', 213), path: `${PP}/HpBarFill`, modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 2,
+    components: [
+      transform({ parentW: 300, parentH: 96, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0, y: 0.5 }, size: { x: 220, y: 14 }, pos: { x: -94, y: -6 } }),
+      sprite({ color: { r: 0.3, g: 0.78, b: 0.36, a: 1 }, type: 1 }),
+    ],
+  }));
+  combat.push(entity({
+    id: guid('cmb', 214), path: `${PP}/HpText`, modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 3,
+    components: [
+      transform({ parentW: 300, parentH: 96, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 220, y: 24 }, pos: { x: 16, y: -30 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '80/80', fontSize: 16, bold: true, color: { r: 1, g: 1, b: 1, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  const blockBadge = entity({
+    id: guid('cmb', 215), path: `${PP}/BlockBadge`, modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 4,
+    components: [
+      transform({ parentW: 300, parentH: 96, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 44, y: 40 }, pos: { x: -122, y: -12 } }),
+      sprite({ color: { r: 0.32, g: 0.5, b: 0.85, a: 1 }, type: 1 }),
+    ],
+  });
+  blockBadge.jsonString.enable = false;
+  combat.push(blockBadge);
+  combat.push(entity({
+    id: guid('cmb', 216), path: `${PP}/BlockBadge/Value`, modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 44, parentH: 40, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 44, y: 36 }, pos: { x: 0, y: 0 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '0', fontSize: 18, bold: true, color: { r: 1, g: 1, b: 1, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  combat.push(entity({
+    id: guid('cmb', 217), path: `${PP}/Buffs`, modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 6,
+    components: [
+      transform({ parentW: 300, parentH: 96, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 280, y: 22 }, pos: { x: 0, y: -44 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '', fontSize: 14, bold: true, color: { r: 0.85, g: 0.65, b: 1, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  const playerDmgPop = entity({
+    id: guid('cmb', 260), path: `${PP}/DmgPop`, modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 5,
+    components: [
+      transform({ parentW: 300, parentH: 96, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 160, y: 30 }, pos: { x: 16, y: 40 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '', fontSize: 22, bold: true, color: { r: 1, g: 0.4, b: 0.35, a: 1 }, alignment: 4 }),
+    ],
+  });
+  playerDmgPop.jsonString.enable = false;
+  combat.push(playerDmgPop);
+  combat.push(entity({
+    id: guid('cmb', 200),
+    path: '/ui/DefaultGroup/CombatHud/TopBar',
+    modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 9,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1200, y: 52 }, pos: { x: 0, y: 486 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.06, g: 0.07, b: 0.1, a: 0.82 }, type: 1 }),
+    ],
+  }));
+  const topTexts = [
+    ['Floor', -520, 160, '막 1/3', GOLD],
+    ['Gold', -360, 160, '메소 0', { r: 0.98, g: 0.85, b: 0.4, a: 1 }],
+  ];
+  topTexts.forEach(([suffix, x, w, value, color], ti) => {
+    combat.push(entity({
+      id: guid('cmb', 201 + ti),
+      path: `/ui/DefaultGroup/CombatHud/TopBar/${suffix}`,
+      modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: ti,
+      components: [
+        transform({ parentW: 1200, parentH: 52, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: w, y: 40 }, pos: { x: x, y: 0 } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value, fontSize: 22, bold: true, color, alignment: 4 }),
+      ],
+    }));
+  });
+  combat.push(entity({
+    id: guid('cmb', 209),
+    path: '/ui/DefaultGroup/CombatHud/TopBar/MesoIcon',
+    modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 2,
+    components: [
+      transform({ parentW: 1200, parentH: 52, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 26, y: 26 }, pos: { x: -432, y: 0 } }),
+      sprite({ color: { r: 1, g: 0.82, b: 0.2, a: 1 }, type: 1 }),
+    ],
+  }));
+  for (let i = 1; i <= 10; i++) {
+    combat.push(entity({
+      id: guid('cmb', 300 + i),
+      path: `/ui/DefaultGroup/CombatHud/TopBar/RelicSlot${i}`,
+      modelId: 'uisprite', entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.UITouchReceiveComponent',
+      displayOrder: 3 + i,
+      components: [
+        transform({ parentW: 1200, parentH: 52, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 40, y: 40 }, pos: { x: -240 + (i - 1) * 48, y: 0 } }),
+        sprite({ color: { r: 0.15, g: 0.16, b: 0.2, a: 0.6 }, type: 0, raycast: true }),
+        { '@type': 'MOD.Core.UITouchReceiveComponent', Enable: true },
+      ],
+    }));
+  }
+  combat.push(entity({
+    id: guid('cmb', 311),
+    path: '/ui/DefaultGroup/CombatHud/TopBar/RelicOverflow',
+    modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 14,
+    components: [
+      transform({ parentW: 1200, parentH: 52, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 60, y: 30 }, pos: { x: 192, y: 0 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '', fontSize: 18, bold: true, color: { r: 0.8, g: 0.7, b: 0.95, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  for (let i = 1; i <= 5; i++) {
+    combat.push(entity({
+      id: guid('cmb', 320 + i),
+      path: `/ui/DefaultGroup/CombatHud/TopBar/PotionSlot${i}`,
+      modelId: 'uisprite', entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.UITouchReceiveComponent',
+      displayOrder: 14 + i,
+      components: [
+        transform({ parentW: 1200, parentH: 52, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 40, y: 40 }, pos: { x: 240 + (i - 1) * 44, y: 0 } }),
+        sprite({ color: { r: 0.22, g: 0.25, b: 0.3, a: 0.9 }, type: 0, raycast: true }),
+        { '@type': 'MOD.Core.UITouchReceiveComponent', Enable: true },
+      ],
+    }));
+  }
+  const tooltipBox = entity({
+    id: guid('cmb', 330),
+    path: '/ui/DefaultGroup/CombatHud/TooltipBox',
+    modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 20,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 360, y: 150 }, pos: { x: 0, y: 400 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.04, g: 0.05, b: 0.08, a: 0.96 }, type: 1 }),
+    ],
+  });
+  tooltipBox.jsonString.enable = false;
+  combat.push(tooltipBox);
+  combat.push(entity({
+    id: guid('cmb', 331),
+    path: '/ui/DefaultGroup/CombatHud/TooltipBox/Name',
+    modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 360, parentH: 150, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 332, y: 28 }, pos: { x: 0, y: 52 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '', fontSize: 19, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  combat.push(entity({
+    id: guid('cmb', 332),
+    path: '/ui/DefaultGroup/CombatHud/TooltipBox/Desc',
+    modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 360, parentH: 150, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 332, y: 102 }, pos: { x: 0, y: -18 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '', fontSize: 15, bold: false, color: { r: 0.92, g: 0.92, b: 0.95, a: 1 }, alignment: 0 }),
+    ],
+  }));
+  const discardPrompt = entity({
+    id: guid('cmb', 333),
+    path: '/ui/DefaultGroup/CombatHud/DiscardPrompt',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 22,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 520, y: 48 }, pos: { x: 0, y: -260 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.05, g: 0.06, b: 0.09, a: 0.86 }, type: 1 }),
+      text({ value: '', fontSize: 22, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  });
+  discardPrompt.jsonString.enable = false;
+  combat.push(discardPrompt);
+  const potionMenu = entity({
+    id: guid('cmb', 340),
+    path: '/ui/DefaultGroup/CombatHud/PotionMenu',
+    modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 21,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 380, y: 180 }, pos: { x: 0, y: 120 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.07, g: 0.08, b: 0.12, a: 0.97 }, type: 1 }),
+    ],
+  });
+  potionMenu.jsonString.enable = false;
+  combat.push(potionMenu);
+  combat.push(entity({
+    id: guid('cmb', 341),
+    path: '/ui/DefaultGroup/CombatHud/PotionMenu/Title',
+    modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 380, parentH: 180, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 360, y: 36 }, pos: { x: 0, y: 52 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '', fontSize: 19, bold: true, color: { r: 1, g: 1, b: 1, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  const pmButtons = [
+    ['Use', '사용', -120, { r: 0.32, g: 0.55, b: 0.36, a: 1 }],
+    ['Toss', '버리기', 0, { r: 0.6, g: 0.32, b: 0.3, a: 1 }],
+    ['Close', '닫기', 120, { r: 0.25, g: 0.28, b: 0.35, a: 1 }],
+  ];
+  pmButtons.forEach(([suffix, label, x, color], bi) => {
+    combat.push(entity({
+      id: guid('cmb', 342 + bi),
+      path: `/ui/DefaultGroup/CombatHud/PotionMenu/${suffix}`,
+      modelId: 'uibutton', entryId: 'UIButton',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+      displayOrder: 1 + bi,
+      components: [
+        transform({ parentW: 380, parentH: 180, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 104, y: 46 }, pos: { x, y: -40 } }),
+        sprite({ color, type: 1, raycast: true }),
+        button(),
+        text({ value: label, fontSize: 20, bold: true, color: { r: 1, g: 1, b: 1, a: 1 }, alignment: 4 }),
+      ],
+    }));
+  });
+  combat.push(entity({
+    id: guid('cmb', 205),
+    path: '/ui/DefaultGroup/CombatHud/TopBar/AllDeckButton',
+    modelId: 'uibutton', entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 3,
+    components: [
+      transform({ parentW: 1200, parentH: 52, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 140, y: 40 }, pos: { x: 528, y: 0 } }),
+      sprite({ color: DARK, type: 1, raycast: true }),
+      button(),
+      text({ value: '모든덱보기', fontSize: 18, bold: true, color: GOLD, alignment: 0 }),
+    ],
+  }));
+  const skillFx = entity({
+    id: guid('cmb', 230), path: '/ui/DefaultGroup/CombatHud/SkillFx',
+    modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 30,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 110, y: 110 }, pos: { x: 0, y: 0 } }),
+      sprite({ color: { r: 1, g: 1, b: 1, a: 1 }, type: 0, raycast: false }),
+    ],
+  });
+  skillFx.jsonString.enable = false;
+  combat.push(skillFx);
+  const result = entity({
+    id: guid('cmb', 2),
+    path: '/ui/DefaultGroup/CombatHud/Result',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 8,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 700, y: 140 }, pos: { x: 0, y: 120 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '', fontSize: 64, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  });
+  result.jsonString.enable = false;
+  combat.push(result);
+  return combat;
+}

tools/deck/hud/deckall.mjs

@@ -0,0 +1,159 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildDeckAll() {
+  const allDeck = [];
+  const allHud = entity({
+    id: guid('all', 0),
+    path: '/ui/DefaultGroup/DeckAllHud',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 16,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.04, g: 0.05, b: 0.07, a: 0.78 }, type: 1, raycast: true }),
+    ],
+  });
+  allHud.jsonString.enable = false;
+  allDeck.push(allHud);
+  allDeck.push(entity({
+    id: guid('all', 1),
+    path: '/ui/DefaultGroup/DeckAllHud/Panel',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1080, y: 800 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.08, g: 0.09, b: 0.11, a: 0.96 }, type: 1 }),
+    ],
+  }));
+  allDeck.push(entity({
+    id: guid('all', 2),
+    path: '/ui/DefaultGroup/DeckAllHud/Title',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 760, y: 54 }, pos: { x: 0, y: 380 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '모든 덱', fontSize: 34, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  allDeck.push(entity({
+    id: guid('all', 3),
+    path: '/ui/DefaultGroup/DeckAllHud/Close',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 2,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 78, y: 52 }, pos: { x: 486, y: 380 } }),
+      sprite({ color: { r: 0.16, g: 0.18, b: 0.22, a: 1 }, type: 1, raycast: true }),
+      button(),
+      text({ value: 'X', fontSize: 26, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  const deckTabs = [
+    { key: 'Warrior', label: '전사', x: -210 },
+    { key: 'Thief', label: '도적', x: 0 },
+    { key: 'Mage', label: '마법사', x: 210 },
+  ];
+  for (let i = 0; i < deckTabs.length; i++) {
+    const tab = deckTabs[i];
+    allDeck.push(entity({
+      id: guid('all', 10 + i),
+      path: `/ui/DefaultGroup/DeckAllHud/${tab.key}Tab`,
+      modelId: 'uibutton',
+      entryId: 'UIButton',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+      displayOrder: 3 + i,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 170, y: 46 }, pos: { x: tab.x, y: 318 } }),
+        sprite({ color: { r: 0.11, g: 0.13, b: 0.16, a: 1 }, type: 1, raycast: true }),
+        button(),
+        text({ value: tab.label, fontSize: 22, bold: true, color: GOLD, alignment: 4 }),
+      ],
+    }));
+  }
+  allDeck.push(entity({
+    id: guid('all', 4),
+    path: '/ui/DefaultGroup/DeckAllHud/Empty',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 3,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 600, y: 50 }, pos: { x: 0, y: 40 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '덱이 없습니다', fontSize: 28, bold: true, color: { r: 0.82, g: 0.86, b: 0.9, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  allDeck.push(entity({
+    id: guid('all', 5),
+    path: '/ui/DefaultGroup/DeckAllHud/Grid',
+    modelId: 'uiempty',
+    entryId: 'UIEmpty',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ScrollLayoutGroupComponent',
+    displayOrder: 4,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 980, y: 620 }, pos: { x: 0, y: 0 } }),
+      sprite({ color: TRANSPARENT, type: 1, raycast: true }),
+      scrollLayoutGroup({ cellSize: { x: 158, y: 214 }, spacing: { x: 22, y: 22 }, columns: 5 }),
+    ],
+  }));
+  const ALL_DECK_CARD_COUNT = 120;
+  const ALL_DECK_CARD_W = 158;
+  const ALL_DECK_CARD_H = 214;
+  // 카드 단위 엔티티 v2 네임스페이스 — DeckInspectHud 주석 참조
+  for (let i = 1; i <= ALL_DECK_CARD_COUNT; i++) {
+    const allBase = 6 + (i - 1) * 7;
+    const cardPath = `/ui/DefaultGroup/DeckAllHud/Grid/Card${i}`;
+    const card = entity({
+      id: guid('all2', allBase),
+      path: cardPath,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: i,
+      components: [
+        transform({ parentW: 980, parentH: 620, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: ALL_DECK_CARD_W, y: ALL_DECK_CARD_H }, pos: { x: 0, y: 0 } }),
+        sprite({ dataId: CARDFRAMES.frames.warrior.normal, color: WHITE, type: 0 }),
+      ],
+    });
+    card.jsonString.enable = false;
+    allDeck.push(card);
+    const allDeckLayout = cardFaceLayout(ALL_DECK_CARD_W);
+    for (const [tIdx, [suffix, cfg]] of allDeckLayout.texts.map(([sfx, c]) => [sfx, { ...c, value: sfx === 'Cost' ? '1' : '' }]).entries()) {
+      const dOrder = suffix === 'Cost' ? 7 : suffix === 'Name' ? 6 : 8;
+      allDeck.push(entity({
+        id: guid('all2', allBase + 1 + tIdx),
+        path: `${cardPath}/${suffix}`,
+        modelId: 'uitext',
+        entryId: 'UIText',
+        componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+        displayOrder: dOrder,
+        components: [
+          transform({ parentW: ALL_DECK_CARD_W, parentH: ALL_DECK_CARD_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: cfg.size, pos: cfg.pos }),
+          sprite({ color: TRANSPARENT }),
+          text({ value: cfg.value, fontSize: cfg.fontSize, bold: cfg.bold, color: cfg.color, dropShadow: cfg.dropShadow, outlineWidth: cfg.outlineWidth }),
+        ],
+      }));
+    }
+    allDeck.push(entity({
+      id: guid('all2', allBase + 6),
+      path: `${cardPath}/Art`,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 5,
+      components: [
+        transform({ parentW: ALL_DECK_CARD_W, parentH: ALL_DECK_CARD_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: allDeckLayout.art.size, pos: allDeckLayout.art.pos }),
+        sprite({ color: WHITE, type: 0, raycast: false }),
+      ],
+    }));
+  }
+  return allDeck;
+}

tools/deck/hud/deckhud.mjs

@@ -0,0 +1,122 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildDeckHud() {
+  const hud = [];
+  const add = (e) => hud.push(e);
+
+  add(entity({
+    id: guid('hud', 0),
+    path: '/ui/DefaultGroup/DeckHud',
+    modelId: 'uiempty',
+    entryId: 'UIEmpty',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 5,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1280, y: 330 }, pos: { x: 0, y: 180 }, align: ALIGN_BOTTOM_CENTER }),
+      sprite({ color: TRANSPARENT }),
+    ],
+  }));
+
+  for (const pile of [
+    { key: 'DrawPile', x: -590, label: '뽑을 덱', count: '10', color: { r: 0.17, g: 0.20, b: 0.25, a: 1 } },
+    { key: 'ExhaustPile', x: 430, label: '소멸 덱', count: '0', color: { r: 0.13, g: 0.13, b: 0.18, a: 1 } },
+    { key: 'DiscardPile', x: 590, label: '버린 덱', count: '0', color: { r: 0.22, g: 0.18, b: 0.16, a: 1 } },
+  ]) {
+    add(entity({
+      id: guid('hud', hud.length),
+      path: `/ui/DefaultGroup/DeckHud/${pile.key}`,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent',
+      displayOrder: pile.key === 'DrawPile' ? 0 : pile.key === 'ExhaustPile' ? 1 : 2,
+      components: [
+        transform({ parentW: 1280, parentH: 330, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 132, y: 186 }, pos: { x: pile.x, y: 8 }, align: ALIGN_CENTER }),
+        sprite({ color: pile.color, type: 1, raycast: true }),
+        button(),
+      ],
+    }));
+    add(entity({
+      id: guid('hud', hud.length),
+      path: `/ui/DefaultGroup/DeckHud/${pile.key}/Label`,
+      modelId: 'uitext',
+      entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 0,
+      components: [
+        transform({ parentW: 132, parentH: 186, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 120, y: 42 }, pos: { x: 0, y: 45 } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value: pile.label, fontSize: 21, bold: true, color: GOLD }),
+      ],
+    }));
+    add(entity({
+      id: guid('hud', hud.length),
+      path: `/ui/DefaultGroup/DeckHud/${pile.key}/Count`,
+      modelId: 'uitext',
+      entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 1,
+      components: [
+        transform({ parentW: 132, parentH: 186, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 120, y: 72 }, pos: { x: 0, y: -20 } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value: pile.count, fontSize: 42, bold: true }),
+      ],
+    }));
+  }
+
+  add(entity({
+    id: guid('hud', hud.length),
+    path: '/ui/DefaultGroup/DeckHud/EndTurnButton',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 2,
+    components: [
+      transform({ parentW: 1280, parentH: 330, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 200, y: 64 }, pos: { x: 560, y: 160 }, align: ALIGN_CENTER }),
+      sprite({ color: DARK, type: 1, raycast: true }),
+      button(),
+      text({ value: '턴 종료', fontSize: 28, bold: true, color: GOLD, alignment: 0 }),
+    ],
+  }));
+
+  add(entity({
+    id: guid('hud', hud.length),
+    path: '/ui/DefaultGroup/DeckHud/EnergyOrb',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 3,
+    components: [
+      transform({ parentW: 1280, parentH: 330, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 96, y: 96 }, pos: { x: -560, y: 160 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.12, g: 0.2, b: 0.34, a: 0.95 }, type: 1 }),
+    ],
+  }));
+  add(entity({
+    id: guid('hud', hud.length),
+    path: '/ui/DefaultGroup/DeckHud/EnergyOrb/Value',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 96, parentH: 96, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 92, y: 48 }, pos: { x: 0, y: 6 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '3/3', fontSize: 34, bold: true, color: { r: 0.65, g: 0.92, b: 1, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  add(entity({
+    id: guid('hud', hud.length),
+    path: '/ui/DefaultGroup/DeckHud/EnergyOrb/Label',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 96, parentH: 96, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 92, y: 24 }, pos: { x: 0, y: -28 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '에너지', fontSize: 14, bold: true, color: { r: 0.55, g: 0.7, b: 0.85, a: 1 }, alignment: 4 }),
+    ],
+  }));
+
+  return hud;
+}

tools/deck/hud/deckinspect.mjs

@@ -0,0 +1,138 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildDeckInspect() {
+  const inspect = [];
+  const inspectHud = entity({
+    id: guid('ins', 0),
+    path: '/ui/DefaultGroup/DeckInspectHud',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 15,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.04, g: 0.05, b: 0.07, a: 0.78 }, type: 1, raycast: true }),
+    ],
+  });
+  inspectHud.jsonString.enable = false;
+  inspect.push(inspectHud);
+  inspect.push(entity({
+    id: guid('ins', 1),
+    path: '/ui/DefaultGroup/DeckInspectHud/Panel',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1040, y: 760 }, pos: { x: 0, y: 10 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.08, g: 0.09, b: 0.11, a: 0.96 }, type: 1 }),
+    ],
+  }));
+  inspect.push(entity({
+    id: guid('ins', 2),
+    path: '/ui/DefaultGroup/DeckInspectHud/Title',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 720, y: 54 }, pos: { x: 0, y: 350 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '\uB371 \uBCF4\uAE30', fontSize: 34, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  inspect.push(entity({
+    id: guid('ins', 3),
+    path: '/ui/DefaultGroup/DeckInspectHud/Close',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 2,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 78, y: 52 }, pos: { x: 466, y: 350 } }),
+      sprite({ color: { r: 0.16, g: 0.18, b: 0.22, a: 1 }, type: 1, raycast: true }),
+      button(),
+      text({ value: 'X', fontSize: 26, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  inspect.push(entity({
+    id: guid('ins', 4),
+    path: '/ui/DefaultGroup/DeckInspectHud/Empty',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 3,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 600, y: 50 }, pos: { x: 0, y: 30 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '\uCE74\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4', fontSize: 28, bold: true, color: { r: 0.82, g: 0.86, b: 0.9, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  inspect.push(entity({
+    id: guid('ins', 5),
+    path: '/ui/DefaultGroup/DeckInspectHud/Grid',
+    modelId: 'uiempty',
+    entryId: 'UIEmpty',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ScrollLayoutGroupComponent',
+    displayOrder: 4,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 950, y: 610 }, pos: { x: 0, y: 0 } }),
+      sprite({ color: TRANSPARENT, type: 1, raycast: true }),
+      scrollLayoutGroup({ cellSize: { x: 158, y: 214 }, spacing: { x: 22, y: 22 }, columns: 5 }),
+    ],
+  }));
+  const INSPECT_CARD_COUNT = 60;
+  const INSPECT_CARD_W = 158;
+  const INSPECT_CARD_H = 214;
+  // 카드 단위 엔티티는 v2 네임스페이스(ins2/all2/rwd2/shp2) — 자식 구성이 바뀌면 id를 통째로 새로 발급해야 함.
+  // 구 id를 다른 path에 재사용하면 메이커 refresh의 id 기준 in-place 병합이 꼬여 자식이 소실됨 (P13 실측).
+  for (let i = 1; i <= INSPECT_CARD_COUNT; i++) {
+    const insBase = 6 + (i - 1) * 7;
+    const cardPath = `/ui/DefaultGroup/DeckInspectHud/Grid/Card${i}`;
+    const card = entity({
+      id: guid('ins2', insBase),
+      path: cardPath,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: i,
+      components: [
+        transform({ parentW: 950, parentH: 610, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: INSPECT_CARD_W, y: INSPECT_CARD_H }, pos: { x: 0, y: 0 } }),
+        sprite({ dataId: CARDFRAMES.frames.warrior.normal, color: WHITE, type: 0 }),
+      ],
+    });
+    card.jsonString.enable = false;
+    inspect.push(card);
+    const inspectLayout = cardFaceLayout(INSPECT_CARD_W);
+    for (const [tIdx, [suffix, cfg]] of inspectLayout.texts.map(([sfx, c]) => [sfx, { ...c, value: sfx === 'Cost' ? '1' : '' }]).entries()) {
+      const dOrder = suffix === 'Cost' ? 7 : suffix === 'Name' ? 6 : 8;
+      inspect.push(entity({
+        id: guid('ins2', insBase + 1 + tIdx),
+        path: `${cardPath}/${suffix}`,
+        modelId: 'uitext',
+        entryId: 'UIText',
+        componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+        displayOrder: dOrder,
+        components: [
+          transform({ parentW: INSPECT_CARD_W, parentH: INSPECT_CARD_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: cfg.size, pos: cfg.pos }),
+          sprite({ color: TRANSPARENT }),
+          text({ value: cfg.value, fontSize: cfg.fontSize, bold: cfg.bold, color: cfg.color, dropShadow: cfg.dropShadow, outlineWidth: cfg.outlineWidth }),
+        ],
+      }));
+    }
+    inspect.push(entity({
+      id: guid('ins2', insBase + 6),
+      path: `${cardPath}/Art`,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 5,
+      components: [
+        transform({ parentW: INSPECT_CARD_W, parentH: INSPECT_CARD_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: inspectLayout.art.size, pos: inspectLayout.art.pos }),
+        sprite({ color: WHITE, type: 0, raycast: false }),
+      ],
+    }));
+  }
+  return inspect;
+}

tools/deck/hud/jobchoice.mjs

@@ -0,0 +1,51 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildJobChoice() {
+  const jobChoice = [];
+  const jobChoiceHud = entity({
+    id: guid('job', 0),
+    path: '/ui/DefaultGroup/JobChoiceHud',
+    modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 9,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.05, g: 0.06, b: 0.09, a: 0.92 }, type: 1, raycast: true }),
+    ],
+  });
+  jobChoiceHud.jsonString.enable = false;
+  jobChoice.push(jobChoiceHud);
+  jobChoice.push(entity({
+    id: guid('job', 1),
+    path: '/ui/DefaultGroup/JobChoiceHud/Title',
+    modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 800, y: 60 }, pos: { x: 0, y: 220 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '보스 처치 보상을 선택하세요', fontSize: 36, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  const jcButtons = [
+    ['RelicButton', '유물 획득', -240, { r: 0.7, g: 0.55, b: 0.85, a: 1 }],
+    ['JobButton', '2차 전직', 240, { r: 0.86, g: 0.6, b: 0.3, a: 1 }],
+  ];
+  jcButtons.forEach(([suffix, label, x, color], bi) => {
+    jobChoice.push(entity({
+      id: guid('job', 2 + bi),
+      path: `/ui/DefaultGroup/JobChoiceHud/${suffix}`,
+      modelId: 'uibutton', entryId: 'UIButton',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+      displayOrder: 1 + bi,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 380, y: 140 }, pos: { x, y: 0 } }),
+        sprite({ color, type: 1, raycast: true }),
+        button(),
+        text({ value: label, fontSize: 32, bold: true, color: { r: 1, g: 1, b: 1, a: 1 }, alignment: 4 }),
+      ],
+    }));
+  });
+  return jobChoice;
+}

tools/deck/hud/jobselect.mjs

@@ -0,0 +1,89 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildJobSelect() {
+  const jobSelect = [];
+  const jobSelectHud = entity({
+    id: guid('job', 10),
+    path: '/ui/DefaultGroup/JobSelectHud',
+    modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 10,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.05, g: 0.06, b: 0.09, a: 0.94 }, type: 1, raycast: true }),
+    ],
+  });
+  jobSelectHud.jsonString.enable = false;
+  jobSelect.push(jobSelectHud);
+  jobSelect.push(entity({
+    id: guid('job', 11),
+    path: '/ui/DefaultGroup/JobSelectHud/Title',
+    modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 800, y: 60 }, pos: { x: 0, y: 300 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '2차 전직 — 직업을 선택하세요', fontSize: 36, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  // 범용 슬롯 3개 — ShowJobSelect(Lua)가 클래스별 JOBS로 텍스트를 채움 (P10 동적화)
+  const jobs = [
+    ['slot1', '', '', '', -440, { r: 0.82, g: 0.4, b: 0.34, a: 1 }],
+    ['slot2', '', '', '', 0, { r: 0.4, g: 0.55, b: 0.85, a: 1 }],
+    ['slot3', '', '', '', 440, { r: 0.42, g: 0.72, b: 0.46, a: 1 }],
+  ];
+  jobs.forEach(([jobId, name, desc, starter, x, color], ji) => {
+    const base = `/ui/DefaultGroup/JobSelectHud/Job_${jobId}`;
+    jobSelect.push(entity({
+      id: guid('job', 12 + ji * 4),
+      path: base,
+      modelId: 'uibutton', entryId: 'UIButton',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent',
+      displayOrder: 1 + ji,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 380, y: 420 }, pos: { x, y: -20 } }),
+        sprite({ color, type: 1, raycast: true }),
+        button(),
+      ],
+    }));
+    jobSelect.push(entity({
+      id: guid('job', 13 + ji * 4),
+      path: `${base}/Name`,
+      modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 0,
+      components: [
+        transform({ parentW: 380, parentH: 420, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 360, y: 50 }, pos: { x: 0, y: 150 } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value: name, fontSize: 34, bold: true, color: { r: 1, g: 1, b: 1, a: 1 }, alignment: 4 }),
+      ],
+    }));
+    jobSelect.push(entity({
+      id: guid('job', 14 + ji * 4),
+      path: `${base}/Desc`,
+      modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 1,
+      components: [
+        transform({ parentW: 380, parentH: 420, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 340, y: 160 }, pos: { x: 0, y: 0 } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value: desc, fontSize: 22, bold: false, color: { r: 0.95, g: 0.95, b: 0.97, a: 1 }, alignment: 4 }),
+      ],
+    }));
+    jobSelect.push(entity({
+      id: guid('job', 15 + ji * 4),
+      path: `${base}/Starter`,
+      modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 2,
+      components: [
+        transform({ parentW: 380, parentH: 420, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 340, y: 32 }, pos: { x: 0, y: -160 } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value: starter, fontSize: 18, bold: true, color: GOLD, alignment: 4 }),
+      ],
+    }));
+  });
+  return jobSelect;
+}

tools/deck/hud/lobby.mjs

@@ -0,0 +1,58 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildLobby() {
+  const lobby = [];
+  let lobId = 0;
+  const lobbyRoot = entity({
+    id: guid('lob', lobId++),
+    path: '/ui/DefaultGroup/LobbyHud',
+    modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 11,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      // 로비가 물리 맵이 됨 — 투명 + 비레이캐스트로 맵을 가리지 않고 월드 NPC 클릭이 통과되게 함.
+      sprite({ color: TRANSPARENT, type: 1, raycast: false }),
+    ],
+  });
+  lobbyRoot.jsonString.enable = false;
+  lobby.push(lobbyRoot);
+  const lobTexts = [
+    ['Title', 0, 478, 760, '메이플 로비', 40, GOLD],
+    ['SoulLabel', 700, 478, 320, '영혼 0', 28, { r: 0.6, g: 0.85, b: 1, a: 1 }],
+    ['AscLabel', -560, 478, 380, '승천 0 / 해금 0', 22, { r: 0.9, g: 0.7, b: 0.5, a: 1 }],
+    ['Hint', 0, -478, 1500, 'NPC에게 다가가 ↑ 또는 클릭으로 대화 · ← → 이동 · Ctrl 공격', 20, { r: 0.72, g: 0.76, b: 0.82, a: 1 }],
+  ];
+  for (const [suffix, x, y, w, value, fs, color] of lobTexts) {
+    lobby.push(entity({
+      id: guid('lob', lobId++),
+      path: `/ui/DefaultGroup/LobbyHud/${suffix}`,
+      modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 1,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: w, y: 56 }, pos: { x, y } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value, fontSize: fs, bold: true, color, alignment: 4 }),
+      ],
+    }));
+  }
+  for (const [suffix, x, label] of [['AscMinus', -780, '<'], ['AscPlus', -540, '>']]) {
+    lobby.push(entity({
+      id: guid('lob', lobId++),
+      path: `/ui/DefaultGroup/LobbyHud/${suffix}`,
+      modelId: 'uibutton', entryId: 'UIButton',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+      displayOrder: 2,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 46, y: 42 }, pos: { x, y: 470 }, align: ALIGN_CENTER }),
+        sprite({ color: { r: 0.2, g: 0.24, b: 0.3, a: 1 }, type: 1, raycast: true }),
+        button(),
+        text({ value: label, fontSize: 28, bold: true, color: WHITE, alignment: 4 }),
+      ],
+    }));
+  }
+  // NPC 4종은 로비 물리 맵의 월드 엔티티(map/lobby.map + LobbyNpc codeblock)로 이동. UI 버튼 행 제거.
+  return lobby;
+}

tools/deck/hud/mainmenu.mjs

@@ -0,0 +1,127 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildMainMenu() {
+  const menu = [];
+  menu.push(entity({
+    id: guid('menu', 0),
+    path: '/ui/DefaultGroup/MainMenu',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 20,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.06, g: 0.09, b: 0.13, a: 1 }, type: 1, raycast: true }),
+    ],
+  }));
+  menu.push(entity({
+    id: guid('menu', 50),
+    path: '/ui/DefaultGroup/MainMenu/OpaqueBackdrop',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: TRANSPARENT, type: 1, raycast: false }),
+    ],
+  }));
+  menu.push(entity({
+    id: guid('menu', 1),
+    path: '/ui/DefaultGroup/MainMenu/Title',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 720, y: 100 }, pos: { x: 0, y: 180 }, align: ALIGN_CENTER }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '슬레이 메이플', fontSize: 64, bold: true, color: GOLD, alignment: 0 }),
+    ],
+  }));
+  menu.push(entity({
+    id: guid('menu', 2),
+    path: '/ui/DefaultGroup/MainMenu/Subtitle',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 760, y: 48 }, pos: { x: 0, y: 104 }, align: ALIGN_CENTER }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '카드를 뽑고, 덱을 만들고, 첨탑을 오른다', fontSize: 24, color: { r: 0.82, g: 0.86, b: 0.9, a: 1 }, alignment: 0 }),
+    ],
+  }));
+  menu.push(entity({
+    id: guid('menu', 3),
+    path: '/ui/DefaultGroup/MainMenu/NewGameButton',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 2,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 260, y: 68 }, pos: { x: 0, y: -20 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.13, g: 0.15, b: 0.18, a: 1 }, type: 1, raycast: true }),
+      button(),
+      text({ value: '새 게임', fontSize: 30, bold: true, color: GOLD, alignment: 0 }),
+    ],
+  }));
+  // 승천 선택 (P11): [-] 라벨 [+]
+  menu.push(entity({
+    id: guid('menu', 195),
+    path: '/ui/DefaultGroup/MainMenu/AscMinus',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 5,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 52, y: 52 }, pos: { x: -170, y: -185 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.13, g: 0.15, b: 0.18, a: 1 }, type: 1, raycast: true }),
+      button(),
+      text({ value: '-', fontSize: 30, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  menu.push(entity({
+    id: guid('menu', 196),
+    path: '/ui/DefaultGroup/MainMenu/AscLabel',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 6,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 250, y: 40 }, pos: { x: 0, y: -185 }, align: ALIGN_CENTER }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '승천 0 / 해금 0', fontSize: 22, bold: true, color: { r: 0.85, g: 0.7, b: 0.95, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  menu.push(entity({
+    id: guid('menu', 197),
+    path: '/ui/DefaultGroup/MainMenu/AscPlus',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 7,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 52, y: 52 }, pos: { x: 170, y: -185 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.13, g: 0.15, b: 0.18, a: 1 }, type: 1, raycast: true }),
+      button(),
+      text({ value: '+', fontSize: 30, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  menu.push(entity({
+    id: guid('menu', 4),
+    path: '/ui/DefaultGroup/MainMenu/ContinueButton',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 3,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 260, y: 58 }, pos: { x: 0, y: -100 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.1, g: 0.11, b: 0.13, a: 0.78 }, type: 1, raycast: false }),
+      button({ enabled: false }),
+      text({ value: '이어하기', fontSize: 24, bold: true, color: { r: 0.55, g: 0.58, b: 0.62, a: 1 }, alignment: 0 }),
+    ],
+  }));
+  return menu;
+}

tools/deck/hud/map.mjs

@@ -0,0 +1,162 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildMap() {
+  const TYPE_KO = { combat: '전투', elite: '엘리트', boss: '보스', shop: '상점', rest: '휴식' };
+  const map = [];
+  const mapHud = entity({
+    id: guid('map', 0),
+    path: '/ui/DefaultGroup/MapHud',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 7,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      // 불투명 다크 배경(게임 월드 가림 보장). 그 위 BgImage 자식이 배경 스프라이트를 얹는다.
+      sprite({ color: { r: 0.06, g: 0.07, b: 0.11, a: 1 }, type: 1, raycast: true }),
+    ],
+  });
+  mapHud.jsonString.enable = false;
+  map.push(mapHud);
+  // 배경 이미지(displayOrder 0 = 도트/타이틀/노드 아래). nodeicons.json background는 SPRITE RUID여야 렌더됨
+  // — 메이플 BackgroundComponent 리소스는 UI 스프라이트로 안 뜬다. 유효 스프라이트면 풀스크린 표시, 아니면 투명(다크 배경 노출).
+  map.push(entity({
+    id: guid('map', 990),
+    path: '/ui/DefaultGroup/MapHud/BgImage',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ dataId: NODEICONS.background, color: { r: 0.5, g: 0.52, b: 0.58, a: 1 }, type: 0, raycast: false }),
+    ],
+  }));
+  map.push(entity({
+    id: guid('map', 1),
+    path: '/ui/DefaultGroup/MapHud/Title',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 2,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 700, y: 60 }, pos: { x: 0, y: 510 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '다음 노드 선택', fontSize: 40, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  // 절차 생성 맵용 정적 그리드 — 가로 진행(왼→오른쪽): 행(row)=x축, 열(col)=y축 분기, 보스는 최우측 중앙.
+  const nodeX = (row) => -540 + (row - 1) * 150;
+  const nodeY = (col) => 180 - (col - 1) * 120;
+  const BOSS_POS = { x: nodeX(MAP_ROWS) + 150, y: 0 };
+  let mapN = 2;
+  const pushMapNode = (id, pos, size, label) => {
+    const nodePath = `/ui/DefaultGroup/MapHud/Node_${id}`;
+    const nodeEnt = entity({
+      id: guid('map', mapN++),
+      path: nodePath,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent',
+      displayOrder: 5,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size, pos }),
+        sprite({ color: { r: 1, g: 1, b: 1, a: 1 }, type: 0, raycast: true }),
+        button(),
+      ],
+    });
+    nodeEnt.jsonString.enable = false;
+    map.push(nodeEnt);
+  };
+  for (let r = 1; r <= MAP_ROWS; r++) {
+    for (let c = 1; c <= MAP_COLS; c++) {
+      pushMapNode(`r${r}c${c}`, { x: nodeX(r), y: nodeY(c) }, { x: 64, y: 64 }, '');
+    }
+  }
+  pushMapNode('boss', BOSS_POS, { x: 88, y: 88 }, '보스');
+  const pushDots = (dotId, from, to) => {
+    for (let k = 1; k <= 3; k++) {
+      const t = k / 4;
+      const dot = entity({
+        id: guid('map', mapN++),
+        path: `/ui/DefaultGroup/MapHud/Dot_${dotId}_${k}`,
+        modelId: 'uisprite',
+        entryId: 'UISprite',
+        componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+        displayOrder: 1,
+        components: [
+          transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 8, y: 8 }, pos: { x: from.x + (to.x - from.x) * t, y: from.y + (to.y - from.y) * t } }),
+          sprite({ color: { r: 0.5, g: 0.5, b: 0.55, a: 0.8 }, type: 1 }),
+        ],
+      });
+      dot.jsonString.enable = false;
+      map.push(dot);
+    }
+  };
+  for (let r = 1; r < MAP_ROWS; r++) {
+    for (let c = 1; c <= MAP_COLS; c++) {
+      for (let c2 = c - 1; c2 <= c + 1; c2++) {
+        if (c2 < 1 || c2 > MAP_COLS) continue;
+        pushDots(`r${r}c${c}_${c2}`, { x: nodeX(r), y: nodeY(c) }, { x: nodeX(r + 1), y: nodeY(c2) });
+      }
+    }
+  }
+  for (let c = 1; c <= MAP_COLS; c++) {
+    pushDots(`r${MAP_ROWS}c${c}_b`, { x: nodeX(MAP_ROWS), y: nodeY(c) }, BOSS_POS);
+  }
+  // 노드 종류 범례 (우측 하단) — 각 타입 아이콘 + 이름
+  const LEGEND = [['combat', '전투'], ['elite', '엘리트'], ['boss', '보스'], ['shop', '상점'], ['rest', '휴식'], ['treasure', '보물']];
+  const lgW = 300, lgH = 312;
+  map.push(entity({
+    id: guid('map', 991),
+    path: '/ui/DefaultGroup/MapHud/Legend',
+    modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 4,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: lgW, y: lgH }, pos: { x: 760, y: -334 } }),
+      sprite({ color: { r: 0.08, g: 0.09, b: 0.14, a: 0.86 }, type: 1, raycast: false }),
+    ],
+  }));
+  map.push(entity({
+    id: guid('map', 992),
+    path: '/ui/DefaultGroup/MapHud/Legend/LegendTitle',
+    modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: lgW, parentH: lgH, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: lgW - 20, y: 32 }, pos: { x: 0, y: lgH / 2 - 26 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '노드 종류', fontSize: 22, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  let lgId = 993;
+  LEGEND.forEach(([t, ko], i) => {
+    const rowY = lgH / 2 - 78 - i * 38;
+    map.push(entity({
+      id: guid('map', lgId++),
+      path: `/ui/DefaultGroup/MapHud/Legend/Icon_${t}`,
+      modelId: 'uisprite', entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 2,
+      components: [
+        transform({ parentW: lgW, parentH: lgH, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 36, y: 36 }, pos: { x: -lgW / 2 + 38, y: rowY } }),
+        sprite({ dataId: NODEICONS.icons[t], color: { r: 1, g: 1, b: 1, a: 1 }, type: 0, raycast: false }),
+      ],
+    }));
+    map.push(entity({
+      id: guid('map', lgId++),
+      path: `/ui/DefaultGroup/MapHud/Legend/Label_${t}`,
+      modelId: 'uitext', entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 2,
+      components: [
+        transform({ parentW: lgW, parentH: lgH, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: lgW - 110, y: 30 }, pos: { x: 32, y: rowY } }),
+        sprite({ color: TRANSPARENT }),
+        text({ value: ko, fontSize: 19, bold: false, color: { r: 0.9, g: 0.92, b: 0.96, a: 1 }, alignment: 4 }),
+      ],
+    }));
+  });
+  return map;
+}

tools/deck/hud/rest.mjs

@@ -0,0 +1,61 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildRest() {
+  const rest = [];
+  const restHud = entity({
+    id: guid('rst', 0),
+    path: '/ui/DefaultGroup/RestHud',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 9,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.05, g: 0.08, b: 0.06, a: 0.92 }, type: 1, raycast: true }),
+    ],
+  });
+  restHud.jsonString.enable = false;
+  rest.push(restHud);
+  rest.push(entity({
+    id: guid('rst', 1),
+    path: '/ui/DefaultGroup/RestHud/Title',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 700, y: 60 }, pos: { x: 0, y: 140 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '휴식', fontSize: 44, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  rest.push(entity({
+    id: guid('rst', 2),
+    path: '/ui/DefaultGroup/RestHud/Info',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 600, y: 50 }, pos: { x: 0, y: 30 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: 'HP 회복', fontSize: 30, bold: true, color: { r: 1, g: 1, b: 1, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  rest.push(entity({
+    id: guid('rst', 3),
+    path: '/ui/DefaultGroup/RestHud/Leave',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 2,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 200, y: 60 }, pos: { x: 0, y: -120 } }),
+      sprite({ color: DARK, type: 1, raycast: true }),
+      button(),
+      text({ value: '나가기', fontSize: 26, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  return rest;
+}

tools/deck/hud/reward.mjs

@@ -0,0 +1,98 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildReward() {
+  const reward = [];
+  const rewardHud = entity({
+    id: guid('rwd', 0),
+    path: '/ui/DefaultGroup/RewardHud',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 6,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.04, g: 0.05, b: 0.07, a: 0.86 }, type: 1, raycast: true }),
+    ],
+  });
+  rewardHud.jsonString.enable = false;
+  reward.push(rewardHud);
+  reward.push(entity({
+    id: guid('rwd', 1),
+    path: '/ui/DefaultGroup/RewardHud/Title',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 700, y: 64 }, pos: { x: 0, y: 300 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '보상 카드 선택', fontSize: 44, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  const rewardXs = [-300, 0, 300];
+  // 카드 단위 엔티티 v2 네임스페이스 — DeckInspectHud 주석 참조
+  for (let i = 1; i <= 3; i++) {
+    const rwdBase = 2 + (i - 1) * 7;
+    const cardPath = `/ui/DefaultGroup/RewardHud/Reward${i}`;
+    reward.push(entity({
+      id: guid('rwd2', rwdBase),
+      path: cardPath,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.UITouchReceiveComponent',
+      displayOrder: i,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: CARD_W, y: CARD_H }, pos: { x: rewardXs[i - 1], y: 0 } }),
+        sprite({ dataId: CARDFRAMES.frames.warrior.normal, color: WHITE, type: 0, raycast: true }),
+        button(),
+        { '@type': 'MOD.Core.UITouchReceiveComponent', Enable: true },
+      ],
+    }));
+    const rewardLayout = cardFaceLayout(CARD_W);
+    for (const [tIdx, [suffix, cfg]] of rewardLayout.texts.map(([sfx, c]) => [sfx, { ...c, value: sfx === 'Cost' ? '1' : sfx === 'Name' ? '카드' : '' }]).entries()) {
+      const dOrder = suffix === 'Cost' ? 7 : suffix === 'Name' ? 6 : 8;
+      reward.push(entity({
+        id: guid('rwd2', rwdBase + 1 + tIdx),
+        path: `${cardPath}/${suffix}`,
+        modelId: 'uitext',
+        entryId: 'UIText',
+        componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+        displayOrder: dOrder,
+        components: [
+          transform({ parentW: CARD_W, parentH: CARD_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: cfg.size, pos: cfg.pos }),
+          sprite({ color: TRANSPARENT }),
+          text({ value: cfg.value, fontSize: cfg.fontSize, bold: cfg.bold, color: cfg.color, dropShadow: cfg.dropShadow, outlineWidth: cfg.outlineWidth }),
+        ],
+      }));
+    }
+    reward.push(entity({
+      id: guid('rwd2', rwdBase + 6),
+      path: `${cardPath}/Art`,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 5,
+      components: [
+        transform({ parentW: CARD_W, parentH: CARD_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: rewardLayout.art.size, pos: rewardLayout.art.pos }),
+        sprite({ color: WHITE, type: 0, raycast: false }),
+      ],
+    }));
+  }
+  let rwdN = 2 + 3 * 7; // 구 시퀀스의 루프 종료 시점 값(23) 보존 — Skip 등 후속 id 불변
+  reward.push(entity({
+    id: guid('rwd', rwdN++),
+    path: '/ui/DefaultGroup/RewardHud/Skip',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 10,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 200, y: 60 }, pos: { x: 0, y: -260 } }),
+      sprite({ color: DARK, type: 1, raycast: true }),
+      button(),
+      text({ value: '건너뛰기', fontSize: 26, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  return reward;
+}

tools/deck/hud/shop.mjs

@@ -0,0 +1,203 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildShop() {
+  const shop = [];
+  const shopHud = entity({
+    id: guid('shp', 0),
+    path: '/ui/DefaultGroup/ShopHud',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 8,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.05, g: 0.06, b: 0.09, a: 0.92 }, type: 1, raycast: true }),
+    ],
+  });
+  shopHud.jsonString.enable = false;
+  shop.push(shopHud);
+  shop.push(entity({
+    id: guid('shp', 1),
+    path: '/ui/DefaultGroup/ShopHud/Title',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 700, y: 60 }, pos: { x: 0, y: 400 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '상점', fontSize: 44, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  shop.push(entity({
+    id: guid('shp', 2),
+    path: '/ui/DefaultGroup/ShopHud/Gold',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 300, y: 44 }, pos: { x: 0, y: 330 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '메소 0', fontSize: 28, bold: true, color: { r: 0.98, g: 0.85, b: 0.4, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  shop.push(entity({
+    id: guid('shp', 3),
+    path: '/ui/DefaultGroup/ShopHud/MesoIcon',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 30, y: 30 }, pos: { x: -86, y: 330 } }),
+      sprite({ color: { r: 1, g: 0.82, b: 0.2, a: 1 }, type: 1 }),
+    ],
+  }));
+  const shopXs = [-300, 0, 300];
+  // 카드 단위 엔티티 v2 네임스페이스 (stride 8: Price 포함) — DeckInspectHud 주석 참조
+  for (let i = 1; i <= 3; i++) {
+    const shpBase = 3 + (i - 1) * 8;
+    const cardPath = `/ui/DefaultGroup/ShopHud/Card${i}`;
+    shop.push(entity({
+      id: guid('shp2', shpBase),
+      path: cardPath,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.UITouchReceiveComponent',
+      displayOrder: i,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: CARD_W, y: CARD_H }, pos: { x: shopXs[i - 1], y: 20 } }),
+        sprite({ dataId: CARDFRAMES.frames.warrior.normal, color: WHITE, type: 0, raycast: true }),
+        button(),
+        { '@type': 'MOD.Core.UITouchReceiveComponent', Enable: true },
+      ],
+    }));
+    const shopLayout = cardFaceLayout(CARD_W);
+    const shopTexts = shopLayout.texts.map(([sfx, c]) => [sfx, { ...c, value: sfx === 'Cost' ? '1' : sfx === 'Name' ? '카드' : '' }]);
+    shopTexts.push(['Price', { size: { x: 160, y: 40 }, pos: { x: 0, y: -135 }, value: '30 메소', fontSize: 22, bold: true, color: { r: 0.98, g: 0.85, b: 0.4, a: 1 } }]);
+    for (const [tIdx, [suffix, cfg]] of shopTexts.entries()) {
+      const dOrder = suffix === 'Cost' ? 7 : suffix === 'Name' ? 6 : suffix === 'Desc' ? 8 : 9;
+      shop.push(entity({
+        id: guid('shp2', shpBase + 1 + tIdx),
+        path: `${cardPath}/${suffix}`,
+        modelId: 'uitext',
+        entryId: 'UIText',
+        componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+        displayOrder: dOrder,
+        components: [
+          transform({ parentW: CARD_W, parentH: CARD_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: cfg.size, pos: cfg.pos }),
+          sprite({ color: TRANSPARENT }),
+          text({ value: cfg.value, fontSize: cfg.fontSize, bold: cfg.bold, color: cfg.color, dropShadow: cfg.dropShadow, outlineWidth: cfg.outlineWidth }),
+        ],
+      }));
+    }
+    shop.push(entity({
+      id: guid('shp2', shpBase + 7),
+      path: `${cardPath}/Art`,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+      displayOrder: 5,
+      components: [
+        transform({ parentW: CARD_W, parentH: CARD_H, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: shopLayout.art.size, pos: shopLayout.art.pos }),
+        sprite({ color: WHITE, type: 0, raycast: false }),
+      ],
+    }));
+  }
+  let shpN = 3 + 3 * 8; // 구 시퀀스의 루프 종료 시점 값(27) 보존 — Relic 등 후속 id 불변
+  shop.push(entity({
+    id: guid('shp', shpN++),
+    path: '/ui/DefaultGroup/ShopHud/Relic',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent',
+    displayOrder: 9,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 560, y: 76 }, pos: { x: 0, y: -190 } }),
+      sprite({ color: { r: 0.7, g: 0.55, b: 0.85, a: 1 }, type: 1, raycast: true }),
+      button(),
+    ],
+  }));
+  shop.push(entity({
+    id: guid('shp', shpN++),
+    path: '/ui/DefaultGroup/ShopHud/Relic/Label',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 560, parentH: 76, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 540, y: 40 }, pos: { x: 0, y: 12 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '유물', fontSize: 22, bold: true, color: { r: 1, g: 1, b: 1, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  shop.push(entity({
+    id: guid('shp', shpN++),
+    path: '/ui/DefaultGroup/ShopHud/Relic/Price',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 560, parentH: 76, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 540, y: 30 }, pos: { x: 0, y: -22 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '60 메소', fontSize: 20, bold: true, color: { r: 0.98, g: 0.85, b: 0.4, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  shop.push(entity({
+    id: guid('shp', shpN++),
+    path: '/ui/DefaultGroup/ShopHud/Potion',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent',
+    displayOrder: 11,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 560, y: 76 }, pos: { x: 0, y: -278 } }),
+      sprite({ color: { r: 0.45, g: 0.7, b: 0.55, a: 1 }, type: 1, raycast: true }),
+      button(),
+    ],
+  }));
+  shop.push(entity({
+    id: guid('shp', shpN++),
+    path: '/ui/DefaultGroup/ShopHud/Potion/Label',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 560, parentH: 76, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 540, y: 40 }, pos: { x: 0, y: 12 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '물약', fontSize: 22, bold: true, color: { r: 1, g: 1, b: 1, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  shop.push(entity({
+    id: guid('shp', shpN++),
+    path: '/ui/DefaultGroup/ShopHud/Potion/Price',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 560, parentH: 76, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 540, y: 30 }, pos: { x: 0, y: -22 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '20 메소', fontSize: 20, bold: true, color: { r: 0.98, g: 0.85, b: 0.4, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  shop.push(entity({
+    id: guid('shp', shpN++),
+    path: '/ui/DefaultGroup/ShopHud/Leave',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 10,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 200, y: 60 }, pos: { x: 0, y: -380 } }),
+      sprite({ color: DARK, type: 1, raycast: true }),
+      button(),
+      text({ value: '나가기', fontSize: 26, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  return shop;
+}

tools/deck/hud/soulshop.mjs

@@ -0,0 +1,90 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildSoulShop() {
+  const soulShop = [];
+  let soulId = 0;
+  const soulRoot = entity({
+    id: guid('soul', soulId++),
+    path: '/ui/DefaultGroup/SoulShopHud',
+    modelId: 'uisprite', entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 15,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.05, g: 0.06, b: 0.09, a: 0.95 }, type: 1, raycast: true }),
+    ],
+  });
+  soulRoot.jsonString.enable = false;
+  soulShop.push(soulRoot);
+  soulShop.push(entity({
+    id: guid('soul', soulId++),
+    path: '/ui/DefaultGroup/SoulShopHud/Title',
+    modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 700, y: 60 }, pos: { x: 0, y: 410 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '영혼 상점', fontSize: 44, bold: true, color: { r: 0.6, g: 0.85, b: 1, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  soulShop.push(entity({
+    id: guid('soul', soulId++),
+    path: '/ui/DefaultGroup/SoulShopHud/Souls',
+    modelId: 'uitext', entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 400, y: 44 }, pos: { x: 0, y: 345 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '영혼 0', fontSize: 28, bold: true, color: { r: 0.6, g: 0.85, b: 1, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  soulShop.push(entity({
+    id: guid('soul', soulId++),
+    path: '/ui/DefaultGroup/SoulShopHud/Close',
+    modelId: 'uibutton', entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 2,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 200, y: 60 }, pos: { x: 0, y: -400 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.2, g: 0.24, b: 0.3, a: 1 }, type: 1, raycast: true }),
+      button(),
+      text({ value: '닫기', fontSize: 28, bold: true, color: WHITE, alignment: 4 }),
+    ],
+  }));
+  for (let i = 1; i <= 4; i++) {
+    const ip = `/ui/DefaultGroup/SoulShopHud/Item${i}`;
+    const iy = 230 - (i - 1) * 125;
+    soulShop.push(entity({
+      id: guid('soul', soulId++),
+      path: ip, modelId: 'uibutton', entryId: 'UIButton',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent',
+      displayOrder: 2,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 760, y: 104 }, pos: { x: 0, y: iy }, align: ALIGN_CENTER }),
+        sprite({ color: { r: 0.14, g: 0.16, b: 0.22, a: 1 }, type: 1, raycast: true }),
+        button(),
+      ],
+    }));
+    for (const [suffix, x, y, w, fs, color] of [
+      ['Name', -180, 22, 360, 28, GOLD],
+      ['Desc', -180, -24, 440, 20, { r: 0.86, g: 0.9, b: 0.94, a: 1 }],
+      ['Status', 270, 0, 220, 22, { r: 0.6, g: 0.85, b: 1, a: 1 }],
+    ]) {
+      soulShop.push(entity({
+        id: guid('soul', soulId++),
+        path: `${ip}/${suffix}`, modelId: 'uitext', entryId: 'UIText',
+        componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+        displayOrder: 1,
+        components: [
+          transform({ parentW: 760, parentH: 104, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: w, y: 38 }, pos: { x, y } }),
+          sprite({ color: TRANSPARENT }),
+          text({ value: '', fontSize: fs, bold: suffix === 'Name', color, alignment: 4 }),
+        ],
+      }));
+    }
+  }
+  return soulShop;
+}

tools/deck/hud/treasure.mjs

@@ -0,0 +1,89 @@
+import { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection } from '../lib/ui-helpers.mjs';
+import { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable } from '../lib/data.mjs';
+
+export function buildTreasure() {
+  const treasure = [];
+  const treasureHud = entity({
+    id: guid('trs', 0),
+    path: '/ui/DefaultGroup/TreasureHud',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
+    displayOrder: 8,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 1920, y: 1080 }, pos: { x: 0, y: 0 }, align: ALIGN_CENTER }),
+      sprite({ color: { r: 0.05, g: 0.06, b: 0.09, a: 0.92 }, type: 1, raycast: true }),
+    ],
+  });
+  treasureHud.jsonString.enable = false;
+  treasure.push(treasureHud);
+  treasure.push(entity({
+    id: guid('trs', 1),
+    path: '/ui/DefaultGroup/TreasureHud/Title',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 0,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 700, y: 60 }, pos: { x: 0, y: 320 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '보물 상자', fontSize: 40, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  treasure.push(entity({
+    id: guid('trs', 2),
+    path: '/ui/DefaultGroup/TreasureHud/Chest',
+    modelId: 'uisprite',
+    entryId: 'UISprite',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent',
+    displayOrder: 1,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 180, y: 180 }, pos: { x: 0, y: 40 } }),
+      sprite({ dataId: CHEST_CLOSED_RUID, color: { r: 1, g: 1, b: 1, a: 1 }, type: 0, raycast: true }),
+      button(),
+    ],
+  }));
+  treasure.push(entity({
+    id: guid('trs', 3),
+    path: '/ui/DefaultGroup/TreasureHud/Hint',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 2,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 500, y: 34 }, pos: { x: 0, y: -90 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '상자를 클릭해 여세요', fontSize: 20, bold: false, color: { r: 0.85, g: 0.85, b: 0.9, a: 1 }, alignment: 4 }),
+    ],
+  }));
+  const treasureReward = entity({
+    id: guid('trs', 4),
+    path: '/ui/DefaultGroup/TreasureHud/Reward',
+    modelId: 'uitext',
+    entryId: 'UIText',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+    displayOrder: 3,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 800, y: 44 }, pos: { x: 0, y: -160 } }),
+      sprite({ color: TRANSPARENT }),
+      text({ value: '', fontSize: 28, bold: true, color: { r: 0.98, g: 0.85, b: 0.4, a: 1 }, alignment: 4 }),
+    ],
+  });
+  treasureReward.jsonString.enable = false;
+  treasure.push(treasureReward);
+  treasure.push(entity({
+    id: guid('trs', 5),
+    path: '/ui/DefaultGroup/TreasureHud/Leave',
+    modelId: 'uibutton',
+    entryId: 'UIButton',
+    componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent,MOD.Core.TextComponent',
+    displayOrder: 4,
+    components: [
+      transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 200, y: 60 }, pos: { x: 0, y: -280 } }),
+      sprite({ color: DARK, type: 1, raycast: true }),
+      button(),
+      text({ value: '나가기', fontSize: 26, bold: true, color: GOLD, alignment: 4 }),
+    ],
+  }));
+  return treasure;
+}

tools/deck/lib/codeblock.mjs

@@ -0,0 +1,60 @@
+function prop(Type, Name, DefaultValue = 'nil') {
+  return { Type, DefaultValue, SyncDirection: 0, Attributes: [], Name };
+}
+
+function method(Name, Code, Arguments = [], ExecSpace = 0, ReturnType = 'void') {
+  return {
+    Return: { Type: ReturnType, DefaultValue: null, SyncDirection: 0, Attributes: [], Name: null },
+    Arguments,
+    Code,
+    Scope: 2,
+    ExecSpace,
+    Attributes: [],
+    Name,
+  };
+}
+
+function codeblock(id, name, properties, methods) {
+  return {
+    Id: '',
+    GameId: '',
+    EntryKey: `codeblock://${id}`,
+    ContentType: 'x-mod/codeblock',
+    Content: '',
+    Usage: 0,
+    UsePublish: 1,
+    UseService: 0,
+    CoreVersion: '26.5.0.0',
+    StudioVersion: '',
+    DynamicLoading: 0,
+    ContentProto: {
+      Use: 'Json',
+      Json: {
+        CoreVersion: { Major: 0, Minor: 2 },
+        ScriptVersion: { Major: 1, Minor: 0 },
+        Description: '',
+        Id: id,
+        Language: 1,
+        Name: name,
+        Type: 1,
+        Source: 0,
+        Target: null,
+        Properties: properties,
+        Methods: methods,
+        EntityEventHandlers: [],
+      },
+    },
+  };
+}
+
+const RUN_LENGTH = 5;
+const GOLD_PER_WIN = 25;
+const CARD_PRICE = 30;
+const REST_HEAL = 30;
+const RELIC_PRICE = 60;
+const ACT_COUNT = 5;
+const ACT_MAPS = ['map01', 'map02', 'map03', 'map04', 'map05'];
+const LOBBY_MAP = 'lobby';
+const LOBBY_SPAWN = 'Vector3(-5, 0.03, 0)'; // 정찰: map01 지면 좌측
+
+export { prop, method, codeblock, RUN_LENGTH, GOLD_PER_WIN, CARD_PRICE, REST_HEAL, RELIC_PRICE, ACT_COUNT, ACT_MAPS, LOBBY_MAP, LOBBY_SPAWN };

tools/deck/lib/data.mjs

@@ -0,0 +1,197 @@
+import { readFileSync } from 'node:fs';
+
+const CARDS = JSON.parse(readFileSync('data/cards.json', 'utf8'));
+const ENEMIES = JSON.parse(readFileSync('data/enemies.json', 'utf8'));
+
+// 검증 (fail-fast): 잘못된 데이터면 생성 중단
+const CLASSES = {
+  warrior: { label: '전사', maxHp: 80 },
+  bandit: { label: '도적', maxHp: 70 },
+  magician: { label: '마법사', maxHp: 70 },
+};
+for (const cls of Object.keys(CLASSES)) {
+  if (!CARDS.starterDecks?.[cls]) throw new Error(`[gen-slaydeck] starterDecks.${cls} 없음`);
+  for (const id of CARDS.starterDecks[cls]) {
+    if (!CARDS.cards[id]) throw new Error(`[gen-slaydeck] starterDecks.${cls}에 없는 카드 id 참조: ${id}`);
+  }
+}
+// 전직 옵션 (클래스별 2차 — JobSelectHud 동적 구성·SetJob 대표 카드)
+const JOBS = {
+  warrior: [
+    { id: 'fighter', name: '파이터', desc: '공격 특화\n콤보 어택 · 버서크\n라이징 어택', starter: 'ComboAttack' },
+    { id: 'page', name: '페이지', desc: '속성 차지 특화\n썬더/블리자드 차지\n파워 가드', starter: 'ThunderCharge' },
+    { id: 'spearman', name: '스피어맨', desc: '방어·관통 특화\n피어스 · 아이언 월\n하이퍼 바디', starter: 'Pierce' },
+  ],
+  magician: [
+    { id: 'firepoison', name: '위자드(불·독)', desc: '화염·독 특화\n파이어 애로우\n포이즌 브레스 · 앰플', starter: 'FireArrow' },
+    { id: 'icelightning', name: '위자드(썬·콜)', desc: '광역·빙결 특화\n썬더 볼트(전체)\n콜드 빔 · 칠링 스텝', starter: 'ThunderBolt' },
+    { id: 'cleric', name: '클레릭', desc: '회복·축복 특화\n힐 · 블레스\n홀리 애로우', starter: 'Heal' },
+  ],
+  bandit: [
+    { id: 'shiv', name: 'Shiv', desc: 'Many small attacks\nBlade Dance\nAccuracy · After Image', starter: 'BladeDance' },
+    { id: 'poisoner', name: 'Poison', desc: 'Poison scaling\nDeadly Poison\nCatalyst · Noxious Fumes', starter: 'DeadlyPoison' },
+    { id: 'trickster', name: 'Trickster', desc: 'Draw and tempo\nAcrobatics\nAdrenaline · Tools', starter: 'Acrobatics' },
+  ],
+};
+for (const [cls, jobs] of Object.entries(JOBS)) {
+  for (const j of jobs) {
+    if (!CARDS.cards[j.starter]) throw new Error(`[gen-slaydeck] JOBS.${cls}.${j.id} 대표 카드 없음: ${j.starter}`);
+  }
+}
+// 영혼(soul) 메타 해금 — 2차 전직 후 보스 클리어로 영혼 적립, 로비 영혼상점에서 구매 → 다음 런 이점
+const SOUL_UNLOCKS = [
+  { key: 'meso', name: '두둑한 지갑', desc: '런 시작 시 메소 +60', cost: 3 },
+  { key: 'hp', name: '단련된 육체', desc: '시작 최대 HP +15', cost: 4 },
+  { key: 'trim', name: '덱 정제', desc: '시작 덱에서 기본 카드 1장 제거', cost: 5 },
+  { key: 'relic', name: '유물 수집가', desc: '런 시작 시 유물 1개 추가', cost: 6 },
+];
+function luaSoulShopTable(unlocks) {
+  const items = unlocks.map((u) => `\t{ key = ${luaStr(u.key)}, name = ${luaStr(u.name)}, desc = ${luaStr(u.desc)}, cost = ${u.cost} },`).join('\n');
+  return `self.SoulShopDef = {\n${items}\n}`;
+}
+if (!ENEMIES.enemies[ENEMIES.activeEnemy]) {
+  throw new Error(`[gen-slaydeck] activeEnemy가 enemies에 없음: ${ENEMIES.activeEnemy}`);
+}
+
+// 카드 프레임 (사용자 제작 이미지 — 로컬 임포트 .sprite RUID, 직업 3종 × 등급 3종)
+const CARDFRAMES = JSON.parse(readFileSync('data/cardframes.json', 'utf8'));
+const RARITIES = ['normal', 'unique', 'legend'];
+for (const [fid, fr] of Object.entries(CARDFRAMES.frames)) {
+  for (const r of RARITIES) {
+    if (!fr[r]) throw new Error(`[gen-slaydeck] cardframes.frames.${fid}.${r} RUID 없음`);
+  }
+}
+for (const [id, c] of Object.entries(CARDS.cards)) {
+  if (!RARITIES.includes(c.rarity)) throw new Error(`[gen-slaydeck] 카드 ${id} rarity 누락/오류: ${c.rarity}`);
+  const fc = CARDFRAMES.classToFrame[c.class];
+  if (!fc || !CARDFRAMES.frames[fc]) throw new Error(`[gen-slaydeck] 카드 ${id} class ${c.class} → 프레임 매핑 없음`);
+}
+function frameRuid(card) {
+  return CARDFRAMES.frames[CARDFRAMES.classToFrame[card.class]][card.rarity];
+}
+function luaFramesTable() {
+  const frames = Object.entries(CARDFRAMES.frames).map(([fid, fr]) =>
+    `\t${fid} = { normal = ${luaStr(fr.normal)}, unique = ${luaStr(fr.unique)}, legend = ${luaStr(fr.legend)} },`).join('\n');
+  const cls = Object.entries(CARDFRAMES.classToFrame).map(([c, f]) => `\t${c} = ${luaStr(f)},`).join('\n');
+  return `self.CardFrames = {\n${frames}\n}\nself.ClassToFrame = {\n${cls}\n}`;
+}
+function luaNodeIconsTable() {
+  const rows = Object.entries(NODEICONS.icons).map(([t, ruid]) => `\t${t} = ${luaStr(ruid)},`).join('\n');
+  return `self.NodeIcons = {\n${rows}\n}`;
+}
+
+// 맵은 런타임 절차 생성(GenerateMap Lua ↔ tools/map/rogue-map.mjs 미러). 정적 data/map.json 제거됨.
+const MAP_ROWS = 6; // 걷는 행 1..6, 보스 row 7 (depth 최대 7)
+const MAP_COLS = 4;
+
+// 보물 상자 스프라이트 (공식 maplestory 리소스, 메이커 선별)
+const CHEST_CLOSED_RUID = '43df67920c0d43298e0d93c02c6afa71';
+const CHEST_OPEN_RUID = '09c5cee56fd640bf8ae3a18ce50f4759';
+
+// 노드 맵 아이콘/배경 (공식 maplestory RUID, data/nodeicons.json 단일 소스 — 교체 시 이 파일만 수정 후 재생성)
+const NODEICONS = JSON.parse(readFileSync('data/nodeicons.json', 'utf8'));
+for (const t of ['combat', 'elite', 'boss', 'shop', 'rest', 'treasure']) {
+  if (!/^[0-9a-f]{32}$/.test((NODEICONS.icons || {})[t] || '')) throw new Error(`[gen-slaydeck] nodeicons.json icons.${t} RUID 누락/형식오류`);
+}
+if (!/^[0-9a-f]{32}$/.test(NODEICONS.background || '')) throw new Error('[gen-slaydeck] nodeicons.json background RUID 누락/형식오류');
+
+// 캐릭터 선택 초상화 (메이커 임포트 RUID, data/characters.json 단일 소스 — 교체 시 이 파일만 수정 후 재생성)
+const CHARS = JSON.parse(readFileSync('data/characters.json', 'utf8'));
+for (const c of ['warrior', 'magician', 'bandit']) {
+  if (!/^[0-9a-f]{32}$/.test((CHARS.portraits || {})[c] || '')) throw new Error(`[gen-slaydeck] characters.json portraits.${c} RUID 누락/형식오류`);
+}
+
+// 전투 카메라 고정값(StS2: 플레이어 좌·몬스터 우). KickCombatCamera가 StartCombat에서 재confine에 사용.
+const CAM = JSON.parse(readFileSync('data/camera.json', 'utf8'));
+
+const RELICS = JSON.parse(readFileSync('data/relics.json', 'utf8'));
+if (!RELICS.relics[RELICS.startingRelic]) throw new Error(`[gen-slaydeck] startingRelic 없음: ${RELICS.startingRelic}`);
+for (const id of RELICS.relicPool) {
+  if (!RELICS.relics[id]) throw new Error(`[gen-slaydeck] relicPool에 없는 유물 id: ${id}`);
+}
+function luaRelicsTable(relics) {
+  const lines = Object.entries(relics).map(([id, r]) =>
+    `\t${id} = { name = ${luaStr(r.name)}, desc = ${luaStr(r.desc)}, hook = ${luaStr(r.hook)}, effect = ${luaStr(r.effect)}, value = ${r.value}, icon = ${luaStr(r.icon || '')} },`);
+  return `self.Relics = {\n${lines.join('\n')}\n}`;
+}
+
+const POTIONS = JSON.parse(readFileSync('data/potions.json', 'utf8'));
+for (const [pid, p] of Object.entries(POTIONS.potions)) {
+  if (!p.name || !p.effect || p.value == null) throw new Error(`[gen-slaydeck] potion 필드 누락: ${pid}`);
+}
+function luaPotionsTable(potions) {
+  const lines = Object.entries(potions).map(([id, p]) =>
+    `\t${id} = { name = ${luaStr(p.name)}, desc = ${luaStr(p.desc)}, effect = ${luaStr(p.effect)}, value = ${p.value}, icon = ${luaStr(p.icon || '')} },`);
+  return `self.Potions = {\n${lines.join('\n')}\n}`;
+}
+
+function luaIntentsArray(intents) {
+  return '{ ' + intents.map((it) => {
+    const fields = [`kind = ${luaStr(it.kind)}`, `value = ${it.value != null ? it.value : 0}`];
+    if (it.effect != null) fields.push(`effect = ${luaStr(it.effect)}`);
+    if (it.card != null) fields.push(`card = ${luaStr(it.card)}`);
+    if (it.count != null) fields.push(`count = ${it.count}`);
+    return `{ ${fields.join(', ')} }`;
+  }).join(', ') + ' }';
+}
+function luaEnemiesTable(enemies) {
+  const lines = Object.entries(enemies).map(([id, e]) =>
+    `\t${id} = { name = ${luaStr(e.name)}, maxHp = ${e.maxHp}, intents = ${luaIntentsArray(e.intents)} },`);
+  return `self.Enemies = {\n${lines.join('\n')}\n}`;
+}
+// Lua 직렬화 헬퍼
+function luaStr(s) {
+  return '"' + String(s).replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n') + '"';
+}
+function luaJobsTable(jobs) {
+  const cls = Object.entries(jobs).map(([clsId, list]) => {
+    const items = list.map((j) => `\t\t{ id = ${luaStr(j.id)}, name = ${luaStr(j.name)}, desc = ${luaStr(j.desc)}, starter = ${luaStr(j.starter)} },`).join('\n');
+    return `\t${clsId} = {\n${items}\n\t},`;
+  }).join('\n');
+  return `self.Jobs = {\n${cls}\n}`;
+}
+function luaCardsTable(cards) {
+  const lines = Object.entries(cards).map(([id, c]) => {
+    const fields = [`name = ${luaStr(c.name)}`, `cost = ${c.cost}`, `desc = ${luaStr(c.desc)}`, `kind = ${luaStr(c.kind)}`];
+    if (c.damage != null) fields.push(`damage = ${c.damage}`);
+    if (c.block != null) fields.push(`block = ${c.block}`);
+    if (c.strength != null) fields.push(`strength = ${c.strength}`);
+    if (c.dex != null) fields.push(`dex = ${c.dex}`);
+    if (c.thorns != null) fields.push(`thorns = ${c.thorns}`);
+    if (c.weak != null) fields.push(`weak = ${c.weak}`);
+    if (c.vuln != null) fields.push(`vuln = ${c.vuln}`);
+    if (c.powerEffect != null) fields.push(`powerEffect = ${luaStr(c.powerEffect)}`);
+    if (c.value != null) fields.push(`value = ${c.value}`);
+    if (!c.class) throw new Error(`[gen-slaydeck] 카드 ${id}에 class 누락`);
+    fields.push(`class = ${luaStr(c.class)}`);
+    fields.push(`rarity = ${luaStr(c.rarity)}`);
+    if (c.hits != null) fields.push(`hits = ${c.hits}`);
+    if (c.pierce === true) fields.push('pierce = true');
+    if (c.selfVuln != null) fields.push(`selfVuln = ${c.selfVuln}`);
+    if (c.draw != null) fields.push(`draw = ${c.draw}`);
+    if (c.heal != null) fields.push(`heal = ${c.heal}`);
+    if (c.poison != null) fields.push(`poison = ${c.poison}`);
+    if (c.discard != null) fields.push(`discard = ${c.discard}`);
+    if (c.discardAll === true) fields.push('discardAll = true');
+    if (c.addShiv != null) fields.push(`addShiv = ${c.addShiv}`);
+    if (c.turnStartShiv != null) fields.push(`turnStartShiv = ${c.turnStartShiv}`);
+    if (c.addShivPerDiscard === true) fields.push('addShivPerDiscard = true');
+    if (c.sly === true) fields.push('sly = true');
+    if (c.retain === true) fields.push('retain = true');
+    if (c.exhaust === true || String(c.desc || '').includes('소멸.')) fields.push('exhaust = true');
+    if (c.aoe === true) fields.push('aoe = true');
+    if (c.unplayable === true) fields.push('unplayable = true');
+    if (c.curse === true) fields.push('curse = true');
+    if (c.token === true) fields.push('token = true');
+    if (c.endTurnDamage != null) fields.push(`endTurnDamage = ${c.endTurnDamage}`);
+    if (c.fx != null) fields.push(`fx = ${luaStr(c.fx)}`);
+    if (c.image != null) fields.push(`image = ${luaStr(c.image)}`);
+    return `\t${id} = { ${fields.join(', ')} },`;
+  });
+  return `self.Cards = {\n${lines.join('\n')}\n}`;
+}
+function luaDeckTable(deck) {
+  return `self.DrawPile = { ${deck.map(luaStr).join(', ')} }`;
+}
+
+export { CARDS, ENEMIES, CLASSES, JOBS, SOUL_UNLOCKS, luaSoulShopTable, CARDFRAMES, RARITIES, frameRuid, luaFramesTable, luaNodeIconsTable, MAP_ROWS, MAP_COLS, CHEST_CLOSED_RUID, CHEST_OPEN_RUID, NODEICONS, CHARS, CAM, RELICS, luaRelicsTable, POTIONS, luaPotionsTable, luaIntentsArray, luaEnemiesTable, luaStr, luaJobsTable, luaCardsTable, luaDeckTable };

tools/deck/lib/ui-helpers.mjs

@@ -0,0 +1,340 @@
+const UI_FILE = 'ui/DefaultGroup.ui';
+const COMMON_FILE = 'Global/common.gamelogic';
+const UI_ROOT = '/ui/DefaultGroup';
+const GENERATED_UI_SECTIONS = [
+  'DeckHud',
+  'DeckInspectHud',
+  'DeckAllHud',
+  'CombatHud',
+  'RewardHud',
+  'MapHud',
+  'ShopHud',
+  'RestHud',
+  'TreasureHud',
+  'JobChoiceHud',
+  'JobSelectHud',
+  'MainMenu',
+  'CharacterSelectHud',
+  'LobbyHud',
+  'BoardHud',
+  'SoulShopHud',
+];
+const UI_APPEND_ORDER = [
+  'DeckHud',
+  'CombatHud',
+  'RewardHud',
+  'MapHud',
+  'ShopHud',
+  'RestHud',
+  'TreasureHud',
+  'JobChoiceHud',
+  'JobSelectHud',
+  'DeckInspectHud',
+  'DeckAllHud',
+  'MainMenu',
+  'CharacterSelectHud',
+  'LobbyHud',
+  'BoardHud',
+  'SoulShopHud',
+];
+const DISABLED_STOCK_CONTROLS = ['Button_Attack', 'Button_Jump', 'UIJoystick'];
+
+const TRANSPARENT = { r: 0, g: 0, b: 0, a: 0 };
+const DARK = { r: 0.08, g: 0.09, b: 0.11, a: 0.92 };
+const GOLD = { r: 0.94, g: 0.74, b: 0.26, a: 1 };
+const ATTACK = { r: 0.86, g: 0.42, b: 0.38, a: 1 };
+const DEFEND = { r: 0.42, g: 0.55, b: 0.85, a: 1 };
+const SKILL = { r: 0.46, g: 0.68, b: 0.52, a: 1 };
+const DAMAGE_DIGIT_RUIDS = [
+  'b94c19830538447f81617035d89bcc05',
+  '01b023122a6f4a5789e1d4c61ff8f430',
+  '57ff71d1b9eb471b9feb1c15348770c9',
+  'cab92837798a42ad9143c67e93f999e1',
+  '366f271f9ca94a0684083aad9298efad',
+  '5c7a6ad38491466aa84bf450e0fdcf25',
+  '7d82a6838e1b4f4a8a0f7420db34c985',
+  'c0765bb1e47d46ffbe1df4ac19ea9b1b',
+  '6ea0bfed61e149f88a9b3f22dd79774f',
+  '82ad2acaae4e4b3fb87bf73635250d22',
+];
+const DAMAGE_POP_MAX_DIGITS = 5;
+const DAMAGE_POP_DIGIT_W = 22;
+const DAMAGE_POP_DIGIT_H = 32;
+const DAMAGE_POP_DIGIT_SPACING = -4;
+
+const MAX_MONSTERS = 4;
+const HEAD_OFFSET_Y = 1.4; // 몬스터 월드 원점 위로 띄울 높이(머리 위) — world→screen 변환 전 가산
+
+const HP_BAR_W = 140;
+const WHITE = { r: 1, g: 1, b: 1, a: 1 };
+const CARD_NAME_TEXT = { r: 1, g: 0.92, b: 0.62, a: 1 };
+const CARD_DESC_TEXT = { r: 0.98, g: 0.96, b: 0.9, a: 1 };
+// 카드 프레임(1054×1492 원본) 슬롯 레이아웃 — 픽셀 실측을 180×250 카드 좌표로 환산한 기준값을 폭 비례 스케일.
+// 실측(워리어·메이지·밴딧 공통): 육각 중심 (120,127)→(-70,104) · 배너 본체 y55..165, x215..1015→중심 (+15,+107)
+// · 설명 박스 y~1030..1480→중심 (0,-86) · 아트 영역 y260..1030→중심 (0,+17)
+function cardFaceLayout(W) {
+  const s = W / 180;
+  const r = (v) => Math.round(v * s);
+  return {
+    texts: [
+      ['Cost', { size: { x: r(40), y: r(40) }, pos: { x: r(-70), y: r(104) }, fontSize: r(24), bold: true, color: WHITE, dropShadow: false, outlineWidth: 2 }],
+      ['Name', { size: { x: r(142), y: r(28) }, pos: { x: r(15), y: r(106) }, fontSize: r(17), bold: true, color: CARD_NAME_TEXT, dropShadow: false, outlineWidth: 2 }],
+      ['Desc', { size: { x: r(158), y: r(78) }, pos: { x: 0, y: r(-82) }, fontSize: r(14), bold: true, color: CARD_DESC_TEXT, dropShadow: false, outlineWidth: 2 }],
+    ],
+    art: { size: { x: r(112), y: r(112) }, pos: { x: 0, y: r(17) } },
+  };
+}
+const CARD_W = 180;
+const CARD_H = 250;
+const CARD_SPACING = 200;
+const CARD_XS = [-400, -200, 0, 200, 400];
+
+const ALIGN_CENTER = 0;
+const ALIGN_BOTTOM_CENTER = 6;
+
+function guid(prefix, n) {
+  // 유효한 8-4-4-4-12 hex GUID 생성. prefix는 충돌 방지용 네임스페이스 바이트로 매핑.
+  const ns = prefix === 'hud' ? 0xd0 : prefix === 'dck' ? 0xca : prefix === 'cmb' ? 0xcb : prefix === 'rwd' ? 0xcc : prefix === 'map' ? 0xcd : prefix === 'shp' ? 0xce : prefix === 'rst' ? 0xcf : prefix === 'menu' ? 0xe0 : prefix === 'ins' ? 0xe1 : prefix === 'all' ? 0xe2 : prefix === 'trs' ? 0xe3 : prefix === 'job' ? 0xe4
+    : prefix === 'ins2' ? 0xe5 : prefix === 'all2' ? 0xe6 : prefix === 'rwd2' ? 0xe7 : prefix === 'shp2' ? 0xe8 : prefix === 'lob' ? 0xe9 : prefix === 'brd' ? 0xea : prefix === 'soul' ? 0xeb : 0xfe;
+  const v = (ns * 0x100000 + n) >>> 0;
+  return `${v.toString(16).padStart(8, '0')}-0000-4000-8000-${v.toString(16).padStart(12, '0')}`;
+}
+
+function transform({ parentW, parentH, anchor, pivot, size, pos, align = 0 }) {
+  const offMin = { x: pos.x - pivot.x * size.x, y: pos.y - pivot.y * size.y };
+  const offMax = { x: pos.x + (1 - pivot.x) * size.x, y: pos.y + (1 - pivot.y) * size.y };
+  return {
+    '@type': 'MOD.Core.UITransformComponent',
+    ActivePlatform: 255,
+    AlignmentOption: align,
+    AnchorsMax: anchor,
+    AnchorsMin: anchor,
+    MobileOnly: false,
+    OffsetMax: offMax,
+    OffsetMin: offMin,
+    Pivot: pivot,
+    RectSize: size,
+    UIMode: 1,
+    UIScale: { x: 1, y: 1, z: 1 },
+    UIVersion: 2,
+    anchoredPosition: pos,
+    Position: { x: anchor.x * parentW - parentW / 2 + pos.x, y: anchor.y * parentH - parentH / 2 + pos.y, z: 0 },
+    QuaternionRotation: { x: 0, y: 0, z: 0, w: 1 },
+    Scale: { x: 1, y: 1, z: 1 },
+    Enable: true,
+  };
+}
+
+function sprite({ dataId = '', color = TRANSPARENT, type = 1, raycast = false }) {
+  return {
+    '@type': 'MOD.Core.SpriteGUIRendererComponent',
+    AnimClipPlayType: 0,
+    EndFrameIndex: 2147483647,
+    ImageRUID: { DataId: dataId },
+    LocalPosition: { x: 0, y: 0 },
+    LocalScale: { x: 1, y: 1 },
+    OverrideSorting: false,
+    PlayRate: 1,
+    PreserveSprite: 0,
+    StartFrameIndex: 0,
+    Color: color,
+    DropShadow: false,
+    DropShadowAngle: 30,
+    DropShadowColor: { r: 0, g: 0, b: 0, a: 0.72 },
+    DropShadowDistance: 32,
+    FillAmount: 1,
+    FillCenter: true,
+    FillClockWise: true,
+    FillMethod: 0,
+    FillOrigin: 0,
+    FlipX: false,
+    FlipY: false,
+    FrameColumn: 1,
+    FrameRate: 0,
+    FrameRow: 1,
+    Outline: false,
+    OutlineColor: { r: 0, g: 0, b: 0, a: 1 },
+    OutlineWidth: 3,
+    RaycastTarget: raycast,
+    Type: type,
+    Enable: true,
+  };
+}
+
+function button({ enabled = true } = {}) {
+  return {
+    '@type': 'MOD.Core.ButtonComponent',
+    Colors: {
+      NormalColor: { r: 1, g: 1, b: 1, a: 1 },
+      HighlightedColor: { r: 0.9607843, g: 0.9607843, b: 0.9607843, a: 1 },
+      PressedColor: { r: 0.784313738, g: 0.784313738, b: 0.784313738, a: 1 },
+      SelectedColor: { r: 0.9607843, g: 0.9607843, b: 0.9607843, a: 1 },
+      DisabledColor: { r: 0.784313738, g: 0.784313738, b: 0.784313738, a: 0.5019608 },
+      ColorMultiplier: 1,
+      FadeDuration: 0.1,
+    },
+    ImageRUIDs: {
+      HighlightedSprite: null,
+      PressedSprite: null,
+      SelectedSprite: null,
+      DisabledSprite: null,
+    },
+    KeyCode: 0,
+    OverrideSorting: false,
+    Transition: 1,
+    Enable: enabled,
+  };
+}
+
+function text({ value, fontSize, bold = false, color = { r: 1, g: 1, b: 1, a: 1 }, alignment = 4, dropShadow = false, outlineWidth = 1 }) {
+  return {
+    '@type': 'MOD.Core.TextComponent',
+    Alignment: alignment,
+    Bold: bold,
+    DropShadow: dropShadow,
+    DropShadowAngle: 30,
+    DropShadowColor: { r: 0, g: 0, b: 0, a: 0.72 },
+    DropShadowDistance: dropShadow ? 18 : 32,
+    Font: 0,
+    FontColor: color,
+    FontSize: fontSize,
+    MaxSize: fontSize,
+    MinSize: 8,
+    OutlineColor: { r: 0.08, g: 0.08, b: 0.08, a: 1 },
+    OutlineDistance: { x: 1, y: -1 },
+    OutlineWidth: outlineWidth,
+    Overflow: 0,
+    OverrideSorting: false,
+    Padding: { left: 0, right: 0, top: 0, bottom: 0 },
+    SizeFit: false,
+    Text: value,
+    UseOutLine: true,
+    Enable: true,
+  };
+}
+
+function scrollLayoutGroup({ cellSize, spacing, columns }) {
+  return {
+    '@type': 'MOD.Core.ScrollLayoutGroupComponent',
+    CellSize: cellSize,
+    ChildAlignment: 0,
+    Constraint: 1,
+    ConstraintCount: columns,
+    GridChildAlignment: 0,
+    GridSpacing: spacing,
+    HorizontalScrollBarDirection: 0,
+    IgnoreMapLayerCheck: false,
+    OrderInLayer: 0,
+    OverrideSorting: false,
+    Padding: { left: 16, right: 16, top: 16, bottom: 16 },
+    ReverseArrangement: false,
+    ScrollBarBackgroundColor: { r: 1, g: 1, b: 1, a: 0.18 },
+    ScrollBarBgImageRUID: { DataId: '' },
+    ScrollBarHandleColor: { r: 0.94, g: 0.74, b: 0.26, a: 0.9 },
+    ScrollBarHandleImageRUID: { DataId: '' },
+    ScrollBarThickness: 12,
+    ScrollBarVisible: 2,
+    SortingLayer: 'UI',
+    Spacing: 0,
+    StartAxis: 0,
+    StartCorner: 0,
+    Type: 2,
+    UseScroll: true,
+    VerticalScrollBarDirection: 1,
+    Enable: true,
+  };
+}
+
+function popupLayerFor(path) {
+  if (path.startsWith('/ui/DefaultGroup/DeckAllHud')) return { root: '/ui/DefaultGroup/DeckAllHud', base: 4000 };
+  if (path.startsWith('/ui/DefaultGroup/DeckInspectHud')) return { root: '/ui/DefaultGroup/DeckInspectHud', base: 3000 };
+  return null;
+}
+
+function uiOrderFor(path, displayOrder) {
+  const popup = popupLayerFor(path);
+  if (popup != null) {
+    const relative = path.slice(popup.root.length).split('/').filter(Boolean);
+    return popup.base + relative.length * 100 + displayOrder;
+  }
+  return displayOrder;
+}
+
+function displayOrderFor(path, displayOrder) {
+  return uiOrderFor(path, displayOrder);
+}
+
+function applySortingOverride(path, components, displayOrder) {
+  if (popupLayerFor(path) == null) return components;
+  const order = uiOrderFor(path, displayOrder);
+  return components.map((component) => {
+    if (component['@type'] !== 'MOD.Core.SpriteGUIRendererComponent' && component['@type'] !== 'MOD.Core.TextComponent') {
+      return component;
+    }
+    return {
+      ...component,
+      OverrideSorting: true,
+      SortingLayer: 'UI',
+      OrderInLayer: order,
+    };
+  });
+}
+
+function entity({ id, path, modelId, entryId, componentNames, components, displayOrder }) {
+  const parts = path.split('/');
+  const name = parts[parts.length - 1];
+  const sortedComponents = applySortingOverride(path, components, displayOrder);
+  return {
+    id,
+    path,
+    componentNames,
+    jsonString: {
+      name,
+      path,
+      nameEditable: true,
+      enable: true,
+      visible: true,
+      localize: true,
+      displayOrder: displayOrderFor(path, displayOrder),
+      pathConstraints: '/'.repeat(parts.length - 1),
+      revision: 1,
+      origin: {
+        type: 'Model',
+        entry_id: entryId,
+        sub_entity_id: null,
+        root_entity_id: null,
+        replaced_model_id: null,
+      },
+      modelId,
+      '@components': sortedComponents,
+      '@version': 1,
+    },
+  };
+}
+
+function uiPath(...parts) {
+  return [UI_ROOT, ...parts].join('/');
+}
+
+function sectionRoot(section) {
+  return uiPath(section);
+}
+
+function isGeneratedUiEntity(e) {
+  return GENERATED_UI_SECTIONS.some((section) => e.path.startsWith(sectionRoot(section)));
+}
+
+function appendUiSection(ui, section, entities) {
+  if (!GENERATED_UI_SECTIONS.includes(section)) {
+    throw new Error(`[gen-slaydeck] unknown generated UI section: ${section}`);
+  }
+  const root = sectionRoot(section);
+  for (const e of entities) {
+    if (!e.path.startsWith(root)) {
+      throw new Error(`[gen-slaydeck] ${section} section emitted unexpected path: ${e.path}`);
+    }
+  }
+  ui.ContentProto.Entities.push(...entities);
+}
+
+export { UI_FILE, COMMON_FILE, UI_ROOT, GENERATED_UI_SECTIONS, UI_APPEND_ORDER, DISABLED_STOCK_CONTROLS, TRANSPARENT, DARK, GOLD, ATTACK, DEFEND, SKILL, DAMAGE_DIGIT_RUIDS, DAMAGE_POP_MAX_DIGITS, DAMAGE_POP_DIGIT_W, DAMAGE_POP_DIGIT_H, DAMAGE_POP_DIGIT_SPACING, MAX_MONSTERS, HEAD_OFFSET_Y, HP_BAR_W, WHITE, CARD_NAME_TEXT, CARD_DESC_TEXT, cardFaceLayout, CARD_W, CARD_H, CARD_SPACING, CARD_XS, ALIGN_CENTER, ALIGN_BOTTOM_CENTER, guid, transform, sprite, button, text, scrollLayoutGroup, popupLayerFor, uiOrderFor, displayOrderFor, applySortingOverride, entity, uiPath, sectionRoot, isGeneratedUiEntity, appendUiSection };

tools/map/gen-lobby-map.mjs

@@ -0,0 +1,140 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+
+// 로비 전용 맵 생성기 — map01 템플릿을 클론해 마을(타운) 배경의 로비 맵을 만든다.
+//  · 몬스터 엔티티 전부 제거(전투 없음)
+//  · NPC 4종(모험가/사서/상인/안내원) 월드 엔티티 배치 + 머리 위 마크(근접 시 표시)
+//  · 각 NPC: TouchReceiveComponent(클릭) + script.LobbyNpc(NpcId)
+//  · 맵 루트: script.PlayerLock 제거(이동 허용) + script.LobbyMobility 추가(이동·공격 해제)
+//  · SectorConfig에 map://lobby 등록
+// codeblock 로직(LobbyNpc/LobbyMobility)은 tools/player/gen-lobby-npc.mjs가 emit한다.
+const TEMPLATE = 'map/map01.map';
+const OUT = 'map/lobby.map';
+const SECTOR = 'Global/SectorConfig.config';
+
+const TOWN_BG = '65c4167ea7484196b890022354e5a4a4'; // Henesys (gen-maps.mjs BACKGROUNDS 풀)
+const MARK_RUID = 'bd4afdde295f40318fceb4166978ebaa'; // 공식 maplestory balloon (근접 마크)
+
+// NPC 4종: x좌표는 정찰 기준 walkable 범위[-5,6.6], 근접 임계 1.2와 분리되게 배치
+const NPCS = [
+  { name: 'NpcRun',   id: 'run',   x: -3.0, ruid: '122095fd155c4633867b0da4f375bc3c' }, // 모험가
+  { name: 'NpcCodex', id: 'codex', x: -0.5, ruid: '4c264be6a64f4ac3970b2e6818d04e40' }, // 사서
+  { name: 'NpcShop',  id: 'shop',  x:  2.0, ruid: '69987ccdc486423f8bedd786bd6cb5d9' }, // 상인
+  { name: 'NpcBoard', id: 'board', x:  4.5, ruid: '8a99bd87d667482cb1f3b2193f8a19c1' }, // 안내원
+];
+const MARK_DY = 1.6; // NPC 머리 위 오프셋
+
+// NPC/마크는 정적 스프라이트로 만든다 — 몬스터 AI·물리(중력/충돌)·히트 컴포넌트 전부 제거.
+// (마크는 물리가 있으면 머리 위에서 떨어지고, NPC는 충돌이 있으면 플레이어 통행을 막음)
+const STRIP = new Set([
+  'script.Monster', 'script.MonsterAttack', 'script.CombatMonster',
+  'MOD.Core.RigidbodyComponent', 'MOD.Core.MovementComponent', 'MOD.Core.KinematicbodyComponent',
+  'MOD.Core.SideviewbodyComponent', 'MOD.Core.HitComponent',
+  'MOD.Core.DamageSkinSpawnerComponent', 'MOD.Core.DamageSkinSettingComponent',
+]);
+
+const compOf = (e, type) => e.jsonString['@components'].find((c) => c['@type'] === type);
+const isMonster = (e) => (e.componentNames || '').includes('script.Monster');
+
+// 결정론 GUID — 기존 생성기(map: nn*1000+idx, enc: +500)와 충돌 없는 고유 오프셋
+function lobbyGuid(idx) {
+  const n = (900000 + idx) >>> 0;
+  return `${n.toString(16).padStart(8, '0')}-0000-4000-8000-${n.toString(16).padStart(12, '0')}`;
+}
+
+// 몬스터 템플릿 엔티티를 클론해 스프라이트 엔티티(NPC/마크)로 변환
+function makeSpriteEntity(base, name, x, y, ruid, withInteract, npcId) {
+  const m = JSON.parse(JSON.stringify(base));
+  m.jsonString.name = name;
+  m.path = `/maps/lobby/${name}`;
+  m.jsonString.path = m.path;
+  // NOTE: 베이스 모델(chasemonster)이 script.Monster/MonsterAttack를 inheritance로 끌고 와서
+  // DuplicateComponent(LobbyNpc와 공존) 경고 + MonsterAttack.OnBeginPlay AnimationClip 에러가 뜬다.
+  // 둘 다 비치명적(로비엔 전투 컨텍스트가 없어 Monster는 휴면, 에러는 전투맵 몬스터와 공유되는 기존 lint).
+  // modelId를 비우면 fresh load에서 렌더가 깨질 위험이 있어 proven-good(모델 유지)로 둔다.
+  const tr = compOf(m, 'MOD.Core.TransformComponent');
+  if (tr) { tr.Position.x = x; tr.Position.y = y; }
+  const sp = compOf(m, 'MOD.Core.SpriteRendererComponent');
+  if (sp) sp.SpriteRUID = ruid;
+  const sa = compOf(m, 'MOD.Core.StateAnimationComponent');
+  if (sa) sa.ActionSheet = { stand: ruid, hit: ruid, die: ruid }; // 항상 stand 스프라이트 고정
+  // 몬스터 AI·물리·히트 컴포넌트 제거 → 정적 비충돌 스프라이트
+  m.jsonString['@components'] = m.jsonString['@components'].filter((c) => !STRIP.has(c['@type']));
+  let names = (m.componentNames || '').split(',').filter((s) => s && !STRIP.has(s));
+  if (withInteract) {
+    m.jsonString['@components'].push({ '@type': 'MOD.Core.TouchReceiveComponent', Enable: true, AutoFitToSize: true });
+    m.jsonString['@components'].push({ '@type': 'script.LobbyNpc', Enable: true, NpcId: npcId, MarkName: name + 'Mark' });
+    names.push('MOD.Core.TouchReceiveComponent', 'script.LobbyNpc');
+  }
+  m.componentNames = names.join(',');
+  return m;
+}
+
+const template = JSON.parse(readFileSync(TEMPLATE, 'utf8'));
+const monsterTemplates = template.ContentProto.Entities.filter(isMonster);
+if (monsterTemplates.length === 0) throw new Error('[gen-lobby-map] 몬스터 템플릿(스프라이트 엔티티) 없음');
+const base = monsterTemplates.find((e) => (e.path || '').includes('Static')) || monsterTemplates[0];
+const baseY = (() => {
+  const tr = compOf(base, 'MOD.Core.TransformComponent');
+  return tr ? tr.Position.y : 0;
+})();
+
+const map = JSON.parse(JSON.stringify(template)); // deep clone
+map.EntryKey = 'map://lobby';
+let ents = map.ContentProto.Entities.filter((e) => !isMonster(e));
+
+// 경로/이름 치환 + 배경 + 루트 컴포넌트 조정
+for (const e of ents) {
+  if (typeof e.path === 'string') e.path = e.path.replace('/maps/map01', '/maps/lobby');
+  if (e.jsonString) {
+    if (typeof e.jsonString.path === 'string') e.jsonString.path = e.jsonString.path.replace('/maps/map01', '/maps/lobby');
+    if (e.jsonString.name === 'map01') e.jsonString.name = 'lobby';
+  }
+  if ((e.path || '').endsWith('/Background')) {
+    const bg = compOf(e, 'MOD.Core.BackgroundComponent');
+    if (bg) bg.TemplateRUID = TOWN_BG;
+  }
+}
+
+const root = ents.find((e) => e.path === '/maps/lobby');
+if (!root) throw new Error('[gen-lobby-map] 맵 루트 없음');
+// 로비엔 PlayerLock 제거(이동 허용) + MapCamera 제거(고정 framing 대신 follow) + LobbyMobility 추가.
+// LobbyMobility가 이동 해제 + 플레이어 추종 카메라를 함께 설정 — MapCamera와 공존하면
+// ConfineCameraArea true/false가 경쟁하므로 MapCamera를 빼야 한다.
+const ROOT_STRIP = ['script.PlayerLock', 'script.MapCamera', 'script.LobbyMobility'];
+root.jsonString['@components'] = root.jsonString['@components'].filter((c) => !ROOT_STRIP.includes(c['@type']));
+root.jsonString['@components'].push({ '@type': 'script.LobbyMobility', Enable: true });
+{
+  const names = (root.componentNames || '').split(',').filter((s) => s && !ROOT_STRIP.includes(s));
+  names.push('script.LobbyMobility');
+  root.componentNames = names.join(',');
+}
+
+// NPC + 마크 엔티티 생성
+for (const npc of NPCS) {
+  ents.push(makeSpriteEntity(base, npc.name, npc.x, baseY, npc.ruid, true, npc.id));
+  ents.push(makeSpriteEntity(base, npc.name + 'Mark', npc.x, baseY + MARK_DY, MARK_RUID, false, ''));
+}
+
+// GUID 전부 재발급 (map01과 충돌 방지 + 자기참조 origin 보정)
+ents.forEach((e, idx) => {
+  const oldId = e.id;
+  const newId = lobbyGuid(idx);
+  e.id = newId;
+  const o = e.jsonString && e.jsonString.origin;
+  if (o) {
+    if (o.root_entity_id === oldId) o.root_entity_id = newId;
+    if (o.sub_entity_id === oldId) o.sub_entity_id = newId;
+  }
+});
+
+map.ContentProto.Entities = ents;
+writeFileSync(OUT, JSON.stringify(map, null, 2), 'utf8');
+
+// SectorConfig 등록 (멱등)
+const sector = JSON.parse(readFileSync(SECTOR, 'utf8'));
+const sec0 = sector.ContentProto.Json.Sectors[0];
+if (!sec0.entries.includes('map://lobby')) sec0.entries.push('map://lobby');
+writeFileSync(SECTOR, JSON.stringify(sector, null, 2), 'utf8');
+
+const npcCount = ents.filter((e) => (e.componentNames || '').includes('script.LobbyNpc')).length;
+console.log(`[gen-lobby-map] lobby.map 생성: NPC ${npcCount}종 + 마크, SectorConfig entries ${sec0.entries.length}`);

tools/player/gen-lobby-npc.mjs

@@ -0,0 +1,114 @@
+import { writeFileSync } from 'node:fs';
+
+// 로비 codeblock 2종 emit (맵/엔티티 부착은 tools/map/gen-lobby-map.mjs 소관):
+//  · LobbyNpc      — NPC 엔티티에 부착. 근접 폴링→머리위 마크 토글, TouchEvent(클릭)/UpArrow(근접)→Interact→컨트롤러 호출.
+//  · LobbyMobility — 로비 맵 루트에 부착. 진입 시 플레이어 이동 잠금 해제(정찰 확정: WalkAcceleration이 진짜 레버).
+// 공격 키(LeftControl) 바인딩은 SlayDeckController(/common, 1회 등록·로비 가드)에서 처리 — 여기 두지 않음.
+// 정찰: 이동에는 RigidbodyComponent.WalkAcceleration(가속)과 MovementComponent.InputSpeed(속도)가
+// 둘 다 양수여야 함 — freeze-turn-player가 둘 다 0으로 만들었으므로 둘 다 복원해야 걷는다(실측 확인).
+// 값은 freeze가 건드리지 않은 intact RigidbodyComponent.WalkSpeed(1.4)/WalkJump(1.23) = 기본값에 맞춤.
+// (실측: InputSpeed 1.4→보행 ~2.5u/s, JumpForce 1.23→점프 상승 1.79u. 이전 5/5는 ~9u/s·상승 14u로 과함.)
+const WALK_ACCEL = 0.7;
+const WALK_SPEED = 1.4;
+const JUMP_FORCE = 1.23;
+const PROX = 1.2;       // 근접 임계(맵 NPC 간격 2.5와 분리)
+// 로비 카메라는 전투맵의 고정 framing(ConfineCameraArea=true)과 달리 플레이어를 추종(follow).
+// MSW 카메라는 기본이 follow이고 ConfineCameraArea=true가 그걸 억제하므로, false로 풀고 ScreenOffset을 중앙에 둔다.
+const LOBBY_ZOOM = 90;  // 전투맵과 동일 줌(전환 시 위화감 최소). 플레이테스트로 조정 가능.
+
+function prop(Type, Name, DefaultValue = 'nil') {
+  return { Type, DefaultValue, SyncDirection: 0, Attributes: [], Name };
+}
+function method(Name, Code, Arguments = [], ExecSpace = 6) {
+  return {
+    Return: { Type: 'void', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: null },
+    Arguments, Code, Scope: 2, ExecSpace, Attributes: [], Name,
+  };
+}
+function writeCodeblock(name, properties, methods) {
+  const cb = {
+    Id: '', GameId: '', EntryKey: `codeblock://${name.toLowerCase()}`, ContentType: 'x-mod/codeblock',
+    Content: '', Usage: 0, UsePublish: 1, UseService: 0, CoreVersion: '26.5.0.0', StudioVersion: '', DynamicLoading: 0,
+    ContentProto: { Use: 'Json', Json: {
+      CoreVersion: { Major: 0, Minor: 2 }, ScriptVersion: { Major: 1, Minor: 0 },
+      Description: '', Id: name, Language: 1, Name: name, Type: 1, Source: 0, Target: null,
+      Properties: properties, Methods: methods, EntityEventHandlers: [],
+    } },
+  };
+  writeFileSync(`RootDesk/MyDesk/${name}.codeblock`, JSON.stringify(cb, null, 2) + '\n', 'utf8');
+}
+
+// ── LobbyNpc ──────────────────────────────────────────────────────────────
+const npcInteract = method('Interact', `local c = _EntityService:GetEntityByPath("/common")
+if c ~= nil and c.SlayDeckController ~= nil then
+	c.SlayDeckController:OnLobbyNpcInteract(self.NpcId)
+end`);
+
+const npcBegin = method('OnBeginPlay', `self.InRange = false
+local mark = _EntityService:GetEntityByPath("/maps/lobby/" .. self.MarkName)
+if mark ~= nil then mark:SetVisible(false) end
+self.Entity:ConnectEvent(TouchEvent, function(e)
+	self:Interact()
+end)
+_InputService:ConnectEvent(KeyDownEvent, function(e)
+	if self.InRange and e.key == KeyboardKey.UpArrow then
+		self:Interact()
+	end
+end)
+local eventId = 0
+local function tick()
+	local lp = _UserService.LocalPlayer
+	if lp == nil then return end
+	if mark == nil then mark = _EntityService:GetEntityByPath("/maps/lobby/" .. self.MarkName) end
+	local a = lp.TransformComponent.WorldPosition
+	local b = self.Entity.TransformComponent.WorldPosition
+	local d = Vector2.Distance(Vector2(a.x, a.y), Vector2(b.x, b.y))
+	local near = d < ${PROX}
+	if near ~= self.InRange then
+		self.InRange = near
+		if mark ~= nil then mark:SetVisible(near) end
+	end
+end
+eventId = _TimerService:SetTimerRepeat(tick, 0.15)`);
+
+writeCodeblock('LobbyNpc', [
+  prop('string', 'NpcId', '""'),
+  prop('string', 'MarkName', '""'),
+  prop('boolean', 'InRange', 'false'),
+], [npcBegin, npcInteract]);
+
+// ── LobbyMobility ─────────────────────────────────────────────────────────
+const mobBegin = method('OnBeginPlay', `self.Tries = 0
+local eventId = 0
+local function apply()
+	self.Tries = self.Tries + 1
+	local lp = _UserService.LocalPlayer
+	if lp ~= nil and lp.PlayerControllerComponent ~= nil then
+		local pc = lp.PlayerControllerComponent
+		pc.Enable = true
+		pc.FixedLookAt = 0
+		local rb = lp.RigidbodyComponent
+		if rb ~= nil then rb.WalkAcceleration = ${WALK_ACCEL} end
+		local mv = lp.MovementComponent
+		if mv ~= nil then
+			mv.InputSpeed = ${WALK_SPEED}
+			mv.JumpForce = ${JUMP_FORCE}
+		end
+		local cam = lp.CameraComponent
+		if cam == nil then cam = _CameraService:GetCurrentCameraComponent() end
+		if cam ~= nil then
+			cam.ZoomRatio = ${LOBBY_ZOOM}
+			cam.ConfineCameraArea = false
+			cam.ScreenOffset = Vector2(0.5, 0.5)
+			cam.CameraOffset = Vector2(0, 0)
+		end
+		_TimerService:ClearTimer(eventId)
+	elseif self.Tries > 50 then
+		_TimerService:ClearTimer(eventId)
+	end
+end
+eventId = _TimerService:SetTimerRepeat(apply, 0.1)`);
+
+writeCodeblock('LobbyMobility', [prop('number', 'Tries', '0')], [mobBegin]);
+
+console.log('[gen-lobby-npc] LobbyNpc / LobbyMobility codeblock 생성 완료');

tools/player/gen-player-lock.mjs

@@ -65,6 +65,10 @@ local function apply()
 		pc.FixedLookAt = ${FIXED_LOOK_AT}
 		pc.Enable = ${CONTROLLER_ENABLE}
 	end
+	if lp ~= nil then
+		if lp.RigidbodyComponent ~= nil then lp.RigidbodyComponent.WalkAcceleration = 0 end
+		if lp.MovementComponent ~= nil then lp.MovementComponent.InputSpeed = 0; lp.MovementComponent.JumpForce = 0 end
+	end
 	if pc ~= nil then
 		_TimerService:ClearTimer(eventId)
 	elseif self.LockTries > 30 then

tools/verify/diffcheck.mjs

@@ -0,0 +1,21 @@
+import { readFileSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+
+// 산출물 바이트-동일 게이트: 워킹트리 vs 지정 ref(blob)를 줄바꿈 정규화 후 비교.
+// 산출물 경로를 Bash 명령줄에 노출하지 않아 settings.json deny를 회피(count.mjs와 동일 취지).
+// 사용: node tools/verify/diffcheck.mjs [ref]   (ref 기본 HEAD; 예: origin/main)
+const ref = process.argv[2] || 'HEAD';
+const FILES = [
+  'ui/DefaultGroup.ui',
+  'RootDesk/MyDesk/SlayDeckController.codeblock',
+  'Global/common.gamelogic',
+];
+let allSame = true;
+for (const f of FILES) {
+  const work = readFileSync(f, 'utf8').replace(/\r\n/g, '\n');
+  const blob = execSync(`git show ${ref}:${f}`, { encoding: 'utf8', maxBuffer: 1 << 30 }).replace(/\r\n/g, '\n');
+  const same = work === blob;
+  if (!same) allSame = false;
+  console.log(`${same ? 'IDENTICAL ' : 'DIFFER    '} ${f}${same ? '' : `  (work=${work.length} ${ref}=${blob.length})`}`);
+}
+console.log(allSame ? `\n=> 산출물이 ${ref}와 바이트-동일` : `\n=> ${ref}와 차이 있음 (확인 필요)`);