feat(E1+E2): 런 루프 코어 — 연속 전투·카드 보상·덱 성장

단일 전투를 N전투 런으로 확장(로그라이크 메타 첫 조각). - 런 상태: RunDeck(보유 카드)·Gold·Floor·RunLength·RewardChoices·RunActive (SlayDeckController 확장) - StartRun(영속 초기화·버튼 1회 바인딩) vs StartCombat(전투별 초기화·RunDeck에서 드로·Floor++) 분리 - 플레이어 HP 전투 간 유지, BindButtons를 StartRun 1회 호출로 이동(핸들러 중첩 버그 예방) - 승리: 골드 +15 → Floor<RunLength면 OfferReward(카드 3택1), 아니면 '런 클리어!' - PickReward: 선택 카드 RunDeck 추가(건너뛰기=추가 안 함)→다음 전투. 입력잠금 가드 - UI: CombatHud 층/골드 표시, RewardHud(보상 카드 3+건너뛰기) 생성 - 런 파라미터(RUN_LENGTH=3·GOLD_PER_WIN=15)는 생성기 상수(향후 외부화) - 메이커 Play 검증: 전투→보상→덱+1→다음전투→3전투 런 클리어, 패배·입력잠금 정상 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-09 02:27:38 +09:00
parent 3be5e85c94
commit e9b6d9c6c0
3 changed files with 3536 additions and 15 deletions
--- a/tools/gen-slaydeck.mjs
+++ b/tools/gen-slaydeck.mjs
@@ -60,7 +60,7 @@ 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 : 0xfe;
+  const ns = prefix === 'hud' ? 0xd0 : prefix === 'dck' ? 0xca : prefix === 'cmb' ? 0xcb : prefix === 'rwd' ? 0xcc : 0xfe;
  const v = (ns * 0x100000 + n) >>> 0;
  return `${v.toString(16).padStart(8, '0')}-0000-4000-8000-${v.toString(16).padStart(12, '0')}`;
 }
@@ -212,7 +212,7 @@ function entity({ id, path, modelId, entryId, componentNames, components, displa
 function upsertUi() {
  const ui = JSON.parse(readFileSync(UI_FILE, 'utf8'));
  const E = ui.ContentProto.Entities;
-  ui.ContentProto.Entities = E.filter((e) => !e.path.startsWith('/ui/DefaultGroup/DeckHud') && !e.path.startsWith('/ui/DefaultGroup/CombatHud'));
+  ui.ContentProto.Entities = E.filter((e) => !e.path.startsWith('/ui/DefaultGroup/DeckHud') && !e.path.startsWith('/ui/DefaultGroup/CombatHud') && !e.path.startsWith('/ui/DefaultGroup/RewardHud'));

  const byPath = new Map(ui.ContentProto.Entities.map((e) => [e.path, e]));

@@ -451,6 +451,24 @@ function upsertUi() {
      ],
    }));
  }
+  for (const [suffix, pos, value, color] of [
+    ['Floor', { x: -820, y: 480 }, '층 1/3', GOLD],
+    ['Gold', { x: 820, y: 480 }, '골드 0', { r: 0.98, g: 0.85, b: 0.4, a: 1 }],
+  ]) {
+    combat.push(entity({
+      id: guid('cmb', cmbN++),
+      path: `/ui/DefaultGroup/CombatHud/${suffix}`,
+      modelId: 'uitext',
+      entryId: 'UIText',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+      displayOrder: 9,
+      components: [
+        transform({ parentW: 1920, parentH: 1080, anchor: { x: 0.5, y: 0.5 }, pivot: { x: 0.5, y: 0.5 }, size: { x: 240, y: 44 }, pos }),
+        sprite({ color: TRANSPARENT }),
+        text({ value, fontSize: 26, bold: true, color, alignment: 4 }),
+      ],
+    }));
+  }
  const result = entity({
    id: guid('cmb', cmbN++),
    path: '/ui/DefaultGroup/CombatHud/Result',
@@ -468,6 +486,87 @@ function upsertUi() {
  combat.push(result);
  ui.ContentProto.Entities.push(...combat);

+  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 }),
+    ],
+  }));
+  let rwdN = 2;
+  const rewardXs = [-300, 0, 300];
+  for (let i = 1; i <= 3; i++) {
+    const cardPath = `/ui/DefaultGroup/RewardHud/Reward${i}`;
+    reward.push(entity({
+      id: guid('rwd', rwdN++),
+      path: cardPath,
+      modelId: 'uisprite',
+      entryId: 'UISprite',
+      componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.ButtonComponent',
+      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({ color: ATTACK, type: 1, raycast: true }),
+        button(),
+      ],
+    }));
+    for (const [suffix, cfg] of [
+      ['Cost', { size: { x: 50, y: 50 }, pos: { x: -60, y: 95 }, value: '1', fontSize: 34, bold: true }],
+      ['Name', { size: { x: 160, y: 50 }, pos: { x: 0, y: 50 }, value: '카드', fontSize: 26, bold: true }],
+      ['Desc', { size: { x: 160, y: 82 }, pos: { x: 0, y: -80 }, value: '', fontSize: 20, bold: false }],
+    ]) {
+      reward.push(entity({
+        id: guid('rwd', rwdN++),
+        path: `${cardPath}/${suffix}`,
+        modelId: 'uitext',
+        entryId: 'UIText',
+        componentNames: 'MOD.Core.UITransformComponent,MOD.Core.SpriteGUIRendererComponent,MOD.Core.TextComponent',
+        displayOrder: suffix === 'Cost' ? 0 : suffix === 'Name' ? 1 : 2,
+        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 }),
+        ],
+      }));
+    }
+  }
+  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 }),
+    ],
+  }));
+  ui.ContentProto.Entities.push(...reward);
+
  JSON.parse(JSON.stringify(ui));
  writeFileSync(UI_FILE, JSON.stringify(ui, null, 2), 'utf8');
 }
@@ -522,6 +621,8 @@ function codeblock(id, name, properties, methods) {
 }

 function writeCodeblocks() {
+  const RUN_LENGTH = 3;
+  const GOLD_PER_WIN = 15;
  const combat = codeblock('SlayDeckController', 'SlayDeckController', [
    prop('any', 'DrawPile'),
    prop('any', 'DiscardPile'),
@@ -542,12 +643,26 @@ function writeCodeblocks() {
    prop('boolean', 'CombatOver', 'false'),
    prop('any', 'EnemyIntents'),
    prop('any', 'EnemyName'),
+    prop('any', 'RunDeck'),
+    prop('number', 'Gold', '0'),
+    prop('number', 'Floor', '0'),
+    prop('number', 'RunLength', String(RUN_LENGTH)),
+    prop('any', 'RewardChoices'),
+    prop('boolean', 'RunActive', 'false'),
  ], [
-    method('OnBeginPlay', `self:StartCombat()`),
+    method('OnBeginPlay', `self:StartRun()`),
+    method('StartRun', `self.PlayerMaxHp = 80
+self.PlayerHp = self.PlayerMaxHp
+self.Gold = 0
+self.Floor = 0
+self.RunLength = ${RUN_LENGTH}
+self.RunDeck = { ${CARDS.starterDeck.map(luaStr).join(', ')} }
+self.RunActive = true
+self:BindButtons()
+self:StartCombat()`),
    method('StartCombat', `self.MaxEnergy = 3
 self.Turn = 0
-self.PlayerMaxHp = 80
-self.PlayerHp = self.PlayerMaxHp
+self.Floor = self.Floor + 1
 self.PlayerBlock = 0
 self.EnemyName = ${luaStr(ACTIVE_ENEMY.name)}
 self.EnemyMaxHp = ${ACTIVE_ENEMY.maxHp}
@@ -559,9 +674,11 @@ self.CombatOver = false
 self.DiscardPile = {}
 self.Hand = {}
 ${luaCardsTable(CARDS.cards)}
-${luaDeckTable(CARDS.starterDeck)}
+self.DrawPile = {}
+for i = 1, #self.RunDeck do
+	self.DrawPile[i] = self.RunDeck[i]
+end
 self:Shuffle(self.DrawPile)
-self:BindButtons()
 self:RenderCombat()
 self:StartPlayerTurn()`),
    method('Shuffle', `if list == nil then
@@ -584,6 +701,16 @@ for i = 1, 5 do
 	if cardEntity ~= nil and cardEntity.ButtonComponent ~= nil then
 		cardEntity:ConnectEvent(ButtonClickEvent, function() self:PlayCard(i) 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)
+	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`),
    method('StartPlayerTurn', `self.Turn = self.Turn + 1
 self.Energy = self.MaxEnergy
@@ -766,11 +893,18 @@ end
 self:RenderCombat()`),
    method('CheckCombatEnd', `if self.EnemyHp <= 0 then
 	self.CombatOver = true
-	self:ShowResult("승리!")
-	-- TODO(E): 전투 보상 훅 — 카드 보상/골드/유물 선택 진입점
+	self.Gold = self.Gold + ${GOLD_PER_WIN}
+	self:RenderRun()
+	if self.Floor >= self.RunLength then
+		self:ShowResult("런 클리어!")
+		self.RunActive = false
+	else
+		self:OfferReward()
+	end
 elseif self.PlayerHp <= 0 then
 	self.CombatOver = true
 	self:ShowResult("패배...")
+	self.RunActive = false
 end`),
    method('ShowResult', `self:SetText("/ui/DefaultGroup/CombatHud/Result", text)
 local entity = _EntityService:GetEntityByPath("/ui/DefaultGroup/CombatHud/Result")
@@ -791,7 +925,58 @@ if intent ~= nil then
 end
 self:SetText("/ui/DefaultGroup/CombatHud/EnemyIntent", intentText)
 self:SetText("/ui/DefaultGroup/CombatHud/PlayerHp", "HP " .. string.format("%d", self.PlayerHp) .. "/" .. string.format("%d", self.PlayerMaxHp))
-self:SetText("/ui/DefaultGroup/CombatHud/PlayerBlock", "방어 " .. string.format("%d", self.PlayerBlock))`),
+self:SetText("/ui/DefaultGroup/CombatHud/PlayerBlock", "방어 " .. string.format("%d", self.PlayerBlock))
+self:RenderRun()`),
+    method('RenderRun', `self:SetText("/ui/DefaultGroup/CombatHud/Floor", "층 " .. string.format("%d", self.Floor) .. "/" .. string.format("%d", self.RunLength))
+self:SetText("/ui/DefaultGroup/CombatHud/Gold", "골드 " .. string.format("%d", self.Gold))`),
+    method('OfferReward', `local pool = {}
+for id, _ in pairs(self.Cards) do
+	table.insert(pool, id)
+end
+self.RewardChoices = {}
+for i = 1, 3 do
+	self.RewardChoices[i] = pool[math.random(1, #pool)]
+	self:ApplyRewardVisual(i, self.RewardChoices[i])
+end
+local hud = _EntityService:GetEntityByPath("/ui/DefaultGroup/RewardHud")
+if hud ~= nil then
+	hud.Enable = true
+end`),
+    method('ApplyRewardVisual', `local c = self.Cards[cardId]
+if c == nil then
+	return
+end
+local base = "/ui/DefaultGroup/RewardHud/Reward" .. tostring(slot)
+self:SetText(base .. "/Name", c.name)
+self:SetText(base .. "/Cost", tostring(c.cost))
+self:SetText(base .. "/Desc", c.desc)
+local e = _EntityService:GetEntityByPath(base)
+if e ~= nil and e.SpriteGUIRendererComponent ~= nil then
+	if c.kind == "Attack" then
+		e.SpriteGUIRendererComponent.Color = Color(0.86, 0.42, 0.38, 1)
+	elseif c.kind == "Skill" then
+		e.SpriteGUIRendererComponent.Color = Color(0.42, 0.55, 0.85, 1)
+	else
+		e.SpriteGUIRendererComponent.Color = Color(0.46, 0.68, 0.52, 1)
+	end
+end`, [
+      { 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:StartCombat()`, [{ Type: 'number', DefaultValue: null, SyncDirection: 0, Attributes: [], Name: 'slot' }]),
  ]);
  for (const m of combat.ContentProto.Json.Methods) {
    m.ExecSpace = 6;