"Master the dark arts through the pursuit of the perfect strike" ๐ฎ Enter the Dojang
A realistic 2D precision combat game inspired by Korean martial arts philosophy and the I Ching
Black Trigram is a realistic combat simulator that teaches authentic Korean martial arts through precise anatomical targeting. Master traditional vital-point techniques via modern 2D combat mechanics across 5 distinct fighter archetypes.
|
๐ฏ ์ ๊ฒฉ์ Jeonggyeokja Precision Striker Every strike targets anatomical weak points |
โ๏ธ ๋น์ Bisu Lethal Technique Decisive unarmed combat methods |
๐ฅท ์์ด์ Amsalja Shadow Assassin Silent takedown techniques |
๐ ๊ธ์๊ฒฉ Geupsogyeok Vital Point Strike 70 anatomical targets for incapacitation |
Master combat through 5 distinct fighting philosophies:
| Archetype | Name | Combat Philosophy | Special Focus |
|---|---|---|---|
| ๐ฏ | ๋ฌด์ฌ (Musa) Traditional Warrior |
Honor through strength | Military discipline, overwhelming force |
| ๐ฅท | ์์ด์ (Amsalja) Shadow Assassin |
Efficiency through invisibility | Stealth approaches, instant takedowns |
| ๐ป | ํด์ปค (Hacker) Cyber Warrior |
Information as power | Environmental manipulation, tech-assisted strikes |
| ๐ต๏ธ | ์ ๋ณด์์ (Jeongbo Yowon) Intelligence Operative |
Knowledge through observation | Psychological manipulation, precise timing |
| โก | ์กฐ์งํญ๋ ฅ๋ฐฐ (Jojik Pokryeokbae) Organized Crime |
Survival through ruthlessness | Dirty fighting, improvised weapons |
Master 70 authentic vital points for combat effectiveness:
| Trigram | Name | Combat Focus | Combat Effects |
|---|---|---|---|
| โฐ | ๊ฑด (Geon) โ Heaven | Bone-striking force | Fractures, structural damage |
| โฑ | ํ (Tae) โ Lake | Joint manipulation | Dislocations, mobility loss |
| โฒ | ๋ฆฌ (Li) โ Fire | Precise nerve strikes | Temporary paralysis, numbness |
| โณ | ์ง (Jin) โ Thunder | Stunning techniques | Disorientation, knockouts |
| โด | ์ (Son) โ Wind | Continuous pressure | Gradual incapacitation |
| โต | ๊ฐ (Gam) โ Water | Blood flow restriction | Circulation disruption |
| โถ | ๊ฐ (Gan) โ Mountain | Defensive counters | Counter-attacks, blocks |
| โท | ๊ณค (Gon) โ Earth | Ground techniques | Throws, takedowns |
- ๐ฉธ Authentic Trauma โ Realistic injury visualization and blood
- ๐ฆด Bone Impact Audio โ Genuine bone contact and fracture sounds
- ๐ซ Breathing Disruption โ Respiratory system targeting
- โ๏ธ Balance System โ Realistic stance and momentum physics
- ๐ง Consciousness States โ Progressive awareness impairment
- ๐ต Pain Response โ Physiological pain affecting performance
- ๐ฏ Anatomical Precision โ 70 target points for tactical advantage
- ๐ฐ๐ท Traditional Korean Arts โ Authentic techniques from ํ๊ถ๋, ํฉ๊ธฐ๋, ํ๊ฒฌ
- โซ Advanced Techniques โ Professional combat methods from 5 distinct archetypes
- ๐ฅ Combat Application โ Real martial arts effectiveness
Built for combat realism and authentic simulation:
- VitalPointTargeter โ Interactive anatomical targeting system
- CombatTracker โ Real-time damage and status monitoring
- TechniqueCalculator โ Precise combat effectiveness calculations
- CombatAnalyzer โ Post-match technique analysis
- ๐ Movement:
WASDorArrow Keysโ Tactical positioning and footwork - โ๏ธ Techniques:
1โ8(Trigram-based combat techniques) - ๐ก๏ธ Guard:
Spacebarโ Defensive positioning and blocks - ๐ฏ Vital Strike:
Mouseโ Targeted vital-point attacks - ๐ Archetype Switch:
Tabโ Change between 5 fighter types
- ๐ฅ Impact Effects: Bone contact sounds and visual trauma
- ๐ฉธ Injury System: Realistic bleeding and damage progression
- ๐ต Incapacitation: Visual indicators of combat effectiveness
- โ๏ธ Balance: Physical stance and vulnerability windows
- ๐ ๊ธ์ํ์ต (Vital Point Study) โ 70 anatomical target points
- ๐ฏ ์ ๋ฐํ๊ฒฉ (Precision Striking) โ Accurate targeting techniques
- โซ ๊ณ ๊ธ๊ธฐ๋ฒ (Advanced Techniques) โ Professional combat methods
- ๐ฅ ์ค์ ์์ฉ (Practical Application) โ Combat effectiveness training
- ๐ฅ ๊ธฐ๋ณธ๊ธฐ (Fundamentals) โ Basic striking and positioning
- ๐ข ํ๊ด์ (Eight Trigram Arts) โ Traditional Korean combat philosophy
- ๐ ์ฐ๊ณ๊ธฐ๋ฒ (Combination Techniques) โ Flowing technique sequences
- ๐ฏ ์ ๋ฐ์ (Precision Arts) โ Exact targeting and timing
- ๐ค ์ผ๋์ผ (One-on-One) โ Single opponent combat simulation
- ๐ข ํ๊ฒฝ์ ํฌ (Environmental Combat) โ Using surroundings tactically
- ๐ง ์ ์ ์์ (Mental Cultivation) โ Psychological combat preparation
- ๐ ์ฐ์๋์ (Continuous Combat) โ Multiple opponent scenarios
- ๐ฏ ๋ฌด์ฌ๋ (Warrior's Way) โ Traditional warrior discipline training
- ๐ฅท ์์์ (Shadow Arts) โ Stealth and assassination techniques
- ๐ป ์ฌ์ด๋ฒ์ (Cyber Warfare) โ Tech-enhanced combat methods
- ๐ต๏ธ ์ ๋ณด์ (Intelligence Warfare) โ Psychological and strategic combat
- โก ๊ฑฐ๋ฆฌ์ (Street Arts) โ Underground survival combat
// Authentic vital point data with combat applications
interface VitalPoint {
name: { korean: string; english: string; technique: string };
location: AnatomicalPosition;
effectiveness: CombatEffectiveness;
difficulty: PrecisionRequired;
method: CombatTechnique[];
archetypeBonus: ArchetypeModifier[]; // Special bonuses for different fighter types
}// Realistic body mechanics for authentic combat
interface CombatState {
health: number; // Physical condition remaining
consciousness: number; // Awareness and responsiveness
pain: number; // Pain levels affecting performance
balance: CombatStability; // Physical stability in combat
stamina: number; // Energy and endurance
technique: number; // Skill and precision level
archetype: PlayerArchetype; // Current fighter specialization
}
// Player archetype system
type PlayerArchetype = "musa" | "amsalja" | "hacker" | "jeongbo" | "jojik";# Clone repository
git clone https://github.com/Hack23/blacktrigram.git
cd blacktrigram
# Install dependencies
npm install
# Start combat simulation
npm run dev
# Build for deployment
npm run build
# Run combat testing
npm run test
npm run test:combatGame/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.
๐ Architecture & Design
- ๐ ARCHITECTURE.md High-level C4 models, container/component views, and system context.
- ๐ FUTURE_ARCHITECTURE.md Vision for upcoming architectural enhancements and PWA integration.
- API Docs Detailed API reference for all components, types, and functions in the application.
๐ Combat & Mechanics
- ๐ฅ COMBAT_ARCHITECTURE.md In-depth battleflow, trigram integration, vital-point targeting, and damage pipeline.
- ๐บ๏ธ game-design.md Overall game mechanics, archetype breakdowns, and design decisions.
- ๐ game-status.md Current progress, feature roadmap, and milestone tracking.
๐ Assets & Media
- ๐ผ๏ธ ART_ASSETS.md Guidelines for sprite sheets, particle textures, color palettes, and UI icons.
- ๐ต AUDIO_ASSETS.md List of traditional Korean instrument loops, impact SFX, and mixing notes.
- ๐ต VIDEO_ASSETS.md Black Trigram: The Path of Shadows ๐โก๐ก๏ธ .Scene 1: Initiation Under Neon Skies ๐๐ก๏ธ๐
๐ CI/CD & Security Features
- ๐ development.md The development implements comprehensive security measures:.
- ๐ก๏ธ Supply Chain Security - OSSF Scorecard analysis and dependency review
- ๐ Static Analysis - CodeQL scanning for vulnerabilities
- ๐ฆ Dependency Protection - Automated dependency vulnerability checks
- ๐ Runner Hardening - All CI/CD runners are hardened with audit logging
- ๐ Security Policies - GitHub security advisories and vulnerability reporting
- ๐ท๏ธ Pinned Dependencies - All GitHub Actions pinned to specific SHA hashes
- ๐ SBOM Generation - Software Bill of Materials for transparency
- ๐ Build Attestations - Cryptographic proof of build integrity
- ๐ Artifact Verification - SLSA-compliant build provenance
- ๐ท๏ธ ZAP Security Scanning - OWASP ZAP dynamic application security testing
- โก Lighthouse Performance - Automated performance and accessibility audits
"์ด๋ ์์์ ์๋ฒฝํ ์ผ๊ฒฉ์ ์ฐพ์๋ผ" > "In darkness, seek the perfect strike"
Each technique focuses on:
- ์ ํํ ํ๊ฒฉ (Precise Targeting) โ Exact anatomical vulnerable points
- ์ต๋ ํจ๊ณผ (Maximum Effectiveness) โ One-strike incapacitation
- ์ ํฌ ์ฌ๋ฆฌ (Combat Psychology) โ Mental preparation for combat
- ์ ํต ์ง์ (Traditional Knowledge) โ Authentic Korean martial arts
- ์ํ ํนํ (Archetype Specialization) โ Unique approach per fighter type
- ๐ ๊ธ์๋๊ฐ (Vital Point Master) โ Master all 70 vital-point targets
- ๐ฉธ ์ ํฌ์ ๋ฌธ๊ฐ (Combat Expert) โ Execute optimal combat techniques
- โซ ๊ณ ์ (Advanced Practitioner) โ Complete advanced technique training
- ๐ช ์๋ฒฝํ ๋ฌด์ฌ (Perfect Warrior) โ Achieve flawless combat records
- ๐ฏ ์ ๋ฐํ๊ฒฉ์ฌ (Precision Striker) โ Perfect vital-point targeting accuracy
- โ๏ธ ๊ท ํ๋์ฌ (Balance Master) โ Master all stance & footwork patterns
- ๐ง ์ ์ ์์์ฌ (Mental Cultivator) โ Complete psychological combat training
- ๐ฐ๐ท ๋ฌด๋ํ์ (Martial Scholar) โ Understand Korean martial arts philosophy
- ๐ฏ ๋ฌด์ฌ์์ฑ (Warrior Perfection) โ Master traditional warrior discipline
- ๐ฅท ๊ทธ๋ฆผ์๋์ฌ (Shadow Master) โ Perfect stealth & assassination arts
- ๐ป ์ฌ์ด๋ฒ๋ฌด์ฌ (Cyber Warrior) โ Tech-enhanced combat mastery
- ๐ต๏ธ ์ ๋ณด๋๊ฐ (Intelligence Master) โ Psychological warfare expertise
- โก ๊ฑฐ๋ฆฌ์ (Street King) โ Underground combat supremacy
Experience authentic Korean combat techniques with anatomical precision across 5 unique fighting archetypes
๐ฅ ๋ฌด๋์ ๊ธธ์ ๊ฑธ์ด๋ผ (Walk the Path of Martial Arts) ๐ฅ