Global/SectorConfig.config

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

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\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/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": [],

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/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` | 재생성 산출물 |

tools/deck/gen-slaydeck.mjs

@@ -2425,17 +2425,17 @@ function upsertUi() {
     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 }),
-      sprite({ color: { r: 0.07, g: 0.08, b: 0.13, a: 1 }, type: 1, raycast: true }),
+      // 로비가 물리 맵이 됨 — 투명 + 비레이캐스트로 맵을 가리지 않고 월드 NPC 클릭이 통과되게 함.
+      sprite({ color: TRANSPARENT, type: 1, raycast: false }),
     ],
   });
   lobbyRoot.jsonString.enable = false;
   lobby.push(lobbyRoot);
   const lobTexts = [
-    ['Title', 0, 470, 760, '메이플 로비', 48, GOLD],
-    ['Subtitle', 0, 408, 900, 'NPC를 클릭해 런을 준비하세요', 24, { r: 0.82, g: 0.86, b: 0.92, a: 1 }],
-    ['SoulLabel', 700, 470, 320, '영혼 0', 28, { r: 0.6, g: 0.85, b: 1, a: 1 }],
-    ['AscLabel', -560, 470, 380, '승천 0 / 해금 0', 22, { r: 0.9, g: 0.7, b: 0.5, a: 1 }],
-    ['Hint', 0, -430, 1300, '런을 클리어하거나 패배하면 로비로 돌아옵니다', 20, { r: 0.6, g: 0.64, b: 0.7, a: 1 }],
+    ['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({
@@ -2466,62 +2466,7 @@ function upsertUi() {
       ],
     }));
   }
-  const npcs = [
-    { key: 'NpcRun', x: -540, name: '모험가', role: '런 시작', tint: { r: 0.74, g: 0.32, b: 0.28, a: 1 } },
-    { key: 'NpcCodex', x: -180, name: '사서', role: '카드 도감', tint: { r: 0.3, g: 0.55, b: 0.5, a: 1 } },
-    { key: 'NpcShop', x: 180, name: '상인', role: '영혼 상점', tint: { r: 0.55, g: 0.45, b: 0.75, a: 1 } },
-    { key: 'NpcBoard', x: 540, name: '안내원', role: '게시판', tint: { r: 0.4, g: 0.5, b: 0.7, a: 1 } },
-  ];
-  for (const npc of npcs) {
-    const base = `/ui/DefaultGroup/LobbyHud/${npc.key}`;
-    lobby.push(entity({
-      id: guid('lob', lobId++),
-      path: base,
-      modelId: 'uibutton', entryId: 'UIButton',
-      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent',
-      displayOrder: 4,
-      components: [
-        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 240, y: 320 }, pos: { x: npc.x, y: 20 }, align: ALIGN_CENTER }),
-        sprite({ color: { r: 0.13, g: 0.15, b: 0.2, a: 1 }, type: 1, raycast: true }),
-        button(),
-      ],
-    }));
-    lobby.push(entity({
-      id: guid('lob', lobId++),
-      path: `${base}/Figure`,
-      modelId: 'uisprite', entryId: 'UISprite',
-      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent',
-      displayOrder: 1,
-      components: [
-        transform({ parentW: 240, parentH: 320, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 130, y: 130 }, pos: { x: 0, y: 30 } }),
-        sprite({ color: npc.tint, type: 1 }),
-      ],
-    }));
-    lobby.push(entity({
-      id: guid('lob', lobId++),
-      path: `${base}/Name`,
-      modelId: 'uitext', entryId: 'UIText',
-      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
-      displayOrder: 2,
-      components: [
-        transform({ parentW: 240, parentH: 320, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 220, y: 40 }, pos: { x: 0, y: 122 } }),
-        sprite({ color: TRANSPARENT }),
-        text({ value: npc.name, fontSize: 28, bold: true, color: GOLD, alignment: 4 }),
-      ],
-    }));
-    lobby.push(entity({
-      id: guid('lob', lobId++),
-      path: `${base}/Role`,
-      modelId: 'uitext', entryId: 'UIText',
-      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
-      displayOrder: 2,
-      components: [
-        transform({ parentW: 240, parentH: 320, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 220, y: 36 }, pos: { x: 0, y: -122 } }),
-        sprite({ color: TRANSPARENT }),
-        text({ value: npc.role, fontSize: 22, bold: false, color: { r: 0.86, g: 0.9, b: 0.94, a: 1 }, alignment: 4 }),
-      ],
-    }));
-  }
+  // NPC 4종은 로비 물리 맵의 월드 엔티티(map/lobby.map + LobbyNpc codeblock)로 이동. UI 버튼 행 제거.
   emit('LobbyHud', lobby);
 
   // ── BoardHud — 게시판(공지/팁) ──
@@ -2743,6 +2688,8 @@ function writeCodeblocks() {
   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 지면 좌측
   const combat = codeblock('SlayDeckController', 'SlayDeckController', [
     prop('any', 'DrawPile'),
     prop('any', 'DiscardPile'),
@@ -2771,6 +2718,7 @@ function writeCodeblocks() {
     prop('any', 'AllDeckCloseHandler'),
     prop('number', 'SoulPoints', '0'),
     prop('boolean', 'LobbyBound', 'false'),
+    prop('number', 'LobbyTpTries', '0'),
     prop('boolean', 'CodexMode', 'false'),
     prop('any', 'CodexCards'),
     prop('any', 'SoulUnlocks'),
@@ -2837,7 +2785,15 @@ local lp = _UserService.LocalPlayer
 if lp ~= nil then
 	self:ReqLoadAscension(lp.PlayerComponent.UserId)
 	self:ReqLoadSouls(lp.PlayerComponent.UserId)
-end`),
+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
@@ -2990,7 +2946,35 @@ self:ShowState("lobby")
 self:SetEntityEnabled("/ui/DefaultGroup/BoardHud", false)
 self:SetEntityEnabled("/ui/DefaultGroup/SoulShopHud", false)
 self:BindLobbyButtons()
-self:BindMenuButtons()`),
+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))`),
@@ -3004,10 +2988,6 @@ local function bindClick(path, fn)
 		e:ConnectEvent(ButtonClickEvent, fn)
 	end
 end
-bindClick("/ui/DefaultGroup/LobbyHud/NpcRun", function() self:ShowCharacterSelect() end)
-bindClick("/ui/DefaultGroup/LobbyHud/NpcCodex", function() self:ShowCodex() end)
-bindClick("/ui/DefaultGroup/LobbyHud/NpcShop", function() self:ShowSoulShop() end)
-bindClick("/ui/DefaultGroup/LobbyHud/NpcBoard", function() self:ShowBoard() 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)
@@ -3229,6 +3209,7 @@ self:BindButtons()
 self:AddRelic("${RELICS.startingRelic}")
 self:ApplySoulUnlocks()
 self:RenderPotions()
+self:TeleportToActMap()
 self:ShowMap()`),
     method('StartCombat', `self:ShowState("combat")
 self:SetEntityEnabled("/ui/DefaultGroup/CombatHud/Result", false)

tools/map/gen-lobby-map.mjs

@@ -0,0 +1,141 @@
+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 제거(이동 허용) + LobbyMobility 추가(이동·공격 해제). MapCamera는 유지.
+root.jsonString['@components'] = root.jsonString['@components'].filter(
+  (c) => !['script.PlayerLock', 'script.LobbyMobility'].includes(c['@type']),
+);
+root.jsonString['@components'].push({ '@type': 'script.LobbyMobility', Enable: true });
+{
+  const names = (root.componentNames || '')
+    .split(',')
+    .filter((s) => s && !['script.PlayerLock', 'script.LobbyMobility'].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,103 @@
+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와 분리)
+
+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
+		_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