흑괘 문서 - 한국 전통무예 게임 가이드 및 매뉴얼

📖 게임 개요

흑괘(Black Trigram)는 한국 무예 철학과 주역에서 영감을 받은 현실적인 2D 정밀 격투 게임입니다. 이 게임은 정밀한 해부학적 타겟팅을 통해 진정한 한국 무술을 가르치며, 70개의 급소점과 5개의 독특한 전투 원형을 현대적인 웹 기술로 구현했습니다.

🚀 빠른 시작

🌐 웹 버전 (권장)

즉시 접근

웹 브라우저를 통해 시작하는 것이 가장 쉬운 방법입니다:

1. https://blacktrigram.com 방문 2. "지금 플레이" 클릭 3. 즉시 격투 훈련 시작

🔧 로컬 개발

개발자 설정

개발 또는 로컬 호스팅을 위해:

# 저장소 복제 git clone https://github.com/Hack23/blacktrigram.git cd blacktrigram # 의존성 설치 npm install # 개발 서버 시작 npm run dev # 프로덕션용 빌드 npm run build # 테스트 실행 npm run test npm run test:combat

🎮 게임플레이 가이드

⌨️ 기본 조작

🏃 이동: WASD 또는 화살표 키 - 전술적 위치 잡기와 발놀림
⚔️ 기법: 1–8 (팔괘 기반 격투 기법)
🛡️ 가드: 스페이스바 - 방어 자세와 블록
🎯 급소 타격: 마우스 - 타겟 급소점 공격
🔄 원형 전환: Tab - 5가지 전투 유형 간 변경

🩸 격투 피드백

💥 충격 효과: 뼈 접촉 소리와 시각적 외상
🩸 부상 시스템: 현실적인 출혈과 손상 진행
😵 무력화: 격투 효과의 시각적 지표
⚖️ 균형: 물리적 자세와 취약성 윈도우

📚 아키텍처 & 문서

흑괘의 완전한 아키텍처 및 기술 문서를 탐색하세요:

🔗 아키텍처 & 디자인

📐 ARCHITECTURE.md - 고수준 C4 모델, 컨테이너/컴포넌트 뷰
📈 FUTURE_ARCHITECTURE.md - 향후 개선 비전
API 문서 - 상세 API 참조

🔗 격투 & 메커니즘

🥋 COMBAT_ARCHITECTURE.md - 격투 시스템 디자인
🗺️ game-design.md - 게임 메커니즘 개요
📊 game-status.md - 현재 진행 상황 추적

🔗 자산 & 미디어

🖼️ ART_ASSETS.md - 비주얼 자산 가이드라인
🎵 AUDIO_ASSETS.md - 오디오 구현
🎬 VIDEO_ASSETS.md - 비디오 콘텐츠

🎯 격투 철학

"어둠 속에서 완벽한 일격을 찾아라"
"In darkness, seek the perfect strike"

각 기법의 초점:

정확한 타격 (Precise Targeting) - 정확한 해부학적 취약점
최대 효과 (Maximum Effectiveness) - 일격 무력화
전투 심리 (Combat Psychology) - 격투를 위한 정신적 준비
전통 지식 (Traditional Knowledge) - 진정한 한국 무술
원형 특화 (Archetype Specialization) - 전투 유형별 독특한 접근

🎮 지금 플레이 📺 YouTube 채널 🎵 TikTok