Skip to content

AlbertDaYoungYT/Project0Z

Repository files navigation

Build Status License Platform Status

🌌 Procedural Worlds | 🔥 Dynamic Events | ⚔️ Faction Warfare | 📈 Live Economy | 📚 Deep Lore


"Sometimes imagination is more powerful than sight."

Project Z0 is a real-time, text-driven multiplayer game focused on exploration, strategy, and survival — without traditional graphics. Inspired by Helldivers II, Pokémon GO, and minimalist game design, it is currently mobile-only.


🌍 Features

  • Mobile Focused: Built for mobile devices with future expansion planned.
  • Text-Driven Experience: Gameplay driven by events, choices, and sector navigation.
  • Real-Time Multiplayer: Robust session system for secure and fast gameplay interactions.
  • Customizable Loadouts: Items, weapons, and abilities with rarity and dynamic attributes.
  • Dynamic Economy: Item prices fluctuate based on supply and demand through player actions.
  • Event-Driven Gameplay: Spontaneous events that change sectors, economies, and lore.
  • Deep Lore System: Persistent universe with factions, history, and evolving narrative.
  • Secure and Scalable Server Backend: Emphasis on authentication and session robustness.

📊 Tech Stack

Technology Purpose
Python Backend server
CouchDB Accounts, items, sectors, shops, loadout, lore, events
KCP/UDP Real-time gameplay networking protocol
HTTP (basic) Login, registration, and session validation
  • No WebSocket dependency — uses KCP for efficient UDP packet delivery.

🚀 Architecture Overview

[Mobile Client]
    ├── HTTP (TCP) 
    │     ├─ Register
    │     ├─ Login
    │     ├─ Session Validation
    │     └─ Static Data Fetching (e.g., item lists, basic lore)
    │
    └── KCP (UDP)
          ├─ Real-Time Gameplay Communication
          ├─ Player Actions (movement, interaction, combat)
          └─ Sector Event Handling

[Server (Dockerized)]
    ├── API Service (Python)
    │     ├─ Authentication
    │     ├─ Session Management
    │     └─ Request Routing
    │
    ├── Game Logic Service (Python)
    │     ├─ Sector State Management
    │     ├─ Event System (spontaneous and scheduled)
    │     ├─ Dynamic Economy Controller
    │     ├─ Procedural World Generator
    │     └─ Combat and Item Systems
    │
    └── CouchDB
          ├─ Persistent Player Data
          ├─ Items, Loadout, Shops
          ├─ World and Sector States
          ├─ Event History
          └─ Lore Database

📁 Installation (Dev Setup)

Clone and Build

git clone https://github.com/AlbertDaYoungYT/Project0Z.git project-z0/
cd project-z0/server
docker build -t project-z0-server .
docker run -d --name project-z0 -p 23899:23899 24899:24899 project-z0-server

The development servers automatic pull system auto-generates a .env file and keeps itself updated via Git hooks, this means you wont be able to use the environment variables it generates. But it has fallbacks in place to prevent any catastrophic events.


🔄 Roadmap

  • Core Authentication and Session Framework
  • KCP Real-Time Protocol Setup
  • CouchDB Integration
  • Player Movement and Sector Interaction
  • Loadout, Abilities, and Item System
  • Real-Time Event Generation
  • Dynamic Economy Implementation
  • Procedural Sector Generation
  • Lore System Deployment
  • Achievements and Progression
  • Mobile Client Early Alpha

🧳 Contributing

Currently not accepting external contributions.
If you have suggestions, ideas, or bug reports, feel free to open an issue or discussion!

Future plans include opening up contributions once core systems are stable and public testing servers are in place.


📃 License

Project Z0 is PROPRIETARY during its development phase.
Potential future licensing will be evaluated once a playable alpha is released.


👥 Authors

  • Lead Developer: @AlbertDaYoungYT
  • Design Inspiration: Helldivers II, Pokémon GO, Material 3 UX philosophy

🌟 Acknowledgements

  • Thanks to the open-source community for protocol and database libraries.
  • Inspired by minimalist and session-based multiplayer designs.

"In the absence of sight, strategy becomes your vision." – Project Z0 Team

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages