Welcome to the Hero6 project. This readme should be included in your copy of Hero6, it is also available in the source code repository. The Hero6 project started in 1999, the project was shut down and the game files released to public in 2011, until it was rebooted by a new team in 2013.

• Links
• Sponsors
• Build
• Contribution
• Changelog
• License

• Homepage
• Facebook
• Twitter
• Google+
• Developer Forum
• GitHub - Development
• GitHub - Releases
• Sourceforge - Historical Prototypes Download

The Windows Installer is made with Advanced Installer on an open source license. Advanced Installer allowed us to create a feature complete installer in a user friendly environment with minimal effort.

	Debug	Release
master	-	-
Windows (DirectX)
Windows (OpenGL)

	Debug	Release
master	-	-
Ubuntu 12.04.5 LTS and OS X 10.11.6 El Capitan

Ideally, we want anyone to be able to build Hero6 on any OS with any IDE. This is an ongoing task and we continue our efforts to make that possible. Currently, we can guarantee that it will work on Windows with Visual Studio 2015.

• To clone the repo you will need git, you will also need git-lfs as we use this to store assets like graphics and audio.
  • If you do not have git-lfs installed you will still be able to clone the repo, but all assets will be corrupt. You can verify if you have it installed with the command git lfs
  • You can use git however you prefer, by bash, GUI frontends like Git Extensions, or whatever git support may be integrated in your IDE of choice. Just make sure that git lfs is working.
• To build you will need an IDE with MonoGame v3.5 installed. Typically, this will be Visual Studio, but you could also use MonoDevelop/Xamarin Studio. Refer to the MonoGame web pages on how to set up MonoGame with your IDE.
  • We have setup MonoGame in our repository using donwloadable packages, however it is important that you also install MonoGame standalone as it provides the "MonoGame Pipeline" tool. This tool is required to build assets in a format compatible across platforms.
  • If you are not a dedicated coder or contributor to the Hero6 project and want to check out the bleeding-edge builds, you will most likely prefer MonoDevelop/Xamarin Studio. While the Visual Studio IDE takes hours to install and requires several GBs of your disk, Xamarin Studio installs in a few minutes and requires approximately 100+ MBs.
  • Rider EAP has been tested and works with Hero6. However, we will not maintain this compatibility until Rider receives a public release and its conditions for use are well defined.
  • If you want to run our unit tests and are also using Visual Studio you will need the NUnit3 Test Adapter.
  • If you want to build the Windows installer you will need Advanced Installer with a professional License, they also offer Visual Studio Extensions.

1. Fork the project.
2. Clone the source git clone https://github.com/YourHero6Repository/Hero6.git.
3. You will need to obtain packages of 3rd party frameworks.
   1. Navigate into the directory ".paket".
   2. Run the command paket.bootstrapper. This will download the most recent and stable version of Paket to the same directory.
   3. Run the command paket restore. In the root directory of your local repository you should now have a new folder "packages".
4. Open "Hero6.sln" with the IDE of your choice.
5. Set the build configuration to the platform you want to work with. We have individual Debug and Release configurations for each platform.
   • The default "Debug" and "Release" refers to the Hero6.DesktopGL project.
   • "WindowsDX Debug" and "WindowsDX Release" refers to the Hero6.WindowsDX project.
   • "Android Debug" and "Android Release" refers to the Hero6.Android project.
6. Set startup project to the project that corresponds with your configuration, "Hero6.Android", "Hero6.DesktopGL" or "Hero6.WindowsDX".
7. Build.
8. Run.

Theoretically, you should be able to build and run Hero6 on Linux and OS X, but this is not something we maintain right now, and we do not intend to do this until we have a working CI build server in place.

• Windows (DirectX)
  • Requires a minimum of Windows 7 SP 1.
  • Requires Microsoft .NET Framework 4.6.1.
  • Requires DirectX 9.0c.
• Windows (OpenGL)
  • Requires a minimum of Windows 7 SP 1.
  • Requires Microsoft .NET Framework 4.6.1.

Theoretically the OpenGL Windows build should also work with Linux and OS X, but this goes unsupported and unmaintained for now. We also have a build configuration for Android but we do not maintain it.

If you are interested in contributing to Hero6 you should read our Getting Started Document.

If you have any general questions that are non development related about Hero6 you can reach us on our forums, or IM. We're also available on Facebook and Twitter.

A changelog listing what is new and happening for each version release is at CHANGELOG.md.

Licensing details are available at LICENSE.md.