Add mod documentation in seven languages
This commit is contained in:
cthangover committed
1 parent
286fd747dc
commit
5b3c538c00
16 files changed
+442
-8
No files matched your search
Binary file not shown.
|
After Width: | Height: | Size: 40 KiB |
+62
@@ -0,0 +1,62 @@
|
|||||||
|
# Live2D Cubism — animated 2D characters
|
||||||
|
|
||||||
|
Live2D Cubism brings Live2D models into the game: drawn characters that breathe, blink, follow a point, move with physics (hair, clothes) and play the motions and expressions their artist made. It contains the Cubism runtime for C# and its native core libraries; other mods use it to show a model in a scene.
|
||||||
|
|
||||||
|
It is an optional block of the Cthangover game. The current story content still uses still portraits, and no built-in game ships a Live2D model yet; the mod's own demo shows a working model.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## What a model can do
|
||||||
|
|
||||||
|
- **Idle life** — automatic blinking (on by default) and breathing (off by default).
|
||||||
|
- **Physics** — hair and clothes swing according to the model's `physics3.json`.
|
||||||
|
- **Looking** — the head and eyes turn toward a target point; the demo lets you drag the mouse over the character to steer them.
|
||||||
|
- **Motions and expressions** — play a motion from a group (`mtn_01`…) or set an expression (`exp_01`…) defined in the model.
|
||||||
|
- **Parameters** — set any of the model's parameters directly, as in the picture above, where the right arm is raised by one parameter.
|
||||||
|
- **Placement** — the model is fitted to its area automatically, or placed at a given position and scale.
|
||||||
|
|
||||||
|
## Model requirements
|
||||||
|
|
||||||
|
A model is the standard Cubism export folder, kept inside a mod:
|
||||||
|
|
||||||
|
```filestree
|
||||||
|
my_mod/
|
||||||
|
└── models/
|
||||||
|
└── runtime/
|
||||||
|
├── ren.model3.json the entry file you point to
|
||||||
|
├── ren.moc3
|
||||||
|
├── ren.physics3.json
|
||||||
|
├── ren.cdi3.json
|
||||||
|
├── ren.4096/texture_00.png
|
||||||
|
├── expressions/exp_01.exp3.json …
|
||||||
|
└── motions/mtn_01.motion3.json …
|
||||||
|
```
|
||||||
|
|
||||||
|
- The model is a Cubism model (`.moc3` with a `model3.json`). The demo model is made with Cubism 5.3 and uses its masks and offscreen drawing.
|
||||||
|
- The native Cubism core is included for Windows (`.dll`) and Linux (`.so`).
|
||||||
|
- Sample models come with Live2D's own licence; read the model's `ReadMe.txt` before publishing it.
|
||||||
|
|
||||||
|
## Show a model from a scenario
|
||||||
|
|
||||||
|
The `add_live2d_model` action puts a model into the scene's view:
|
||||||
|
|
||||||
|
```scenario
|
||||||
|
action add_live2d_model model_path=models/runtime/ren.model3.json mod_id=my_mod node_name=Ren x=960 y=540 scale=0.5
|
||||||
|
```
|
||||||
|
|
||||||
|
- `model_path` — the `model3.json`, relative to the mod's folder;
|
||||||
|
- `mod_id` — the mod that contains it;
|
||||||
|
- `node_name` — a name for this model in the scene (a second action with the same name is ignored);
|
||||||
|
- `x`, `y`, `scale` — optional position and size; without them the model is fitted automatically.
|
||||||
|
|
||||||
|
A mod with code can create a model with `Live2DService.CreateModel(...)` and then call `StartMotion(group, number)`, `StartExpression(id)`, `SetLiveParameter(id, value)` or `SetTargetPoint(x, y)` on it.
|
||||||
|
|
||||||
|
## The demo
|
||||||
|
|
||||||
|
The mod's **avatar** test suite contains the sample model Ren. When it is turned on, Ren appears outside the villa in Cthangover and follows mouse drags; its automatic check raises the right arm and compares the frames. It is a developer demo and is off in normal play.
|
||||||
|
|
||||||
|
## If something goes wrong
|
||||||
|
|
||||||
|
1. **No model and a log message about `model_path` or the mod.** The path is relative to the mod's folder and must point to the `model3.json`; `mod_id` must be the id of the mod that has it.
|
||||||
|
2. **The model appears in the wrong place or size.** Give `x`, `y` and `scale`, or leave all three out for automatic fitting.
|
||||||
|
3. **The model does not load on a platform.** The Cubism core library is provided for Windows and Linux only.
|
||||||
+62
@@ -0,0 +1,62 @@
|
|||||||
|
# Live2D Cubism — personajes 2D animados
|
||||||
|
|
||||||
|
Live2D Cubism trae modelos de Live2D al juego: personajes dibujados que respiran, parpadean, siguen un punto, se mueven con física (pelo, ropa) y reproducen los movimientos y expresiones que hizo su artista. Contiene el runtime de Cubism para C# y sus bibliotecas nativas del núcleo; otros mods lo usan para mostrar un modelo en una escena.
|
||||||
|
|
||||||
|
Es un bloque opcional del juego Cthangover. El contenido de la historia actual sigue usando retratos fijos, y todavía ningún juego integrado incluye un modelo Live2D; la demo propia del mod muestra un modelo en funcionamiento.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## Lo que puede hacer un modelo
|
||||||
|
|
||||||
|
- **Vida en reposo** — parpadeo automático (activado por defecto) y respiración (desactivada por defecto).
|
||||||
|
- **Física** — el pelo y la ropa se mueven según el `physics3.json` del modelo.
|
||||||
|
- **Mirar** — la cabeza y los ojos giran hacia un punto objetivo; en la demo puedes arrastrar el ratón sobre el personaje para dirigir su mirada.
|
||||||
|
- **Movimientos y expresiones** — reproducir un movimiento de un grupo (`mtn_01`…) o poner una expresión (`exp_01`…) definidas en el modelo.
|
||||||
|
- **Parámetros** — fijar directamente cualquier parámetro del modelo, como en la imagen de arriba, donde un solo parámetro levanta el brazo derecho.
|
||||||
|
- **Colocación** — el modelo se ajusta solo a su área, o se coloca en una posición y escala dadas.
|
||||||
|
|
||||||
|
## Requisitos del modelo
|
||||||
|
|
||||||
|
Un modelo es la carpeta de exportación estándar de Cubism, guardada dentro de un mod:
|
||||||
|
|
||||||
|
```filestree
|
||||||
|
my_mod/
|
||||||
|
└── models/
|
||||||
|
└── runtime/
|
||||||
|
├── ren.model3.json el archivo de entrada al que apuntas
|
||||||
|
├── ren.moc3
|
||||||
|
├── ren.physics3.json
|
||||||
|
├── ren.cdi3.json
|
||||||
|
├── ren.4096/texture_00.png
|
||||||
|
├── expressions/exp_01.exp3.json …
|
||||||
|
└── motions/mtn_01.motion3.json …
|
||||||
|
```
|
||||||
|
|
||||||
|
- El modelo es un modelo Cubism (`.moc3` con un `model3.json`). El modelo de demo está hecho con Cubism 5.3 y usa sus máscaras y su dibujo fuera de pantalla.
|
||||||
|
- El núcleo nativo de Cubism viene incluido para Windows (`.dll`) y Linux (`.so`).
|
||||||
|
- Los modelos de ejemplo tienen la licencia propia de Live2D; lee el `ReadMe.txt` del modelo antes de publicarlo.
|
||||||
|
|
||||||
|
## Mostrar un modelo desde un escenario
|
||||||
|
|
||||||
|
La acción `add_live2d_model` pone un modelo en la vista de la escena:
|
||||||
|
|
||||||
|
```scenario
|
||||||
|
action add_live2d_model model_path=models/runtime/ren.model3.json mod_id=my_mod node_name=Ren x=960 y=540 scale=0.5
|
||||||
|
```
|
||||||
|
|
||||||
|
- `model_path` — el `model3.json`, relativo a la carpeta del mod;
|
||||||
|
- `mod_id` — el mod que lo contiene;
|
||||||
|
- `node_name` — un nombre para este modelo en la escena (una segunda acción con el mismo nombre se ignora);
|
||||||
|
- `x`, `y`, `scale` — posición y tamaño opcionales; sin ellos el modelo se ajusta automáticamente.
|
||||||
|
|
||||||
|
Un mod con código puede crear un modelo con `Live2DService.CreateModel(...)` y luego llamar `StartMotion(group, number)`, `StartExpression(id)`, `SetLiveParameter(id, value)` o `SetTargetPoint(x, y)`.
|
||||||
|
|
||||||
|
## La demo
|
||||||
|
|
||||||
|
El conjunto de pruebas **avatar** de este mod contiene el modelo de ejemplo Ren. Cuando se activa, Ren aparece fuera de la villa en Cthangover y sigue los arrastres del ratón; su comprobación automática levanta el brazo derecho y compara los fotogramas. Es una demo para desarrolladores y está apagada en el juego normal.
|
||||||
|
|
||||||
|
## Si algo falla
|
||||||
|
|
||||||
|
1. **No hay modelo y el log habla de `model_path` o del mod.** La ruta es relativa a la carpeta del mod y debe apuntar al `model3.json`; `mod_id` debe ser el id del mod que lo contiene.
|
||||||
|
2. **El modelo aparece en un lugar o tamaño equivocados.** Da `x`, `y` y `scale`, o no des ninguno de los tres para el ajuste automático.
|
||||||
|
3. **El modelo no carga en una plataforma.** La biblioteca del núcleo de Cubism solo existe para Windows y Linux.
|
||||||
+62
@@ -0,0 +1,62 @@
|
|||||||
|
# Live2D Cubism——動く 2D キャラクター
|
||||||
|
|
||||||
|
Live2D Cubism は、Live2D モデルをゲームに持ち込みます: 描かれたキャラクターが呼吸し、まばたきし、一点を見つめ、物理(髪、服)で動き、絵師が作ったモーションと表情を再生します。C# 用の Cubism ランタイムとそのネイティブコアライブラリを含み、ほかの mod はこれを使ってシーンにモデルを表示します。
|
||||||
|
|
||||||
|
Cthangover ゲームの任意のブロックです。現在のストーリーコンテンツはまだ静止ポートレートを使っており、内蔵ゲームはどれも Live2D モデルを同梱していません。mod 自前のデモが動くモデルを見せてくれます。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## モデルにできること
|
||||||
|
|
||||||
|
- **待機のいのち** — 自動まばたき(既定でオン)と呼吸(既定でオフ)。
|
||||||
|
- **物理** — 髪や服が、モデルの `physics3.json` に従って揺れます。
|
||||||
|
- **視線** — 頭と目が目標点へ向きます。デモでは、キャラクターの上をマウスでドラッグして視線を導けます。
|
||||||
|
- **モーションと表情** — モデルに定義されたグループ(`mtn_01`…)のモーションを再生したり、表情(`exp_01`…)を設定したりします。
|
||||||
|
- **パラメータ** — モデルのパラメータをどれでも直接設定できます。上の絵は、ひとつのパラメータで右腕が上がったところです。
|
||||||
|
- **配置** — モデルは自分の領域に自動で収まるか、指定した位置と倍率で置かれます。
|
||||||
|
|
||||||
|
## モデルの要件
|
||||||
|
|
||||||
|
モデルは Cubism の標準エクスポートフォルダで、mod の中に置きます:
|
||||||
|
|
||||||
|
```filestree
|
||||||
|
my_mod/
|
||||||
|
└── models/
|
||||||
|
└── runtime/
|
||||||
|
├── ren.model3.json 指し示す入口のファイル
|
||||||
|
├── ren.moc3
|
||||||
|
├── ren.physics3.json
|
||||||
|
├── ren.cdi3.json
|
||||||
|
├── ren.4096/texture_00.png
|
||||||
|
├── expressions/exp_01.exp3.json …
|
||||||
|
└── motions/mtn_01.motion3.json …
|
||||||
|
```
|
||||||
|
|
||||||
|
- モデルは Cubism モデル(`model3.json` 付きの `.moc3`)です。デモモデルは Cubism 5.3 で作られ、そのマスクとオフスクリーン描画を使っています。
|
||||||
|
- ネイティブの Cubism コアは Windows(`.dll`)と Linux(`.so`)向けが同梱されています。
|
||||||
|
- サンプルモデルは Live2D 独自のライセンスが付きます。公開する前に、モデルの `ReadMe.txt` を読んでください。
|
||||||
|
|
||||||
|
## シナリオからモデルを表示する
|
||||||
|
|
||||||
|
`add_live2d_model` アクションが、シーンのビューへモデルを置きます:
|
||||||
|
|
||||||
|
```scenario
|
||||||
|
action add_live2d_model model_path=models/runtime/ren.model3.json mod_id=my_mod node_name=Ren x=960 y=540 scale=0.5
|
||||||
|
```
|
||||||
|
|
||||||
|
- `model_path` — `model3.json`。mod フォルダからの相対パス。
|
||||||
|
- `mod_id` — それを含む mod。
|
||||||
|
- `node_name` — このモデルのシーン内での名前(同じ名前の 2 つ目のアクションは無視されます)。
|
||||||
|
- `x`、`y`、`scale` — 省略できる位置と大きさ。なければモデルは自動で収まります。
|
||||||
|
|
||||||
|
コードを持つ mod は `Live2DService.CreateModel(...)` でモデルを作り、`StartMotion(group, number)`、`StartExpression(id)`、`SetLiveParameter(id, value)`、`SetTargetPoint(x, y)` を呼べます。
|
||||||
|
|
||||||
|
## デモ
|
||||||
|
|
||||||
|
この mod の **avatar** テストスイートに、サンプルモデル Ren が入っています。有効にすると、Ren は Cthangover のヴィラの外に現れ、マウスのドラッグに従います。自動チェックが右腕を上げ、フレームを比較します。開発者向けのデモで、通常のプレイではオフです。
|
||||||
|
|
||||||
|
## うまくいかないとき
|
||||||
|
|
||||||
|
1. **モデルが出ないのに、ログに `model_path` や mod についての表示がある。** パスは mod フォルダからの相対で、`model3.json` を指す必要があります。`mod_id` は、モデルを持つ mod の id でなければなりません。
|
||||||
|
2. **モデルの場所や大きさがおかしい。** `x`、`y`、`scale` を指定するか、3 つとも省略して自動収任せにしてください。
|
||||||
|
3. **プラットフォーム上でモデルが読み込めない。** Cubism コアライブラリは Windows と Linux 向けしかありません。
|
||||||
+62
@@ -0,0 +1,62 @@
|
|||||||
|
# Live2D Cubism — 움직이는 2D 캐릭터
|
||||||
|
|
||||||
|
Live2D Cubism은 Live2D 모델을 게임으로 가져옵니다: 숨 쉬고, 깜빡이고, 한 점을 바라보고, 물리(머리카락, 옷)로 움직이며, 작가가 만든 모션과 표정을 재생하는 그려진 캐릭터입니다. C#용 Cubism 런타임과 그 네이티브 코어 라이브러리가 들어 있고, 다른 mod들이 이것으로 장면에 모델을 표시합니다.
|
||||||
|
|
||||||
|
Cthangover 게임의 선택 블록입니다. 지금의 스토리 콘텐츠는 여전히 정지 초상화를 쓰고, 내장 게임 중 Live2D 모델을 실은 것은 아직 없습니다. 이 mod의 자체 데모가 동작하는 모델을 보여 줍니다.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## 모델이 할 수 있는 것
|
||||||
|
|
||||||
|
- **대기 중의 생기** — 자동 깜빡임(기본 켜짐)과 호흡(기본 꺼짐).
|
||||||
|
- **물리** — 머리카락과 옷이 모델의 `physics3.json`에 따라 흔들립니다.
|
||||||
|
- **시선** — 머리와 눈이 목표점을 향합니다. 데모에서는 캐릭터 위에서 마우스를 끌어 시선을 이끌 수 있습니다.
|
||||||
|
- **모션과 표정** — 모델에 정의된 그룹(`mtn_01`…)의 모션을 재생하거나 표정(`exp_01`…)을 설정합니다.
|
||||||
|
- **파라미터** — 모델의 어떤 파라미터든 직접 설정합니다. 위 그림은 파라미터 하나로 오른팔을 든 모습입니다.
|
||||||
|
- **배치** — 모델이 자기 영역에 자동으로 맞춰지거나, 주어진 위치와 배율로 놓입니다.
|
||||||
|
|
||||||
|
## 모델 요건
|
||||||
|
|
||||||
|
모델은 Cubism 표준 내보내기 폴더로, mod 안에 둡니다:
|
||||||
|
|
||||||
|
```filestree
|
||||||
|
my_mod/
|
||||||
|
└── models/
|
||||||
|
└── runtime/
|
||||||
|
├── ren.model3.json 가리킬 진입 파일
|
||||||
|
├── ren.moc3
|
||||||
|
├── ren.physics3.json
|
||||||
|
├── ren.cdi3.json
|
||||||
|
├── ren.4096/texture_00.png
|
||||||
|
├── expressions/exp_01.exp3.json …
|
||||||
|
└── motions/mtn_01.motion3.json …
|
||||||
|
```
|
||||||
|
|
||||||
|
- 모델은 Cubism 모델(`model3.json`이 있는 `.moc3`)입니다. 데모 모델은 Cubism 5.3으로 만들어졌고 그 마스크와 오프스크린 그리기를 사용합니다.
|
||||||
|
- 네이티브 Cubism 코어가 Windows(`.dll`)와 Linux(`.so`)용으로 포함되어 있습니다.
|
||||||
|
- 예시 모델에는 Live2D 자체 라이선스가 따릅니다. 공개하기 전에 모델의 `ReadMe.txt`를 읽어 보세요.
|
||||||
|
|
||||||
|
## 시나리오에서 모델 표시하기
|
||||||
|
|
||||||
|
`add_live2d_model` 액션이 모델을 장면의 뷰에 넣습니다:
|
||||||
|
|
||||||
|
```scenario
|
||||||
|
action add_live2d_model model_path=models/runtime/ren.model3.json mod_id=my_mod node_name=Ren x=960 y=540 scale=0.5
|
||||||
|
```
|
||||||
|
|
||||||
|
- `model_path` — `model3.json`, mod 폴더 기준 상대 경로.
|
||||||
|
- `mod_id` — 그것을 담고 있는 mod.
|
||||||
|
- `node_name` — 장면에서 이 모델의 이름(같은 이름의 두 번째 액션은 무시됩니다).
|
||||||
|
- `x`, `y`, `scale` — 선택 사항인 위치와 크기. 없으면 모델이 자동으로 맞춰집니다.
|
||||||
|
|
||||||
|
코드가 있는 mod는 `Live2DService.CreateModel(...)`로 모델을 만들고, `StartMotion(group, number)`, `StartExpression(id)`, `SetLiveParameter(id, value)`, `SetTargetPoint(x, y)`를 호출할 수 있습니다.
|
||||||
|
|
||||||
|
## 데모
|
||||||
|
|
||||||
|
이 mod의 **avatar** 테스트 스위트에 예시 모델 Ren이 들어 있습니다. 켜면 Ren이 Cthangover의 빌라 밖에 나타나 마우스 끌기를 따라갑니다. 자동 검사는 오른팔을 올리고 프레임을 비교합니다. 개발자용 데모이고 일반 플레이에서는 꺼져 있습니다.
|
||||||
|
|
||||||
|
## 문제가 생겼을 때
|
||||||
|
|
||||||
|
1. **모델이 없는데 로그에 `model_path`나 mod 이야기가 나옵니다.** 경로는 mod 폴더 기준이며 `model3.json`을 가리켜야 합니다. `mod_id`는 그것을 가진 mod의 id여야 합니다.
|
||||||
|
2. **모델이 엉뚱한 위치나 크기로 나옵니다.** `x`, `y`, `scale`을 주거나, 셋 다 생략해 자동 맞춤에 맡기세요.
|
||||||
|
3. **어떤 플랫폼에서 모델이 로드되지 않습니다.** Cubism 코어 라이브러리는 Windows와 Linux용만 제공됩니다.
|
||||||
+62
@@ -0,0 +1,62 @@
|
|||||||
|
# Live2D Cubism — анимированные 2D-персонажи
|
||||||
|
|
||||||
|
Live2D Cubism приносит в игру модели Live2D: нарисованных персонажей, которые дышат, моргают, следят за точкой, двигаются по законам физики (волосы, одежда) и исполняют движения и выражения лица, которые сделал их художник. Мод содержит рантайм Cubism для C# и его нативные библиотеки ядра; другие моды используют его, чтобы показать модель в сцене.
|
||||||
|
|
||||||
|
Это необязательный блок игры Cthangover. Нынешний сюжетный контент всё ещё пользуется статичными портретами, и ни одна встроенная игра пока не поставляет Live2D-модель; собственная демо-сцена мода показывает работающую модель.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## Что умеет модель
|
||||||
|
|
||||||
|
- **Жизнь в покое** — автоматическое моргание (включено по умолчанию) и дыхание (выключено по умолчанию).
|
||||||
|
- **Физика** — волосы и одежда колышутся по правилам из `physics3.json` модели.
|
||||||
|
- **Взгляд** — голова и глаза поворачиваются к целевой точке; в демо за персонажем можно «водить» мышью, перетаскивая её по нему.
|
||||||
|
- **Движения и выражения** — проиграть движение из группы (`mtn_01`…) или установить выражение (`exp_01`…), заданные в модели.
|
||||||
|
- **Параметры** — задать любой параметр модели напрямую, как на картинке выше, где правую руку поднял один параметр.
|
||||||
|
- **Размещение** — модель сама вписывается в свою область или ставится в заданную позицию с заданным масштабом.
|
||||||
|
|
||||||
|
## Требования к модели
|
||||||
|
|
||||||
|
Модель — это стандартная папка экспорта Cubism, лежащая внутри мода:
|
||||||
|
|
||||||
|
```filestree
|
||||||
|
my_mod/
|
||||||
|
└── models/
|
||||||
|
└── runtime/
|
||||||
|
├── ren.model3.json входной файл, на который вы указываете
|
||||||
|
├── ren.moc3
|
||||||
|
├── ren.physics3.json
|
||||||
|
├── ren.cdi3.json
|
||||||
|
├── ren.4096/texture_00.png
|
||||||
|
├── expressions/exp_01.exp3.json …
|
||||||
|
└── motions/mtn_01.motion3.json …
|
||||||
|
```
|
||||||
|
|
||||||
|
- Модель — это модель Cubism (`.moc3` с `model3.json`). Демо-модель сделана в Cubism 5.3 и использует его маски и рисование вне экрана.
|
||||||
|
- Нативное ядро Cubism входит в состав для Windows (`.dll`) и Linux (`.so`).
|
||||||
|
- Примеры моделей идут под собственной лицензией Live2D; перед публикацией прочитайте `ReadMe.txt` модели.
|
||||||
|
|
||||||
|
## Показ модели из сценария
|
||||||
|
|
||||||
|
Действие `add_live2d_model` ставит модель в вид сцены:
|
||||||
|
|
||||||
|
```scenario
|
||||||
|
action add_live2d_model model_path=models/runtime/ren.model3.json mod_id=my_mod node_name=Ren x=960 y=540 scale=0.5
|
||||||
|
```
|
||||||
|
|
||||||
|
- `model_path` — `model3.json`, путь относительно папки мода;
|
||||||
|
- `mod_id` — мод, в котором она лежит;
|
||||||
|
- `node_name` — имя этой модели в сцене (второе действие с тем же именем игнорируется);
|
||||||
|
- `x`, `y`, `scale` — необязательные позиция и размер; без них модель вписывается автоматически.
|
||||||
|
|
||||||
|
Мод с кодом может создать модель через `Live2DService.CreateModel(...)` и вызвать у неё `StartMotion(group, number)`, `StartExpression(id)`, `SetLiveParameter(id, value)` или `SetTargetPoint(x, y)`.
|
||||||
|
|
||||||
|
## Демонстрация
|
||||||
|
|
||||||
|
Тестовый набор **avatar** этого мода содержит пример модели Ren. Когда он включён, Ren появляется возле виллы в Cthangover и следует за перетаскиванием мыши; его автоматическая проверка поднимает правую руку и сравнивает кадры. Это демо для разработчиков, в обычной игре оно выключено.
|
||||||
|
|
||||||
|
## Если что-то пошло не так
|
||||||
|
|
||||||
|
1. **Модели нет, а в логе сообщение о `model_path` или о моде.** Путь задаётся относительно папки мода и должен указывать на `model3.json`; `mod_id` должен быть id того мода, где модель лежит.
|
||||||
|
2. **Модель оказалась не в том месте или не того размера.** Задайте `x`, `y` и `scale` — или не задавайте ни одного из трёх, чтобы модель вписалась сама.
|
||||||
|
3. **Модель не загружается на платформе.** Ядро Cubism поставляется только для Windows и Linux.
|
||||||
+62
@@ -0,0 +1,62 @@
|
|||||||
|
# Live2D Cubism — nhân vật 2D chuyển động
|
||||||
|
|
||||||
|
Live2D Cubism mang mô hình Live2D vào trò chơi: những nhân vật được vẽ, biết thở, chớp mắt, dõi theo một điểm, chuyển động theo vật lý (tóc, quần áo) và diễn các chuyển động cùng biểu cảm mà họa sĩ đã làm. Mod chứa runtime Cubism cho C# cùng các thư viện lõi gốc của nó; các mod khác dùng nó để hiện một mô hình trong cảnh.
|
||||||
|
|
||||||
|
Đây là một khối tùy chọn của trò chơi Cthangover. Nội dung cốt truyện hiện tại vẫn dùng chân dung tĩnh, và chưa trò chơi tích hợp nào kèm mô hình Live2D; bản demo riêng của mod cho thấy một mô hình đang chạy.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## Một mô hình có thể làm gì
|
||||||
|
|
||||||
|
- **Sự sống khi rảnh rỗi** — tự động chớp mắt (bật mặc định) và thở (tắt mặc định).
|
||||||
|
- **Vật lý** — tóc và quần áo đung đưa theo `physics3.json` của mô hình.
|
||||||
|
- **Ánh nhìn** — đầu và mắt xoay về một điểm đích; bản demo cho phép kéo chuột trên nhân vật để hướng ánh nhìn.
|
||||||
|
- **Chuyển động và biểu cảm** — phát một chuyển động thuộc một nhóm (`mtn_01`…) hoặc đặt một biểu cảm (`exp_01`…) được định nghĩa trong mô hình.
|
||||||
|
- **Tham số** — đặt trực tiếp bất kỳ tham số nào của mô hình, như trong hình trên, nơi một tham số nâng cánh tay phải lên.
|
||||||
|
- **Bố trí** — mô hình tự khớp vào vùng của nó, hoặc được đặt ở vị trí và tỉ lệ cho trước.
|
||||||
|
|
||||||
|
## Yêu cầu của mô hình
|
||||||
|
|
||||||
|
Một mô hình là thư mục xuất chuẩn của Cubism, được giữ bên trong một mod:
|
||||||
|
|
||||||
|
```filestree
|
||||||
|
my_mod/
|
||||||
|
└── models/
|
||||||
|
└── runtime/
|
||||||
|
├── ren.model3.json tệp dẫn nhập mà bạn trỏ tới
|
||||||
|
├── ren.moc3
|
||||||
|
├── ren.physics3.json
|
||||||
|
├── ren.cdi3.json
|
||||||
|
├── ren.4096/texture_00.png
|
||||||
|
├── expressions/exp_01.exp3.json …
|
||||||
|
└── motions/mtn_01.motion3.json …
|
||||||
|
```
|
||||||
|
|
||||||
|
- Mô hình là mô hình Cubism (`.moc3` với một `model3.json`). Mô hình demo được làm bằng Cubism 5.3 và dùng mặt nạ cùng cách vẽ ngoài màn hình của nó.
|
||||||
|
- Lõi Cubism gốc được kèm cho Windows (`.dll`) và Linux (`.so`).
|
||||||
|
- Các mô hình mẫu đi kèm giấy phép riêng của Live2D; hãy đọc `ReadMe.txt` của mô hình trước khi công bố nó.
|
||||||
|
|
||||||
|
## Hiện mô hình từ kịch bản
|
||||||
|
|
||||||
|
Hành động `add_live2d_model` đặt một mô hình vào khung nhìn của cảnh:
|
||||||
|
|
||||||
|
```scenario
|
||||||
|
action add_live2d_model model_path=models/runtime/ren.model3.json mod_id=my_mod node_name=Ren x=960 y=540 scale=0.5
|
||||||
|
```
|
||||||
|
|
||||||
|
- `model_path` — tệp `model3.json`, đường dẫn tương đối so với thư mục mod;
|
||||||
|
- `mod_id` — mod chứa nó;
|
||||||
|
- `node_name` — tên của mô hình này trong cảnh (hành động thứ hai trùng tên sẽ bị bỏ qua);
|
||||||
|
- `x`, `y`, `scale` — vị trí và kích thước tùy chọn; không có chúng thì mô hình tự khớp.
|
||||||
|
|
||||||
|
Một mod có mã có thể tạo mô hình bằng `Live2DService.CreateModel(...)` rồi gọi `StartMotion(group, number)`, `StartExpression(id)`, `SetLiveParameter(id, value)` hoặc `SetTargetPoint(x, y)` trên nó.
|
||||||
|
|
||||||
|
## Bản demo
|
||||||
|
|
||||||
|
Bộ kiểm thử **avatar** của mod chứa mô hình mẫu Ren. Khi bật, Ren xuất hiện bên ngoài biệt thự ở Cthangover và đi theo thao tác kéo chuột; phần kiểm tra tự động của nó nâng cánh tay phải và so sánh các khung hình. Đây là bản demo dành cho nhà phát triển và tắt trong lối chơi bình thường.
|
||||||
|
|
||||||
|
## Khi có gì đó không ổn
|
||||||
|
|
||||||
|
1. **Không có mô hình và log nhắc tới `model_path` hoặc mod.** Đường dẫn tính từ thư mục mod và phải trỏ tới `model3.json`; `mod_id` phải là id của mod chứa nó.
|
||||||
|
2. **Mô hình hiện sai chỗ hoặc sai kích thước.** Hãy cho `x`, `y` và `scale`, hoặc bỏ cả ba để mô hình tự khớp.
|
||||||
|
3. **Mô hình không tải được trên một nền tảng.** Thư viện lõi Cubism chỉ có cho Windows và Linux.
|
||||||
+62
@@ -0,0 +1,62 @@
|
|||||||
|
# Live2D Cubism——会动的 2D 角色
|
||||||
|
|
||||||
|
Live2D Cubism 把 Live2D 模型带进游戏：画出来的角色会呼吸、会眨眼、会盯着一个点看、会带物理地运动（头发、衣服），并播放美术做好的动作和表情。这个 mod 包含面向 C# 的 Cubism 运行时和它的原生核心库；其他 mod 用它在场景里显示模型。
|
||||||
|
|
||||||
|
它是 Cthangover 游戏的可选部件。目前的剧情内容仍在使用静态立绘，内置游戏也还没有附带 Live2D 模型；mod 自带的演示展示了一个能跑的模型。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## 模型能做什么
|
||||||
|
|
||||||
|
- **闲置的生机**——自动眨眼（默认开启）和呼吸（默认关闭）。
|
||||||
|
- **物理**——头发和衣服按模型 `physics3.json` 的规则摆动。
|
||||||
|
- **注视**——头和眼睛转向一个目标点；演示中可以在角色身上拖动鼠标来引导它。
|
||||||
|
- **动作与表情**——播放模型里定义的某组动作（`mtn_01`…）或设置表情（`exp_01`…）。
|
||||||
|
- **参数**——直接设置模型的任意参数，就像上图那样：一个参数就抬起了右臂。
|
||||||
|
- **摆放**——模型自动适配自己的区域，或按给定的位置和缩放摆放。
|
||||||
|
|
||||||
|
## 模型的要求
|
||||||
|
|
||||||
|
一个模型就是标准的 Cubism 导出文件夹，放在 mod 里面：
|
||||||
|
|
||||||
|
```filestree
|
||||||
|
my_mod/
|
||||||
|
└── models/
|
||||||
|
└── runtime/
|
||||||
|
├── ren.model3.json 你要指向的入口文件
|
||||||
|
├── ren.moc3
|
||||||
|
├── ren.physics3.json
|
||||||
|
├── ren.cdi3.json
|
||||||
|
├── ren.4096/texture_00.png
|
||||||
|
├── expressions/exp_01.exp3.json …
|
||||||
|
└── motions/mtn_01.motion3.json …
|
||||||
|
```
|
||||||
|
|
||||||
|
- 模型必须是 Cubism 模型（`.moc3` 加一个 `model3.json`）。演示模型用 Cubism 5.3 制作，用到了它的遮罩和离屏绘制。
|
||||||
|
- 原生 Cubism 核心已随 mod 提供 Windows（`.dll`）和 Linux（`.so`）版本。
|
||||||
|
- 示例模型带有 Live2D 自己的许可协议；发布前请先阅读模型的 `ReadMe.txt`。
|
||||||
|
|
||||||
|
## 从剧本显示模型
|
||||||
|
|
||||||
|
`add_live2d_model` 动作把一个模型放进场景视图：
|
||||||
|
|
||||||
|
```scenario
|
||||||
|
action add_live2d_model model_path=models/runtime/ren.model3.json mod_id=my_mod node_name=Ren x=960 y=540 scale=0.5
|
||||||
|
```
|
||||||
|
|
||||||
|
- `model_path`——`model3.json`，相对 mod 文件夹的路径；
|
||||||
|
- `mod_id`——包含它的 mod；
|
||||||
|
- `node_name`——这个模型在场景中的名字（同名第二个动作会被忽略）；
|
||||||
|
- `x`、`y`、`scale`——可选的位置和大小；不填则模型自动适配。
|
||||||
|
|
||||||
|
带代码的 mod 可以用 `Live2DService.CreateModel(...)` 创建模型，然后调用它的 `StartMotion(group, number)`、`StartExpression(id)`、`SetLiveParameter(id, value)` 或 `SetTargetPoint(x, y)`。
|
||||||
|
|
||||||
|
## 演示
|
||||||
|
|
||||||
|
本 mod 的 **avatar** 测试套件包含示例模型 Ren。开启后，Ren 会出现在 Cthangover 的别墅外并跟随鼠标拖动；它的自动检查会抬起右臂并比较画面帧。这是给开发者的演示，正常游戏中不开启。
|
||||||
|
|
||||||
|
## 出问题了？
|
||||||
|
|
||||||
|
1. **没有模型，日志提到 `model_path` 或 mod。** 路径相对 mod 文件夹，必须指向 `model3.json`；`mod_id` 必须是拥有它的那个 mod 的 id。
|
||||||
|
2. **模型位置或大小不对。** 给出 `x`、`y` 和 `scale`，或者三个都不填让它自动适配。
|
||||||
|
3. **模型在某个平台上加载不出来。** Cubism 核心库只提供 Windows 和 Linux 版本。
|
||||||
@@ -1,2 +1,2 @@
|
|||||||
mod_live2d_base_name = Live2D Cubism
|
mod_live2d_base_name = Live2D Cubism
|
||||||
mod_live2d_base_desc = Live2D Cubism C# runtime: model loading, rendering, physics, animation, effects.
|
mod_live2d_base_desc = Live2D Cubism runtime for C#: drawn characters that breathe, blink and move with physics, playing the motions and expressions their artist made.
|
||||||
@@ -1,2 +1,2 @@
|
|||||||
mod_live2d_base_name = Live2D Cubism
|
mod_live2d_base_name = Live2D Cubism
|
||||||
mod_live2d_base_desc = Runtime de Live2D Cubism en C#: carga de modelos, renderizado, física, animación, efectos.
|
mod_live2d_base_desc = Runtime de Live2D Cubism para C#: personajes dibujados que respiran, parpadean y se mueven con física, reproduciendo los movimientos y expresiones que hizo su artista.
|
||||||
@@ -1,2 +1,2 @@
|
|||||||
mod_live2d_base_name = Live2D Cubism
|
mod_live2d_base_name = Live2D Cubism
|
||||||
mod_live2d_base_desc = Live2D Cubism の C# ランタイム：モデルの読み込み、描画、物理、アニメーション、エフェクト。
|
mod_live2d_base_desc = C# 用の Live2D Cubism ランタイム: 呼吸し、まばたきし、物理で揺れる描画キャラクター。作者が作ったモーションと表情を再生します。
|
||||||
@@ -1,2 +1,2 @@
|
|||||||
mod_live2d_base_name = Live2D Cubism
|
mod_live2d_base_name = Live2D Cubism
|
||||||
mod_live2d_base_desc = Live2D Cubism C# 런타임: 모델 로드, 렌더링, 물리, 애니메이션, 효과.
|
mod_live2d_base_desc = C#용 Live2D Cubism 런타임: 숨 쉬고, 깜빡이고, 물리로 움직이는 그려진 캐릭터. 작가가 만든 모션과 표정을 재생합니다.
|
||||||
@@ -1,2 +1,2 @@
|
|||||||
mod_live2d_base_name = Live2D Cubism
|
mod_live2d_base_name = Live2D Cubism
|
||||||
mod_live2d_base_desc = C#-рантайм Live2D Cubism: загрузка и отрисовка моделей, физика, анимации и эффекты.
|
mod_live2d_base_desc = Рантайм Live2D Cubism для C#: нарисованные персонажи, которые дышат, мигают и двигаются по законам физики, исполняя движения и выражения лица, сделанные их художником.
|
||||||
@@ -1,2 +1,2 @@
|
|||||||
mod_live2d_base_name = Live2D Cubism
|
mod_live2d_base_name = Live2D Cubism
|
||||||
mod_live2d_base_desc = Runtime Live2D Cubism bằng C#: tải mô hình, kết xuất, vật lý, hoạt ảnh, hiệu ứng.
|
mod_live2d_base_desc = Runtime Live2D Cubism cho C#: những nhân vật vẽ biết thở, chớp mắt và chuyển động theo vật lý, diễn các chuyển động và biểu cảm mà họa sĩ đã tạo ra.
|
||||||
@@ -1,2 +1,2 @@
|
|||||||
mod_live2d_base_name = Live2D Cubism
|
mod_live2d_base_name = Live2D Cubism
|
||||||
mod_live2d_base_desc = Live2D Cubism C# 运行时：模型加载、渲染、物理、动画、特效。
|
mod_live2d_base_desc = 面向 C# 的 Live2D Cubism 运行时：会呼吸、会眨眼、带物理运动的绘制角色，播放美术做好的动作与表情。
|
||||||
+1
-1
@@ -3,7 +3,7 @@
|
|||||||
"name": "Live2D Cubism",
|
"name": "Live2D Cubism",
|
||||||
"version": "1.0.0",
|
"version": "1.0.0",
|
||||||
"author": "ct",
|
"author": "ct",
|
||||||
"description": "Live2D Cubism C# runtime: model loading, rendering, physics, animation, effects",
|
"description": "Live2D Cubism runtime for C#: drawn characters that breathe, blink and move with physics, playing the motions and expressions their artist made.",
|
||||||
"category": "library, visual",
|
"category": "library, visual",
|
||||||
"depends": ["ui_base>=1"],
|
"depends": ["ui_base>=1"],
|
||||||
"depends_native": ["native/*.dll", "native/*.so"],
|
"depends_native": ["native/*.dll", "native/*.so"],
|
||||||
|
|||||||
Reference in new issue
Block a user