Frent 0.2.1-alpha

Frent

A high preformance archetyped based ECS/ECF library for C#. Zero unsafe code and optimized to be just as fast.

Whaaaat?! Isn't there enough ECS libraries out there!

While Frent at its core is an archetype based ECS library, thats not why Frent was made. Frent is also an ECF - Entity Component Framework - that allows you to easily use composition for code reuse rather than inheritance with minimal boilerplate. Think Unity's Monobehavior but powered by the principles and speed of an ECS.

[!CAUTION] Frent is still in alpha, with an incomplete feature set. The api is unstable and there may be bugs!

Quick Example

using Frent;
using Frent.Components;
using System.Numerics;

using World world = new World();
Entity entity = world.Create<Position, Velocity>(new(Vector2.Zero), new(Vector2.One));

//Call Update to run the update functions of your components
world.Update();

//Alternatively, run a system by providing a delegate or a struct
world.Query((ref Position pos, ref Velocity vel) => pos.Value += vel.Delta);

// Position is <2,2>
Console.WriteLine(entity.Get<Position>().Value);

record struct Position(Vector2 Value);
record struct Velocity(Vector2 Delta) : IUpdateComponent<Position>
{
    public void Update(ref Position position) => position.Value += Delta;
}

Wanna start cooking? Check out the Cookbook!

Features

Implemented

• Entity struct the size of a 64 bits
• Up to 16 components per entity
• Getting, Adding, and Removing components
• Zero unsafe code
• Classes as components
• Structs as components
• Deconstructing entities
• Component memory stored contiguously (when using structs)
• All entity functions are O(1) and highly optimised
• Pass in uniform data e.g., deltaTime
• Deconstructing entities
• Zero reflection
• AOT Compatible
• Built in Uniform Provider implementation
• Programmical Entity Creation

Future

• Multithreading
• Entity relationships
• Tests
• Entity Tag