블록 체인 RPG — 프로토타입

▶ 플레이: https://hyunho97.github.io/2D-run-and-fight/

설치 없이 링크만 열면 PC·모바일 브라우저에서 바로 플레이할 수 있습니다. 진행 상황은 각자의 브라우저(localStorage)에 저장됩니다.

휴대폰에서는 브라우저 메뉴의 홈 화면에 추가로 앱처럼 전체 화면으로 실행할 수 있고, 한 번 접속한 뒤에는 오프라인에서도 실행됩니다. 아이콘·공유 미리보기 이미지는 tools/assets.html로 다시 만들 수 있습니다.

Phaser 3 (무료 오픈소스 2D 엔진, vendor/에 포함) + JavaScript, 빌드/서버 불필요. (기획서는 비공개)

현재 구현 범위

영역	내용
전투	블록 바 9칸(리더 가중치 2배, 연속 미생성 방지), 1·2·3체인, 직업별 스킬 연출(베기·화살비·마법 폭발·덫·빛기둥), 자동 전진, 웨이브 3 + 보스(2페이즈·시전), 2분 광폭화, 별 평가, 자동/배속/일시정지
진행	챕터 1 숲 · 챕터 2 사막 · 챕터 3 설원 각 10스테이지(순차 해금), 승리 보상(골드·EXP·첫 클리어 보석·유닛 드롭)
유닛	기본 유닛 576종(6직업 × 6등급 × 16색), 레벨업(최대 = 등급×10), 첫 MAX 레벨 보상
성장	합성(★N MAX ×2 → 랜덤 ★N+1, ★4+ 결과 메인 5%, 한정 경고), 강화 +1~+5, 진화(메인 전용)
획득	보석 소환(★1 80% / ★2 20%), 유닛 방출(골드)
보관함 정리	등급별 일괄 합성(강화·메인/한정 제외), 선택 방출(Lv.1 미육성 전체 선택)
일일 던전	황금 광산(골드)·수련의 탑(EXP) 각 6단계, 메인 스테이지 진행으로 해금, 던전별 하루 3회(승리 시 차감, 로컬 자정 초기화)
무한의 탑	1-5 클리어 후 개방, 100층(층마다 웨이브 2, 5층마다 보스), 층 구성 고정 생성, 첫 돌파 보상(골드·EXP·보석)
도감	576종 수집 현황(등급·직업별), 첫 MAX 달성 표시, 수집 수 달성 보상
백업	설정 → 백업 코드 복사/파일 저장, 코드·파일로 불러오기 (기기 이동용)
안내	첫 전투 튜토리얼(블록 탭 → 체인 → 3체인), 로비 추천 행동
사운드	Web Audio 합성 효과음 + BGM(로비/전투/보스), 효과음·음악 각각 켜기/끄기
화면	로비, 스테이지 선택(챕터 탭), 파티 편성(배치·리더), 보관함(등급 필터), 유닛 상세, 도움말

진행 곡선 (자동 플레이 시뮬레이션 기준)

파티 성장도	클리어 가능
★1 Lv.1	1-5까지
★1 MAX	1-7까지
★2	1-9까지
★2 MAX / ★3	1-10, 2-1~2-2
★3 Lv.15~30	2-6~2-9
★4 Lv.10	2-10, 3-1
★4 Lv.20	3-5까지
★4 MAX / ★5 Lv.1	3-8까지
★5 Lv.10	3-10

무한의 탑 도달 층(시뮬레이션): ★1 MAX ≈ 14층 · ★2 MAX ≈ 24층 · ★3 MAX ≈ 29층 · ★4 ≈ 44층 · ★5 Lv.25 ≈ 60층 이상

다음 단계 (기획 확정 필요)

1. 메인 캐릭터 — 이미지·컨셉·전용 스킬 확정 후 추가 (데이터 형식·합성 5%·진화 로직은 준비됨)
2. 지원 스킬 게이지 / 와일드 블록 — 충전 조건·수치 확정 필요
3. 장비 (무기/방어구/장신구), 스킬 강화
4. 챕터 4 이후 스테이지, 게임 모드(PvP·레이드 등)
5. 아트 — 현재는 코드로 그린 도트 그래픽(템플릿 + 의상 색 바리에이션). 정식 아트가 나오면 텍스처만 교체

배포

GitHub Pages(main 브랜치 루트)로 정적 배포됩니다. main에 push하면 1~2분 후 위 링크에 자동 반영됩니다.

로컬 실행

• index.html을 브라우저로 열기 (더블클릭)
• 테스트: npm test
• 밸런스 시뮬레이션: npm run sim -- 40 BAS_0001,BAS_0003,BAS_0004 0 stage=all grade=1 level=10 ([판수] [파티] [리더] [stage=ID|all] [grade=N] [level=N] [CONFIG_KEY=값 ...])

디버그 URL 파라미터

아래 파라미터가 있으면 세이브와 무관한 단독 전투로 바로 시작합니다 (진행 미반영).

파라미터	예	설명
stage	STG_01_10	스테이지
party	BAS_0001,CHR_0001:6,BAS_0005	전열→후열 순서 3명 (:등급을 붙이면 그 등급으로 출전)
leader	0	리더 인덱스
seed	123	난수 시드 고정
warp	110	N초 미리 진행 (보스·광폭화 확인용)

조작

입력	동작
블록 탭 / 숫자키 1~9	해당 칸이 속한 체인 스킬 발동
블록 길게 누르기	스킬 정보 툴팁
x1/x2 버튼, S	배속
AUTO 버튼, A	자동 블록 사용
⏸ 버튼, Space / Esc	일시정지 (계속 / 다시 / 나가기)

구조 (기획서 12.2 / 12.3 대응)

src/
  core.js, config.js, rules.js     공용 유틸 / 밸런스 상수(TBD 표시) / 성장 공식
  data.js                          직업, 기본 유닛 카탈로그, 적, 챕터/스테이지, 일일 던전
  battle/
    BattleManager.js               전투 상태 머신, 웨이브, 광폭화, 승패·별 평가, 자동 모드
    BlockManager.js                블록 생성(리더 가중치 2배, 사망자 제외), 소모
    ChainResolver.js               인접 블록 체인 판정 (최대 3)
    SkillExecutor.js               체인 레벨별 스킬 실행
    DamageCalculator.js            데미지 공식, 속성 상성
    StatusEffectSystem.js          상태이상 (CC/화상/방깎/보호막/지속치유)
    Unit.js                        유닛 스탯 (등급·레벨·강화 배율)
  meta/
    Progression.js                 보상, 레벨업, 합성, 강화, 진화, 소환, 세이브 검증
    SaveManager.js                 localStorage 저장/불러오기
  ui/
    BattleView.js                  전투 화면 (Phaser 씬: 유닛 애니메이션, 이펙트, HUD)
    PixelArt.js                    도트 템플릿(인간형·적·무기)과 팔레트 — 576종 색 바리에이션
    Screens.js, style.css          메뉴 화면 (DOM)
    Sound.js                       효과음/BGM (Web Audio 합성)
  main.js                          화면 전환, 게임 루프, 입력
tests/run-tests.js                 Node 단위 테스트
tools/simulate.js                  헤드리스 밸런스 시뮬레이터
vendor/phaser.min.js               Phaser 3.80.1 (MIT)

battle/, meta/는 DOM에 의존하지 않아 Node에서 그대로 실행됩니다.

기획 미확정(TBD) 항목의 임시값

모두 src/config.js에 모여 있습니다.

항목	임시값
블록 생성 주기	1.2초
방어 상수 K	100
속성 유리/불리	x1.25 / x0.8
아군 기본 공격 / 적 공격 계수	ATK 30% / 60%
레벨당 스탯 성장	3% (상위 등급 Lv.1 = 하위 등급 MAX 스탯)
필요 경험치	10 × Lv^1.3
강화	단계당 HP/ATK/DEF +5%, 성공률 100/90/80/70/60%, 비용 200 × 등급 × 단계, 실패 시 골드만 소모
첫 MAX 보상	골드 300 × 등급, 보석 10 × 등급
소환	보석 100, ★1 80% / ★2 20%
스테이지 드롭	챕터 1: ★1 30% / 챕터 2: ★2 10% + ★1 30% / 챕터 3: ★3 5% + ★2 20%
방출 골드	★1~★6: 30 / 100 / 300 / 1,000 / 3,000 / 10,000
★★★ 클리어 시간	90초
성직자 회복	ATK × 50/120/200% (기획서 10/20/30%은 성직자를 넣으면 승률이 떨어져 상향)
스킬 대상	피해: 최전방 적 단일 / 회복: HP 비율 최저 아군 단일
사망 멤버의 기존 블록	즉시 제거
연속 미생성 방지	6번 연속 안 나온 캐릭터는 다음 블록 확정
일일 던전	하루 3회, 보상 = 해금 기준 스테이지 골드/EXP × 3, 적 강도 = 기준 스테이지와 동일
무한의 탑	적 배율 0.8 + 0.1 × 층, 첫 돌파 골드 60 × 층 · EXP 40 × 층 · 보석 10(보스 층 50)
도감 달성 보상	10/25/50/100/200/400/576종 → 보석 50/100/150/300/500/1,000/3,000