Development

Prerequisites and Development environment

Windows

1. Install Visual Studio. The community edition works great and is free!
2. Clone the repository or download a source ZIP.
3. In the source code folder you'll find a file named runprebuild.bat - run this file to copy needed files to the bin folder so that you can compile.
4. Open the resulting project file in Visual Studio and build the solution! (Build menu, Build Solution)

NOTE: If you downloaded a release zipfile under windows and compiled it, you will have to unblock all executable files in the /bin directory before halcyon will run properly. This can be done by using powershell as noted here: https://marcofranssen.nl/unblock-downloaded-files-with-powershell/

NOTE 2: If you see an error like [Failure] Could not find file 'OpenSim\Framework\Servers\VersionInfo.cs' ignore it and build anyway: the build system will fix it automatically.

NOTE 3: If the first build fails complaining about missing DLLs, try again, sometimes NuGet gets confused. If it does it twice in a row you may have forgotten to run runprebuild.bat first.

Ubuntu Linux 64bit

Linux support is a work in progress. Right now it builds, but may not run like it should.

1. Install Mono and MonoDevelop - yes, you need to grab it from there, the version of Mono in the standard repositories are often very out of date.
2. Clone the repository or download a source ZIP.
3. In the source code folder you'll find a file named runprebuild.sh - run this file to copy needed files to the bin folder so that you can compile.
4. Open the resulting project file in MonoDevelop and build it!

Collaboration, Development, Debugging

While there are several ways to go once you've decided you want to dig in, the best way is to fork the repo, make our changes to your fork, and then send us a pull request!

Deploying / Installing

For what you need to get what you've compiled running, see the Installation page.