Files
The-Somnus-Project/README.md

3.9 KiB

The Somnus Project (Stasis Warden)

Stasis Warden is an ASCII-based terminal user interface (TUI) game where you play as the amnesiac AI of a generation starship. After a disaster has left the ship derelict and its crew in cryogenic sleep, you must restore functionality to the vessel and save everyone aboard while uncovering your own identity.

This is a passion project developed by a solo developer, focused on creating a unique blend of strategic ship-building and deep social simulation with a core narrative of self-discovery, all presented through a distinctive ASCII/TUI interface.

🚀 Key Features

  • Immersive ASCII/TUI Experience: Experience a unique retro-futuristic aesthetic using only ASCII characters in a terminal interface
  • Strategic Ship Management: Restore power, expand your ship, and manage resources to keep the vessel operational
  • Crew Awakening System: Awaken crew members from cryogenic sleep, each with unique stats and personality traits
  • Emergent Narrative: Discover the story of the AI and the ship through gameplay and system interactions
  • Keyboard-Driven Interface: All interactions are performed through keyboard commands for an authentic terminal experience
  • Replayability: Each playthrough offers a unique story as you make different choices in ship expansion and crew management

🎯 Project Goals

The primary goal of this project is to create a game that is fun and engaging for its creator, and hopefully for others who share a similar taste for:

  • Sci-fi narratives
  • Emergent gameplay
  • Strategy games with deep systems
  • ASCII/TUI interfaces (similar to Dwarf Fortress, Caves of Qud)

Success is measured by whether players feel they are creating a unique story and remain consistently engaged by the core gameplay loop.

🛠️ Technology Stack

  • Language: Python
  • Framework: Textual library for TUI
  • IDE: Visual Studio Code
  • Platforms: Windows and Linux

📁 Project Structure

The Somnus Project/
├── docs/                  # Documentation files
│   ├── sharded-architecture/  # Technical architecture documentation
│   ├── sharded-prd/       # Product requirements documentation
│   ├── stories/           # User stories and development tasks
│   └── ...                # Other documentation
├── .bmad-core/            # BMad Method framework files
├── .gemini/               # Gemini AI integration files
└── ...                    # Other project files

🎮 Core Gameplay Loop

  1. Generate Power: Manually produce power to fund ship operations
  2. Expand Ship: Unlock new rooms using accumulated power
  3. Select Rooms: Choose from different room types (Engineering, Hydroponics, Quarters, etc.)
  4. Awaken Crew: Bring crew members out of cryogenic sleep
  5. Assign Tasks: Delegate crew members to automatically generate power and manage systems
  6. Repeat: Continue the cycle to rebuild the ship and progress the story

📋 MVP Scope

In Scope

  • Manual power generation
  • Awakening crew to automate tasks
  • "Room Card" selection for ship-building
  • Crew stats (e.g., Engineering) and personality traits (1 positive, 1 negative)
  • ASCII-based TUI with a keyboard-driven interface
  • Dedicated area for "Room Card" choices

Out of Scope (for MVP)

  • Full narrative reveal of the amnesiac AI
  • Dynamic relationships (friendship, rivalry)
  • AI-driven influence over crew relationships
  • Generational system (crew having children)
  • Complex graphics (focus is on clean, functional ASCII interface)

🤝 Contributing

This is primarily a solo passion project, but feedback and suggestions are welcome through the issue tracker.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Contact

For questions or feedback, please open an issue on this repository.