@primitiv/server

Status: Prototype - API is unstable and may change between minor versions.

Authoritative game server runtime for the Primitiv engine. Runs on Node.js with uWebSockets.js and WebRTC data channels.

Installation

pnpm add @primitiv/engine @primitiv/server

Quick start

import { RuntimeServer } from '@primitiv/server';

Subpath exports

import { Engine, Display, User } from '@primitiv/server/core';
import { Vector2, ScalingMode }  from '@primitiv/server/types';
import { NetworkServer }         from '@primitiv/server/network';

Requirements

• Node.js >= 18.0.0

Bundle size

Server JS runtime (import { RuntimeServer } from "@primitiv/server"):

| Format | Minified | Gzip | Brotli | |--------|----------|------|--------| | ESM | 106.1 KB | 30.7 KB | 26.2 KB | | CJS | 106.8 KB | 31.0 KB | 26.5 KB |

Native dependencies (uWebSockets.js, node-datachannel): ~11.4 MB per platform (prebuilt N-API binaries).

📄 License

Apache-2.0 - See LICENSE.txt.