Skip to content

插件系统

Minecraft Skin Renderer 使用插件架构来保持核心的轻量化,同时提供可扩展的功能。

插件类型

项目包含两类插件:

渲染器插件

渲染器插件提供不同的图形后端实现,通过 use() 注册:

  • WebGLRendererPlugin — 基于 WebGL2 的渲染器
  • WebGPURendererPlugin — 基于 WebGPU 的渲染器
ts
import { use } from "@daidr/minecraft-skin-renderer";
import { WebGLRendererPlugin } from "@daidr/minecraft-skin-renderer/webgl";

use(WebGLRendererPlugin);

注意

渲染器插件必须在调用 createSkinViewer() 之前注册。

功能插件

功能插件为 viewer 添加额外能力:

  • PanoramaPlugin — 全景图背景
ts
import { use } from "@daidr/minecraft-skin-renderer";
import { PanoramaPlugin } from "@daidr/minecraft-skin-renderer/panorama";

use(PanoramaPlugin);

按需加载

得益于 ESM 模块化设计和独立的入口点,你只需导入实际使用的插件。未导入的插件不会被打包到最终产物中,实现真正的树摇优化。