Black Trigram Features English

Master the dark arts through the pursuit of the perfect strike - Korean Traditional Martial Arts Precision Combat Simulator

GitHub Release License OpenSSF Scorecard CII Best Practices SLSA 3 Scorecard supply-chain security Test & Report Lines of Code Quality Gate Status Security Rating Maintainability Rating Reliability Rating FOSSA Status
Home 📚 Documentation 🎮 Play Now

Game Overview

Black Trigram (흑괘) is a realistic 2D precision combat game inspired by Korean martial arts philosophy and I Ching. This innovative combat simulator teaches authentic Korean martial arts through precise anatomical targeting, featuring 70 vital points and 5 distinct combat archetypes using modern 2D combat mechanics to master traditional vital point techniques.

Play now to experience the depth and beauty of Korean martial arts firsthand.

Key Features

🎯 70 Anatomical Vital Points

Strategic targeting system based on traditional Korean martial arts knowledge. Each vital point is designed with authentic martial arts education and anatomical accuracy in mind.

For Fighters: Achieve maximum effectiveness through precise vital point strikes.

🥋 5 Distinct Archetypes

Five character archetypes each with unique combat philosophy and techniques: Musa (Warrior), Amsalja (Assassin), Hacker, Intelligence Operative, and Organized Crime.

For Players: Explore diverse combat styles and strategies across different fighting philosophies.

⚔️ Authentic Korean Martial Arts

Traditional Korean martial arts techniques including Taekkyeon and Hapkido are accurately implemented in the game. Each technique carries cultural respect and educational value.

For Martial Arts Students: Learn practical applications of traditional techniques.

💥 Realistic Combat Physics

Advanced trauma simulation and realistic damage modeling provide authentic combat experience. Accurately recreates the mechanics and consequences of real combat.

For Simulation Enthusiasts: Experience realistic combat dynamics and consequences.

📚 Educational Gameplay

Integration of traditional philosophy with modern game mechanics provides cultural learning experience. Learn Korean martial arts spirit and history through gameplay.

For Educators: Teach martial arts in an engaging and interactive way.

🏛️ Cultural Authenticity

Deep integration of Korean martial arts philosophy and terminology with respectful cultural representation. Features deep understanding and accurate representation of tradition.

For Culture Enthusiasts: Explore authentic Korean martial arts traditions.

🥋 Player Archetypes

Master combat through 5 distinct fighting philosophies:

🏯 Musa (무사) - Traditional Warrior

Combat Philosophy: Honor through strength

Special Focus: Military discipline, overwhelming force, direct confrontation

Weapon Preference: Balance of traditional weapons and unarmed combat

🥷 Amsalja (암살자) - Shadow Assassin

Combat Philosophy: Efficiency through stealth

Special Focus: Stealthy approach, instant neutralization, vital point strikes

Weapon Preference: Small concealed weapons and poisons

💻 Hacker - Cyber Warrior

Combat Philosophy: Information is power

Special Focus: Environmental manipulation, tech-assisted strikes, tactical advantage

Weapon Preference: Electronic devices and modified tools

🕵️ Intelligence Operative - Information Agent

Combat Philosophy: Knowledge through observation

Special Focus: Psychological manipulation, precise timing, adaptive tactics

Weapon Preference: Multi-purpose tools and disguised weapons

⚡ Organized Crime - Criminal Organization

Combat Philosophy: Survival through brutality

Special Focus: Dirty fighting, improvised weapons, ruthless efficiency

Weapon Preference: Improvised weapons and unconventional tools

🎯 Anatomical Targeting System

Master 70 authentic vital points using traditional I Ching Eight Trigrams to enhance combat effectiveness:

☰ Geon (건) - Heaven

Combat Focus: Bone-striking force

Combat Effect: Fractures, structural damage, immobilization

Strategic Use: Complete neutralization of opponent's defenses

☱ Tae (태) - Lake

Combat Focus: Joint manipulation

Combat Effect: Dislocation, mobility loss, joint damage

Strategic Use: Limiting opponent's mobility

☲ Li (리) - Fire

Combat Focus: Precise nerve strikes

Combat Effect: Temporary paralysis, numbness, reflex inhibition

Strategic Use: Blocking opponent's response capabilities

☳ Jin (진) - Thunder

Combat Focus: Stunning techniques

Combat Effect: Disorientation, unconsciousness, knockout

Strategic Use: Immediate combat termination

🚀 Technical Excellence

Built for combat realism and authentic simulation:

🎮 Game Engine

  • PixiJS 8.x - Advanced 2D rendering engine
  • React 19 - Modern UI framework
  • TypeScript - Type-safe development
  • Vite - Fast build system

⚡ Performance Optimization

  • WebGL - Hardware-accelerated graphics
  • Howler.js - Professional audio engine
  • Web Workers - Multi-threaded processing
  • Progressive Web App - Native app experience

🛡️ Security & Quality

  • SLSA Level 3 - Supply chain security
  • OpenSSF Scorecard - Security best practices
  • CII Best Practices - Quality standards
  • Continuous Integration/Deployment - Automated testing

🔗 Architecture & Design

🔗 Combat & Mechanics

🔗 Assets & Media

🎮 Ready to Master Korean Martial Arts?

Experience authentic Korean combat techniques with anatomical precision through 5 distinct combat archetypes. Enjoy both the depth of traditional martial arts and the fun of modern gaming.

🎮 Play Now 📂 GitHub Repository 📚 Documentation 📺 YouTube Channel 🎵 TikTok

Frequently Asked Questions

Common questions about Black Trigram's features, gameplay, and Korean martial arts integration.

Black Trigram is a revolutionary 2D precision combat simulator inspired by traditional Korean martial arts. It combines authentic martial arts techniques with modern gaming to create an educational and engaging experience.

Key Features:

  • 70 Anatomical Vital Points: Strategic targeting system based on traditional knowledge
  • 5 Combat Archetypes: Unique fighting styles (Musa, Amsalja, Hacker, Jeongbo, Jojik)
  • Authentic Techniques: Taekkyeon and Hapkido martial arts integration
  • Cultural Preservation: Educational focus on Korean martial arts heritage
  • Realistic Physics: Advanced trauma simulation and combat mechanics

Each archetype represents a distinct fighting philosophy and tactical approach:

  • Musa (무사) - Traditional Warrior: Emphasizes honor, direct combat, and traditional martial values. Strong in frontal assaults and disciplined techniques.
  • Amsalja (암살자) - Assassin: Focuses on precision strikes to vital points, stealth, and quick eliminations. Masters of anatomical targeting.
  • Hacker (해커) - Technical Fighter: Uses system knowledge, strategic analysis, and unconventional tactics. Exploits weaknesses in opponent's patterns.
  • Jeongbo (정보) - Intelligence Operative: Specializes in information gathering, reading opponents, and gaining tactical advantage through awareness.
  • Jojik (조직) - Organization Member: Leverages group tactics, coordinated attacks, and organizational strength. Excels in team-based combat scenarios.

Players can master multiple archetypes or specialize in one to develop a unique fighting style.

The game features 70 anatomically accurate vital points based on traditional Korean martial arts knowledge and modern anatomy:

  • Strategic Targeting: Each vital point has specific effects on an opponent - some cause immediate damage, others impair movement or create openings
  • Anatomical Accuracy: Points are positioned based on real human anatomy, making the system educational as well as tactical
  • Contextual Effectiveness: The effectiveness of targeting specific points depends on combat situation, opponent stance, and timing
  • Skill-Based Gameplay: Rewards anatomical knowledge and precision over button mashing
  • Traditional Knowledge: Based on classical Korean martial arts teachings about pressure points and vital areas

Mastering the vital points system requires understanding human anatomy, timing, and strategic thinking - making combat more tactical and rewarding.

Black Trigram authentically integrates two primary Korean martial arts:

Taekkyeon (택견):

  • Korea's traditional martial art with fluid kicking techniques
  • Circular movements and rhythmic footwork
  • Dance-like qualities emphasizing grace and flow
  • UNESCO-recognized intangible cultural heritage

Hapkido (합기도):

  • Comprehensive martial art focusing on joint locks and pressure points
  • Throws, strikes, and grappling techniques
  • Circular motions and redirecting opponent's energy
  • Philosophy of harmony and non-resistance

Cultural Integration: The game also incorporates I Ching principles, Korean martial philosophy, honor codes, and traditional respect for the martial way (무도).

Black Trigram is designed as both an educational tool and entertainment experience. It serves multiple purposes:

Educational Value:

  • Anatomical Knowledge: Learn about vital points and human anatomy
  • Martial Arts Techniques: Experience authentic Korean martial arts movements
  • Cultural Heritage: Understand traditional Korean martial culture and philosophy
  • Strategic Thinking: Develop tactical planning and pattern recognition
  • I Ching Philosophy: Explore traditional Eastern philosophy in combat context

Target Audience:

  • Martial arts students seeking to understand Korean techniques
  • Cultural heritage enthusiasts interested in traditional combat
  • Gamers looking for tactical, skill-based combat systems
  • Educators teaching about Korean culture and martial arts

The game balances entertainment value with educational content, making learning engaging and interactive.

Black Trigram is currently available as a cross-platform PC game with plans for expansion:

Current Availability:

  • Web Version: Play online at blacktrigram.com
  • PC Download: Available from GitHub Releases
  • Source Code: Open source on GitHub for educational and development purposes

Technical Details:

  • Built with modern game development tools
  • Cross-platform compatibility
  • Optimized for various PC specifications
  • Regular updates and improvements via GitHub

Future platform expansion will be based on community feedback and technical feasibility. Follow the project on GitHub or YouTube for updates.

Yes, Black Trigram is proudly open source, reflecting Hack23's commitment to transparency and community contribution:

Open Source Benefits:

  • Transparency: Full source code available for review and learning
  • Community Contribution: Accept improvements and bug fixes from the community
  • Educational Resource: Developers can learn from the implementation
  • Security: Public code review improves security and quality

Security & Quality Standards:

  • OpenSSF Scorecard: Security best practices validation
  • CII Best Practices: Core Infrastructure Initiative certification
  • SLSA Level 3: Supply chain security attestation
  • Continuous Integration: Automated testing and quality checks

Visit the GitHub repository to explore the code, contribute, or report issues. The open-source approach ensures the game evolves with community input while maintaining high quality standards.