Home

Welcome to the Live2D-JavaBinding Wiki

This project provides a high-performance, native Java binding for the Live2D Cubism SDK. It allows you to load, render, and interact with Live2D models directly in your Java applications using OpenGL or Vulkan.

Vulkan backend scope is currently limited to linux-x64 and windows-x64. Other targets continue to use OpenGL.

Philosophy

The library is designed to be unopinionated about your windowing system. Whether you use LWJGL, JOGL, or even JavaFX (with an OpenGL bridge), this binding provides the raw tools to render the model. We handle the JNI complexity; you handle the context.

Navigation

• Getting Started: Installation and your first model.
• Lifecycle Management: Starting up and shutting down the native core safely.
• Loading Assets: How to load .moc3 files, textures, physics, and poses.
• Rendering Loop: The essential update and draw cycle.
• Motion & Expressions: Bringing the model to life with animations.
• Interaction & Parameters: Hit testing, eye tracking, and manual parameter control.