Human Space Program

Hello there!

Human Space Program (HSP for short) is a free and open source realistic spaceflight game inspired by Kerbal Space Program, currently in pre-alpha development phase.

Table of Contents:

1. Introduction
   1. Goals and Features
2. Installation
   1. Prebuilt Binaries
   2. Unity Editor
3. Contributing
   1. Ways to Contribute
4. License
5. Additional Links

Introduction:

Goals and Features:

Human Space Program aims to create a realistic spaceflight game with hopefully a relatively low barrier of entry (comparatively speaking) that is easy to mod.

• Free of Charge - HSP is and will forever be available for free for everyone.
• Open Source - Contribute to the project.

If you like Kerbal Space Program, you will also like this.

• Real Scale Systems - The Earth, the Solar System, and real world-sized rockets.
• Modular Rockets - Build rockets from parts, which themselves may consist of even more parts.
• Highly Flexible - Replace any system you want using mods.

Installation:

Prebuilt Binaries:

You can download prebuilt binaries from the releases section on GitHub. Download the appropriate file for your operating system, extract it, and run the executable to start playing. There is no installation process - simply unzip and double-click on the executable. :D

Unity Editor:

If you prefer to build HSP from source or want to contribute to its development, you can follow the steps below.

Prerequisites:

• Unity Editor - Version 2022.1.8f1 (as of 2024/07/10). HSP will transition to Unity 6 sometime in the future.
• Git or a Git client - To clone the repository (optional).

Running in the editor:

1. Clone the repository or download as ZIP.
2. Download the Unity Editor:
   • Download and install Unity Hub from the Unity website.
   • Use Unity Hub to download the Unity Editor version specified above.
3. Press the Add button and locate the HumanSpaceProgram directory. Note that it is not the root directory, but one level deeper.
4. Once the Unity Editor finishes loading, navigate to the ___Scenes directory within the editor and double-click the _AlwaysLoaded scene to open it.
5. Now when you press Play, it will handle the rest.

Building from source:

1. Clone the repository or download as ZIP.
2. Download the Unity Editor:
   • Download and install Unity Hub from the Unity website.
   • Use Unity Hub to download the Unity Editor version specified above.
3. Press the Add button and locate the HumanSpaceProgram directory. Note that it is not the root directory, but one level deeper.
4. Once the Unity Editor finishes loading, go to File > Build Settings, select your operating system and CPU architecture, and press Build.
5. Once Unity finishes the build process, copy the HumanSpaceProgram/GameData directory inside the build folder.
6. Now you can double-click the HumanSpaceProgram.exe and launch the game.

Contributing:

Contributions are always welcome! See the Contributing Guide for more information.

Ways to Contribute:

• Reporting Bugs - If you encounter any issues, please report them on GitHub.
• Suggesting Enhancements - Have an idea for a new feature? Open an issue on GitHub to share your thoughts.
• Submitting Pull Requests - Ready to write some code? Fork the repository, make your changes, and submit a pull request.

License:

Human Space Program is licensed under AGPL-3.0

Additional Links:

• Human Space Program creator's official Discord server
• Reddit

Thank you for your interest in Human Space Program! :heart: