# libmmd-for-unity

**Repository Path**: moeleader/libmmd-for-unity

## Basic Information

- **Project Name**: libmmd-for-unity
- **Description**: A library for loading mikumikudance files at runtime in Unity 3D.
- **Primary Language**: C#
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2019-02-25
- **Last Updated**: 2021-03-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PS:If your system is windows which requires a windows version "I18N.CJK.dll" which can be found in your Unity Editor!---by superowner



# Libmmd-for-Unity

Libmmd-for-Unity is a Unity version of [libmmd](https://github.com/itsuhane/libmmd), which is for loading mikumikudance files at **runtime** in Unity 3D.

## Features

- support pmd, pmx 2.0, vmd and vpd file.
- support png, jpg, bmp, tga and dds format texture files.
- use Bullet Physics for physics calculation.
- async physics calculation, which improve the performance.
- support pre-calculation of physics. The result of bone motion can be saved to a file, which can be used to play the motion with the pre-calculated result.

## Usage

### Run demos

- Download the source code. 
- Play the scenes under the folder Assets/LibMmdDemo. You need to fill your mikumikudance model and motion path to the component under the "GameController" object before playing.

### Use in your project

- Copy the "Libmmd" directory and the "msp.rsp" file to your project.
- Copy the I18N.CJK.dll file to your plugin folder in your project. This file is for decoding Shift-JIS strings in mikumikudance files. You can find the file under your Unity 3D installation directory. 

## License

Libmmd-for-Unity is free software available under the 3-Clause BSD License. See the file license.txt for license conditions.

3rd party software licenses are under the "3rd-party-softwore-licenses" directory.

## 3rd party software

Libmmd-for-Unity makes use of the following 3rd party software:

- mmd-for-unity - Copyright (c) 2011, Eiichi Takebuchi, Takahiro Inoue, Shota Ozaki, Masamitsu Ishikawa, Kazuki Yasufuku, Fumiya Hirano. - provided under the 3-Clause BSD license.

  https://github.com/mmd-for-unity-proj/mmd-for-unity

- BulletSharpUnity3d - Copyright for portions of project BulletSharp and BulletSharpPInvoke are held by Andres Traks, 2013-2015 as part of project BulletSharpUnity3d - provided under the zlib/libpng License

  https://github.com/Phong13/BulletSharpUnity3d