Skip to content

johny5w/Pulsar4x

 
 

Repository files navigation

ECS-CrossPlatform status: Build status

Pulsar4x

Join the chat at https://gitter.im/Pulsar4x/Lobby

A Fan work recreation of Aurora, a 4x space sim created by Steve Walmsley. Pulsar4x is being develop in in C#. The long term goal of the project is to produce a feature complete clone of Aurora.

Community

Main forum at: http://aurora2.pentarch.org/index.php/board,169.0.html

IRC channel #Pulsar4x on Freenode.
Gitter room at https://gitter.im/Pulsar4x/Lobby# (another chat system that uses your git account. messages are persistant and you can paste/drag and drop screenshots directly to the chat)

Bugs can be reported on the issue tracker.

Compiling Pulsar4x ECS-CrossPlatform branch:

To compile Pulsar4x we recommend VisualStudio 2015 Community Edition. we're starting to use a bit of C#6, so 2013 is not recomended unless you know what you're doing.
Xamarin Studio does work under windows, and the process is the same as for VS2015.

under linux you will need: MonoDevelop Mono-Complete and we recomended that you also install: Monodevelop-nunit (to run the unit tests) In monodevelop Tools -> Addin Manager -> Gallery install Eto.Forms Support Addin (this adds some autocomplete to the eto.forms xaml, and shows a live preview of forms as you code them, and adds some Templates for the eto.forms stuff.

under mac you will need:

Xamarin Studio ??? (probibly simular to the linux requirements as xamarin is a fork of monodevelop)

Another IDE option is the cross platform Rider from jetbrains: https://www.jetbrains.com/rider/
I'm currently using this under linux and I'm finding it a good option, though a bit heavier than MonoDevelop, it's lighter and more responsive than Visual studio. Although in beta it apears to have all the bells and whistles, and currently a lot easier to setup than MD, and a far faster install than VS.

Instructions:

  1. Clone the Git Repo.

  2. Open the solution file "Pulsar4X\Pulsar4X.sln".

  3. a. If you're running Windows: unload the GTK and Mac projects by right clicking them in the solution explorer (!Don't delete them!) (this should eventualy be fixed but at the time of this writing they're WIP.)

b. If you're running Linux: Our primary linux dev has disapeared into the either, but I've started attempting to dev on linux mint. wish me luck...
install monodev and mono-complete. (bare minimum) open the Pulsar4x.sln in monodevelop.

c. If you're running Mac: welcome to the team! we don't currently have a mac specialist, feel free to take on the challenge! you'll need xamarin studio to compile it for mac, there is a dedicated mac project, but that is missing the OpenTK lib. as I dont' have access to mac I'm unable to test or fix this. you can however run the gtk project, which has some bugs I'm hoping will get fixed when a new version of eto.forms comes out.

  1. a. if you're running Windows Set Pulsar4x.CrossPlatform.WPF project as the startup project. you should be able to build and/or run from there.
    b. Linux: Set Pulsar4x.CrossPlatform.Gtk2 as teh startup project. if you have problems building and running try unloading the WPF, Mac and Test projects. c. Mac: See 3c

Note! there are a number of nuget packages that VS should automaticaly get the first time you attempt to build. the IDE will have a number of errors, build the solution anyway, VS will get the packages for you.

You can also run the gtk2 project in visual studio, this will help with debugging linux side of things as visual studio debugger apears to be superior to monodevelop. there currently apear to be some null refference exceptions that get hit when running from the GTK2 project that don't happen in the wpf.

##Working with the code: I need to flesh this section out a bit more, but for now, read the pages in the wiki, or ask me on IRC.

About

A Fan work recreation of Aurora4x in C#

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 99.7%
  • Other 0.3%