@live2d-loader/core

Framework-agnostic core engine for live2d-loader. Provides the loading pipeline, model management, event system, and render loop — with zero UI dependencies.

Install

# npm
npm install @live2d-loader/core

# yarn
yarn add @live2d-loader/core

# pnpm
pnpm add @live2d-loader/core

# bun
bun add @live2d-loader/core

Usage

import { createLive2DLoader } from '@live2d-loader/core';

const loader = createLive2DLoader({
  adapters: [/* your adapters */],
  renderer: /* your renderer */,
});

loader.mount(canvas);
await loader.loadModel('https://cdn.example.com/model/index.json');

loader.on('load:complete', (e) => console.log('Loaded:', e.modelId));
loader.on('hit', (e) => console.log('Hit:', e.hitArea));

API

• createLive2DLoader(options) — Create a loader instance
• loader.mount(canvas) — Attach to a canvas and start rendering
• loader.loadModel(source, options?) — Load a model by URL
• loader.removeModel(id) — Remove a loaded model
• loader.on(event, listener) / loader.off(event, listener) — Event subscription
• loader.destroy() — Release all resources

See the main README for full documentation.

License

MIT