UltravioletFramework / ultraviolet

The Ultraviolet Framework is a .NET game development framework written in C#.
https://github.com/UltravioletFramework/ultraviolet/wiki
MIT License
542 stars 46 forks source link
c-sharp fna game-development game-engine-framework graphics monogame xna

For questions and discussion, check out our Discord.

What is Ultraviolet?

![Join the chat at https://discord.gg/ehQMumHJ]

Ultraviolet is a cross-platform, .NET game development framework written in C# and released under the MIT License. It is heavily inspired by Microsoft's XNA Framework, and is intended to be easy for XNA developers to quickly pick up and start using. However, unlike MonoGame and similar projects, Ultraviolet is not intended to be a drop-in replacement for XNA. Its current implementation is written on top of SDL2 and OpenGL, but its modular design makes it (relatively) easy to re-implement using other technologies if it becomes necessary to do so in the future.

At present, Ultraviolet officially supports Windows, Linux, and macOS using .NET 6, as well as Android through Xamarin. Support for iOS is no longer provided due to a lack of the requisite development hardware. If anyone wants to take responsibility for providing this support, please Create an issue.

Some core features of the Ultraviolet Framework:

The Ultraviolet Framework's source code is available on GitHub.

Getting Started

If you don't want to build Ultraviolet yourself, official packages are available through NuGet.

The wiki contains a quick start guide for development using .NET 6.

A dedicated repository contains a number of sample projects which demonstrate various features of the Framework.

Requirements

Ultraviolet can be used with any version of .NET which supports .NET Standard 2.1.

Building Ultraviolet requires .NET 6 SDK.

Building the mobile projects requires the appropriate Xamarin tools to be installed.

The following platforms are supported for building the Framework:

Please file an issue if you encounter any difficulty building on any of these platforms. Linux distributions other than Ubuntu should work, assuming that they can run .NET 6 and you can provide appropriate versions of the native dependencies, but only Ubuntu has been thoroughly tested.

Building

Desktop Platforms

The Sources folder contains several solution files for the various platforms which Ultraviolet supports. Alternatively, you can run msbuild Ultraviolet.proj from the command line in the repository's root directory; this will automatically select and build the correct solution for your current platform, and additionally will copy the build results into a single Binaries folder.

Mobile Platforms

Building Ultraviolet for Android requires that Xamarin be installed. As with the desktop version of the Framework, you can either build the appropriate solution file or Ultraviolet.proj, but in the latter case you must also explicitly specify that you want to use one of the mobile build targets, i.e.:

msbuild Ultraviolet.proj /t:BuildAndroid