installer: fix UPnP PowerShell parse error (^| -> | inside quotes)

run.bat 의 UPnP 등록/해제 PowerShell 명령에서 파이프를 cmd식 ^| 로
이스케이프했는데, 이 파이프는 powershell -Command "..." 의 큰따옴표 안이라
cmd 가 이미 리터럴로 넘긴다. 그래서 PowerShell 이 ^ 를 "예기치 않은 토큰"
으로 파싱 실패(서버는 정상 기동하나 콘솔에 에러 출력, UPnP 매핑도 실패).
^| -> | 로 교정. for/f 의 2^>nul(=cmd 레벨 리다이렉트)은 그대로 유지. v0.3.13.

Co-Authored-By: Claude Opus 4 <noreply@anthropic.com>

installer-rp/renderer.js

@@ -534,6 +534,7 @@ function renderStep3() {
   section.innerHTML =
     '<h2>' + escapeHtml(tt('step3.heading')) + '</h2>' +
     '<p class="formMessage">' + escapeHtml(tt('step3.message')) + '</p>' +
+    '<p class="formMessage">' + escapeHtml(tt('step3.applyNotice')) + '</p>' +
     (state.resourcepackPath
       ? '<p class="formMessage"><code>' + escapeHtml(state.resourcepackPath) + '</code></p>'
       : '') +

installer/renderer.js

@@ -96,6 +96,20 @@ function clearPage() {
   pageHost.innerHTML = ''
 }
 
+// 첫 진입 안내 페이지: 마인크래프트 런처를 끄고 시작하도록 안내.
+function renderIntro() {
+  setActiveStep(1)
+  clearPage()
+  var section = document.createElement('section')
+  section.className = 'page'
+  section.innerHTML =
+    '<h2>' + tt('intro.heading') + '</h2>' +
+    '<p class="formMessage">' + tt('intro.message') + '</p>' +
+    '<div class="actionRow"><button class="primaryBtn" id="introNext">' + tt('common.next') + '</button></div>'
+  pageHost.appendChild(section)
+  section.querySelector('#introNext').addEventListener('click', renderStep1)
+}
+
 function renderStep1() {
   setActiveStep(1)
   clearPage()
@@ -972,5 +986,5 @@ function escapeHtml(s) {
     I18N = (await installerApi.loadLocale()) || {}
   } catch (_) { I18N = {} }
   applyStaticI18n()
-  renderStep1()
+  renderIntro()
 })()

locales/installer-rp/ko-kr.json

@@ -63,7 +63,8 @@
   },
   "step3": {
     "heading": "완료",
-    "message": "리소스팩 설치를 완료했습니다."
+    "message": "사용자 동의하에 리소스팩이 설치되었습니다.",
+    "applyNotice": "리소스팩은 직접 적용해주세요."
   },
   "install": {
     "errorMessage": "설치 중 오류가 발생했습니다: {{message}}",

locales/installer/ko-kr.json

@@ -1,4 +1,8 @@
 {
+  "intro": {
+    "heading": "시작하기 전에",
+    "message": "마인크래프트 런처를 끄고 시작해주세요."
+  },
   "common": {
     "back": "이전",
     "next": "다음",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecraft-music-quiz-installer",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "description": "마인크래프트 음악퀴즈 간편설치기 + 관리 사이트",
   "main": "dist/installer/main.js",
   "scripts": {

src/installer/main.ts

@@ -657,13 +657,13 @@ async function injectUpnpToRunBat(installPath: string): Promise<void> {
     'for /f "tokens=2 delims==" %%a in (\'findstr /b /c:"server-port=" server.properties 2^>nul\') do set "_MQ_PORT=%%a"',
     'set "_MQ_PORT=%_MQ_PORT: =%"',
     'echo [MusicQuiz] UPnP 등록 시도: TCP %_MQ_PORT%',
-    'powershell -NoProfile -Command "$port=[int]$env:_MQ_PORT; $ip=(Get-NetIPAddress -AddressFamily IPv4 -PrefixOrigin Dhcp,Manual -ErrorAction SilentlyContinue ^| Where-Object {$_.IPAddress -notlike \'169.254.*\' -and $_.IPAddress -ne \'127.0.0.1\'} ^| Select-Object -First 1).IPAddress; if (-not $ip) { Write-Host \'[MusicQuiz] 로컬 IPv4 검색 실패\'; exit 1 }; try { $u = New-Object -ComObject HNetCfg.NATUPnP.1; $c=$u.StaticPortMappingCollection; if ($c) { try { $c.Remove($port,\'TCP\') ^| Out-Null } catch {}; $c.Add($port,\'TCP\',$port,$ip,$true,\'MusicQuiz Minecraft Server\') ^| Out-Null; Write-Host (\'[MusicQuiz] UPnP 등록 성공: \' + $ip + \':\' + $port + \' TCP\') } else { Write-Host \'[MusicQuiz] UPnP 컬렉션 사용 불가(라우터 UPnP 꺼짐?)\' } } catch { Write-Host (\'[MusicQuiz] UPnP 등록 실패: \' + $_.Exception.Message) }"'
+    'powershell -NoProfile -Command "$port=[int]$env:_MQ_PORT; $ip=(Get-NetIPAddress -AddressFamily IPv4 -PrefixOrigin Dhcp,Manual -ErrorAction SilentlyContinue | Where-Object {$_.IPAddress -notlike \'169.254.*\' -and $_.IPAddress -ne \'127.0.0.1\'} | Select-Object -First 1).IPAddress; if (-not $ip) { Write-Host \'[MusicQuiz] 로컬 IPv4 검색 실패\'; exit 1 }; try { $u = New-Object -ComObject HNetCfg.NATUPnP.1; $c=$u.StaticPortMappingCollection; if ($c) { try { $c.Remove($port,\'TCP\') | Out-Null } catch {}; $c.Add($port,\'TCP\',$port,$ip,$true,\'MusicQuiz Minecraft Server\') | Out-Null; Write-Host (\'[MusicQuiz] UPnP 등록 성공: \' + $ip + \':\' + $port + \' TCP\') } else { Write-Host \'[MusicQuiz] UPnP 컬렉션 사용 불가(라우터 UPnP 꺼짐?)\' } } catch { Write-Host (\'[MusicQuiz] UPnP 등록 실패: \' + $_.Exception.Message) }"'
   ]
 
   const removeBlock = [
     'REM 서버 종료 후: UPnP 매핑 해제.',
     'echo [MusicQuiz] UPnP 해제 시도: TCP %_MQ_PORT%',
-    'powershell -NoProfile -Command "$port=[int]$env:_MQ_PORT; try { $u = New-Object -ComObject HNetCfg.NATUPnP.1; $c=$u.StaticPortMappingCollection; if ($c) { $c.Remove($port,\'TCP\') ^| Out-Null; Write-Host (\'[MusicQuiz] UPnP 해제 완료: TCP \' + $port) } } catch { Write-Host (\'[MusicQuiz] UPnP 해제 실패: \' + $_.Exception.Message) }"'
+    'powershell -NoProfile -Command "$port=[int]$env:_MQ_PORT; try { $u = New-Object -ComObject HNetCfg.NATUPnP.1; $c=$u.StaticPortMappingCollection; if ($c) { $c.Remove($port,\'TCP\') | Out-Null; Write-Host (\'[MusicQuiz] UPnP 해제 완료: TCP \' + $port) } } catch { Write-Host (\'[MusicQuiz] UPnP 해제 실패: \' + $_.Exception.Message) }"'
   ]
 
   const merged: string[] = []