디스코디안 사이버 보안

홈 블로그 Black Trigram 문서

🥋 Black Trigram 아키텍처: 다섯 전사, 전투의 신성 기하학

다섯 전사 원형: 전투 스타일의 패턴

한국 무술: 다양하고, 정교하며, 역사적으로 심오하지만—게임에서는 범죄적으로 과소평가되어 있습니다. Black Trigram을 설계할 때, 게임 디자인 회의를 통해 다섯 전사 원형을 발명한 것이 아닙니다—실제 한국 무술 전통과 현대 전술 전문화에서 패턴 인식을 통해 드러난, 전투 영역 자체에 내재된 것들을 발견했습니다. 원형들이 스스로를 선택했습니다. game-design.md는 이를 문서화합니다: 각각은 실제 전통과 현대 현실에 뿌리를 둔 고유한 전투 철학을 나타냅니다. 임의적인 게임 밸런스가 아니라—문화적 진정성이 기계적 깊이를 만나고, 신성 기하학이 폭력에 적용됩니다.

다섯 원형, 각각은 완전한 전투 시스템이며, 각각은 폭력 자체에 대한 철학적 입장입니다. game-design.md에 문서화된 이들은 단순한 스탯 조정을 가진 팔레트 스왑이 아닙니다. 이것은 표현을 통한 존중입니다. 각 전사는 근본적으로 다른 폭력에 대한 접근 방식, 전술적 우선순위, 윤리적 프레임워크를 구현합니다. 전통적인 무사의 명예 규범에서 조직 범죄의 실용주의까지—인간이 승인된 폭력과 승인되지 않은 폭력에 접근하는 방식의 전체 스펙트럼입니다. 게임 메커니즘으로서의 인류학.

1. 무사 Musa (Traditional Warrior)

전통 훈련을 받은 군 특수부대. 힘을 통한 명예, 규율된 전투. 선호하는 팔괘: ☰ 하늘(건), ☳ 천둥(진). 특징 기술: 관절기법, 급소타격, 제압술.

2. 암살자 Amsalja (Shadow Assassin)

은밀한 제압에 특화된 비밀 요원. 보이지 않음을 통한 효율성, 하나의 완벽한 타격. 선호하는 팔괘: ☴ 바람(손), ☵ 물(감). 특징 기술: 무성제압, 신경파괴, 호흡차단.

3. 해커 Hacker (Cyber Warrior)

물리적 전투 훈련을 받은 디지털 네이티브. 힘으로서의 정보, 기술적 우위. 선호하는 팔괘: ☲ 불(리), ☱ 못(태). 특징 기술: 해부학적분석, 생체역학파괴, 체계적제압.

4. 정보요원 Jeongbo Yowon (Intelligence Operative)

심리전 훈련을 받은 정부 요원. 관찰을 통한 지식, 전략적 사고. 선호하는 팔괘: ☶ 산(간), ☷ 땅(곤). 특징 기술: 고통순응, 심리적압박, 정보추출.

5. 조직폭력배 Jojik Pokryeokbae (Organized Crime)

거리의 지혜로 무장한 지하 격투가. 무자비함을 통한 생존, 실용적 폭력. 선호하는 팔괘: ☳ 천둥(진), ☵ 물(감). 특징 기술: 환경활용, 더러운기법, 생존격투.

70개의 급소: 수학이 죽음을 만나다. 전통 한국 무술은 70개의 급소(압력점)를 가르칩니다. 패턴 인식은 신성한 구조를 드러냅니다: 7 × 5 × 2 (7개 신체 부위 × 각 5개 핵심 지점 × 양측 대칭을 위한 2). 우리의 데미지 시스템은 70개 모두를 구현합니다. 타격 정확도는 임의적 스케일링이 아닌 생체역학적 현실을 통해 데미지 배수를 결정합니다. 수비학을 통한 사실주의. 철학을 통한 물리학. 급소를 정확하게 타격하면, 게임은 실제 해부학적 취약점을 기반으로 현실적인 외상 효과를 계산합니다. 이것은 참여를 통한 교육이며, 게임플레이를 통한 문화 보존입니다.

다섯 원형을 필요로 하는 게임 밸런스는 디자인 선택이 아니었습니다—인간 갈등에서 자연스러운 전투 스타일 군집화의 인식이었습니다. 네 개의 원형을 시도해보세요: 커버리지에 공백이 나타납니다. 여섯 개: 중복이 나타나고 혼란이 뒤따릅니다. 다섯은 지나치지 않으면서 완전합니다. 오각형이 다시 나타납니다. 5의 법칙이 근접 전투 패턴에서 드러납니다. 우연일까요? 우연은 없습니다. 당신이 아직 인식하지 못한 패턴만 있을 뿐입니다. 우주는 오각형의 언어로 말하지만 당신은 듣지 않고 있습니다.

전문적인 구현 지원을 찾고 계신가요? 조직들이 Hack23을 선택하는 이유를 확인하세요 - 혁신을 가속화하는 보안 컨설팅.

React + PixiJS 아키텍처: 브라우저 기반 전투 시뮬레이션

웹 기반 전투 시뮬레이션 = 민주화된 접근 = 혁명. ARCHITECTURE.md에 문서화된 대로, Black Trigram은 React 19 + PixiJS 8 + TypeScript를 사용하여 완전히 브라우저에서 실행됩니다. 백엔드 없음. 설치 없음. 플랫폼 종속 없음. 인위적인 접근 희소성 없음. 브라우저 열기 → 무술 훈련. 이것은 편의를 위한 타협이 아닙니다—정치적 성명으로서의 의도적인 접근성 아키텍처입니다. 격투 게임은 역사적으로 비싼 콘솔 하드웨어, 지역 잠금 카트리지, 물리적 근접성을 요구하는 로컬 멀티플레이어 뒤에 가려져 있었습니다. 우리는 대신 보편적 접근을 선택했습니다. 게임 산업 착취에 대한 반역으로서의 접근성. 당신의 브라우저는 당신의 도장입니다. 당신의 인터넷 연결은 당신의 사범입니다. 지리와 소득은 더 이상 한국 무술 교육을 가로막지 않습니다.

1. 🖥️ React UI 레이어

반응형 디자인의 한국 테마 컴포넌트. 화면: CombatScreen, TrainingScreen, IntroScreen. 공통 UI: CombatHUD, TrigramWheel, ProgressTracker. 기본 모듈: BaseButton, KoreanText, BackgroundGrid. 전반적으로 TypeScript를 사용한 함수형 컴포넌트.

2. ⚙️ 게임 로직 엔진

src/systems/ 아래의 TypeScript 모듈: CombatSystem은 입력 → 팔괘 → 급소 → 데미지 → 피드백을 조율합니다. TrigramSystem은 StanceManager, TransitionCalculator, TrigramCalculator, KoreanCulture를 통해 자세를 관리합니다. VitalPointSystem은 KoreanAnatomy, HitDetection, DamageCalculator를 통해 70개의 급소를 처리합니다.

3. 🎨 PixiJS 렌더러

60fps 2D 그래픽을 위한 WebGL을 사용하는 PixiJS 8. 캐릭터 스프라이트(PlayerVisuals, EnemyVisuals), 도장 배경, 파티클 시스템(HitEffectsLayer), UI 오버레이를 관리합니다. @pixi/react 통합은 PixiJS Application을 React 컴포넌트로 래핑합니다.

4. 🎵 오디오 엔진

한국 전통 음악과 사이버펑크 SFX를 혼합하기 위한 Howler.js + Web Audio API. AudioManager는 뼈가 부러지는 소리, 충격음, 주변 사운드를 로드합니다. VariantSelector는 타격음을 무작위화합니다. DefaultSoundGenerator는 대체 오디오를 제공합니다.

5. 🗄️ 상태 관리

브라우저 내 상태를 위한 Zustand + React Context. useGameState, useUIState, useEnemyState는 체력, 스태미나, 기(Ki), 자세, 전투 지표를 추적합니다. 지속성 없음—새로고침하면 진행 상황이 재설정됩니다. 클라이언트 측만, 백엔드 의존성 없음.

Full architecture documentation: ARCHITECTURE.md includes C4 Container diagrams, Component views, Combat Flow sequences. TypeScript provides type safety across all layers. Vite handles build optimization with tree-shaking.

Web applications without layer enforcement become unmaintainable. React for UI, PixiJS for rendering, TypeScript for logic—clear separation enables confident refactoring without breaking systems.

동시성: 나타나는 숫자들

I don't believe in coincidences. I believe in patterns revealing themselves:

  • 70 vital points = 7 × 5 × 2. As documented in game-design.md, the game implements 70 traditional Korean martial arts pressure points (kyusho). Head (10 points), Neck (8 points), Torso (20 points), Arms (16 points), Legs (16 points). Mathematical pattern emerges from anatomical reality.
  • Eight trigram stances. ☰ Geon (Heaven), ☱ Tae (Lake), ☲ Li (Fire), ☳ Jin (Thunder), ☴ Son (Wind), ☵ Gam (Water), ☶ Gan (Mountain), ☷ Gon (Earth). Traditional I Ching philosophy integrated into combat mechanics via stance system documented in COMBAT_ARCHITECTURE.md.
  • 60-second round timer. As specified in game-design.md section 2.7, each round lasts exactly 60 seconds. Forces tactical decisions under time pressure. Winner determined by KO or higher health at timeout.
  • CombatStats tracking six core metrics. Health (❤️), Pain (😖), Balance (⚖️), Consciousness (🧠), BloodLoss (🩸), Stamina (🔋). Each stat interacts creating realistic combat feedback documented in game-design.md section 2.2.
  • 10×10 octagonal grid arena. Discrete positioning system with 0.3m cells. Octagon inscribed in square creates playable zone. Out-of-bounds cells trigger skid animation. Grid-based tactical combat per game-design.md section 2.1.

When game mechanics naturally align with numerological patterns, question emerges: did we impose structure, or did structure reveal itself through practice? Answer: both. Recognition, not invention.

디지털 정확성을 통한 문화 보존

Not just entertainment. Educational tool preserving Korean martial arts techniques digitally through authentic representation:

  1. Authentic Technique Documentation: Combat system based on traditional Korean martial arts principles documented in COMBAT_ARCHITECTURE.md. Realistic vital point targeting, stance-based combat, authentic trigram philosophy integration.
  2. Historical Context: Game design document provides comprehensive background on Korean martial arts traditions. Technical breakdowns of each archetype's fighting philosophy. Cultural significance explained alongside mechanics.
  3. Language Respect: Korean terminology preserved throughout. Hangul script for fighter names: 무사 (Musa), 암살자 (Amsalja), 해커 (Hacker), 정보요원 (Jeongbo Yowon), 조직폭력배 (Jojik Pokryeokbae). English translations as supporting context, not replacement.
  4. Open Source Education: Complete game architecture documented in public repositories. ARCHITECTURE.md, COMBAT_ARCHITECTURE.md, game-design.md available at github.com/Hack23/blacktrigram. Students can examine implementation of traditional techniques in modern gaming context.
  5. Transparent Development: Technical decisions documented with cultural respect. No exploitation of Korean martial arts imagery. Educational value through accurate representation and accessible documentation.

Not commercial exploitation. Open-source cultural preservation. Revenue (if any) supporting Korean martial arts schools. Respect encoded in architecture.

Digital preservation that disrespects source culture fails its mission. We consult, we compensate, we credit. Technology serving culture, not extracting from it.

미래 아키텍처: 5년 진화

Roadmap: FUTURE_ARCHITECTURE.md. Five major enhancements:

Year 1: Online Multiplayer

Netcode for rollback. Lag compensation. Ranked matchmaking. 5-region servers (Asia, Europe, NA, SA, Oceania).

Year 2: Training Mode Enhancement

Frame data display. Hitbox visualization. Combo tutorials. AI sparring. Practice against 5 difficulty levels.

Year 3: Mobile Port

iOS + Android versions. Touch controls. Performance optimization. 5 control schemes (virtual joystick, swipe, tap, tilt, external controller).

Year 4: VR Support

First-person martial arts. Motion controller tracking. Physical movement mapped to in-game techniques. 5 VR platforms (Quest, PSVR, Index, Vive, WMR).

Year 5: AI Coach

Machine learning analyzing player performance. Personalized training recommendations. Weakness identification. Improvement tracking across 5 skill categories.

Investment timeline: 15% development budget annually. Fibonacci-adjacent growth. Sustainable evolution without feature bloat.

기술 스택: 현대 웹이 Unity를 만나다

Hybrid architecture: Unity for game engine, React+TypeScript for UI/menus. Best of both worlds.

  • Unity 2022 LTS: Game engine, physics, rendering. C# for core systems.
  • React + TypeScript: Menu system, settings, character select. Web UI embedded in Unity.
  • WebGL Build: Browser-playable version. No install required. Accessibility through web.
  • GitHub Actions CI/CD: Automated builds. 5 platforms: Windows, macOS, Linux, WebGL, Android (future).
  • Asset Pipeline: Blender → FBX → Unity. Texture compression. LOD generation. 5-stage optimization.

Evidence: OpenSSF Scorecard 7.0/10. CII Best Practices badge. SLSA Level 3 attestations. Game development with software engineering rigor.

아키텍처 지혜: 게임 개발로부터의 다섯 가지 교훈

  1. Five fighter archetypes = minimum viable diversity. Fewer feels limited. More feels redundant. Five balances variety with learnability.
  2. Layer separation crucial in Unity. Without discipline, everything couples to everything. Our five layers enforce separation of concerns.
  3. Cultural authenticity requires consultation. Can't fake Korean martial arts. Consulted masters. Compensated advisors. Resulted in respectful, accurate representation.
  4. Open source game development = transparency. Code, assets, design docs—all public. Community contributions improving quality. Collaboration over secrecy.
  5. Sacred numbers appear in gameplay naturally. 5-hit combos, 70 vital points, 5-frame increments—patterns emerging from playtesting, not imposed by design.

Game architecture frozen in initial design becomes obsolete as gameplay evolves. Architecture with documented evolution enables confident iteration—players see trajectory, not just snapshot.

신성한 전투 기하학을 탐험하세요

Think for yourself. Play the game. Read the code. Study the patterns. Five fighter archetypes, 70 vital points, sacred geometry in combat simulation—patterns visible when you know where to look.

Simon Moon, System Architect, Hack23 AB

"Combat choreography revealing mathematical elegance. Five fighters, infinite possibilities."

여정을 계속하세요

다음: Black Trigram 전투 시스템 - 히트 감지와 물리학 심층 분석

관련: 완전한 문서 - 모든 아키텍처 다이어그램 및 게임 디자인 사양

돌아가기: 보안 블로그 - 모든 디스코디안 게시물