Skip to content

AximoGames/AxEngine

Repository files navigation

Join Discord https://discord.gg/wMCNgFC License Actions Status CodeFactor

Documentation: http://www.aximo.games

Aximo Game Engine is written purly in C#.

Features

  • Free Open Source
  • Platform independent (runs on Windows & Linux)
  • Code first: everything is defined as code.
  • Multi-Threaded
  • Dynamic Mesh Creation and Manipulation
  • Several Geometry Components.
  • Phong-Lighning
  • Multiple Lights with Shadows (Directional- and Pointlights)
  • Deferred and forward shading (can be mixed)
  • UI Components (Buttons, Panels, Labels, Performance Statistics)
  • Custom Shaders / Materials
  • Asset Management (incl. dynamic generation on-the-fly)
  • Scene Management via Actors, Components and relative transformations.
  • Audio (only global).
  • Flexible Vertex data layout.

Small sample

mkdir mkdir TestGame
cd TestGame
dotnet new console # create a new console application

dotnet add package Aximo
using Aximo;
using Aximo.Engine;
using Aximo.Engine.Components.Geometry;
using Aximo.Engine.Components.Lights;
using OpenToolkit.Mathematics;

internal class Program
{
    public static void Main(string[] args)
    {
        new MyApplication().Start();
    }
}

public class MyApplication : Application
{
    protected override void SetupScene()
    {
        // it's not required, but we should have a least one light.
        SceneContext.AddActor(new Actor(new PointLightComponent()
        {
            Name = "StaticLight",
            RelativeTranslation = new Vector3(2f, -1.5f, 3.25f),
        }));

        // add a cube
        SceneContext.AddActor(new Actor(new CubeComponent()
        {
            Name = "Box1",
            RelativeRotation = new Vector3(0, 0, 0.5f).ToQuaternion(),
            RelativeScale = new Vector3(1),
            RelativeTranslation = new Vector3(0, 0, 0.5f),
            Material = new Material
            {
                Color = new Vector4(1, 0, 1, 1),
            },
        }));
    }
}

Run your application via dotnet run.

Contributing

We are open for every kind of pull request. Response time is normally below 24 hours. You can also meet us in discord.

Build the engine from source

To clone this repository, (currently) you need git LFS, otherwise you need to download the Assets folder manually.

Don't forget the --recursive option:

git clone --recursive https://github.com/AximoGames/AxEngine.git

Build from command line:

cd AxEngine
dotnet build

Run the shipped sample:

dotnet run -p Demo
Keymapping:
C -> Control Camera (default)
B -> Control Box1
L -> Control static light
J -> Move Camera to current controlling object

W, S, A, D -> Moving object in XY.
PageUp, PageDown -> Moving object in Z.
Arrows -> Rotate

ESC -> Quit

About

Aximo Game Engine is an open source 3D Game Engine written in C#

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published