为什么值得关注

它完全从头实现 Live2D 模型渲染，不包含任何专有代码，采用 MIT/Apache2 双许可，并提供基于 wgpu 的高质量跨平台参考渲染器。

适合谁使用

需要 Live2D 模型支持的游戏开发者
VTuber 及直播工具构建者
对图形/渲染感兴趣的 Rust 程序员
需要嵌入网页木偶查看器的开发者

典型使用场景

在 Rust 游戏或应用中渲染 Live2D 模型
构建实时木偶动画的 VTubing 应用
嵌入用于摆姿势和导出 Live2D 模型的网页演示
研究文件格式兼容性的净室逆向工程方法

项目优势

纯 Rust 实现，确保内存安全，无效模型不会导致未定义行为
通过 wgpu 实现跨平台渲染（Vulkan、Metal、DirectX、OpenGL、WebGL/WebGPU）
免费且许可宽松（MIT 或 Apache2），无需版税或许可
高质量渲染：1:1 像素遮罩、正确的预乘 alpha、sRGB/线性混合

使用前须知

API 不稳定且缺乏文档；尚未发布到 crates.io
模型验证有限，不一致的模型可能导致 panic
功能不完整——物理、动画、表情和姿势文件支持仍在待办列表中

README 快速开始

Ayagami: Open source 2D puppet rendering SDK

Web Demo

Ayagami (彩紙) is a 2D puppet model loading and rendering library written in Rust. It is designed to be compatible with models in the Live2D model format, while being extensible to new model formats and features in the future.

Ayagami is completely free software dual licensed under the MIT and Apache2 licenses. You may use it for any purpose as long as you abide by your choice of either license, without having to pay any royalties or obtain permission from anyone. This includes any use cases, including both games with built-in models and expandable applications that load user-provided models.

This software is developed strictly using black-box reverse engineering only. That means that it is a complete, from-scratch, independent implementation, and no license terms were violated during its development. We have never and will never disassemble or decompile any proprietary software in order to develop this project. To guarantee this, we have a strict contributor policy.

Demo

Check out the Web demo & model poser! This demo runs entirely in your browser, and your model data is not sent anywhere outside your machine. You can use it to manually pose your model (high quality screenshot feature coming soon).

You can also build and run the demo as a native app by running cargo run -r in the ayagami-demo directory. Use trunk serve --release instead to run the web version locally (using trunk).

Status

The API is pretty unstable and subject to change, and there is no documentation yet! crates.io release coming soon. For now, take a look at ayagami-demo for a usage example.

The code is messy; I'm releasing this early to get feedback on the API and start enabling users, but expect significant cleanup over time.

Supported features

MOC3 file loading & features up to SDK 5.0: Parts, ArtMeshes, Rotation & Warp deformers, Glue, Blendshape Parameters, etc.
Computing the final ArtMeshes given a model & parameters: driver
- Live2D-equivalent interpolation, extrapolation, and deformer chaining algorithms
Reference renderer using wgpu-rs: ayagami-render (supports Vulkan, Metal, DirectX,

项目描述

2D puppet model renderer compatible with Live2D

ayagami