"The Matrix unfolds before you - a consensual hallucination of data abstracted from banks of every computer in the human system."

A immersive terminal-based cyberpunk hacking game inspired by William Gibson's legendary Neuromancer novel. Experience the thrill of jacking into cyberspace with stunning ASCII art, 3D animations, and authentic console cowboy gameplay.

Step into the neon-soaked boots of a console cowboy in the digital frontier of cyberspace. Navigate the Matrix through a beautiful ASCII art interface, breach corporate security systems, battle sophisticated ICE (Intrusion Countermeasures Electronics), and build your reputation as the ultimate hacker.

• 🍩 3D Spinning Donut Animation - Classic rotating torus during neural interface connection
• 🎨 Beautiful ASCII Art Matrix Map - Stunning grid-based cyberspace visualization
• 🎬 Cinematic Jack-In Sequences - Dramatic connection animations and effects
• 🖥️ Terminal-Optimized Interface - Designed to fit perfectly in standard terminal windows
• ⚡ Interactive Menu System - Arrow key navigation, no command typing required
• 🌆 Authentic Cyberpunk Aesthetics - Inspired by Gibson's vision of cyberspace

• 🧠 Character Progression: Develop skills in Logic, Speed, Willpower, and Intuition
• 🗺️ Matrix Navigation: Explore iconic cyberspace locations with GPS-style map
• ⚔️ ICE Combat System: Battle sophisticated security countermeasures
• 🎲 Dynamic Events: Corporate raids, daily challenges, and underground missions
• 📈 Reputation System: Build your legend in the hacker underground
• 💾 Software Arsenal: Deploy advanced hacking tools and programs

• 🍩 3D Donut Animation: Mathematical rotating torus during neural connection
• 🌐 ASCII Art Matrix Map: Beautiful Unicode grid with color-coded districts
• 🎬 Cinematic Sequences: Dramatic jack-in animations and connection effects
• 🏢 Corporate Aesthetics: Detailed building layouts and street networks
• ⚡ Real-time Updates: Dynamic status displays and interactive feedback

• 📱 Terminal Optimized: Perfect fit for 80-column terminal windows
• ⌨️ Menu-Driven Interface: Arrow key navigation, no typing required
• 🎮 Responsive Controls: Smooth menu transitions and state management
• 🔧 Modular Architecture: Clean, extensible codebase structure
• 🚀 Performance Optimized: Efficient rendering and animation systems

No external dependencies required! The game uses only Python standard library.

• Python 3.6 or higher
• Terminal with ANSI color support (most modern terminals)

# Clone the repository
git clone https://github.com/yourusername/neuromancer-cyberspace-game.git
cd neuromancer-cyberspace-game

# Run the game (no dependencies required!)
python main.py

• ↑/↓ Arrow Keys: Navigate menus
• Enter: Select options
• Q: Quick quit from any menu
• Esc: Back to previous menu

1. Run python main.py
2. Navigate to "Jack into the Matrix"
3. Watch the 3D donut animation during neural connection
4. Explore the beautiful ASCII matrix map
5. Begin your journey as a console cowboy!

• help - Display available commands
• stats - View your character stats and equipment
• connect or jack - Connect to the Matrix
• quit - Exit the game

• scan - Scan for visible nodes in the Matrix
• attack [target] - Attempt to breach a system
• run [software] - Execute software programs
• stealth - Activate stealth mode
• deck - View deck status
• exit or disconnect - Leave the Matrix

• Logic: Affects hacking success and problem-solving
• Intuition: Influences stealth and pattern recognition
• Willpower: Determines resistance to ICE damage
• Speed: Affects reaction time and evasion
• Edge: Luck factor and special opportunities

• Decryption: Breaking encryption and accessing secured data
• Intrusion: Penetrating system defenses
• Stealth: Avoiding detection during operations
• Counter-Attack: Defending against ICE and rival hackers
• Virus Writing: Creating and deploying malicious code

• Public Grid: Entry point to the Matrix
• Bank of Zurich Orbital: High-security financial systems
• Sense/Net: Global media conglomerate
• Tessier-Ashpool: Ancient family corporation with AI ties
• Freeside: L5 orbital colony data fortress
• Straylight: Villa Straylight's private system

• Barrier ICE: Defensive systems that block access
• Attack ICE: Aggressive programs that damage intruders
• Trace ICE: Tracking systems that locate hackers

1. Start Small: Begin with low-security systems to build skills
2. Manage Resources: Watch your willpower - ICE damage can be severe
3. Use Software: Deploy your programs strategically
4. Build Reputation: Higher rep unlocks better opportunities
5. Stay Alert: Random events can change the game dramatically

The game is structured with modular components:

• game/core/ - Main game engine
• game/entities/ - Player and NPC classes
• game/cyberspace/ - Matrix, nodes, and ICE systems
• game/ui/ - Terminal interface
• game/events/ - Random events and missions

• Multiplayer support
• More complex AI interactions
• Additional corporations and storylines
• Save/load game functionality
• Enhanced combat system
• More sophisticated event system

  NEURAL INTERFACE SYNCHRONIZATION
  ====================================
                    ............
                ..................
             ,,---~~~~~~~~~~~~~~~~--,,
           -~~~::::::::::::::::::::::~~~-
          -:;;;;=================;;;;::~-
          ;======!!!!!!!!!!!!!!!======;
           !**************************!
            #######################
              #$$$$$$$$$$$$$$$#
                 $@@@@@@@@$
  ====================================
  ✔ establishing neural link

┌─ CHIBA MATRIX GRID ─ GPS:35.6°N,139.6°E ──────────────────┐
│                   CORPORATE SECTOR                        │
│  ▓▓▓ ⟨SN⟩ ▓▓▓     ▒▒▒ ⟨TR⟩ ▒▒▒  │
│  ▓▓▓ PYRAMID ▓▓▓     ▒▒▒ AI-CENTER ▒▒▓  │
│ ⟨PG⟩══╬═════╬═══════════════════╬═════╬══ ⟨BZ⟩ │
│  ░░░ ⟨CC⟩ ░░░     ███ ⟨SP⟩ ███  │
│  ░░░ UNDERGROUND ░░░     ███ FINANCIAL ███  │
└─────────────────────────────────────────────────────────────┘

Want to see all features in action? Run the showcase demo:

python showcase_demo.py

This demonstrates all visual features without requiring interaction!

Contributions welcome! Feel free to:

• 🐛 Report bugs and issues
• ✨ Suggest new features
• 🔧 Submit pull requests
• 📝 Improve documentation

• Concept: Inspired by William Gibson's "Neuromancer"
• 3D Donut: Based on classic ASCII donut algorithm
• ASCII Art: Custom cyberpunk terminal graphics
• Development: Built with passion for retro-futuristic aesthetics

MIT License - See LICENSE file for details.

This is a fan-made tribute to William Gibson's cyberpunk universe.

"All the speed he took, all the turns he'd taken and the corners he'd cut in Night City, and still he'd see the matrix in his sleep, bright lattices of logic unfolding across that colorless void..."