mgrcd-live2d

Invite Magia Record characters to your mobile home screen or your desktop wallpaper.

Disclaimer

• Magia Record (magireco) is copyrighted by ©Magica Quartet/Aniplex・Magia Record Partners
• NEVER DISTRIBUTE generated data publicly. Enjoy for PRIVATE USE ONLY.
• This repository doesn't include any game contents.

What's this?

This is a Live2D model generator for Live2DViewerEX from magireco game contents.

Live2DViewerEX is not just a Live2D Viewer. It enables Live2D models to have more powerful expressions; that's powerful enough to embed magireco characters' behaviors like tap reactions into the models.

Features

The generated models behaves like magireco app's home. They reacts when they appeared or are tapped.

when	reaction	condition
appeared	自己紹介①	only first time
appeared	自己紹介②	possibly second time
appeared	ログイン①(初回ログイン時)	every time except for the above
tapped	ログイン②(朝)	from 6am to 9am
tapped	ログイン③(昼)	from 11am to 1pm
tapped	ログイン④(夜)	from 5pm to 7pm
tapped	ログイン⑤(深夜)	from 10pm to 0am
tapped	ログイン⑥(その他)	anytime except the above
tapped	ログイン⑦(AP最大時)
tapped	ログイン⑧(BP最大時)
tapped	魔法少女タップ①
tapped	魔法少女タップ②
tapped	魔法少女タップ③
tapped	魔法少女タップ④
tapped	魔法少女タップ⑤	8+ taps
tapped	魔法少女タップ⑥	16+ taps
tapped	魔法少女タップ⑦	24+ taps
tapped	魔法少女タップ⑧	32+ taps
tapped	(secret)	40+ taps
tapped	(hidden)	--spoiler flag and 48+ taps

Usage

Preparation

1. Install and launch magireco app to download the latest game contents locally
   • Optional download contents are not required.
2. Extract magireco game data files in /data/data/com.aniplex.magireco/files/madomagi/resource/
   • At least, files in image_native/live2d_v4/, scenario/json/general/ and sound_native/voice/ are required.
   • This step doesn't require magireco app running.
3. Decode HCA Audio into mp3 in sound_native/voice/ directory
   • vo_char_1001_00_01_hca.hca should be converted into vo_char_1001_00_01_hca.mp3
4. Install Deno on your computer to run this program
5. Install Live2DViewerEX via Steam or Google Play Store

Install

$ deno install -fn mgrcd-live2d --allow-read --allow-write --allow-env --allow-run --allow-net https://ghcdn.rawgit.org/reosablo/mgrcd-live2d/main/cli.ts

• --allow-env=MGRCD_RESOURCE doesn't work for now.
• --allow-run and --allow-net is required for upgrade command.
• You can upgrade mgrcd-live2d without upgrade command by running the above command again.

Generate Live2D models

Environment variable MGRCD_RESOURCE needs to be set to run each example.

# posix shell
$ export MGRCD_RESOURCE=/path/to/resource

# powershell
$env:MGRCD_RESOURCE = "\path\to\resource"

Generate Iroha Tamaki (School Uniform) model

$ mgrcd-live2d bake-ex-model 100101
Generated: /path/to/resource/image_native/live2d_v4/100101/model-100100.model3.json

100101 in input parameter is a chara id of Iroha Tamaki (School Uniform). To see all available chara ids, run mgrcd-live2d list-chara.

100100 in output filename is a scenario id of Iroha Tamaki's default behavior. To see all available scenario ids, run mgrcd-live2d list-scenario.

Generate Iroha Tamaki (School Uniform) model behaves like Christmas 2017 version

$ mgrcd-live2d bake-ex-model 100150 --cast 100150=100101
Generated: /path/to/resource/image_native/live2d_v4/100101/model-100150.model3.json

100150 in input parameter is a scenario id of Iroha Tamaki (2017 Christmas).

--cast 100100=100101 describes mapping of role id in scenario to chara id. To see all available scenario ids, run mgrcd-live2d list-role $scenario_id.

To be precise, 100101 in the former example is also a scenario id. scenario id 100101 doesn't exist so fall back to 100100 and implicitly add parameter like --cast 100100=100101.

Generate Iroha & Yachiyo (Final Battle ver.)

$ mgrcd-live2d bake-ex-model 130100
Generated: /path/to/resource/image_native/live2d_v4/130100/model-130100@130100.model3.json
Generated: /path/to/resource/image_native/live2d_v4/130100/model-130100@130102.model3.json

@130100 and @130102 in output filename is a role id of scenario 130100. The scenario includes 2 role ids: 130100 and 130102.

Generate all models

$ mgrcd-live2d bake-ex-model --all
Generated: /path/to/resource/image_native/live2d_v4/100100/model-100100.model3.json
Generated: /path/to/resource/image_native/live2d_v4/100101/model-100100.model3.json
...

All chara ids will be processed with no cast parameters.

Load generated Live2D models into Live2DViewerEX

Follow the instructions in the official Live2DViewerEX documents.

• https://live2d.pavostudio.com/doc/en-us/pc/quick-start/#load-model
• https://live2d.pavostudio.com/doc/en-us/android/manual/#model

About this project

• Known issues and feature plans are in backlog.