blacktrigram 0.7.32 โ 0.7.34
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ARCHITECTURE.md +10 -10
- package/COMBAT_ARCHITECTURE.md +5 -1
- package/CONTROLS.md +3 -3
- package/CRA-ASSESSMENT.md +8 -8
- package/DATA_MODEL.md +1 -1
- package/README.md +567 -594
- package/SECURITY.md +33 -6
- package/lib/components/screens/combat/CombatScreen3D.js.map +1 -1
- package/lib/components/screens/intro/IntroScreen3D.js +1 -1
- package/lib/components/screens/training/hooks/useTrainingActions.js.map +1 -1
- package/lib/components/shared/three/ui/TechniqueBar.d.ts.map +1 -1
- package/lib/components/shared/three/ui/TechniqueBar.js +1 -6
- package/lib/components/shared/three/ui/TechniqueBar.js.map +1 -1
- package/lib/components/shared/three/ui/TechniqueCard.d.ts +0 -5
- package/lib/components/shared/three/ui/TechniqueCard.d.ts.map +1 -1
- package/lib/components/shared/three/ui/TechniqueCard.js.map +1 -1
- package/lib/components/shared/ui/SplashScreen.js +2 -2
- package/lib/hooks/useResponsiveLayout.d.ts +7 -7
- package/lib/hooks/useResponsiveLayout.d.ts.map +1 -1
- package/lib/hooks/useResponsiveLayout.js +18 -6
- package/lib/hooks/useResponsiveLayout.js.map +1 -1
- package/lib/systems/animation/catalogs/StanceAnimations.d.ts +0 -14
- package/lib/systems/animation/catalogs/StanceAnimations.d.ts.map +1 -1
- package/lib/systems/animation/catalogs/StanceAnimations.js +2 -15
- package/lib/systems/animation/catalogs/StanceAnimations.js.map +1 -1
- package/lib/systems/animation/core/AnimationRegistry.js +1 -1
- package/lib/systems/bodypart/CombatInjuryIntegration.d.ts +0 -21
- package/lib/systems/bodypart/CombatInjuryIntegration.d.ts.map +1 -1
- package/lib/systems/bodypart/CombatInjuryIntegration.js +0 -21
- package/lib/systems/bodypart/CombatInjuryIntegration.js.map +1 -1
- package/lib/systems/bodypart/InjuryTracker.d.ts +9 -11
- package/lib/systems/bodypart/InjuryTracker.d.ts.map +1 -1
- package/lib/systems/bodypart/InjuryTracker.js +13 -15
- package/lib/systems/bodypart/InjuryTracker.js.map +1 -1
- package/lib/systems/breathing/integration.d.ts +6 -0
- package/lib/systems/breathing/integration.d.ts.map +1 -1
- package/lib/systems/breathing/integration.js +13 -6
- package/lib/systems/breathing/integration.js.map +1 -1
- package/lib/types/physicsConstants.d.ts +23 -5
- package/lib/types/physicsConstants.d.ts.map +1 -1
- package/lib/types/physicsConstants.js +23 -5
- package/lib/types/physicsConstants.js.map +1 -1
- package/lib/utils/accessibility.d.ts +0 -5
- package/lib/utils/accessibility.d.ts.map +1 -1
- package/lib/utils/accessibility.js +0 -1
- package/lib/utils/accessibility.js.map +1 -1
- package/lib/utils/performance/PerformanceOverlay3D.d.ts +0 -2
- package/lib/utils/performance/PerformanceOverlay3D.d.ts.map +1 -1
- package/lib/utils/performance/PerformanceOverlay3D.js +1 -5
- package/lib/utils/performance/PerformanceOverlay3D.js.map +1 -1
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -1,106 +1,296 @@
|
|
|
1
|
+
<!-- SPDX-FileCopyrightText: 2024-2026 Hack23 AB -->
|
|
2
|
+
<!-- SPDX-License-Identifier: Apache-2.0 -->
|
|
3
|
+
|
|
1
4
|
<p align="center">
|
|
2
|
-
<img src="https://hack23.com/icon-192.png" alt="Hack23 Logo" width="192" height="192">
|
|
5
|
+
<img src="https://hack23.com/icon-192.png" alt="Hack23 AB Logo โ Korean martial arts simulator publisher" width="192" height="192">
|
|
3
6
|
</p>
|
|
4
7
|
|
|
5
|
-
<
|
|
8
|
+
<h1 align="center">๐ฅ Black Trigram (ํ๊ด)</h1>
|
|
6
9
|
|
|
7
|
-
|
|
10
|
+
<p align="center">
|
|
11
|
+
<strong>Korean Martial Arts Combat Simulator โ Eight Trigrams ยท 70 Vital Points ยท 51 Authentic Techniques</strong><br>
|
|
12
|
+
<em>์ด๋ ์ ๋ฌด์๋ก ์๋ฒฝํ ์ผ๊ฒฉ์ ์ถ๊ตฌํ๋ผ โ "Master the dark arts through the pursuit of the perfect strike"</em>
|
|
13
|
+
</p>
|
|
8
14
|
|
|
9
|
-
|
|
15
|
+
<p align="center">
|
|
16
|
+
<a href="https://blacktrigram.com/"><img src="https://img.shields.io/badge/๐ฎ_Play-blacktrigram.com-FFD700?style=for-the-badge&labelColor=000000" alt="Play Black Trigram live at blacktrigram.com"/></a>
|
|
17
|
+
<a href="https://hack23.github.io/blacktrigram/"><img src="https://img.shields.io/badge/๐_API_Docs-TypeDoc-00FFFF?style=for-the-badge&labelColor=000000&logo=typescript&logoColor=white" alt="TypeDoc API documentation for Black Trigram"/></a>
|
|
18
|
+
<a href="https://www.npmjs.com/package/blacktrigram"><img src="https://img.shields.io/badge/๐ฆ_npm-blacktrigram-CB3837?style=for-the-badge&labelColor=000000&logo=npm&logoColor=white" alt="Black Trigram on npm"/></a>
|
|
19
|
+
<a href="https://deepwiki.com/Hack23/blacktrigram"><img src="https://img.shields.io/badge/๐ค_Ask_DeepWiki-blacktrigram-7B1FA2?style=for-the-badge&labelColor=000000" alt="Ask DeepWiki about Black Trigram"/></a>
|
|
20
|
+
</p>
|
|
10
21
|
|
|
11
|
-
|
|
12
|
-
|
|
22
|
+
<table>
|
|
23
|
+
<tr>
|
|
24
|
+
<td width="180" align="center" valign="top">
|
|
25
|
+
<a href="https://blacktrigram.com/"><img src="public/black-trigram.png" alt="Black Trigram (ํ๊ด) game logo โ Korean martial arts" width="160"/></a>
|
|
26
|
+
<div>
|
|
27
|
+
<a href="https://blacktrigram.com/"><img src="https://img.shields.io/website?url=https%3A%2F%2Fblacktrigram.com&style=flat-square&label=blacktrigram.com" alt="blacktrigram.com website status"/></a>
|
|
28
|
+
</div>
|
|
29
|
+
<div>
|
|
30
|
+
<a href="https://www.npmjs.com/package/blacktrigram"><img src="https://img.shields.io/npm/v/blacktrigram.svg?style=flat-square&color=CB3837&logo=npm&logoColor=white" alt="npm package version 0.7.32"/></a>
|
|
31
|
+
</div>
|
|
32
|
+
<div>
|
|
33
|
+
<a href="https://www.npmjs.com/package/blacktrigram"><img src="https://img.shields.io/npm/dm/blacktrigram.svg?style=flat-square&color=CB3837&label=npm%20downloads" alt="npm monthly downloads"/></a>
|
|
34
|
+
</div>
|
|
35
|
+
<div>
|
|
36
|
+
<a href="https://github.com/Hack23/blacktrigram/releases"><img src="https://img.shields.io/github/v/release/Hack23/blacktrigram?style=flat-square&color=FFD700&logo=github&logoColor=white" alt="Latest GitHub release"/></a>
|
|
37
|
+
</div>
|
|
38
|
+
<div>
|
|
39
|
+
<a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node-%E2%89%A525-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js 25 or later required"/></a>
|
|
40
|
+
</div>
|
|
41
|
+
</td>
|
|
42
|
+
<td>
|
|
43
|
+
<p><strong>๐ฅ Korean martial arts ยท โฏ๏ธ Eight Trigrams (ํ๊ด) ยท ๐ฏ 70 vital points (๊ธ์) ยท โ๏ธ 51 techniques ยท ๐ฎ Three.js / React Three Fiber ยท ๐ฑ 60fps desktop ยท 55fps+ mobile</strong></p>
|
|
44
|
+
<p><strong>Black Trigram (ํ๊ด)</strong> is a production-ready 3D precision combat simulator that turns authentic Korean martial arts โ Hapkido (ํฉ๊ธฐ๋), Taekwondo (ํ๊ถ๋), Taekkyeon (ํ๊ฒฌ), Kuk Sool Won, Tang Soo Do, Hwa Rang Do, Ssireum, Subak, Yudo, and Gongkwon Yusul โ into a typed, deterministic, browser-native combat experience. Eight I Ching trigram stances drive a 70-point anatomical targeting system across 5 distinct fighter archetypes, with skeletal animation (28 bones ยท 7 hand poses ยท 4 grappling states), counter-attack AI with limb-exposure detection, and a complete 13/13 combat-realism stack covering pain, consciousness, breathing, balance, trauma visualization, and bone-impact audio.</p>
|
|
45
|
+
<p>Built on <strong>React 19</strong>, <strong>Three.js 0.184</strong>, <strong>@react-three/fiber 9</strong>, <strong>@react-three/drei 10</strong>, <strong>TypeScript 6.0.3</strong>, and <strong>Vite 8</strong>. Frontend-only architecture deployed on <strong>AWS CloudFront + S3 (multi-region)</strong> with <strong>Route 53</strong> health-checked failover to <strong>GitHub Pages</strong> โ zero backend, zero PII, WCAG 2.1 AA accessible, GDPR-clean, and aligned with the full Hack23 ISMS, ISO 27001:2022, NIST CSF 2.0, CIS Controls v8.1, EU CRA, and NIS2.</p>
|
|
46
|
+
<div>
|
|
47
|
+
<a href="https://github.com/Hack23/blacktrigram"><img src="https://img.shields.io/badge/๐ฆ_Repo-Hack23%2Fblacktrigram-181717?style=flat-square&logo=github&logoColor=white" alt="GitHub repository Hack23/blacktrigram"/></a>
|
|
48
|
+
<a href="https://blacktrigram.com/"><img src="https://img.shields.io/badge/๐ฎ_Live_Game-blacktrigram.com-FFD700?style=flat-square&labelColor=000000" alt="Live game at blacktrigram.com"/></a>
|
|
49
|
+
<a href="https://hack23.github.io/blacktrigram/"><img src="https://img.shields.io/badge/๐_API-TypeDoc-00FFFF?style=flat-square&labelColor=000000&logo=typescript&logoColor=white" alt="TypeDoc API reference"/></a>
|
|
50
|
+
<a href="https://github.com/Hack23/ISMS-PUBLIC"><img src="https://img.shields.io/badge/๐_ISMS-PUBLIC-0066CC?style=flat-square&logo=github&logoColor=white" alt="Hack23 ISMS-PUBLIC repository"/></a>
|
|
51
|
+
</div>
|
|
52
|
+
<div>
|
|
53
|
+
<a href="https://blacktrigram.com/"><strong>๐ฎ Play</strong></a> ยท
|
|
54
|
+
<a href="https://hack23.github.io/blacktrigram/"><strong>๐ API</strong></a> ยท
|
|
55
|
+
<a href="ROADMAP.md"><strong>๐บ๏ธ Roadmap</strong></a> ยท
|
|
56
|
+
<a href="SECURITY_ARCHITECTURE.md"><strong>๐ก๏ธ Security</strong></a> ยท
|
|
57
|
+
<a href="THREAT_MODEL.md"><strong>๐ฏ Threat Model</strong></a> ยท
|
|
58
|
+
<a href="game-status.md"><strong>๐ Status</strong></a>
|
|
59
|
+
</div>
|
|
60
|
+
</td>
|
|
61
|
+
</tr>
|
|
62
|
+
</table>
|
|
13
63
|
|
|
14
|
-
|
|
64
|
+
<!-- โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ -->
|
|
65
|
+
<!-- Supply chain ยท OpenSSF ยท SLSA -->
|
|
66
|
+
<!-- โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ -->
|
|
15
67
|
|
|
16
|
-
[](https://github.com/Hack23/blacktrigram/releases)
|
|
17
|
-
[](https://www.npmjs.com/package/blacktrigram)
|
|
18
|
-
[](https://github.com/Hack23/blacktrigram/raw/master/LICENSE.md)
|
|
19
68
|
[](https://scorecard.dev/viewer/?uri=github.com/Hack23/blacktrigram)
|
|
20
|
-
[](https://www.bestpractices.dev/projects/10777)
|
|
21
70
|
[](https://github.com/Hack23/blacktrigram/attestations)
|
|
22
71
|
[](https://github.com/Hack23/blacktrigram/actions/workflows/scorecards.yml)
|
|
23
|
-
[](https://hack23.github.io/blacktrigram/)
|
|
27
|
-
[](https://github.com/Hack23/blacktrigram/actions/workflows/docs.yml)
|
|
28
|
-
[](https://hack23.github.io/blacktrigram/)
|
|
29
|
-
|
|
30
|
-
**๐ Test Documentation:**
|
|
31
|
-
[](E2ETestPlan.md)
|
|
32
|
-
[](UnitTestPlan.md)
|
|
33
|
-
|
|
34
|
-
[](https://github.com/Hack23/blacktrigram/blob/main/performance-testing.md)
|
|
35
|
-
[](https://github.com/Hack23/blacktrigram/blob/main/performance-testing.md)
|
|
36
|
-
[](./budget.json)
|
|
72
|
+
[](https://github.com/Hack23/blacktrigram/blob/main/LICENSE)
|
|
73
|
+
[](https://app.fossa.io/projects/git%2Bgithub.com%2FHack23%2Fblacktrigram?ref=badge_shield)
|
|
74
|
+
[](https://cla-assistant.io/Hack23/blacktrigram)
|
|
37
75
|
|
|
38
|
-
|
|
76
|
+
<!-- CI workflows -->
|
|
77
|
+
[](https://github.com/Hack23/blacktrigram/actions/workflows/codeql.yml)
|
|
78
|
+
[](https://github.com/Hack23/blacktrigram/actions/workflows/test-and-report.yml)
|
|
79
|
+
[](https://github.com/Hack23/blacktrigram/actions/workflows/dependency-review.yml)
|
|
80
|
+
[](https://github.com/Hack23/blacktrigram/actions/workflows/lighthouse-performance.yml)
|
|
81
|
+
[](https://github.com/Hack23/blacktrigram/actions/workflows/zap-scan.yml)
|
|
82
|
+
[](https://github.com/Hack23/blacktrigram/actions/workflows/accessibility-test.yml)
|
|
83
|
+
[](https://github.com/Hack23/blacktrigram/actions/workflows/release.yml)
|
|
84
|
+
[](https://github.com/Hack23/blacktrigram/actions/workflows/deploy-s3.yml)
|
|
85
|
+
[](https://github.com/Hack23/blacktrigram/actions/workflows/audit-assets.yml)
|
|
86
|
+
[](https://github.com/Hack23/blacktrigram/actions/workflows/screenshot-analysis.yml)
|
|
87
|
+
|
|
88
|
+
<!-- SonarCloud -->
|
|
39
89
|
[](https://sonarcloud.io/summary/new_code?id=Hack23_blacktrigram)
|
|
40
90
|
[](https://sonarcloud.io/summary/new_code?id=Hack23_blacktrigram)
|
|
41
91
|
[](https://sonarcloud.io/summary/new_code?id=Hack23_blacktrigram)
|
|
42
92
|
[](https://sonarcloud.io/summary/new_code?id=Hack23_blacktrigram)
|
|
43
|
-
[](https://sonarcloud.io/summary/new_code?id=Hack23_blacktrigram)
|
|
94
|
+
[](https://sonarcloud.io/summary/new_code?id=Hack23_blacktrigram)
|
|
95
|
+
|
|
96
|
+
<!-- Documentation & meta -->
|
|
97
|
+
[](https://hack23.github.io/blacktrigram/)
|
|
98
|
+
[](./budget.json)
|
|
99
|
+
[](./performance-testing.md)
|
|
100
|
+
[](https://isitmaintained.com/project/Hack23/blacktrigram "Average time to resolve an issue")
|
|
101
|
+
[](https://isitmaintained.com/project/Hack23/blacktrigram "Percentage of issues still open")
|
|
102
|
+
|
|
103
|
+
<!-- ISMS framework alignment -->
|
|
104
|
+
[](https://github.com/Hack23/ISMS-PUBLIC)
|
|
105
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Compliance_Checklist.md)
|
|
106
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Compliance_Checklist.md)
|
|
107
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Compliance_Checklist.md)
|
|
108
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Data_Classification_Policy.md)
|
|
109
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Information_Security_Policy.md)
|
|
110
|
+
[](./CRA-ASSESSMENT.md)
|
|
48
111
|
|
|
49
|
-
|
|
50
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Information_Security_Policy.md)
|
|
51
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Secure_Development_Policy.md)
|
|
52
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Threat_Modeling.md)
|
|
53
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Vulnerability_Management.md)
|
|
54
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Open_Source_Policy.md)
|
|
55
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/ISMS_Transparency_Plan.md)
|
|
112
|
+
---
|
|
56
113
|
|
|
57
|
-
|
|
114
|
+
## ๐ฏ Why This Exists
|
|
58
115
|
|
|
59
|
-
|
|
116
|
+
> **"์ด๋ ์์์ ์๋ฒฝํ ์ผ๊ฒฉ์ ์ฐพ์๋ผ"** โ _"In darkness, seek the perfect strike."_
|
|
117
|
+
|
|
118
|
+
Authentic Korean martial arts deserve more than a flashy combo system. **Black Trigram (ํ๊ด)** is the cultural-tech sister project to **[Riksdagsmonitor](https://github.com/Hack23/riksdagsmonitor)** and **[EU Parliament Monitor](https://github.com/Hack23/euparliamentmonitor)** in the Hack23 portfolio: where those projects apply structured intelligence tradecraft to democratic transparency, **Black Trigram** applies the same engineering rigor to combat simulation โ turning the I Ching's Eight Trigrams (โฐโฑโฒโณโดโตโถโท), 70 anatomically-precise vital points (๊ธ์) across 4 body regions and 14 TCM meridians, and 51 traditional techniques into a typed, testable, deterministic, accessible, browser-first **Korean martial arts simulator**.
|
|
119
|
+
|
|
120
|
+
It is a **complete 13/13 combat-realism platform** โ body-part health, vital-point targeting, enhanced anatomy, visual feedback, pain response, consciousness levels, breathing disruption, trauma visualization, balance/vulnerability, combat-readiness HUD, injury-based movement, bone-impact audio, and counter-attack AI with limb-exposure detection โ running at **60fps on desktop and 55fps+ on mobile**, validated across 518 tests (372 unit + 146 new), with **75%+ coverage**, **WCAG 2.1 AA** accessibility, and full **OWASP / OSSF / SLSA 3** supply-chain hardening.
|
|
121
|
+
|
|
122
|
+
| Pillar | What it means in this project |
|
|
123
|
+
|---|---|
|
|
124
|
+
| ๐ฅ **Cultural Authenticity** | Hangul + Revised Romanization + meaning for every term. 51 techniques sourced from Hapkido, Taekwondo, Taekkyeon, Kuk Sool Won, Tang Soo Do, Hwa Rang Do, Gumdo, Ssireum, Subak, Yudo, Gongkwon Yusul. 127 medical references underpin the 70 vital points. |
|
|
125
|
+
| ๐ฏ **Anatomical Precision** | 70/70 vital points, 4 body regions, 5 severity levels, 14 TCM meridians, 28-bone skeletal animation, 7 hand poses, 4 grappling states. Counter-attack AI with limb-exposure detection. |
|
|
126
|
+
| โ๏ธ **Engineering Rigor** | TypeScript strict mode, React 19, Three.js 0.184, R3F 9, Drei 10, Vite 8 โ 60fps desktop, 55fps+ mobile, 75%+ test coverage, 518 tests, deterministic combat math. |
|
|
127
|
+
| ๐ **Radical Transparency** | Frontend-only ยท zero backend ยท zero PII ยท public ISMS ยท CodeQL ยท ZAP DAST ยท Lighthouse ยท OSSF Scorecard ยท SLSA 3 attestations ยท CycloneDX SBOM. |
|
|
128
|
+
|
|
129
|
+
**๐ Production-readiness snapshot (v0.7.32)** โ see [`game-status.md`](./game-status.md) and [`ARCHITECTURE.md`](./ARCHITECTURE.md):
|
|
130
|
+
|
|
131
|
+
| Metric | Value | Source |
|
|
132
|
+
|---|---|---|
|
|
133
|
+
| Product version | **0.7.32** | [`package.json`](./package.json) |
|
|
134
|
+
| Overall quality | **9.4 / 10 โ Production-Ready** | game-status.md |
|
|
135
|
+
| Combat realism systems | **13 / 13 (100%)** | game-status.md |
|
|
136
|
+
| Vital points | **70 / 70** (4 regions ยท 5 severity ยท 14 TCM meridians ยท 127 medical refs) | game-status.md |
|
|
137
|
+
| Trigram stances | **8 / 8** | game-status.md |
|
|
138
|
+
| Player archetypes | **5 / 5** | game-status.md |
|
|
139
|
+
| Techniques | **51** across 4 categories | game-status.md |
|
|
140
|
+
| Skeletal animation | **28 bones ยท 7 hand poses ยท 4 grappling states** | game-status.md |
|
|
141
|
+
| Tests passing | **518** (372 + 146 new) | game-status.md |
|
|
142
|
+
| Test coverage | **~75%** (target 80%+) | game-status.md |
|
|
143
|
+
| Performance | **60fps desktop ยท 55fps+ mobile** (validated) | performance-testing.md |
|
|
144
|
+
| Accessibility | **WCAG 2.1 AA** | accessibility-test.yml |
|
|
145
|
+
| Last architecture review | **2026-04-21**, Architecture v2.1 | ARCHITECTURE.md |
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
## ๐ Explore the Platform
|
|
150
|
+
|
|
151
|
+
The published game is the audience-facing companion to this open-source TypeScript / React Three Fiber package. Bookmark these entry points:
|
|
152
|
+
|
|
153
|
+
<table>
|
|
154
|
+
<tr>
|
|
155
|
+
<td width="140" align="center" valign="top">
|
|
156
|
+
<a href="https://blacktrigram.com/"><img src="https://img.shields.io/badge/๐ฎ-Play_Now-FFD700?style=for-the-badge&labelColor=000000" alt="Play Black Trigram"/></a>
|
|
157
|
+
</td>
|
|
158
|
+
<td>
|
|
159
|
+
<strong><a href="https://blacktrigram.com/">๐ฎ Live Game โ blacktrigram.com</a></strong><br>
|
|
160
|
+
The production WebGL build. Eight Trigram stances, 70 vital points, 5 fighter archetypes, full 3D skeletal combat. Hardware-accelerated Three.js ยท 60fps desktop, 55fps+ mobile ยท WCAG 2.1 AA accessibility ยท keyboard, mouse, touch, and gesture controls. Hosted from <strong>AWS CloudFront + S3</strong> (multi-region) with <strong>Route 53</strong> health-checked DNS failover to GitHub Pages.
|
|
161
|
+
</td>
|
|
162
|
+
</tr>
|
|
163
|
+
<tr>
|
|
164
|
+
<td width="140" align="center" valign="top">
|
|
165
|
+
<a href="https://hack23.github.io/blacktrigram/"><img src="https://img.shields.io/badge/๐-API_Docs-00FFFF?style=for-the-badge&labelColor=000000&logo=typescript&logoColor=white" alt="API documentation"/></a>
|
|
166
|
+
</td>
|
|
167
|
+
<td>
|
|
168
|
+
<strong><a href="https://hack23.github.io/blacktrigram/">๐ TypeDoc API Reference</a></strong><br>
|
|
169
|
+
Strict TypeDoc output covering every public type, interface, hook, component, and system: Eight Trigram philosophy, vital-point system (all 70 points), combat math (damage / accuracy / counter-attack), 5 archetypes, audio engine, and KoreanโEnglish bilingual JSDoc. Strict <code>notDocumented:true</code> validation drives 100% public-API coverage.
|
|
170
|
+
</td>
|
|
171
|
+
</tr>
|
|
172
|
+
<tr>
|
|
173
|
+
<td width="140" align="center" valign="top">
|
|
174
|
+
<a href="SECURITY_ARCHITECTURE.md"><img src="https://img.shields.io/badge/๐ก๏ธ-Security_Architecture-DC143C?style=for-the-badge&labelColor=000000" alt="Security architecture"/></a>
|
|
175
|
+
</td>
|
|
176
|
+
<td>
|
|
177
|
+
<strong><a href="SECURITY_ARCHITECTURE.md">๐ก๏ธ Security Architecture</a></strong><br>
|
|
178
|
+
Trust boundaries, browser-only sandbox model, CSP, SRI, no-PII data flows, cryptography choices, supply-chain controls (OSSF Scorecard, SLSA 3, SBOM, Dependabot, CodeQL, ZAP). Aligned with <a href="https://github.com/Hack23/ISMS-PUBLIC/blob/main/Information_Security_Policy.md">Hack23 Information Security Policy</a> and <a href="https://github.com/Hack23/ISMS-PUBLIC/blob/main/Secure_Development_Policy.md">Secure Development Policy</a>.
|
|
179
|
+
</td>
|
|
180
|
+
</tr>
|
|
181
|
+
<tr>
|
|
182
|
+
<td width="140" align="center" valign="top">
|
|
183
|
+
<a href="THREAT_MODEL.md"><img src="https://img.shields.io/badge/๐ฏ-Threat_Model-FF6B6B?style=for-the-badge&labelColor=000000" alt="STRIDE threat model"/></a>
|
|
184
|
+
</td>
|
|
185
|
+
<td>
|
|
186
|
+
<strong><a href="THREAT_MODEL.md">๐ฏ STRIDE Threat Model</a></strong><br>
|
|
187
|
+
STRIDE-per-trust-boundary analysis with MITRE ATT&CK mapping, attack trees for the most likely abuse paths (e.g. dependency injection, supply-chain compromise, XSS via user-uploaded content โ none accepted), and explicit residual-risk acceptance. Aligned with <a href="https://github.com/Hack23/ISMS-PUBLIC/blob/main/Threat_Modeling.md">Hack23 Threat Modeling Policy</a>.
|
|
188
|
+
</td>
|
|
189
|
+
</tr>
|
|
190
|
+
<tr>
|
|
191
|
+
<td width="140" align="center" valign="top">
|
|
192
|
+
<a href="ROADMAP.md"><img src="https://img.shields.io/badge/๐บ๏ธ-Roadmap-2E7D32?style=for-the-badge&labelColor=000000" alt="Black Trigram roadmap to v1.0"/></a>
|
|
193
|
+
</td>
|
|
194
|
+
<td>
|
|
195
|
+
<strong><a href="ROADMAP.md">๐บ๏ธ Roadmap to v1.0 (Q3 2026)</a></strong><br>
|
|
196
|
+
Production-Ready release plan. Combat realism complete (13/13). Remaining: training-mode polish, Korean localization to 100%, mobile performance budget tightening, v1.0.0-rc validation. See also <a href="VISION_2026_2034.md">VISION_2026_2034.md</a> for the 8-year strategic plan and <a href="FUTURE_ARCHITECTURE.md">FUTURE_ARCHITECTURE.md</a> for the post-v1.0 architecture.
|
|
197
|
+
</td>
|
|
198
|
+
</tr>
|
|
199
|
+
<tr>
|
|
200
|
+
<td width="140" align="center" valign="top">
|
|
201
|
+
<a href="game-status.md"><img src="https://img.shields.io/badge/๐-Status_Report-0A66C2?style=for-the-badge&labelColor=000000" alt="Game status report"/></a>
|
|
202
|
+
</td>
|
|
203
|
+
<td>
|
|
204
|
+
<strong><a href="game-status.md">๐ Comprehensive Status Report</a></strong><br>
|
|
205
|
+
Source-of-truth metrics: 13/13 combat realism, 70/70 vital points, 28-bone skeletal animation, 51 techniques, 518 tests, 75%+ coverage, 60fps / 55fps+ mobile. Updated 2026-04-21 alongside ARCHITECTURE.md and THREAT_MODEL.md.
|
|
206
|
+
</td>
|
|
207
|
+
</tr>
|
|
208
|
+
<tr>
|
|
209
|
+
<td width="140" align="center" valign="top">
|
|
210
|
+
<a href="https://www.npmjs.com/package/blacktrigram"><img src="https://img.shields.io/badge/๐ฆ-npm_Package-CB3837?style=for-the-badge&labelColor=000000&logo=npm&logoColor=white" alt="npm package blacktrigram"/></a>
|
|
211
|
+
</td>
|
|
212
|
+
<td>
|
|
213
|
+
<strong><a href="https://www.npmjs.com/package/blacktrigram">๐ฆ npm: <code>blacktrigram</code></a></strong><br>
|
|
214
|
+
Reusable game systems, combat mechanics, animation framework, and Korean martial arts data, published as ESM with strict TypeScript types. Subpath exports: <code>blacktrigram/systems</code>, <code>/types</code>, <code>/audio</code>, <code>/utils</code>, <code>/components</code>, <code>/hooks</code>, <code>/data</code>. Each release ships with an <strong>SLSA 3</strong> provenance attestation and a <strong>CycloneDX SBOM</strong>.
|
|
215
|
+
</td>
|
|
216
|
+
</tr>
|
|
217
|
+
<tr>
|
|
218
|
+
<td width="140" align="center" valign="top">
|
|
219
|
+
<a href="https://deepwiki.com/Hack23/blacktrigram"><img src="https://img.shields.io/badge/๐ค-DeepWiki-7B1FA2?style=for-the-badge&labelColor=000000" alt="DeepWiki for Black Trigram"/></a>
|
|
220
|
+
</td>
|
|
221
|
+
<td>
|
|
222
|
+
<strong><a href="https://deepwiki.com/Hack23/blacktrigram">๐ค Ask DeepWiki</a></strong><br>
|
|
223
|
+
AI-indexed knowledge base over the entire Black Trigram repository. Best for natural-language deep-dives into combat math, archetypes, vital-point algorithms, animation rigging, or Three.js performance choices.
|
|
224
|
+
</td>
|
|
225
|
+
</tr>
|
|
226
|
+
</table>
|
|
60
227
|
|
|
61
228
|
---
|
|
62
229
|
|
|
63
|
-
## โก Combat
|
|
230
|
+
## โก Combat Pipeline โ at a Glance
|
|
231
|
+
|
|
232
|
+
The combat loop is fully deterministic, frame-accurate, and side-effect-isolated. Player input is normalised, fed through the active trigram stance, validated against vital-point geometry, scored for damage, and rendered in Three.js โ all within a single 16.6 ms frame budget.
|
|
233
|
+
|
|
234
|
+
```mermaid
|
|
235
|
+
flowchart LR
|
|
236
|
+
A[๐ฎ Input<br/>Keyboard ยท Touch ยท Gesture] --> B[โฏ๏ธ Trigram Stance<br/>๊ฑดํ๋ฆฌ์ง์๊ฐ๊ฐ๊ณค]
|
|
237
|
+
B --> C[๐ฆด Skeletal Pose<br/>28 bones ยท 7 hand poses]
|
|
238
|
+
C --> D[๐ฏ Vital-Point Targeter<br/>70 points ยท 4 regions ยท 14 meridians]
|
|
239
|
+
D --> E[โ๏ธ Damage Calculator<br/>severity ยท accuracy ยท archetype bonus]
|
|
240
|
+
E --> F[๐ฉธ Body-Part Health<br/>pain ยท consciousness ยท breathing ยท balance]
|
|
241
|
+
F --> G[๐ค Counter-Attack AI<br/>limb-exposure detection]
|
|
242
|
+
G --> H[๐จ Three.js Render<br/>60fps ยท trauma ยท particles ยท shaders]
|
|
243
|
+
F --> I[๐ Audio Engine<br/>bone impact ยท breath ยท ๊ตญ์
]
|
|
244
|
+
H --> J[โฟ WCAG 2.1 AA HUD<br/>combat readiness ยท haptics]
|
|
245
|
+
I --> J
|
|
246
|
+
|
|
247
|
+
classDef korean fill:#000000,stroke:#FFD700,color:#FFD700,stroke-width:2px
|
|
248
|
+
classDef tech fill:#001a1a,stroke:#00FFFF,color:#00FFFF,stroke-width:2px
|
|
249
|
+
classDef combat fill:#1a0000,stroke:#FF6B6B,color:#FF6B6B,stroke-width:2px
|
|
250
|
+
class A,J tech
|
|
251
|
+
class B,C,D korean
|
|
252
|
+
class E,F,G,H,I combat
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
See [`COMBAT_ARCHITECTURE.md`](COMBAT_ARCHITECTURE.md) for the full pipeline (3,300+ lines), [`FLOWCHART.md`](FLOWCHART.md) for business / combat process flows, and [`STATEDIAGRAM.md`](STATEDIAGRAM.md) for the complete state machine.
|
|
64
256
|
|
|
65
|
-
|
|
257
|
+
---
|
|
258
|
+
|
|
259
|
+
## ๐ฅ Combat Disciplines
|
|
66
260
|
|
|
67
|
-
|
|
261
|
+
**Black Trigram** is a **realistic Korean martial arts simulator** that teaches authentic vital-point combat through precise anatomical targeting. Master traditional techniques via modern 3D combat mechanics across 5 distinct fighter archetypes.
|
|
68
262
|
|
|
69
263
|
<table>
|
|
70
264
|
<tr>
|
|
71
265
|
<td align="center" width="25%">
|
|
72
266
|
|
|
73
|
-
**๐ฏ
|
|
74
|
-
_Jeonggyeokja_
|
|
75
|
-
**Precision Striker
|
|
76
|
-
|
|
267
|
+
**๐ฏ ์ ๊ฒฉ์**<br>
|
|
268
|
+
_Jeonggyeokja_<br>
|
|
269
|
+
**Precision Striker**<br>
|
|
77
270
|
_Every strike targets anatomical weak points_
|
|
78
271
|
|
|
79
272
|
</td>
|
|
80
273
|
<td align="center" width="25%">
|
|
81
274
|
|
|
82
|
-
**โ๏ธ
|
|
83
|
-
_Bisu_
|
|
84
|
-
**Lethal Technique
|
|
85
|
-
|
|
275
|
+
**โ๏ธ ๋น์**<br>
|
|
276
|
+
_Bisu_<br>
|
|
277
|
+
**Lethal Technique**<br>
|
|
86
278
|
_Decisive unarmed combat methods_
|
|
87
279
|
|
|
88
280
|
</td>
|
|
89
281
|
<td align="center" width="25%">
|
|
90
282
|
|
|
91
|
-
**๐ฅท
|
|
92
|
-
_Amsalja_
|
|
93
|
-
**Shadow Assassin
|
|
94
|
-
|
|
283
|
+
**๐ฅท ์์ด์**<br>
|
|
284
|
+
_Amsalja_<br>
|
|
285
|
+
**Shadow Assassin**<br>
|
|
95
286
|
_Silent takedown techniques_
|
|
96
287
|
|
|
97
288
|
</td>
|
|
98
289
|
<td align="center" width="25%">
|
|
99
290
|
|
|
100
|
-
**๐
|
|
101
|
-
_Geupsogyeok_
|
|
102
|
-
**Vital Point Strike
|
|
103
|
-
|
|
291
|
+
**๐ ๊ธ์๊ฒฉ**<br>
|
|
292
|
+
_Geupsogyeok_<br>
|
|
293
|
+
**Vital Point Strike**<br>
|
|
104
294
|
_70 anatomical targets for incapacitation_
|
|
105
295
|
|
|
106
296
|
</td>
|
|
@@ -109,173 +299,152 @@ _70 anatomical targets for incapacitation_
|
|
|
109
299
|
|
|
110
300
|
---
|
|
111
301
|
|
|
112
|
-
##
|
|
302
|
+
## ๐ญ Player Archetypes
|
|
303
|
+
|
|
304
|
+
Master combat through **5 distinct fighting philosophies** โ each with unique vital-point bonuses, archetype-specific techniques, and signature visual effects:
|
|
113
305
|
|
|
114
306
|
<div align="center">
|
|
115
307
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
308
|
+
| Archetype | Korean / English | Combat Philosophy | Special Focus |
|
|
309
|
+
| :---: | :---: | :---: | :---: |
|
|
310
|
+
| ๐ฏ | **๋ฌด์ฌ (Musa)** ยท _Traditional Warrior_ | Honor through strength | Military discipline, overwhelming force |
|
|
311
|
+
| ๐ฅท | **์์ด์ (Amsalja)** ยท _Shadow Assassin_ | Efficiency through invisibility | Stealth approaches, instant takedowns |
|
|
312
|
+
| ๐ป | **ํด์ปค (Hacker)** ยท _Cyber Warrior_ | Information as power | Environmental manipulation, tech-assisted strikes |
|
|
313
|
+
| ๐ต๏ธ | **์ ๋ณด์์ (Jeongbo Yowon)** ยท _Intelligence Operative_ | Knowledge through observation | Psychological manipulation, precise timing |
|
|
314
|
+
| โก | **์กฐ์งํญ๋ ฅ๋ฐฐ (Jojik Pokryeokbae)** ยท _Organized Crime_ | Survival through ruthlessness | Dirty fighting, improvised weapons |
|
|
119
315
|
|
|
120
316
|
</div>
|
|
121
317
|
|
|
122
318
|
---
|
|
123
319
|
|
|
124
|
-
##
|
|
125
|
-
|
|
126
|
-
### ๐ฅ Player Archetypes
|
|
320
|
+
## โฏ๏ธ Eight Trigrams (ํ๊ด) โ Combat Stance System
|
|
127
321
|
|
|
128
|
-
Master
|
|
322
|
+
Master **70 authentic vital points (๊ธ์)** distributed across the I Ching's eight trigrams. Each stance shapes the active hitbox geometry, technique pool, defensive posture, and audio profile:
|
|
129
323
|
|
|
130
324
|
<div align="center">
|
|
131
325
|
|
|
132
|
-
|
|
|
133
|
-
|
|
|
134
|
-
|
|
|
135
|
-
|
|
|
136
|
-
|
|
|
137
|
-
|
|
|
138
|
-
|
|
|
326
|
+
| Trigram | Korean / Meaning | Combat Focus | Combat Effects |
|
|
327
|
+
| :---: | :---: | :---: | :---: |
|
|
328
|
+
| โฐ | **๊ฑด (Geon)** โ _Heaven_ | Bone-striking force | Fractures, structural damage |
|
|
329
|
+
| โฑ | **ํ (Tae)** โ _Lake_ | Joint manipulation | Dislocations, mobility loss |
|
|
330
|
+
| โฒ | **๋ฆฌ (Li)** โ _Fire_ | Precise nerve strikes | Temporary paralysis, numbness |
|
|
331
|
+
| โณ | **์ง (Jin)** โ _Thunder_ | Stunning techniques | Disorientation, knockouts |
|
|
332
|
+
| โด | **์ (Son)** โ _Wind_ | Continuous pressure | Gradual incapacitation |
|
|
333
|
+
| โต | **๊ฐ (Gam)** โ _Water_ | Blood-flow restriction | Circulation disruption |
|
|
334
|
+
| โถ | **๊ฐ (Gan)** โ _Mountain_ | Defensive counters | Counter-attacks, blocks |
|
|
335
|
+
| โท | **๊ณค (Gon)** โ _Earth_ | Ground techniques | Throws, takedowns |
|
|
139
336
|
|
|
140
337
|
</div>
|
|
141
338
|
|
|
142
|
-
###
|
|
339
|
+
### ๐ช Realistic Body Mechanics (13/13 systems ยท 100% complete)
|
|
143
340
|
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
341
|
+
- ๐ฉธ **Authentic Trauma** โ Realistic injury visualization, blood, bruising progression
|
|
342
|
+
- ๐ฆด **Bone-Impact Audio** โ Genuine bone-contact and fracture sounds
|
|
343
|
+
- ๐ซ **Breathing Disruption** โ Respiratory targeting affects stamina and accuracy
|
|
344
|
+
- โ๏ธ **Balance System** โ Stance- and momentum-physics-driven vulnerability windows
|
|
345
|
+
- ๐ง **Consciousness Levels** โ 4-level progressive awareness impairment
|
|
346
|
+
- ๐ต **Pain Response** โ Physiological pain accumulation affecting performance
|
|
347
|
+
- ๐ฆต **Injury-Based Movement** โ Damage to limbs constrains mobility and stance access
|
|
348
|
+
- ๐ฏ **Vital-Point Targeter** โ 70 points ยท 4 regions ยท 5 severity tiers ยท 14 TCM meridians
|
|
349
|
+
- ๐ค **Counter-Attack AI** โ Limb-exposure detection triggers archetype-aware ripostes
|
|
147
350
|
|
|
148
|
-
|
|
149
|
-
| :-----: | :-----------------------: | :--------------------: | :---------------------------: |
|
|
150
|
-
| โฐ | **๊ฑด (Geon)** โ _Heaven_ | Bone-striking force | Fractures, structural damage |
|
|
151
|
-
| โฑ | **ํ (Tae)** โ _Lake_ | Joint manipulation | Dislocations, mobility loss |
|
|
152
|
-
| โฒ | **๋ฆฌ (Li)** โ _Fire_ | Precise nerve strikes | Temporary paralysis, numbness |
|
|
153
|
-
| โณ | **์ง (Jin)** โ _Thunder_ | Stunning techniques | Disorientation, knockouts |
|
|
154
|
-
| โด | **์ (Son)** โ _Wind_ | Continuous pressure | Gradual incapacitation |
|
|
155
|
-
| โต | **๊ฐ (Gam)** โ _Water_ | Blood flow restriction | Circulation disruption |
|
|
156
|
-
| โถ | **๊ฐ (Gan)** โ _Mountain_ | Defensive counters | Counter-attacks, blocks |
|
|
157
|
-
| โท | **๊ณค (Gon)** โ _Earth_ | Ground techniques | Throws, takedowns |
|
|
158
|
-
|
|
159
|
-
</div>
|
|
351
|
+
---
|
|
160
352
|
|
|
161
|
-
|
|
353
|
+
## ๐ธ Concept
|
|
162
354
|
|
|
163
|
-
|
|
164
|
-
- **๐ฆด Bone Impact Audio** โ Genuine bone contact and fracture sounds
|
|
165
|
-
- **๐ซ Breathing Disruption** โ Respiratory system targeting
|
|
166
|
-
- **โ๏ธ Balance System** โ Realistic stance and momentum physics
|
|
167
|
-
- **๐ง Consciousness States** โ Progressive awareness impairment
|
|
168
|
-
- **๐ต Pain Response** โ Physiological pain affecting performance
|
|
355
|
+
<div align="center">
|
|
169
356
|
|
|
170
|
-
|
|
357
|
+
<img src="public/CyberpunkTeamDynamics.png" alt="Cyberpunk team dynamics โ Black Trigram fighter selection screen" width="600" />
|
|
358
|
+
<img src="public/PlayerArchetypesExplained.png" alt="Player archetypes explained โ Musa, Amsalja, Hacker, Jeongbo Yowon, Jojik Pokryeokbae" width="600" />
|
|
359
|
+
<img src="public/PlayerArchetypesOverview.png" alt="Player archetypes overview with Korean martial arts philosophy" width="600" />
|
|
171
360
|
|
|
172
|
-
|
|
173
|
-
- **๐ฐ๐ท Traditional Korean Arts** โ Authentic techniques from ํ๊ถ๋, ํฉ๊ธฐ๋, ํ๊ฒฌ
|
|
174
|
-
- **โซ Advanced Techniques** โ Professional combat methods from 5 distinct archetypes
|
|
175
|
-
- **๐ฅ Combat Application** โ Real martial arts effectiveness
|
|
361
|
+
</div>
|
|
176
362
|
|
|
177
363
|
---
|
|
178
364
|
|
|
179
|
-
## ๐ Technical
|
|
365
|
+
## ๐ Technical Stack
|
|
180
366
|
|
|
181
|
-
Built for **combat realism** and **
|
|
367
|
+
Built for **combat realism**, **60fps performance**, and **production-grade engineering**:
|
|
182
368
|
|
|
183
369
|
<div align="center">
|
|
184
370
|
|
|
185
371
|
### ๐ฎ Rendering Engine
|
|
186
372
|
|
|
187
|
-
|
|
188
|
-
|
|
374
|
+
|
|
375
|
+
|
|
376
|
+
|
|
377
|
+
|
|
378
|
+
|
|
379
|
+
### โก Build & Performance
|
|
191
380
|
|
|
192
|
-
|
|
381
|
+
|
|
382
|
+
|
|
383
|
+
|
|
384
|
+
|
|
385
|
+
|
|
386
|
+
|
|
193
387
|
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
391
|
+
|
|
392
|
+
|
|
393
|
+
|
|
394
|
+
|
|
198
395
|
|
|
199
396
|
### ๐จ 3D Visual Effects
|
|
200
397
|
|
|
201
|
-
|
|
399
|
+
|
|
400
|
+
|
|
401
|
+
|
|
204
402
|
|
|
205
403
|
</div>
|
|
206
404
|
|
|
207
|
-
### ๐ฏ Combat Components
|
|
405
|
+
### ๐ฏ Core Combat Components
|
|
208
406
|
|
|
209
|
-
-
|
|
210
|
-
-
|
|
211
|
-
-
|
|
212
|
-
-
|
|
213
|
-
-
|
|
407
|
+
- **`VitalPointTargeter`** โ Interactive 70-point anatomical targeting with polygon-based zone detection
|
|
408
|
+
- **`CombatTracker`** โ Real-time damage, pain, consciousness, breathing, and balance monitoring
|
|
409
|
+
- **`TechniqueCalculator`** โ Deterministic damage / accuracy / counter-attack math (51 techniques)
|
|
410
|
+
- **`CombatAnalyzer`** โ Post-match technique-effectiveness analysis
|
|
411
|
+
- **`ThreeJSRenderer`** โ Hardware-accelerated 3D combat visualization with skeletal animation (28 bones)
|
|
412
|
+
- **`CounterAttackAI`** โ Archetype-aware riposte system with limb-exposure detection
|
|
214
413
|
|
|
215
414
|
---
|
|
216
415
|
|
|
217
416
|
## ๐ฎ Combat Controls
|
|
218
417
|
|
|
219
|
-
> **๐
|
|
220
|
-
|
|
221
|
-
### โจ๏ธ Desktop
|
|
222
|
-
|
|
223
|
-
- **๐ Movement
|
|
224
|
-
-
|
|
225
|
-
- `1` โฐ Geon (Heaven)
|
|
226
|
-
- `2` โฑ Tae (Lake)
|
|
227
|
-
- `3` โฒ Li (Fire)
|
|
228
|
-
- `4` โณ Jin (Thunder)
|
|
229
|
-
- `5` โด Son (Wind)
|
|
230
|
-
- `6` โต Gam (Water)
|
|
231
|
-
- `7` โถ Gan (Mountain)
|
|
232
|
-
- `8` โท Gon (Earth)
|
|
233
|
-
- **๐ก๏ธ Guard
|
|
234
|
-
- **โก Attack
|
|
235
|
-
- **๐ฏ Vital Strike
|
|
236
|
-
- **โธ๏ธ Pause
|
|
237
|
-
|
|
238
|
-
### ๐ฑ Mobile Touch
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
- **โก Action Buttons** (Bottom-Right)
|
|
250
|
-
- **Attack Button** (80x80px, Gold โก) โ Execute current stance technique
|
|
251
|
-
- **Block Button** (70x70px, Blue ๐ก๏ธ) โ Activate defensive guard
|
|
252
|
-
- Safe area aware positioning (34px from bottom)
|
|
253
|
-
|
|
254
|
-
- **โฏ๏ธ Stance Wheel** (Bottom-Center)
|
|
255
|
-
- Tap to expand circular selector (200px diameter)
|
|
256
|
-
- 8 trigram stances (โฐ โฑ โฒ โณ โด โต โถ โท)
|
|
257
|
-
- Korean names: ๊ฑด ํ ๋ฆฌ ์ง ์ ๊ฐ ๊ฐ ๊ณค
|
|
258
|
-
- Safe area aware positioning
|
|
259
|
-
|
|
260
|
-
**Gesture Controls**:
|
|
261
|
-
|
|
262
|
-
- **Swipe Right โ** โ Advance toward opponent
|
|
263
|
-
- **Swipe Left โ** โ Retreat from opponent
|
|
264
|
-
- **Swipe Up โ** โ High attack execution
|
|
265
|
-
- **Swipe Down โ** โ Low attack execution
|
|
266
|
-
- **Two-Finger Tap ๐ค** โ Toggle vital point targeting mode
|
|
267
|
-
|
|
268
|
-
**Haptic Feedback**:
|
|
269
|
-
- Light vibration (10ms) on D-pad movement and stance selection
|
|
270
|
-
- Medium vibration (50ms) on attack execution
|
|
271
|
-
- Heavy vibration (100ms) on critical hits and vital point strikes
|
|
272
|
-
|
|
273
|
-
### ๐ฉธ Combat Feedback
|
|
274
|
-
|
|
275
|
-
- **๐ฅ Impact Effects**: Bone contact sounds and visual trauma
|
|
276
|
-
- **๐ฉธ Injury System**: Realistic bleeding and damage progression
|
|
277
|
-
- **๐ต Incapacitation**: Visual indicators of combat effectiveness
|
|
278
|
-
- **โ๏ธ Balance**: Physical stance and vulnerability windows
|
|
418
|
+
> **๐ Full reference:** [`CONTROLS.md`](./CONTROLS.md) โ single source of truth for all keyboard, mouse, touch, gesture, and haptic controls.
|
|
419
|
+
|
|
420
|
+
### โจ๏ธ Desktop (currently implemented)
|
|
421
|
+
|
|
422
|
+
- **๐ Movement** โ `WASD` / `Arrow Keys` โ 8-directional tactical positioning
|
|
423
|
+
- **โฏ๏ธ Stances** โ `1`โ`8` (Eight Trigrams)
|
|
424
|
+
- `1` โฐ Geon (Heaven) โ bone-striking force
|
|
425
|
+
- `2` โฑ Tae (Lake) โ joint manipulation
|
|
426
|
+
- `3` โฒ Li (Fire) โ precise nerve strikes
|
|
427
|
+
- `4` โณ Jin (Thunder) โ stunning techniques
|
|
428
|
+
- `5` โด Son (Wind) โ continuous pressure
|
|
429
|
+
- `6` โต Gam (Water) โ adaptive counters
|
|
430
|
+
- `7` โถ Gan (Mountain) โ defensive mastery
|
|
431
|
+
- `8` โท Gon (Earth) โ ground control
|
|
432
|
+
- **๐ก๏ธ Guard** โ `B` โ defensive positioning and blocks
|
|
433
|
+
- **โก Attack** โ `Space` โ execute current stance technique
|
|
434
|
+
- **๐ฏ Vital Strike** โ `V` โ toggle 70-point anatomical targeting overlay
|
|
435
|
+
- **โธ๏ธ Pause** โ `ESC` / `M` โ pause menu / return to intro
|
|
436
|
+
|
|
437
|
+
### ๐ฑ Mobile Touch (auto-displayed on screens < 768px)
|
|
438
|
+
|
|
439
|
+
- **๐น๏ธ Virtual D-Pad** (bottom-left, 140ร140 px, 48 px buttons exceeding the 44 px iOS guideline) โ 8-directional movement with Korean arrows (โ โ โ โ โ โ โ โ)
|
|
440
|
+
- **โก Action Buttons** (bottom-right) โ 80ร80 px gold Attack โก, 70ร70 px blue Block ๐ก๏ธ
|
|
441
|
+
- **โฏ๏ธ Stance Wheel** (bottom-center, 200 px diameter) โ 8 trigrams with hangul: ๊ฑด ํ ๋ฆฌ ์ง ์ ๊ฐ ๊ฐ ๊ณค
|
|
442
|
+
- All controls are **safe-area aware** (34 px bottom inset for notched devices)
|
|
443
|
+
|
|
444
|
+
### ๐ Gesture & Haptic Feedback
|
|
445
|
+
|
|
446
|
+
- **Swipe โ** advance ยท **โ retreat** ยท **โ high attack** ยท **โ low attack** ยท **two-finger tap** toggles vital-point mode
|
|
447
|
+
- **Haptics:** 10 ms light (movement / stance), 50 ms medium (attack), 100 ms heavy (vital-point hits)
|
|
279
448
|
|
|
280
449
|
---
|
|
281
450
|
|
|
@@ -283,50 +452,45 @@ Built for **combat realism** and **authentic simulation**:
|
|
|
283
452
|
|
|
284
453
|
### ๐ฏ ํด๋ถํ ์ฐ๊ตฌ (Anatomical Study)
|
|
285
454
|
|
|
286
|
-
- **๐
|
|
287
|
-
- **๐ฏ
|
|
288
|
-
- **โซ
|
|
289
|
-
- **๐ฅ
|
|
455
|
+
- **๐ ๊ธ์ํ์ต** โ 70 anatomical target points
|
|
456
|
+
- **๐ฏ ์ ๋ฐํ๊ฒฉ** โ accurate targeting techniques
|
|
457
|
+
- **โซ ๊ณ ๊ธ๊ธฐ๋ฒ** โ professional combat methods
|
|
458
|
+
- **๐ฅ ์ค์ ์์ฉ** โ combat-effectiveness training
|
|
290
459
|
|
|
291
460
|
### โ๏ธ ๋ฌด์ ๊ธฐ๋ฒ (Martial Techniques)
|
|
292
461
|
|
|
293
|
-
- **๐ฅ
|
|
294
|
-
- **๐ข
|
|
295
|
-
- **๐
|
|
296
|
-
- **๐ฏ
|
|
462
|
+
- **๐ฅ ๊ธฐ๋ณธ๊ธฐ** โ fundamentals: striking and positioning
|
|
463
|
+
- **๐ข ํ๊ด์ ** โ Eight Trigram Arts: traditional Korean combat philosophy
|
|
464
|
+
- **๐ ์ฐ๊ณ๊ธฐ๋ฒ** โ combination techniques: flowing technique sequences
|
|
465
|
+
- **๐ฏ ์ ๋ฐ์ ** โ precision arts: exact targeting and timing
|
|
297
466
|
|
|
298
467
|
### ๐ฅ ์ค์ ํ๋ จ (Combat Training)
|
|
299
468
|
|
|
300
|
-
- **๐ค
|
|
301
|
-
- **๐ข
|
|
302
|
-
- **๐ง
|
|
303
|
-
- **๐
|
|
469
|
+
- **๐ค ์ผ๋์ผ** โ single-opponent simulation
|
|
470
|
+
- **๐ข ํ๊ฒฝ์ ํฌ** โ environmental combat (using surroundings tactically)
|
|
471
|
+
- **๐ง ์ ์ ์์** โ mental cultivation: psychological combat preparation
|
|
472
|
+
- **๐ ์ฐ์๋์ ** โ continuous combat: multiple-opponent scenarios
|
|
304
473
|
|
|
305
474
|
### ๐ญ ์ํ ํนํ (Archetype Mastery)
|
|
306
475
|
|
|
307
|
-
- **๐ฏ
|
|
308
|
-
- **๐ฅท ์์์ (Shadow Arts)** โ Stealth and assassination techniques
|
|
309
|
-
- **๐ป ์ฌ์ด๋ฒ์ (Cyber Warfare)** โ Tech-enhanced combat methods
|
|
310
|
-
- **๐ต๏ธ ์ ๋ณด์ (Intelligence Warfare)** โ Psychological and strategic combat
|
|
311
|
-
- **โก ๊ฑฐ๋ฆฌ์ (Street Arts)** โ Underground survival combat
|
|
476
|
+
- **๐ฏ ๋ฌด์ฌ๋** โ traditional warrior discipline ยท **๐ฅท ์์์ ** โ shadow arts ยท **๐ป ์ฌ์ด๋ฒ์ ** โ cyber warfare ยท **๐ต๏ธ ์ ๋ณด์ ** โ intelligence warfare ยท **โก ๊ฑฐ๋ฆฌ์ ** โ street arts
|
|
312
477
|
|
|
313
478
|
---
|
|
314
479
|
|
|
315
480
|
## ๐ Architecture & Development Insights
|
|
316
481
|
|
|
317
|
-
|
|
482
|
+
In-depth technical and cultural analysis from the Hack23 development team.
|
|
318
483
|
|
|
319
|
-
### โญ Simon Moon
|
|
484
|
+
### โญ Simon Moon โ Architecture Chronicles
|
|
320
485
|
|
|
321
486
|
<div align="center">
|
|
322
487
|
|
|
323
|
-
_System Architect
|
|
324
|
-
|
|
488
|
+
_System Architect ยท Pattern Recognition Expert ยท Philosopher-Engineer_<br>
|
|
325
489
|
[**View Agent Profile**](https://github.com/Hack23/homepage/blob/master/.github/agents/simon-moon.md)
|
|
326
490
|
|
|
327
491
|
</div>
|
|
328
492
|
|
|
329
|
-
Simon Moon reveals the hidden structures and sacred geometry in Black Trigram's architecture through the Law of Fives and numerological patterns.
|
|
493
|
+
Simon Moon reveals the hidden structures and sacred geometry in Black Trigram's architecture through the **Law of Fives** and numerological patterns.
|
|
330
494
|
|
|
331
495
|
<table>
|
|
332
496
|
<tr>
|
|
@@ -336,7 +500,7 @@ Simon Moon reveals the hidden structures and sacred geometry in Black Trigram's
|
|
|
336
500
|
|
|
337
501
|
**[Five Fighters, Sacred Geometry](https://hack23.com/blog-trigram-architecture.html)**
|
|
338
502
|
|
|
339
|
-
Five fighter archetypes discovered through combat
|
|
503
|
+
Five fighter archetypes discovered through combat-domain analysis. Cultural authenticity meeting mechanical depth โ with **zero backend** architecture.
|
|
340
504
|
|
|
341
505
|
</td>
|
|
342
506
|
<td width="33%" valign="top">
|
|
@@ -345,7 +509,7 @@ Five fighter archetypes discovered through combat domain analysis. Cultural auth
|
|
|
345
509
|
|
|
346
510
|
**[70 Vital Points & Physics](https://hack23.com/blog-trigram-combat.html)**
|
|
347
511
|
|
|
348
|
-
Traditional Korean martial arts mapped to 70 biomechanical vital points
|
|
512
|
+
Traditional Korean martial arts mapped to **70 biomechanical vital points**. Five collision systems with anatomical precision and respect for cultural tradition.
|
|
349
513
|
|
|
350
514
|
</td>
|
|
351
515
|
<td width="33%" valign="top">
|
|
@@ -354,23 +518,22 @@ Traditional Korean martial arts mapped to 70 biomechanical vital points. Five co
|
|
|
354
518
|
|
|
355
519
|
**[VR Martial Arts & Immersive Combat](https://hack23.com/blog-trigram-future.html)**
|
|
356
520
|
|
|
357
|
-
Five-year evolution roadmap from immersive 3D fighter to VR martial arts training platform
|
|
521
|
+
Five-year evolution roadmap from immersive 3D fighter to **VR martial arts training platform**. Korean martial arts preservation through immersive technology.
|
|
358
522
|
|
|
359
523
|
</td>
|
|
360
524
|
</tr>
|
|
361
525
|
</table>
|
|
362
526
|
|
|
363
|
-
### ๐ George Dorn
|
|
527
|
+
### ๐ George Dorn โ Code Analysis
|
|
364
528
|
|
|
365
529
|
<div align="center">
|
|
366
530
|
|
|
367
|
-
_Developer
|
|
368
|
-
|
|
531
|
+
_Developer ยท Repository Inspector ยท Code Archaeologist_<br>
|
|
369
532
|
[**View Agent Profile**](https://github.com/Hack23/homepage/blob/master/.github/agents/george-dorn.md)
|
|
370
533
|
|
|
371
534
|
</div>
|
|
372
535
|
|
|
373
|
-
George Dorn provides
|
|
536
|
+
George Dorn provides repository deep-dives based on **actual code inspection**, not assumptions. Each analysis includes cloned repositories, file counts, dependency reviews, and verified metrics.
|
|
374
537
|
|
|
375
538
|
<table>
|
|
376
539
|
<tr>
|
|
@@ -380,10 +543,10 @@ George Dorn provides detailed repository deep-dives based on actual code inspect
|
|
|
380
543
|
|
|
381
544
|
**[Repository Deep-Dive](https://hack23.com/blog-george-dorn-trigram-code.html)**
|
|
382
545
|
|
|
383
|
-
**Stack:** TypeScript 6.0
|
|
384
|
-
**Metrics:** 132 TypeScript files
|
|
546
|
+
**Stack:** TypeScript 6.0.3 ยท React 19 ยท Three.js 0.184 ยท Vite 8<br>
|
|
547
|
+
**Metrics:** 132+ TypeScript files ยท 70 vital points ยท 5 archetypes ยท 28-bone skeletal animation ยท 51 techniques
|
|
385
548
|
|
|
386
|
-
Examined package.json dependencies, explored src
|
|
549
|
+
Examined `package.json` dependencies, explored `src/` structure, verified combat-system implementation, and reviewed AI integrations.
|
|
387
550
|
|
|
388
551
|
</td>
|
|
389
552
|
<td width="50%" valign="top">
|
|
@@ -392,9 +555,9 @@ Examined package.json dependencies, explored src/ structure, verified combat sys
|
|
|
392
555
|
|
|
393
556
|
**[Combat Code: TypeScript vs. Martial Arts Physics](https://hack23.com/blog-trigram-architecture.html#george-dorn-implementation)**
|
|
394
557
|
|
|
395
|
-
George's technical commentary
|
|
558
|
+
George's technical commentary on collision-detection challenges, performance optimization for 60fps combat, and Easter eggs hidden throughout the codebase.
|
|
396
559
|
|
|
397
|
-
**Easter Eggs:**
|
|
560
|
+
**Easter Eggs:** land exactly **23 hits** โ FNORD victory screen ยท Konami code unlocks "Hagbard Mode" ยท health at **23%** โ UI pulses urgently.
|
|
398
561
|
|
|
399
562
|
</td>
|
|
400
563
|
</tr>
|
|
@@ -402,9 +565,7 @@ George's technical commentary reveals collision detection challenges, performanc
|
|
|
402
565
|
|
|
403
566
|
<div align="center">
|
|
404
567
|
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
**[๐ Full Security Blog](https://hack23.com/blog.html)** โ 50+ posts covering cybersecurity, ISMS policies, and software architecture through radical transparency
|
|
568
|
+
**[๐ Full Hack23 Blog](https://hack23.com/blog.html)** โ 50+ posts on cybersecurity, ISMS policy, and software architecture through radical transparency.
|
|
408
569
|
|
|
409
570
|
_"Code is reality made computational. If it doesn't work, nothing else matters."_ โ **George Dorn**
|
|
410
571
|
|
|
@@ -412,138 +573,29 @@ _"Code is reality made computational. If it doesn't work, nothing else matters."
|
|
|
412
573
|
|
|
413
574
|
---
|
|
414
575
|
|
|
415
|
-
##
|
|
416
|
-
|
|
417
|
-
### API Reference
|
|
418
|
-
|
|
419
|
-
Complete TypeDoc API documentation with Korean martial arts context is available:
|
|
420
|
-
|
|
421
|
-
**[๐ View API Documentation](https://hack23.github.io/blacktrigram/)**
|
|
422
|
-
|
|
423
|
-
The API documentation includes:
|
|
424
|
-
|
|
425
|
-
- **๐ Core Types**: All enums, interfaces, and type definitions with Korean-English bilingual descriptions
|
|
426
|
-
- **๐ฅ Eight Trigram System**: Complete I Ching philosophy and stance mechanics
|
|
427
|
-
- **๐ฏ Vital Point System**: All 70 Korean vital points with anatomical details
|
|
428
|
-
- **โ๏ธ Combat System**: Combat mechanics, damage calculation, and technique execution
|
|
429
|
-
- **๐ค Player Archetypes**: Detailed descriptions of all 5 fighter types
|
|
430
|
-
- **๐จ UI Components**: Component usage examples and props documentation
|
|
431
|
-
- **๐ง Utilities**: Helper functions and system utilities
|
|
432
|
-
|
|
433
|
-
### Key Documentation Sections
|
|
434
|
-
|
|
435
|
-
- **Korean Martial Arts Concepts**: Traditional philosophy integrated with modern combat
|
|
436
|
-
- **I Ching (ๆ็ถ) Integration**: How the Eight Trigrams influence combat flow
|
|
437
|
-
- **Anatomical Targeting**: Realistic vital point system based on Korean martial arts
|
|
438
|
-
- **Combat Calculations**: Damage, accuracy, and effectiveness algorithms
|
|
439
|
-
- **Security Notes**: Critical functions with security considerations
|
|
440
|
-
|
|
441
|
-
### Documentation Coverage
|
|
442
|
-
|
|
443
|
-
- โ
**100% of core types** documented with examples
|
|
444
|
-
- โ
**All system classes** with comprehensive JSDoc
|
|
445
|
-
- โ
**Korean-English bilingual** terminology throughout
|
|
446
|
-
- โ
**Usage examples** for complex functions
|
|
447
|
-
- โ
**Philosophy context** for martial arts concepts
|
|
448
|
-
|
|
449
|
-
**Validation Approach**: Strict TypeDoc validation is enabled (`notDocumented: true`) to track documentation progress. This generates ~2,250 warnings initially, which are being addressed incrementally. The strict approach ensures all new exports are documented from the start, maintaining high documentation standards as the codebase evolves.
|
|
450
|
-
|
|
451
|
-
### Building Documentation Locally
|
|
452
|
-
|
|
453
|
-
```bash
|
|
454
|
-
# Generate TypeDoc documentation
|
|
455
|
-
npm run docs
|
|
456
|
-
|
|
457
|
-
# View documentation
|
|
458
|
-
open docs/api/index.html
|
|
459
|
-
```
|
|
460
|
-
|
|
461
|
-
### UI/UX Architecture Documentation
|
|
462
|
-
|
|
463
|
-
> **๐ Planned:** Comprehensive guides for developers building Korean-themed cyberpunk interfaces are being developed. See [ARCHITECTURE.md](ARCHITECTURE.md) and [CONTROLS.md](CONTROLS.md) for current UI/UX patterns.
|
|
464
|
-
|
|
465
|
-
---
|
|
466
|
-
|
|
467
|
-
## ๐ Commitment to Transparency and Security
|
|
468
|
-
|
|
469
|
-
At Hack23 AB, we believe that true security comes through transparency and demonstrable practices. Our Information Security Management System (ISMS) is publicly available, showcasing our commitment to security excellence and organizational transparency.
|
|
470
|
-
|
|
471
|
-
<table>
|
|
472
|
-
<tr>
|
|
473
|
-
<td width="50%">
|
|
474
|
-
<div align="center">
|
|
475
|
-
<h3>๐ Public ISMS Repository</h3>
|
|
476
|
-
<p>Complete Information Security Management System documentation</p>
|
|
477
|
-
<a href="https://github.com/Hack23/ISMS-PUBLIC">
|
|
478
|
-
<img src="https://img.shields.io/badge/ISMS-PUBLIC-0066CC?style=for-the-badge&logo=github&logoColor=white" alt="ISMS Public Repository">
|
|
479
|
-
</a>
|
|
480
|
-
</div>
|
|
481
|
-
</td>
|
|
482
|
-
<td width="50%">
|
|
483
|
-
<div align="center">
|
|
484
|
-
<h3>๐ Information Security Policy</h3>
|
|
485
|
-
<p>Enterprise-grade security framework and governance</p>
|
|
486
|
-
<a href="https://github.com/Hack23/ISMS-PUBLIC/blob/main/Information_Security_Policy.md">
|
|
487
|
-
<img src="https://img.shields.io/badge/Security-Policy-DC143C?style=for-the-badge&logo=shield&logoColor=white" alt="Information Security Policy">
|
|
488
|
-
</a>
|
|
489
|
-
</div>
|
|
490
|
-
</td>
|
|
491
|
-
</tr>
|
|
492
|
-
</table>
|
|
493
|
-
|
|
494
|
-
**๐ ISMS Reference Mapping**: For a complete mapping of all ISMS policies referenced by Black Trigram, see [ISMS_REFERENCE_MAPPING.md](./ISMS_REFERENCE_MAPPING.md)
|
|
495
|
-
|
|
496
|
-
### ๐ Security Through Transparency
|
|
497
|
-
|
|
498
|
-
Our approach to cybersecurity consulting is built on a foundation of transparent practices:
|
|
499
|
-
|
|
500
|
-
- **๐ Open Documentation**: Complete ISMS framework available for review
|
|
501
|
-
- **๐ Policy Transparency**: Detailed security policies and procedures publicly accessible
|
|
502
|
-
- **๐ฏ Demonstrable Expertise**: Our own security implementation serves as a live demonstration
|
|
503
|
-
- **๐ Continuous Improvement**: Public documentation enables community feedback and enhancement
|
|
576
|
+
## ๐ฉธ Combat Realism Systems โ 13 / 13 Complete (100%)
|
|
504
577
|
|
|
505
578
|
<div align="center">
|
|
506
|
-
<p><em>"Our commitment to transparency extends to our security practices - demonstrating that true security comes from robust processes, continuous improvement, and a culture where security considerations are integrated into every business decision."</em></p>
|
|
507
|
-
<p><strong>โ James Pether Sรถrling, CEO/Founder</strong></p>
|
|
508
|
-
</div>
|
|
509
|
-
|
|
510
|
-
---
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
## ๐ง Development Features
|
|
515
579
|
|
|
516
|
-
|
|
580
|
+
| System | Status | Notes |
|
|
581
|
+
|---|---|---|
|
|
582
|
+
| **Body-Part Health** | โ
| 8-part damage tracking |
|
|
583
|
+
| **Vital-Point Targeting** | โ
| 70 authentic Korean vital points |
|
|
584
|
+
| **Enhanced Anatomy** | โ
| Polygon-based zone detection |
|
|
585
|
+
| **Visual Feedback** | โ
| Damage numbers, hit effects, combos |
|
|
586
|
+
| **Pain Response** | โ
| Realistic pain accumulation (production-tested) |
|
|
587
|
+
| **Consciousness Levels** | โ
| 4-level awareness system |
|
|
588
|
+
| **Breathing Disruption** | โ
| Respiratory targeting affects stamina/accuracy |
|
|
589
|
+
| **Trauma Visualization** | โ
| Injury rendering, bruising progression |
|
|
590
|
+
| **Balance / Vulnerability** | โ
| Stance-based weakness windows |
|
|
591
|
+
| **Combat-Readiness HUD** | โ
| Real-time multi-system status display |
|
|
592
|
+
| **Injury-Based Movement** | โ
| Damage constrains mobility and stance access |
|
|
593
|
+
| **Bone-Impact Audio** | โ
| Bone-contact and fracture sounds |
|
|
594
|
+
| **Counter-Attack AI** | โ
| Limb-exposure detection ยท archetype-aware ripostes |
|
|
595
|
+
|
|
596
|
+
**[๐ Detailed Status Report โ](game-status.md)** ยท **[๐บ๏ธ v1.0 Roadmap โ](ROADMAP.md)** ยท **[โ๏ธ Combat Architecture โ](COMBAT_ARCHITECTURE.md)**
|
|
517
597
|
|
|
518
|
-
|
|
519
|
-
// Authentic vital point data with combat applications
|
|
520
|
-
interface VitalPoint {
|
|
521
|
-
name: { korean: string; english: string; technique: string };
|
|
522
|
-
location: AnatomicalPosition;
|
|
523
|
-
effectiveness: CombatEffectiveness;
|
|
524
|
-
difficulty: PrecisionRequired;
|
|
525
|
-
method: CombatTechnique[];
|
|
526
|
-
archetypeBonus: ArchetypeModifier[]; // Special bonuses for different fighter types
|
|
527
|
-
}
|
|
528
|
-
```
|
|
529
|
-
|
|
530
|
-
### ๐ฉธ Combat Mechanics System
|
|
531
|
-
|
|
532
|
-
```typescript
|
|
533
|
-
// Realistic body mechanics for authentic combat
|
|
534
|
-
interface CombatState {
|
|
535
|
-
health: number; // Physical condition remaining
|
|
536
|
-
consciousness: number; // Awareness and responsiveness
|
|
537
|
-
pain: number; // Pain levels affecting performance
|
|
538
|
-
balance: CombatStability; // Physical stability in combat
|
|
539
|
-
stamina: number; // Energy and endurance
|
|
540
|
-
technique: number; // Skill and precision level
|
|
541
|
-
archetype: PlayerArchetype; // Current fighter specialization
|
|
542
|
-
}
|
|
543
|
-
|
|
544
|
-
// Player archetype system
|
|
545
|
-
type PlayerArchetype = "musa" | "amsalja" | "hacker" | "jeongbo" | "jojik";
|
|
546
|
-
```
|
|
598
|
+
</div>
|
|
547
599
|
|
|
548
600
|
---
|
|
549
601
|
|
|
@@ -551,317 +603,238 @@ type PlayerArchetype = "musa" | "amsalja" | "hacker" | "jeongbo" | "jojik";
|
|
|
551
603
|
|
|
552
604
|
### ๐ Prerequisites
|
|
553
605
|
|
|
554
|
-
- **Node.js 25+**
|
|
555
|
-
- **npm 11+** (
|
|
556
|
-
- Modern browser with WebGL 2.0 support
|
|
606
|
+
- **Node.js 25+** โ [download](https://nodejs.org/)
|
|
607
|
+
- **npm 11+** (bundled with Node 25)
|
|
608
|
+
- Modern browser with **WebGL 2.0** support
|
|
557
609
|
|
|
558
|
-
### ๐
|
|
610
|
+
### ๐ Play Now
|
|
559
611
|
|
|
560
|
-
**[๐ฎ
|
|
612
|
+
**[๐ฎ Play live โ blacktrigram.com](https://blacktrigram.com/)** ยท **[๐ฎ GitHub Pages mirror โ hack23.github.io/blacktrigram](https://hack23.github.io/blacktrigram/)**
|
|
561
613
|
|
|
562
614
|
### ๐ง Local Development
|
|
563
615
|
|
|
564
616
|
```bash
|
|
565
|
-
# Clone
|
|
617
|
+
# Clone
|
|
566
618
|
git clone https://github.com/Hack23/blacktrigram.git
|
|
567
619
|
cd blacktrigram
|
|
568
620
|
|
|
569
|
-
# Install
|
|
621
|
+
# Install (requires Node โฅ 25)
|
|
570
622
|
npm install
|
|
571
623
|
|
|
572
|
-
# Start
|
|
624
|
+
# Start the dojang
|
|
573
625
|
npm run dev
|
|
574
626
|
|
|
575
|
-
#
|
|
627
|
+
# Production build
|
|
576
628
|
npm run build
|
|
577
629
|
|
|
578
|
-
# Run
|
|
579
|
-
npm run test
|
|
580
|
-
npm run test:combat
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
---
|
|
584
|
-
|
|
585
|
-
## ๐ Documentation & Further Reading
|
|
586
|
-
|
|
587
|
-
Game/frontend will be open source with commercial backend supporting multiplayer functionality, rankings and subscriptions to fund development and runtime of backend. Will enable progressions and persistent state of game.
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
๐ **Architecture & Design**
|
|
591
|
-
|
|
592
|
-
- [๐ ARCHITECTURE.md](https://github.com/Hack23/blacktrigram/blob/main/ARCHITECTURE.md)
|
|
593
|
-
_High-level C4 models, container/component views, and system context._
|
|
594
|
-
- [๐ FUTURE_ARCHITECTURE.md](https://github.com/Hack23/blacktrigram/blob/main/FUTURE_ARCHITECTURE.md)
|
|
595
|
-
_Vision for upcoming architectural enhancements and PWA integration._
|
|
596
|
-
- [API Docs](https://blacktrigram.com/api/)
|
|
597
|
-
_Detailed API reference for all components, types, and functions in the application._
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
๐ **Combat & Mechanics**
|
|
601
|
-
|
|
602
|
-
- [๐บ๏ธ **ROADMAP.md**](https://github.com/Hack23/blacktrigram/blob/main/ROADMAP.md)
|
|
603
|
-
_**v1.0 release timeline (Q2-Q3 2026), quarterly milestones, and combat realism system tracking.**_
|
|
604
|
-
- [๐ **game-status.md**](https://github.com/Hack23/blacktrigram/blob/main/game-status.md)
|
|
605
|
-
_**Current metrics: 8.4/10 quality, 76% test coverage, 67% combat realism (8/12 systems)**._
|
|
606
|
-
- [๐ฅ COMBAT_ARCHITECTURE.md](https://github.com/Hack23/blacktrigram/blob/main/COMBAT_ARCHITECTURE.md)
|
|
607
|
-
_In-depth battleflow, trigram integration, vital-point targeting, and damage pipeline._
|
|
608
|
-
- [๐บ๏ธ game-design.md](https://github.com/Hack23/blacktrigram/blob/main/game-design.md)
|
|
609
|
-
_Overall game mechanics, archetype breakdowns, and design decisions._
|
|
610
|
-
|
|
611
|
-
๐ **Assets & Media**
|
|
612
|
-
|
|
613
|
-
- [๐ผ๏ธ ART_ASSETS.md](https://github.com/Hack23/blacktrigram/blob/main/ART_ASSETS.md)
|
|
614
|
-
_Guidelines for sprite sheets, particle textures, color palettes, and UI icons._
|
|
615
|
-
- [๐ต AUDIO_ASSETS.md](https://github.com/Hack23/blacktrigram/blob/main/AUDIO_ASSETS.md)
|
|
616
|
-
_List of traditional Korean instrument loops, impact SFX, and mixing notes._
|
|
617
|
-
- [๐ต VIDEO_ASSETS.md](https://github.com/Hack23/blacktrigram/blob/main/VIDEO_ASSETS.md)
|
|
618
|
-
_Black Trigram: The Path of Shadows ๐โก๐ก๏ธ .Scene 1: Initiation Under Neon Skies ๐๐ก๏ธ๐_
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
630
|
+
# Run tests
|
|
631
|
+
npm run test # Vitest unit
|
|
632
|
+
npm run test:systems # combat-system focused
|
|
633
|
+
npm run test:e2e # Cypress E2E
|
|
622
634
|
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
_The development implements comprehensive security measures._
|
|
627
|
-
- [๐ค Copilot MCP Setup](.github/COPILOT_MCP_SETUP.md)
|
|
628
|
-
_Model Context Protocol servers for enhanced Copilot capabilities._
|
|
629
|
-
- **๐ก๏ธ Supply Chain Security** - OSSF Scorecard analysis and dependency review
|
|
630
|
-
- **๐ Static Analysis** - CodeQL scanning for vulnerabilities
|
|
631
|
-
- **๐ฆ Dependency Protection** - Automated dependency vulnerability checks
|
|
632
|
-
- **๐ Runner Hardening** - All CI/CD runners are hardened with audit logging
|
|
633
|
-
- **๐ Security Policies** - GitHub security advisories and vulnerability reporting
|
|
634
|
-
- **๐ท๏ธ Pinned Dependencies** - All GitHub Actions pinned to specific SHA hashes
|
|
635
|
-
- **๐ SBOM Generation** - Software Bill of Materials for transparency
|
|
636
|
-
- **๐ Build Attestations** - Cryptographic proof of build integrity
|
|
637
|
-
- **๐ Artifact Verification** - SLSA-compliant build provenance
|
|
638
|
-
- **๐ท๏ธ ZAP Security Scanning** - OWASP ZAP dynamic application security testing
|
|
639
|
-
- **โก Lighthouse Performance** - [Automated performance and accessibility audits](./performance-testing.md)
|
|
635
|
+
# Generate API docs (TypeDoc)
|
|
636
|
+
npm run docs
|
|
637
|
+
```
|
|
640
638
|
|
|
641
|
-
|
|
639
|
+
### ๐ฆ Use as a Library
|
|
642
640
|
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
_7 automatic enforcement skills for security, architecture, Korean theming, testing, performance, and Three.js best practices._
|
|
647
|
-
- [๐ **Agent Capabilities Matrix**](.github/agents/AGENT_CAPABILITIES.md)
|
|
648
|
-
_Comprehensive coordination guide for all agents and their specialized capabilities._
|
|
649
|
-
- [๐ **Agent Skills Implementation Report**](.github/AGENT_SKILLS_IMPLEMENTATION.md)
|
|
650
|
-
_Complete implementation details of the agent skills system with compliance frameworks._
|
|
641
|
+
```bash
|
|
642
|
+
npm install blacktrigram
|
|
643
|
+
```
|
|
651
644
|
|
|
645
|
+
```ts
|
|
646
|
+
// ESM with strict TypeScript types
|
|
647
|
+
import { CombatSystem, VitalPoints } from 'blacktrigram/systems';
|
|
648
|
+
import type { TrigramStance, PlayerArchetype } from 'blacktrigram/types';
|
|
649
|
+
```
|
|
652
650
|
|
|
653
651
|
---
|
|
654
652
|
|
|
655
|
-
##
|
|
656
|
-
|
|
657
|
-
|
|
653
|
+
## ๐ Security, Compliance & ISMS Alignment
|
|
654
|
+
|
|
655
|
+
At Hack23 AB we believe **true security comes through transparency and demonstrable practices**. Black Trigram is governed by the public **[ISMS-PUBLIC](https://github.com/Hack23/ISMS-PUBLIC)** framework, aligned with **ISO 27001:2022**, **NIST CSF 2.0**, **CIS Controls v8.1**, **EU CRA**, **NIS2**, and **GDPR**.
|
|
656
|
+
|
|
657
|
+
### ๐ก๏ธ Supply-Chain Security (SLSA 3)
|
|
658
|
+
|
|
659
|
+
- **OSSF Scorecard** โ automated weekly via [`scorecards.yml`](./.github/workflows/scorecards.yml)
|
|
660
|
+
- **OpenSSF Best Practices** โ [project ID 10777](https://www.bestpractices.dev/projects/10777)
|
|
661
|
+
- **SLSA 3 Provenance** โ every release attested โ [`/attestations`](https://github.com/Hack23/blacktrigram/attestations)
|
|
662
|
+
- **CycloneDX SBOM** โ published with each GitHub Release
|
|
663
|
+
- **CodeQL SAST** โ [`codeql.yml`](./.github/workflows/codeql.yml)
|
|
664
|
+
- **OWASP ZAP DAST** โ [`zap-scan.yml`](./.github/workflows/zap-scan.yml)
|
|
665
|
+
- **Lighthouse Performance** โ [`lighthouse-performance.yml`](./.github/workflows/lighthouse-performance.yml)
|
|
666
|
+
- **Accessibility (WCAG 2.1 AA)** โ [`accessibility-test.yml`](./.github/workflows/accessibility-test.yml)
|
|
667
|
+
- **Dependency Review** โ [`dependency-review.yml`](./.github/workflows/dependency-review.yml)
|
|
668
|
+
- **Dependabot + auto-merge** for low-risk updates
|
|
669
|
+
- **All GitHub Actions pinned to commit SHAs** โ see [`WORKFLOWS.md`](./WORKFLOWS.md)
|
|
670
|
+
|
|
671
|
+
### ๐ Hack23 ISMS Policy Anchors
|
|
672
|
+
|
|
673
|
+
| Policy | Alignment |
|
|
674
|
+
|---|---|
|
|
675
|
+
| [Information Security Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Information_Security_Policy.md) | Master security governance |
|
|
676
|
+
| [Secure Development Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Secure_Development_Policy.md) | SDLC, code review, testing, threat modeling |
|
|
677
|
+
| [Open Source Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Open_Source_Policy.md) | License compliance, OSSF Scorecard, SBOM |
|
|
678
|
+
| [Vulnerability Management](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Vulnerability_Management.md) | CodeQL, ZAP, Dependabot, SLA |
|
|
679
|
+
| [Cryptography Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Cryptography_Policy.md) | TLS 1.3, SRI, no client secrets |
|
|
680
|
+
| [Threat Modeling](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Threat_Modeling.md) | STRIDE per trust boundary |
|
|
681
|
+
| [Access Control Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Access_Control_Policy.md) | GitHub branch protection, signed commits |
|
|
682
|
+
| [Network Security Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Network_Security_Policy.md) | CDN, WAF, CSP, HSTS, SRI |
|
|
683
|
+
| [Backup & Recovery Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Backup_Recovery_Policy.md) | Multi-region S3 + GitHub Pages DR |
|
|
684
|
+
| [Incident Response Plan](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Incident_Response_Plan.md) | Security disclosure, runbooks |
|
|
685
|
+
| [Risk Register](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Risk_Register.md) | Project risks tracked centrally |
|
|
686
|
+
| [Compliance Checklist](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Compliance_Checklist.md) | ISO 27001 ยท NIST CSF ยท CIS v8.1 mapping |
|
|
687
|
+
| [Security Metrics](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Security_Metrics.md) | KPIs and dashboards |
|
|
688
|
+
| [AI Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/AI_Policy.md) | Copilot governance, EU AI Act, NIST AI RMF |
|
|
689
|
+
| [Data Classification Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Data_Classification_Policy.md) | Public ยท no PII |
|
|
690
|
+
| [ISMS Transparency Plan](https://github.com/Hack23/ISMS-PUBLIC/blob/main/ISMS_Transparency_Plan.md) | Public-disclosure strategy |
|
|
691
|
+
| [CLASSIFICATION.md](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md) | Business-impact analysis |
|
|
692
|
+
|
|
693
|
+
**๐ Full project โ ISMS mapping:** [`ISMS_REFERENCE_MAPPING.md`](./ISMS_REFERENCE_MAPPING.md)
|
|
658
694
|
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
- **์ ํฌ ์ฌ๋ฆฌ (Combat Psychology)** โ Mental preparation for combat
|
|
664
|
-
- **์ ํต ์ง์ (Traditional Knowledge)** โ Authentic Korean martial arts
|
|
665
|
-
- **์ํ ํนํ (Archetype Specialization)** โ Unique approach per fighter type
|
|
695
|
+
<div align="center">
|
|
696
|
+
<em>"Our commitment to transparency extends to our security practices โ true security comes from robust processes, continuous improvement, and a culture where security considerations are integrated into every business decision."</em><br>
|
|
697
|
+
<strong>โ James Pether Sรถrling, CEO/Founder, Hack23 AB</strong>
|
|
698
|
+
</div>
|
|
666
699
|
|
|
667
700
|
---
|
|
668
701
|
|
|
669
|
-
##
|
|
670
|
-
|
|
671
|
-
### ๐ฏ Combat Mastery
|
|
702
|
+
## ๐๏ธ Hack23 Portfolio โ Sister Projects
|
|
672
703
|
|
|
673
|
-
|
|
674
|
-
- **๐ฉธ ์ ํฌ์ ๋ฌธ๊ฐ (Combat Expert)** โ Execute optimal combat techniques
|
|
675
|
-
- **โซ ๊ณ ์ (Advanced Practitioner)** โ Complete advanced technique training
|
|
676
|
-
- **๐ช ์๋ฒฝํ ๋ฌด์ฌ (Perfect Warrior)** โ Achieve flawless combat records
|
|
704
|
+
Black Trigram is part of the **Hack23 portfolio** โ a connected suite of open-source platforms applying transparent engineering and structured-intelligence tradecraft to high-stakes domains:
|
|
677
705
|
|
|
678
|
-
|
|
706
|
+
| Project | Description |
|
|
707
|
+
|---|---|
|
|
708
|
+
| ๐ฅ [**Black Trigram**](https://github.com/Hack23/blacktrigram) | _This repo_ โ Korean martial arts simulator (Three.js / R3F / TypeScript) |
|
|
709
|
+
| ๐ต๏ธ [**Citizen Intelligence Agency**](https://github.com/Hack23/cia) | Swedish political-intelligence and accountability platform |
|
|
710
|
+
| ๐ [**CIA Compliance Manager**](https://github.com/Hack23/cia-compliance-manager) | CIA-triad compliance dashboard with business-impact mapping |
|
|
711
|
+
| ๐ณ๏ธ [**Riksdagsmonitor**](https://github.com/Hack23/riksdagsmonitor) | Swedish Parliament monitor โ autonomous AI newsroom in 14 languages |
|
|
712
|
+
| ๐๏ธ [**EU Parliament Monitor**](https://github.com/Hack23/euparliamentmonitor) | European Parliament political-intelligence platform |
|
|
713
|
+
| ๐ฐ๏ธ [**European Parliament MCP Server**](https://github.com/Hack23/European-Parliament-MCP-Server) | TypeScript MCP server exposing EP open data to LLMs |
|
|
714
|
+
| ๐ [**Hack23 Homepage**](https://github.com/Hack23/homepage) | Hack23 AB corporate site โ radical transparency in practice |
|
|
715
|
+
| ๐ [**ISMS-PUBLIC**](https://github.com/Hack23/ISMS-PUBLIC) | Public Information Security Management System framework |
|
|
679
716
|
|
|
680
|
-
|
|
681
|
-
- **โ๏ธ ๊ท ํ๋์ฌ (Balance Master)** โ Master all stance & footwork patterns
|
|
682
|
-
- **๐ง ์ ์ ์์์ฌ (Mental Cultivator)** โ Complete psychological combat training
|
|
683
|
-
- **๐ฐ๐ท ๋ฌด๋ํ์ (Martial Scholar)** โ Understand Korean martial arts philosophy
|
|
684
|
-
|
|
685
|
-
### ๐ญ Archetype Mastery
|
|
686
|
-
|
|
687
|
-
- **๐ฏ ๋ฌด์ฌ์์ฑ (Warrior Perfection)** โ Master traditional warrior discipline
|
|
688
|
-
- **๐ฅท ๊ทธ๋ฆผ์๋์ฌ (Shadow Master)** โ Perfect stealth & assassination arts
|
|
689
|
-
- **๐ป ์ฌ์ด๋ฒ๋ฌด์ฌ (Cyber Warrior)** โ Tech-enhanced combat mastery
|
|
690
|
-
- **๐ต๏ธ ์ ๋ณด๋๊ฐ (Intelligence Master)** โ Psychological warfare expertise
|
|
691
|
-
- **โก ๊ฑฐ๋ฆฌ์ (Street King)** โ Underground combat supremacy
|
|
717
|
+
๐ **Hack23 AB** โ [hack23.com](https://hack23.com/) ยท [Blog](https://hack23.com/blog.html) ยท [Security Posture](https://hack23.com/security.html)
|
|
692
718
|
|
|
693
719
|
---
|
|
694
720
|
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
## ๐ Ready to Master Korean Martial Arts?
|
|
721
|
+
## ๐ Documentation Map
|
|
698
722
|
|
|
699
|
-
|
|
723
|
+
### ๐บ๏ธ Planning & Status
|
|
700
724
|
|
|
701
|
-
|
|
725
|
+
- [๐บ๏ธ **ROADMAP.md**](./ROADMAP.md) โ v1.0 release plan (Q3 2026), milestones, system tracking
|
|
726
|
+
- [๐ **game-status.md**](./game-status.md) โ comprehensive metrics (9.4/10 ยท 13/13 combat realism ยท 75%+ coverage)
|
|
727
|
+
- [๐ฎ **VISION_2026_2034.md**](./VISION_2026_2034.md) โ 8-year strategic vision
|
|
728
|
+
- [๐ฎ **game-design.md**](./game-design.md) โ game mechanics, archetypes, design decisions
|
|
702
729
|
|
|
703
|
-
|
|
730
|
+
### ๐๏ธ Architecture (C4 Model)
|
|
704
731
|
|
|
705
|
-
|
|
732
|
+
- [๐ **ARCHITECTURE.md**](./ARCHITECTURE.md) โ current C4 context ยท container ยท component
|
|
733
|
+
- [โ๏ธ **COMBAT_ARCHITECTURE.md**](./COMBAT_ARCHITECTURE.md) โ full combat pipeline (3,300+ lines)
|
|
734
|
+
- [๐ **DATA_MODEL.md**](./DATA_MODEL.md) โ data structures and relationships
|
|
735
|
+
- [๐ **FLOWCHART.md**](./FLOWCHART.md) โ combat / business process flows
|
|
736
|
+
- [๐๏ธ **STATEDIAGRAM.md**](./STATEDIAGRAM.md) โ game and combat state machines
|
|
737
|
+
- [๐ง **MINDMAP.md**](./MINDMAP.md) โ conceptual relationships
|
|
738
|
+
- [๐ **SWOT.md**](./SWOT.md) โ strategic analysis
|
|
739
|
+
- [๐ **FUTURE_ARCHITECTURE.md**](./FUTURE_ARCHITECTURE.md) โ post-v1.0 evolution roadmap
|
|
706
740
|
|
|
707
|
-
|
|
741
|
+
### ๐ Security & Compliance
|
|
708
742
|
|
|
709
|
-
|
|
743
|
+
- [๐ **SECURITY.md**](./SECURITY.md) โ vulnerability disclosure, supported versions, SLA
|
|
744
|
+
- [๐ก๏ธ **SECURITY_ARCHITECTURE.md**](./SECURITY_ARCHITECTURE.md) โ implemented security design
|
|
745
|
+
- [๐ **FUTURE_SECURITY_ARCHITECTURE.md**](./FUTURE_SECURITY_ARCHITECTURE.md) โ planned security improvements
|
|
746
|
+
- [๐ฏ **THREAT_MODEL.md**](./THREAT_MODEL.md) โ STRIDE analysis and attack trees
|
|
747
|
+
- [๐ **FUTURE_THREAT_MODEL.md**](./FUTURE_THREAT_MODEL.md) โ evolved threats
|
|
748
|
+
- [๐ **CRA-ASSESSMENT.md**](./CRA-ASSESSMENT.md) โ EU Cyber Resilience Act readiness
|
|
749
|
+
- [๐บ๏ธ **ISMS_REFERENCE_MAPPING.md**](./ISMS_REFERENCE_MAPPING.md) โ repo โ ISMS-PUBLIC cross-reference
|
|
750
|
+
- [๐ **WORKFLOWS.md**](./WORKFLOWS.md) โ CI/CD security automation
|
|
751
|
+
- [โป๏ธ **BCPPlan.md**](./BCPPlan.md) โ Business Continuity Plan (multi-region failover)
|
|
752
|
+
- [๐ **End-of-Life-Strategy.md**](./End-of-Life-Strategy.md) โ sunset and migration plan
|
|
753
|
+
|
|
754
|
+
### ๐ ๏ธ Development, Testing & Assets
|
|
755
|
+
|
|
756
|
+
- [๐ง **development.md**](./development.md) โ dev environment, security features, testing
|
|
757
|
+
- [๐งช **UnitTestPlan.md**](./UnitTestPlan.md) โ unit-testing strategy (Vitest)
|
|
758
|
+
- [๐ฏ **E2ETestPlan.md**](./E2ETestPlan.md) โ end-to-end testing (Cypress)
|
|
759
|
+
- [โก **performance-testing.md**](./performance-testing.md) โ Lighthouse + load testing
|
|
760
|
+
- [๐ฎ **CONTROLS.md**](./CONTROLS.md) โ complete controls reference (desktop ยท mobile ยท gestures ยท haptics)
|
|
761
|
+
- [๐ผ๏ธ **ART_ASSETS.md**](./ART_ASSETS.md) โ sprites, particles, palettes
|
|
762
|
+
- [๐ต **AUDIO_ASSETS.md**](./AUDIO_ASSETS.md) โ Korean instruments, impact SFX, mixing
|
|
763
|
+
- [๐ฌ **VIDEO_ASSETS.md**](./VIDEO_ASSETS.md) โ cinematic content
|
|
764
|
+
- [๐ฐ **FinancialSecurityPlan.md**](./FinancialSecurityPlan.md) โ financial-security plan
|
|
765
|
+
|
|
766
|
+
### ๐ค GitHub Copilot Custom Agents
|
|
767
|
+
|
|
768
|
+
- [๐ฏ **Custom Agents Guide**](.github/agents/README.md) โ specialized agents for development, testing, security, documentation, and Korean martial arts expertise
|
|
769
|
+
- [โก **Agent Skills Catalog**](.github/skills/README.md) โ automatic enforcement skills
|
|
770
|
+
- [๐ **Agent Capabilities Matrix**](.github/agents/AGENT_CAPABILITIES.md) โ coordination guide
|
|
771
|
+
- [๐ **Agent Skills Implementation**](.github/AGENT_SKILLS_IMPLEMENTATION.md) โ implementation report
|
|
710
772
|
|
|
711
773
|
---
|
|
712
774
|
|
|
713
|
-
##
|
|
775
|
+
## ๐ฅ Project Classification
|
|
714
776
|
|
|
715
|
-
|
|
777
|
+
### ๐ฏ Project Type
|
|
778
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#project-type-classifications)
|
|
779
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#project-type-classifications)
|
|
716
780
|
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
| **Enhanced Anatomy** | โ
Complete | 95% | Polygon-based zone detection |
|
|
722
|
-
| **Visual Feedback** | โ
Complete | 90% | Damage numbers, hit effects, combos |
|
|
723
|
-
| **Pain Response** | โ
Complete | 90% | Realistic pain accumulation |
|
|
724
|
-
| **Consciousness Levels** | โ
Complete | 90% | 4-level awareness system |
|
|
725
|
-
| **Breathing Disruption** | โ ๏ธ Near-Complete | 75% | Respiratory targeting |
|
|
726
|
-
| **Trauma Visualization** | โ ๏ธ In Progress | 65% | Injury rendering system |
|
|
727
|
-
| **Balance/Vulnerability** | โ ๏ธ In Progress | 70% | Stance-based weaknesses |
|
|
728
|
-
| **Combat Readiness HUD** | โ ๏ธ In Progress | 60% | Real-time status display |
|
|
729
|
-
| **Injury-Based Movement** | ๐ Planned | 10% | Damage affects mobility |
|
|
730
|
-
| **Bone Impact Audio** | ๐ Planned | 0% | Realistic fracture sounds |
|
|
731
|
-
|
|
732
|
-
**[๐ Detailed Status Report โ](game-status.md)** | **[๐บ๏ธ v1.0 Roadmap โ](ROADMAP.md)**
|
|
781
|
+
### ๐ Security Classification
|
|
782
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#confidentiality-levels)
|
|
783
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#integrity-levels)
|
|
784
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#availability-levels)
|
|
733
785
|
|
|
734
|
-
|
|
786
|
+
### โฑ๏ธ Business Continuity
|
|
787
|
+
[-lightgreen?style=for-the-badge&logo=clock&logoColor=white)](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#rto-classifications)
|
|
788
|
+
[-lightblue?style=for-the-badge&logo=database&logoColor=white)](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#rpo-classifications)
|
|
735
789
|
|
|
736
|
-
|
|
790
|
+
The frontend is statically deployed to **AWS CloudFront + S3** in multiple AWS regions with **Route 53** health-checked failover to **GitHub Pages** as disaster-recovery โ supporting the RTO/RPO commitments above with no backend dependencies. See [`BCPPlan.md`](./BCPPlan.md) and [`SECURITY_ARCHITECTURE.md`](./SECURITY_ARCHITECTURE.md).
|
|
737
791
|
|
|
738
|
-
|
|
792
|
+
### ๐ฐ Business Impact Analysis Matrix
|
|
739
793
|
|
|
740
|
-
|
|
794
|
+
| Impact | Financial | Operational | Reputational | Regulatory |
|
|
795
|
+
|---|---|---|---|---|
|
|
796
|
+
| **๐ Confidentiality** | Negligible | Negligible | Low | Negligible |
|
|
797
|
+
| **โ
Integrity** | Negligible | Moderate | Moderate | Negligible |
|
|
798
|
+
| **โฑ๏ธ Availability** | Negligible | Low | Low | Negligible |
|
|
741
799
|
|
|
742
|
-
|
|
800
|
+
### ๐ก๏ธ Security Investment & Strategic Position
|
|
743
801
|
|
|
744
|
-
|
|
802
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#security-investment-returns)
|
|
803
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#security-investment-returns)
|
|
804
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#competitive-differentiation)
|
|
805
|
+
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#competitive-differentiation)
|
|
745
806
|
|
|
746
|
-
|
|
747
|
-
- โ
Pain Response System (90% production-ready)
|
|
748
|
-
- โ
Consciousness Levels (90% production-ready)
|
|
749
|
-
- โ
Breathing Disruption (75% near-complete)
|
|
750
|
-
- โ ๏ธ Test Coverage 76% (target: 80%+)
|
|
751
|
-
|
|
752
|
-
### Q2 2026 (Apr-Jun) - Feature Completion ๐ฏ
|
|
753
|
-
- ๐ฏ Complete remaining combat realism systems (4/12)
|
|
754
|
-
- ๐ฏ Training Mode with progressive difficulty
|
|
755
|
-
- ๐ฏ EndScreen with combat statistics
|
|
756
|
-
- ๐ฏ Mobile performance optimization (55-60fps)
|
|
757
|
-
- ๐ฏ Korean localization 100%
|
|
758
|
-
|
|
759
|
-
### Q3 2026 (Jul-Sep) - Release Candidate ๐
|
|
760
|
-
- ๐ v1.0.0-rc.1 Release Candidate
|
|
761
|
-
- ๐ User acceptance testing
|
|
762
|
-
- ๐ Complete documentation and marketing materials
|
|
763
|
-
- ๐ Security audit and compliance verification
|
|
764
|
-
|
|
765
|
-
### Success Criteria for v1.0
|
|
766
|
-
- [ ] 9.0/10+ overall quality
|
|
767
|
-
- [ ] 100% combat realism systems (12/12)
|
|
768
|
-
- [ ] 80%+ test coverage
|
|
769
|
-
- [ ] 60fps desktop, 55fps+ mobile
|
|
770
|
-
- [ ] Zero critical bugs
|
|
771
|
-
- [ ] Complete Korean/English localization
|
|
807
|
+
---
|
|
772
808
|
|
|
773
|
-
|
|
809
|
+
## ๐ค Contributing
|
|
774
810
|
|
|
775
|
-
|
|
811
|
+
We welcome contributions in code, documentation, Korean cultural review, accessibility audits, and security research.
|
|
776
812
|
|
|
777
|
-
|
|
813
|
+
- ๐ [`CONTRIBUTING.md`](./CONTRIBUTING.md) โ contribution workflow
|
|
814
|
+
- ๐ค [`CODE_OF_CONDUCT.md`](./CODE_OF_CONDUCT.md) โ community standards
|
|
815
|
+
- ๐ [`SECURITY.md`](./SECURITY.md) โ responsible disclosure (use the dedicated channel; do **not** file public issues)
|
|
816
|
+
- โ๏ธ All commits must be signed; first-time contributors sign the [CLA](https://cla-assistant.io/Hack23/blacktrigram)
|
|
778
817
|
|
|
779
818
|
---
|
|
780
819
|
|
|
781
|
-
##
|
|
820
|
+
## ๐ License
|
|
782
821
|
|
|
783
|
-
|
|
784
|
-
- [๐บ๏ธ **v1.0 Roadmap**](./ROADMAP.md) - **Complete v1.0 release timeline (Q2-Q3 2026)**
|
|
785
|
-
- [๐ **Game Status Report**](./game-status.md) - **Current metrics (8.4/10, 76% coverage, 67% combat realism)**
|
|
786
|
-
- [๐ฎ **Vision 2026-2034**](./VISION_2026_2034.md) - **8-year strategic vision and evolution roadmap**
|
|
787
|
-
- [๐ฎ Game Design](./game-design.md) - Overall game mechanics
|
|
788
|
-
- [๐ผ๏ธ Art Assets](./ART_ASSETS.md) - Visual asset guidelines
|
|
789
|
-
- [๐ต Audio Assets](./AUDIO_ASSETS.md) - Sound design documentation
|
|
790
|
-
- [๐ฌ Video Assets](./VIDEO_ASSETS.md) - Cinematic content
|
|
822
|
+
**Apache License 2.0** โ see [`LICENSE`](./LICENSE).
|
|
791
823
|
|
|
792
|
-
|
|
793
|
-
- [๐ Information Security Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Information_Security_Policy.md) - Enterprise-grade security framework
|
|
794
|
-
- [๐ก๏ธ Security Architecture](./SECURITY_ARCHITECTURE.md) - Complete security implementation
|
|
795
|
-
- [๐ฎ Future Security Architecture](./FUTURE_SECURITY_ARCHITECTURE.md) - Planned security enhancements
|
|
796
|
-
- [๐ฏ Threat Model](./THREAT_MODEL.md) - STRIDE analysis and attack trees
|
|
797
|
-
- [๐ CRA Assessment](./CRA-ASSESSMENT.md) - EU Cyber Resilience Act compliance
|
|
798
|
-
- [๐ Security Policy](./SECURITY.md) - Vulnerability reporting and disclosure
|
|
799
|
-
- [๐บ๏ธ ISMS Reference Mapping](./ISMS_REFERENCE_MAPPING.md) - Complete ISMS policy mapping
|
|
800
|
-
|
|
801
|
-
### ๐ ๏ธ Development & Architecture
|
|
802
|
-
- [๐ ๏ธ Secure Development Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Secure_Development_Policy.md) - Security-integrated SDLC
|
|
803
|
-
- [๐ Architecture](./ARCHITECTURE.md) - High-level system design
|
|
804
|
-
- [๐ **Future Architecture**](./FUTURE_ARCHITECTURE.md) - **Evolutionary architecture roadmap (2026-2034)**
|
|
805
|
-
- [โ๏ธ Combat Architecture](./COMBAT_ARCHITECTURE.md) - Combat system mechanics
|
|
806
|
-
- [๐ Workflows](./WORKFLOWS.md) - CI/CD security automation
|
|
807
|
-
- [๐ง Development Guide](./development.md) - Security features and testing
|
|
808
|
-
- [๐ท๏ธ Classification Framework](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md) - Business impact analysis
|
|
809
|
-
|
|
810
|
-
### ๐ Testing & Quality
|
|
811
|
-
- [๐งช Unit Test Plan](./UnitTestPlan.md) - Comprehensive unit testing strategy (76% coverage)
|
|
812
|
-
- [๐ฏ E2E Test Plan](./E2ETestPlan.md) - End-to-end testing documentation
|
|
813
|
-
- [โก Performance Testing](./performance-testing.md) - Lighthouse & load testing
|
|
814
|
-
- [๐ Vulnerability Management](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Vulnerability_Management.md) - Security testing procedures
|
|
815
|
-
|
|
816
|
-
### ๐ฎ Game Design & Assets
|
|
817
|
-
- _Moved to Planning & Progress section above_
|
|
818
|
-
|
|
819
|
-
### ๐ ISMS Public Repository
|
|
820
|
-
- [๐ Open Source Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Open_Source_Policy.md) - Open source governance
|
|
821
|
-
- [๐ค AI Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/AI_Policy.md) - AI governance framework
|
|
822
|
-
- [๐ ISMS Transparency Plan](https://github.com/Hack23/ISMS-PUBLIC/blob/main/ISMS_Transparency_Plan.md) - Public disclosure strategy
|
|
823
|
-
- [๐ Security Metrics](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Security_Metrics.md) - Performance measurement
|
|
824
|
+
[](https://app.fossa.io/projects/git%2Bgithub.com%2FHack23%2Fblacktrigram?ref=badge_large)
|
|
824
825
|
|
|
825
826
|
---
|
|
826
827
|
|
|
827
|
-
|
|
828
|
-
|
|
829
|
-
### ๐ฏ Project Classification
|
|
830
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#project-type-classifications)
|
|
831
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#project-type-classifications)
|
|
832
|
-
|
|
833
|
-
### ๐ Security Classification
|
|
834
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#confidentiality-levels)
|
|
835
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#integrity-levels)
|
|
836
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#availability-levels)
|
|
837
|
-
|
|
838
|
-
### โฑ๏ธ Business Continuity
|
|
839
|
-
[-lightgreen?style=for-the-badge&logo=clock&logoColor=white)](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#rto-classifications)
|
|
840
|
-
[-lightblue?style=for-the-badge&logo=database&logoColor=white)](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#rpo-classifications)
|
|
828
|
+
<div align="center">
|
|
841
829
|
|
|
842
|
-
|
|
830
|
+
## ๐ Ready to Master Korean Martial Arts?
|
|
843
831
|
|
|
844
|
-
|
|
845
|
-
|-----------------|-----------|-------------|--------------|------------|
|
|
846
|
-
| **๐ Confidentiality** | [](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#financial-impact-levels) | [](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#operational-impact-levels) | [](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#reputational-impact-levels) | [](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#regulatory-impact-levels) |
|
|
847
|
-
| **โ
Integrity** | [](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#financial-impact-levels) | [](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#operational-impact-levels) | [](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#reputational-impact-levels) | [](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#regulatory-impact-levels) |
|
|
848
|
-
| **โฑ๏ธ Availability** | [](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#financial-impact-levels) | [](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#operational-impact-levels) | [](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#reputational-impact-levels) | [](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#regulatory-impact-levels) |
|
|
832
|
+
**[๐ฎ Play โ blacktrigram.com](https://blacktrigram.com/)** ยท **[๐ API Docs](https://hack23.github.io/blacktrigram/)** ยท **[๐ฆ npm](https://www.npmjs.com/package/blacktrigram)** ยท **[๐ค DeepWiki](https://deepwiki.com/Hack23/blacktrigram)**
|
|
849
833
|
|
|
850
|
-
|
|
851
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#security-investment-returns)
|
|
852
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#security-investment-returns)
|
|
853
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#security-investment-returns)
|
|
834
|
+
_Experience authentic Korean combat techniques with anatomical precision across **5 unique fighting archetypes**, **8 trigram stances**, and **70 vital points**._
|
|
854
835
|
|
|
855
|
-
### ๐ฏ
|
|
856
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#competitive-differentiation)
|
|
857
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#competitive-differentiation)
|
|
858
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#competitive-differentiation)
|
|
836
|
+
### Built with ๐ฏ Combat Precision ยท ๐ฐ๐ท Cultural Authenticity ยท ๐ Radical Transparency
|
|
859
837
|
|
|
860
|
-
|
|
861
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#porters-five-forces)
|
|
862
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#porters-five-forces)
|
|
863
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#porters-five-forces)
|
|
864
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#porters-five-forces)
|
|
865
|
-
[](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#porters-five-forces)
|
|
838
|
+
**๐ฅ ํ๊ด์ ๊ธธ์ ๊ฑธ์ด๋ผ โ Walk the Path of the Black Trigram ๐ฅ**
|
|
866
839
|
|
|
867
|
-
|
|
840
|
+
</div>
|