Kiwi Engine

Quick Start

1. Install kiwiengine in your project. npm install kiwiengine
2. Create a Renderer and configure layers.
3. Create a GameObject and add it to renderer.

import { Renderer, GameObject } from 'kiwiengine'

const renderer = new Renderer(document.body, {
  layers: [
    { name: 'background', drawOrder: 0 },
    { name: 'game',       drawOrder: 1 },
    { name: 'ui',         drawOrder: 2 },
  ]
})

const player = new GameObject({ x: 0, y: 0, layer: 'game' })
renderer.add(player)

Core Concepts

• Center-Origin Coordinates — The canvas center is (0,0). Use screenToWorld(x,y) for screen→world conversion.
• Responsive Canvas — Automatically resizes to match the parent element.
• Layers/Camera — Control draw order and pan/zoom the camera.
• Time-based Updates — Ticker provides dt in seconds; debug mode caps unfocused tabs at 6 FPS.

Main Nodes

• GameObject — Transform (position/rotation/scale/layer), children management.
• SpriteNode / AnimatedSpriteNode — Texture/spritesheet rendering.
• BitmapTextNode — Bitmap-font text rendering.
• CircleNode / RectangleNode — Primitive shapes.
• SpineNode — Spine animation.
• ParticleSystem — Simple burst particles.
• Dom* — DOM-based nodes (sprite/animated/particle/container).

Collision/Physics

• checkCollision — Supports rect/circle/ellipse/polygon.
• PhysicsWorld / PhysicsObject — Gravity/collision simulation with render transform sync.

Audio

• musicPlayer — BGM player (volume persisted in localStorage).
• sfxPlayer — Lightweight sound effects.

Debug

Toggle debug mode with enableDebug(). Unfocused tabs run at a fixed 6 FPS step in debug.