Skip to content

Galactic Exchange is a real-time, background-running, command-line based space trading simulation. Players take on the role of a faction leader, managing resources, trading, establishing routes, handling faction politics, and exploring an expansive, procedurally generated universe.

License

Notifications You must be signed in to change notification settings

luisya22/galactic-exchange

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

galactic-exchange

Galactic Exchange is a real-time, CLI-based strategy game that allows you to explore, trade, and manage a space-trading faction in a dynamically generated universe. Designed to be both engaging and respectful of your time, the game leverages real-world time as a resource and features a real-time economy system, various NPC factions, and intricate mechanics like interstellar commerce, diplomacy, and conflict. Galactic Exchange can run in the background, sending you notifications for crucial events, allowing you to attend to your real-world responsibilities while keeping your in-game empire running smoothly.

⚠️ Work in Progress Notice ⚠️

This project is currently under development and not all features are implemented yet. It's possible that you may encounter bugs, incomplete features, or other irregularities. Your patience and contributions are appreciated!

Planned Features

MVP (Minimum Viable Product)

  • Universe Generation with different zones and resources
  • Basic Resource Management
  • Simple Trading and Economy System (static prices)
  • Basic NPC Factions with random behaviors (select random action from list)
  • Real-world Time Management
  • Notifications for crucial events
  • Access game through basic CLI commands

Full Game

  • Universe Generation: A complex universe with multiple zones, each with unique resources, danger levels, and NPC populations.
  • Advanced Resource Management: Players and NPCs will gather a wide variety of resources from planets. They can send squads on missions that can last x amount of time. Create balance formula to decide resources collected depending on crew experience and ship equipment.
  • Dynamic Trading and Economy: A dynamic economy influenced by supply, demand, and world events.
  • NPCs Behavior: NPCs with complex behaviors, including trading, combat, and alliances. Use Finite State machines, Behavioral Trees, and Utility Systems to develop a complex NPC behavior.
  • Missions: Varied mission types, from exploration to combat.
  • Time Management: Missions and events will take real-world time to complete, allowing for multitasking.
  • World Events: Random events like natural disasters, market fluctuations, and legal changes affect the game world.
  • Taxes and Authorities: Keep an eye out for tax changes and authorities who may penalize illegal activities.
  • Reputation and Diplomacy: Build or break alliances with various factions based on your actions.
  • Notifications: Get notified about important game events.
  • News System: Stay updated on game happenings through in-game bulletins.
  • Starship Inventory: Fleet of ships management. Building, Repairs, ...
  • Crew Roster & Recruitment: Hire squad officers and crew members. Manage payrolls.
  • Auto-Save: Auto-Save after x amount of time
  • Technology Research: Unlock new features, ships and items through research.
  • Espionage and Sabotage: Damage other factions ships or steal plans (buildings, ships, ...)
  • Resource Processing: Convert raw materials into more valuable products.
  • Simulation: Planets should change their resource demand over time (population, world events, technology advancement)
  • UI: CLI commands and TUI to access game features

Additional Mechanics

  • Stock Market: Invest in different companies or planets and watch as your portfolio grows or shrinks based on in-game events.
  • Player-Owned Enterprises: Establish and manage your own businesses like trading companies or research labs.
  • Contracts and Trade Deals: Negotiate and establish long-term contracts for resources or protection.
  • Trade Embargoes: Adapt to new market conditions when trade is restricted by the Galactic Council.
  • Planet Colonization: Claim and develop uninhabited planets.
  • Quests and Achievements: Complete side quests and challenges for extra rewards.
  • Civil Unrest: Manage the happiness of your population to prevent revolts.
  • NPC Faction Alliances: Temporary or long-term alliances can form between NPC factions, affecting the game dynamics.
  • Insurance System: Protect your assets from unexpected losses through an insurance system.
  • Pirate Raids: Prepare to defend against or negotiate with pirate threats.

How to Contribute

We welcome contributions from everyone! Here's how you can contribute:

  1. Fork the Repository: Start by forking the repository to your GitHub account.
  2. Clone Locally: Clone your fork to your local machine.
  3. Set Up the Environment: Follow the installation instructions to set up the game on your local machine.
  4. Pick an Issue: Look for issues labeled 'good-first-issue' or 'help-wanted'.
  5. Create a New Branch: Create a branch for your work from the 'main' branch.
  6. Make Changes: Work on the issue in your branch.
  7. Test Your Changes: Ensure your changes don't break any existing functionality.
  8. Submit a Pull Request: Push your changes to your fork and open a pull request to the main repository.

FAQ

(TBA)

License

MIT License

About

Galactic Exchange is a real-time, background-running, command-line based space trading simulation. Players take on the role of a faction leader, managing resources, trading, establishing routes, handling faction politics, and exploring an expansive, procedurally generated universe.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages