A multiplayer terminal-based roguelike MMO game where players explore procedurally generated dungeons, fight enemies, collect loot, and level up their characters.

CmdMMO is a real-time multiplayer game that runs entirely in the terminal. Players can see each other moving around the game world, engage in turn-based combat with enemies, collect items from chests, and progress through increasingly challenging stages. The game features a boss every 5 stages and includes RPG mechanics like leveling, stats, and inventory management.

• Multiplayer: See other players in real-time as they move around the map
• Three Character Classes:
  • Rogue: High attack & luck, low defense (HP: 80, ATK: 15, DEF: 4, LUCK: 8)
  • Knight: High HP & defense, balanced (HP: 120, ATK: 12, DEF: 10, LUCK: 3)
  • Wizard: Highest attack, low defense (HP: 70, ATK: 18, DEF: 3, LUCK: 5)
• Procedurally Generated Dungeons: Each level features unique layouts with walls and pathways
• Progressive Difficulty: Enemies scale with each stage, getting stronger as you progress
• Boss Battles: Every 5th stage features a powerful boss with minions
• Turn-Based Combat: Strategic combat system with critical hits and miss chances
• Leveling System: Gain XP from defeating enemies to level up and improve stats
• Loot System: Collect potions and swords from chests scattered throughout the dungeon
• Inventory Management: Store and use items to enhance your character
• Portal System: Clear all enemies to spawn a portal to the next stage
• City Hub: Safe zone with multiple buildings and NPCs for various interactions
• Farming System: Plant and harvest crops to gather crafting materials
• Potion Crafting: Trade harvested materials with the Alchemist to craft healing potions
• Property System: Purchase and own properties like farms through the Landlord

• Node.js with Express
• Socket.IO for real-time multiplayer communication
• WebSocket-based player synchronization

• Python 3
• Blessed library for terminal UI rendering
• python-socketio for client-server communication
• keyboard library for input handling

• Python 3.7+
• Node.js 14+
• npm

1. Clone the repository

   git clone <repository-url>
   cd CmdMMO

2. Install server dependencies

   cd server
   npm install
   cd ..

3. Install client dependencies

   pip install -r requirements.txt

In the server directory:

cd server
node index.js

The server will start on port 3001.

In the project root directory, run:

sudo python3 -m client.game.main

Note: sudo is required for proper keyboard input handling.

To play with multiple people, each player should:

1. Ensure they can connect to the server (update server address in client/game/server.py if needed)
2. Run sudo python3 -m client.game.main in their own terminal

• W/↑: Move up
• S/↓: Move down
• A/←: Move left
• D/→: Move right
• I: Toggle inventory

1. Character Creation: Enter your name and choose your class
2. Exploration: Navigate the procedurally generated dungeon
3. Combat: Collide with enemies (marked as E) to enter turn-based combat
4. Looting: Walk over chests (marked as ▣) to collect items
5. Progression: Defeat all enemies to spawn a portal (U)
6. Advance: Enter the portal to proceed to the next stage

• Attack: Deal damage based on your attack stat minus enemy defense
• Critical Hits: Your luck stat determines critical hit chance (double damage)
• Enemy Attacks: Enemies attack based on their stats; luck gives you a chance to dodge
• Victory: Defeat enemies to gain XP and gold

• Gain XP by defeating enemies
• Level up to increase HP, attack, defense, and luck
• XP required for next level increases by 1.5x each time
• HP fully restored on level up

• Normal Stages: Fight regular enemies (Snakes)
• Boss Stages: Every 5th stage features a Shadow Lord boss with minions
• Enemies scale in strength with each stage
• More enemies and chests spawn at higher stages

CmdMMO/
├── server/
│   ├── index.js              # Express + Socket.IO server
│   ├── package.json          # Server dependencies
│   └── routes/               # API routes
├── client/
│   ├── engine/               # Core game engine (maps, UI components, entities)
│   │   ├── core/             # Game client and core systems
│   │   ├── entities/         # Base entity classes
│   │   ├── maps/             # Base map system
│   │   └── ui/               # Base UI components
│   └── game/                 # Game-specific implementations
│       ├── main.py           # Game entry point
│       ├── server.py         # Client-server communication
│       ├── api_client.py     # REST API client
│       ├── entities/         # Game entities (player, enemy)
│       ├── maps/             # City and dungeon maps
│       │   ├── city.py       # City hub map
│       │   ├── dungeon.py    # Procedural dungeon
│       │   └── map_transition.py  # Map transitions
│       ├── items/            # Item definitions
│       │   ├── potions.py    # Potion types
│       │   ├── swords.py     # Weapon types
│       │   └── materials.py  # Crafting materials
│       ├── mechanics/        # Game mechanics
│       │   ├── farming.py    # Farming system
│       │   ├── properties.py # Property ownership
│       │   └── ranking.py    # Player ranking
│       ├── skills/           # Skills system
│       │   └── skill.py      # Skill definitions
│       ├── ui/               # User interfaces
│       │   ├── combatui.py   # Combat interface
│       │   ├── inventoryui.py # Inventory interface
│       │   ├── skillsui.py   # Skills menu
│       │   ├── levelup_ui.py # Level up screen
│       │   └── interactiveuis/ # Interactive UIs
│       │       ├── farmui.py      # Farm interface
│       │       ├── alchemist_ui.py # Potion crafting
│       │       ├── landlord_ui.py  # Property purchase
│       │       ├── rank_ui.py      # Rankings display
│       │       └── yago_ui.py      # Easter egg NPC
│       └── arts/             # ASCII art assets
│           ├── buildings.py  # Building designs
│           ├── materials.py  # Material icons
│           ├── merchant.py   # Merchant art
│           └── shitpost.py   # Easter eggs
└── requirements.txt          # Python dependencies

• HP: Health points - when it reaches 0, game over
• Attack: Damage dealt to enemies (reduced by enemy defense)
• Defense: Reduces incoming damage from enemies
• Luck: Increases critical hit chance and dodge chance

• Potions: Restore or boost HP
• Swords: Increase attack power
• Items can be collected from chests and used from inventory

• Regular enemies spawn with stats based on current stage level
• Bosses have 3x HP, 2x attack, and 2x defense of regular enemies
• Enemies drop gold and XP when defeated
• Boss encounters include minions for added challenge

• Server currently runs on localhost (port 3001)
• No authentication system
• Game state is not persisted between sessions
• Limited enemy variety (Snake and Shadow Lord)

Planned features and improvements for future versions:

• ✅ Class-specific abilities and special attacks
• 🔄 Active and passive skill trees
• 🔄 Cooldown-based skill mechanics
• ✅ Skill points earned through leveling
• 🔄 Ultimate abilities unlocked at higher levels

• ✅ Enemies can have unique skills and abilities
• ✅ Status effects (e.g., Snake poison - deals damage over time each turn)
• ✅ Different enemy types with distinct skill sets
• 🔄 Boss enemies with powerful signature abilities

• ✅ Interactive level-up screen with stat allocation
• ✅ Choice between different upgrade paths
• ✅ Unlock new abilities and perks at milestone levels
• ✅ Visual celebrations and notifications
• 🔄 Prestige system for endgame progression

• Weapon and armor upgrading mechanics
• Material gathering from enemies and chests
• Equipment enhancement with success/failure rates
• Unique enchantments and forging recipes
• Blacksmith NPC interaction in safe zones

• ✅ Buy potions with gold (Small: 100g, Medium: 200g)
• ✅ Trade materials for potions (2 Mushrooms → Small Potion, 4 Mushrooms → Medium Potion)
• ✅ NPC interaction UI with merchant ASCII art
• 🔄 Rotating inventory of rare items (Coming soon)
• 🔄 Price negotiation mechanics based on luck stat (Coming soon)
• 🔄 Special merchant events and limited-time offers (Coming soon)
• 🔄 Trade-in system for unwanted equipment (Coming soon)

• ✅ Crafting materials (Mushrooms from farming)
• ✅ Seeds as plantable items
• 🔄 Armor sets (helmets, chest plates, boots, gloves) (Coming soon)
• 🔄 Accessories (rings, amulets, talismans) (Coming soon)
• 🔄 Consumables (buff potions, scrolls, food) (Coming soon)
• 🔄 More crafting materials and resources (Coming soon)
• 🔄 Legendary and mythic rarity items (Coming soon)
• 🔄 Set bonuses for wearing complete equipment sets (Coming soon)

• Dynamically generated quest narratives
• Unique enemy descriptions and lore
• Procedurally generated NPC dialogues
• Contextual story events based on player actions
• Personalized dungeon backstories
• AI-powered merchant personalities and interactions

• ✅ Plant and harvest crops in safe zones or home base
• ✅ Grow alchemical ingredients for potion crafting
• ✅ Time-based crop growth mechanics
• ✅ Seed storage system (Silo)
• ✅ Crop status tracking with growth percentage and time remaining
• ✅ Property ownership requirement for farm access
• 🔄 Irrigation and fertilizer systems for better yields (Coming soon)
• 🔄 Rare seed drops from enemies and chests (Coming soon)
• ✅ Trade or sell harvested crops to merchants

• ✅ Player progression tracked through rank tiers (gold, phase, level)
• ✅ Gold rank representing overall achievement milestones
• ✅ Phase system for dividing progression into distinct stages
• ✅ Level tracking within each phase
• ✅ Rank board in city for viewing leaderboards
• ✅ Interactive rank UI showing player statistics
• 🔄 Rank-based rewards and unlocks (Coming soon)

• Open-world map with exploration and travel mechanics
• Dungeon entrances scattered throughout the overworld
• Wandering enemies that players can encounter and fight
• Hidden areas and secrets to discover
• Multiplayer interactions in shared overworld space

• ✅ Safe zone hub with multiple buildings and NPCs
• ✅ Landlord House: Buy and manage player properties (farm)
• ✅ Farm House: Access personal farm for crop management
• ✅ Alchemist House: Craft and buy potions using materials or gold
• ✅ Rank Board: View player rankings and leaderboards
• ✅ Yago NPC: Easter egg character in the city
• ✅ Portal system to transition between City and Dungeon
• ✅ Building interaction system with door collision detection
• ✅ Dynamic building rendering with proper collision
• 🔄 Blacksmith District: Upgrade weapons and armor (Coming soon)
• 🔄 Arena: PvP battles (Coming soon)
• 🔄 City quest board for side missions (Coming soon)
• ✅ Bank System: Persistent storage for items and gold (Coming soon)
  • Create bank account with unique ID and password
  • Store items and currency securely
  • Persistent across character deaths - access with new characters
  • Withdraw/deposit system with authentication
  • Shared account access for players who know the credentials
• 🔄 Social spaces for player interactions (Coming soon)

• Player housing with purchase and ownership mechanics
• Neighborhood map instance where purchased houses dynamically appear
• Multiple players' houses visible in shared neighborhood space
• ✅ Home Builder Interface: Terminal-based furniture customization
  • Keyboard-driven placement system (arrow keys for selection and positioning)
  • Furniture catalog with various items (beds, tables, decorations, storage)
  • Grid-based placement within house interior
  • Save and load custom house layouts
  • Preview mode before finalizing furniture placement
• House upgrades (size expansions, additional rooms)
• Invite other players to visit your house
• Functional furniture (storage chests, crafting stations, rest areas)

• More enemy types and variations
• Additional character classes
• Trading between players
• More diverse procedural generation
• PvP combat system

Feel free to fork this project and submit pull requests for improvements or bug fixes.

This project is open source and available for educational and personal use.

Built with Python, Node.js, Socket.IO, and the Blessed terminal library.