@bitshim/engine NPM

@bitshim/engine

A lightweight, high-performance core for browser-based game engines, providing Web Worker–based ticking and flexible loop management.

Why use this?

🚀 High-performance: Web Worker–driven simulation tick loop
🧠 Smart focus handling: Automatically throttles or pauses when hidden/unfocused
⟳ Multiple loops: Easily manage physics, simulation, rendering, etc.

@bitshim/engine

Installation

# npm
npm install @bitshim/engine

# yarn
yarn add @bitshim/engine

# bun
bun add @bitshim/engine

Quick Start

import { createEngine } from '@bitshim/engine';

function handleSimulationTick() {
  console.log('Running simulation step');
}

function handleRenderTick() {
  console.log('Rendering scene frame');
}

const engine = createEngine({
  loops: [
    {
      name: 'simulation',
      interval: 1000 / 60,
      callback: handleSimulationTick,
    },
    {
      name: 'rendering',
      interval: 1000 / 60,
      callback: handleRenderTick,
      reduceWhenUnfocused: true,
      pauseWhenHidden: true,
      unfocusedInterval: 1000 / 30,
    },
  ],
});

Other Loops

You can add more loops for background tasks, physics, or analytics:

function handlePhysicsTick() {
  console.log('Executing physics update');
}

engine.loopManager.registerLoop({
  name: 'physics',
  interval: 1000 / 20, // 20 FPS physics
  callback: handlePhysicsTick,
});

API Reference

`createEngine(options)`

Creates and initializes the core game engine.

Parameter	Type	Description
`loops`	`LoopConfig[]`	Array of loop configurations (required; must not be empty)
`hz`	`number`	Web Worker tick rate in Hz (default: `60`)
`autoStart`	`boolean`	Whether to start automatically on creation (default: `true`)