Install via NuGet

Docs / Getting started / Install via NuGet

Install ZenECS Core via NuGet for .NET projects (non-Unity).

Overview

ZenECS Core is available as a NuGet package for .NET Standard 2.1+ projects. This is ideal for:

Server Applications: Game servers, simulation servers
Standalone Tools: Command-line tools, utilities
Other Game Engines: Godot, MonoGame, etc.
Testing: Unit tests and integration tests

Installation

Via .NET CLI

dotnet add package ZenECS.Core --version 1.0.0

Via Package Manager

In Visual Studio:

Right-click project → Manage NuGet Packages
Search for ZenECS.Core
Click Install

Via PackageReference

Add to .csproj:

<ItemGroup>
  <PackageReference Include="ZenECS.Core" Version="1.0.0" />
</ItemGroup>

Via packages.config

Add to packages.config:

<packages>
  <package id="ZenECS.Core" version="1.0.0" targetFramework="netstandard2.1" />
</packages>

Requirements

.NET Standard 2.1 or higher
.NET Core 3.1+, .NET 5+, or .NET Framework 4.8+

Verify Installation

Check Package

dotnet list package

Should show:

ZenECS.Core    1.0.0

Test in Code

using ZenECS.Core;

class Program
{
    static void Main()
    {
        var kernel = new Kernel();
        var world = kernel.CreateWorld(null, "TestWorld");
        Console.WriteLine("ZenECS Core: OK");
    }
}

Project Types

Console Application

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net6.0</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="ZenECS.Core" Version="1.0.0" />
  </ItemGroup>
</Project>

Class Library

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netstandard2.1</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="ZenECS.Core" Version="1.0.0" />
  </ItemGroup>
</Project>

Next Steps

After installation:

Quick Start Guide - Build your first system
Core Concepts - Learn ECS concepts
Samples Overview - Explore examples