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

📖 게임 개요

흑괘(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 - 스프라이트 시트, 파티클 텍스처, 컬러 팔레트, UI 아이콘 가이드라인
🎵 AUDIO_ASSETS.md - 전통 한국 악기 루프, 충격 SFX, 믹싱 노트 목록
🎬 VIDEO_ASSETS.md - 흑괘: 그림자의 길 비디오 콘텐츠

🔒 CI/CD & 보안

🔒 development.md - 포괄적인 보안 조치 및 개발 관행
🕷️ ZAP 보안 스캐닝 - OWASP ZAP 동적 애플리케이션 보안 테스트
⚡ Lighthouse 성능 - 자동화된 성능 및 접근성 감사
📄 SBOM 생성 - 투명성을 위한 소프트웨어 자재 명세서

🔐 보안 아키텍처

🔐 SECURITY_ARCHITECTURE.md - 보안 설계 및 구현 패턴
🔐 FUTURE_SECURITY_ARCHITECTURE.md - AI 향상된 고급 보안 아키텍처
🔒 development.md - 보안 조치 및 개발 관행

🔗 개념 & 전략

🧠 MINDMAP.md - 현재 시스템 구성 요소 관계 및 개념 아키텍처
🧠 FUTURE_MINDMAP.md - 향상된 기능이 포함된 진화 로드맵
💼 SWOT.md - 강점, 약점, 기회, 위협의 전략적 평가
💼 FUTURE_SWOT.md - 미래 포지셔닝 및 기회의 전략적 분석

🔗 데이터 & 프로세스

📊 DATA_MODEL.md - 현재 데이터 구조, 관계 및 엔티티 프레임워크
📊 FUTURE_DATA_MODEL.md - 미래 반복을 위한 향상된 데이터 아키텍처
🔄 FLOWCHART.md - 현재 데이터 처리 워크플로 및 비즈니스 프로세스
🔄 FUTURE_FLOWCHART.md - 미래 개발을 위한 향상된 워크플로

🔗 행동 시스템

🔄 STATEDIAGRAM.md - 현재 시스템 상태 전환 및 행동 모델
🔄 FUTURE_STATEDIAGRAM.md - 미래 구현을 위한 향상된 적응형 상태 전환
🔧 WORKFLOWS.md - 현재 자동화 프로세스 및 CI/CD 파이프라인
🔧 FUTURE_WORKFLOWS.md - 고급 기능이 포함된 향상된 CI/CD

🔗 테스팅 & 품질 보증

🧪 단위 테스트 결과 - 단위 테스트 결과 및 커버리지의 시각적 표현
📊 테스트 커버리지 - 코드베이스 커버리지를 보여주는 테스트 커버리지 보고서
🔍 E2E 테스트 보고서 - 전체 시스템 검증을 보여주는 종단간 테스트 보고서
🎓 UnitTestPlan.md - 포괄적인 단위 테스트 전략
🎮 E2ETestPlan.md - 종단간 테스트 전략

🔗 성능 & 운영

⚡ performance-testing.md - 다양한 조건에서의 벤치마크 및 성능 분석
🔄 BCPPlan.md - 포괄적인 사업 연속성 계획 및 복구 전략
📅 End-of-Life-Strategy.md - 기술 구성 요소의 유지 관리 및 수명 종료 계획
📘 API 문서 - 모든 구성 요소, 유형 및 함수에 대한 상세한 API 참조

🎯 격투 철학

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

각 기법의 초점:

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

🎮 도장 입문

한국 무예 기초

흑괘는 진정한 한국 무예 원리를 기반으로 구축되어 전통 기법과 철학을 통합합니다:

🥋 택견 (Taekkyeon) - 전통 한국 발차기

리듬, 균형, 연속적인 움직임을 강조하는 유동적인 다리 기법으로 격투 효과를 극대화합니다.

🤼 씨름 (Ssireum) - 한국 레슬링

던지기, 테이크다운, 그라운드 컨트롤 방법에 초점을 맞춘 그래플링 기법입니다.

🗡️ 검술 (Geomsul) - 검 무예

맨손 격투 응용을 위해 적응된 전통 한국 검술 원리입니다.

🎯 급소술 (Geupso-sul) - 급소점 타격

최대 격투 효율을 위한 해부학적 취약점의 정밀한 타겟팅입니다.

⚔️ 비수 (Bisu) - 치명적 기법

최대 효과를 위한 결정적인 맨손 격투 방법입니다.

격투 메커니즘

흑괘는 진정한 무예 시뮬레이션을 위해 현실적인 격투 물리학과 신체 역학을 구현합니다:

🩸 진정한 외상 시스템

실제 격투 손상 패턴을 기반으로 한 현실적인 부상 시각화 및 출혈 효과입니다.

🦴 뼈 충격 오디오

현실적인 격투 피드백을 위한 진짜 뼈 접촉 및 골절 소리입니다.

🫁 호흡 방해

호흡계 타겟팅이 체력과 격투 성능에 영향을 미칩니다.

⚖️ 균형 시스템

격투 안정성에 영향을 미치는 현실적인 자세와 운동량 물리학입니다.

🧠 의식 상태

성공적인 격투 기법으로부터의 점진적인 인식 손상입니다.

😵 통증 반응

성능과 격투 효과에 영향을 미치는 생리적 통증입니다.

격투 조작

정밀한 기법 실행을 위한 격투 입력 시스템을 마스터하세요:

조작	액션	설명
WASD / 화살표 키	이동	전술적 위치 잡기와 발놀림
1-8	괘 기법	팔괘를 기반으로 한 기법 실행
스페이스바	가드	방어 자세와 블록
마우스	급소 타격	타겟 급소점 공격
Tab	원형 전환	5가지 격투 유형 간 변경