블록 체인 RPG — 프로토타입
설치 없이 링크만 열면 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층 이상
다음 단계 (기획 확정 필요)
- 메인 캐릭터 — 이미지·컨셉·전용 스킬 확정 후 추가 (데이터 형식·합성 5%·진화 로직은 준비됨)
- 지원 스킬 게이지 / 와일드 블록 — 충전 조건·수치 확정 필요
- 장비 (무기/방어구/장신구), 스킬 강화
- 챕터 4 이후 스테이지, 게임 모드(PvP·레이드 등)
- 아트 — 현재는 코드로 그린 도트 그래픽(템플릿 + 의상 색 바리에이션). 정식 아트가 나오면 텍스처만 교체
배포
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 |
