2
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Pyxel 3 で VRM アバターを動かすためにやったこと全部(格闘・ボウリング・爆弾迷路)

2
Last updated at Posted at 2026-11-11

はじめに

Pyxel 3 の 3D 機能(pyxel.cube)で、VRoid のアバター(VRM)を主役にしたゲームを 3 本作りました。どれも Code & Magic(ブラウザで Pyxel を動かせるサービス)で公開しています。

作品 内容 Code & Magic
VRM CYBER FIGHTER '95 1 対 1 の格闘 https://codeandmagic.samurai-apps.com/works/vrm-cyber-fighter-95-27648
STRIKE '95: RETRO BOWL 10 フレームのボウリング https://codeandmagic.samurai-apps.com/works/retro-bowl-strike-95-35458
BLAST ARENA 爆弾で壁を壊す 4 人対戦の迷路 https://codeandmagic.samurai-apps.com/works/blast-arena-battle-99965

VRM はそのままでは Pyxel 3 で動きません。この記事では、3 本を作る中でぶつかった壁と、その越え方をまとめます。数値は、特に書いていないものは Mac(ローカル)か Code & Magic で測ったものです。

Pyxel 3 の 3D の基本(パレット、頂点の共有で遅くなる話など)は前の記事に書いたので、ここでは省きます。

アバターは VRoid Studio のサンプルモデル「AvatarSample_A」を使いました(ライセンスは最後に書きます)。

VRM CYBER FIGHTER '95

STRIKE '95: RETRO BOWL

BLAST ARENA

1. Pyxel 3 で VRM を使うときの壁

VRM の中身は glTF(GLB)なので、Mesh.from_glb() で読み込めること自体は読み込めます。ただし、次のものが使えません。

VRM の機能 Pyxel 3(pyxel.cube 3.0.0)
スキン(骨の動きに合わせて体の形を曲げる仕組み) 使えない。「GLB skins are not supported」と出て、体は固まったまま
表情(ブレンドシェイプ / モーフ) 使えない。基本の顔だけ
半透明のマテリアル(BLEND) 使えない。不透明として描かれる
色 全部で 256 色のパレット。テクスチャは近い色に置き換えられる
ファイルの大きさ Code & Magic は 1 ファイル 3 MB まで(元の VRM は約 15 MB)

以下、この 5 つを順に越えていきます。

2. 1/10 に軽くする — 骨ごとの「硬い部品」に分ける

スキンが使えないので、発想を逆にします。三角形を、いちばん強く影響している骨 1 本にくっつけて、その骨の「硬い部品」にしてしまう方法です。

  • VRM の各頂点には「どの骨に何 % ついていくか」(ウェイト、最大 4 本)が入っています。三角形ごとに、ウェイトの合計がいちばん大きい骨を選びます。
  • 選んだ骨の座標系に三角形を書き直し、骨のノードの子にします。
  • こうすると、Pyxel が普通に再生できる「ノードの回転のアニメーション」だけで、体が動くようになります。
  • テクスチャは基本色(baseColor)だけ残し、最大 384 px に縮めます。
大きさ
元の VRM(AvatarSample_A.vrm) 15,096,320 B(約 15 MB)
硬い部品に分けた GLB 1,564,820 B(約 1.56 MB、約 1/10)
格闘ゲームの GLB(モーション 18 本込み) 2,325,820 B

三角形の数は元と同じ 24,854 個で、見た目は減らしていません。ノードは 157 個です。

この方式の弱点は、関節を大きく曲げると部品の間にすき間ができることです。これは 6 章で直します。

3. 目が黒い板になる問題 — BLEND を MASK に

読み込んでそのまま描くと、目のまわりが黒い板でふさがります。

左:BLEND のまま 右:MASK に変えたもの

原因は、目元のマテリアル(まつげ、眉、ハイライトなど 5 つ)が半透明(alphaMode: "BLEND")になっていることです。Pyxel は半透明を使えないので、透明な部分まで塗りつぶしてしまいます。

GLB の中の JSON で、この 5 つを 切り抜き("alphaMode": "MASK"、"alphaCutoff": 0.5) に書き換えると直ります。切り抜きなら Pyxel でも使えます。

注意点が 1 つあります。切り抜きには「透明」を表すパレット番号が 1 つ必要です。256 色を全部ちがう色で埋めてしまうと透明にできません。私は 255 番を空けておき、Mesh.from_glb(path, colkey=255) と指定しています。

4. 顔が灰色に沈む問題 — 肌用の陰の表

次は、顔の真ん中が灰色のコンクリートのようになる問題です。原因は 2 つありました。

  • 光の向きの既定値 (0.5, -1, -0.8) だと、正面を向いた顔が暗い側になる。
  • 暗い部分の色を自動で選ぶと、肌の影に、服の影用の灰色が選ばれてしまう。

Pyxel の Shading は、「パレットの各色が、明るさの段階ごとにどの色になるか」の表です。そこで、暖色(肌の色)の暗い色には、無彩色を選ばないようにした表を自分で作りました。段階を 2 つ(明るい / 暗い)にまとめると、アニメ調の 2 階調の陰になります。光の向きは正面寄りにしました。

5. 1P と 2P の色違い — 追加の容量ゼロ

格闘ゲームでは、同じアバターを 2 体並べて、2P の上着をピンクにしています。

1P(白)と 2P(ピンク)

Shading はノードごとに設定でき、子ノードに受け継がれます。そこで、2P の上着の部品にだけ、白をピンクに置き換えた Shading を設定しました。GLB は 1 つのままなので、追加の容量はゼロです。

コツは、読み込む前に上着のテクスチャに少しだけ青みを足して、上着の白と肌のクリーム色が別々のパレット番号になるようにしておくことです。同じ番号を共有していると、肌まで色が変わってしまいます。

BLAST ARENA では CPU 3 人を赤・青・黄にしました。この方式だと、上着だけが使うパレット番号が 2 つしかなく、うまくいきませんでした。そこで、読み込む前に GLB の中の上着の画像を Pillow で塗り替え、色ごとに別の Mesh として読み込むようにしました。Pyxel はテクスチャを Mesh ごとに持つので、同じアバターから色違いが作れます。代わりに、読み込みが 1 体あたり約 1 秒増えます。

左から:元の色、赤、青、黄(上着の画像を読み込む前に塗り替えたもの)

6. 継ぎ目の穴 — 重ね合わせ、そして CPU スキニング

2 章の硬い部品のままだと、腕を大きく上げたときに脇の下が裂けます。

左:硬い部品(脇の下が裂ける) 右:CPU スキニング

最初は「2 つの骨にまたがる三角形を、両方の部品にコピーして重ねる」方法で穴を目立たなくしました。ただ、コピーを親の部品にも置くと、腕を下ろしたときに肩からトゲのように飛び出す副作用が出ました。コピーは子の側(骨の鎖の先のほう)にだけ置くのが正解でした。

それでも完全には消えないので、最後は numpy で毎フレーム頂点を計算する(CPU スキニング) ことにしました。

  1. VRM から、髪と体の頂点、ウェイト(最大 4 本)、逆バインド行列を書き出しておく。
  2. 毎フレーム、骨のワールド行列 × 逆バインド行列を、ウェイトで足し合わせて、全部の頂点を動かす。
  3. 新しい位置を Primitive に書き込み、compute_normals() で法線を作り直して描く。

骨の動き自体は、Pyxel のアニメーション再生(apply_motion)にまかせ、その結果の骨の位置だけを読みます。

重さは次のとおりでした(ms は揺れもの + スキニングの計算と、描画の合計)。

体数 環境 硬い部品 髪だけスキニング 髪 + 体スキニング
1 Mac 6.4 ms 8.0 ms 8.5 ms
1 Code & Magic 6.5 ms 9.1 ms 10.8 ms
2 Mac 9.0 ms 10.1 ms 11.9 ms
2 Code & Magic 10.9 ms 13.8 ms 17.3 ms
4 Mac 13.9 ms 16.2 ms 19.2 ms
4 Code & Magic 17.4 ms 22.4 ms 29.5 ms

Code & Magic でも 4 体まで 30 fps を保てました。スキニングの計算は 1 体あたり Code & Magic で約 4 ms、Mac で約 2 ms です。描画の時間はほとんど変わりません(三角形の数が同じため)。

BLAST ARENA では、自分のキャラだけ「髪 + 体スキニング」、CPU 3 人は軽い「硬い部品」にしています。

7. 表情 — 目と口を焼き込んで切り替える

Pyxel はモーフ(表情)を再生しません。そこで、表情ごとの顔を変換のときに作っておき、表示を切り替える方式にしました。

  • 顔の三角形を、どのモーフで動くかで「目のまわり」「口のまわり」「両方で動く少数」「動かない部分」に分けます。
  • 目のまわりは 10 種類(ふつう、まばたき、片目つぶり(左・右)、半目、喜び、怒り、悲しみ、楽しい、驚き)、口は 12 種類(あいうえお、半開き、喜怒哀楽など)を、それぞれ別のノードとして焼き込みます。
  • 実行時は、目と口で 1 つずつ表示します。目と口は別々に選べるので、「怒った顔で『あ』」もできます。

表情:ふつう、喜び、怒り、悲しみ、楽しい、驚き

口の形(あいうえお)と漫符

ハマったのは、ノードを visible = False にしても、子ノードは隠れないことです。GLB から作ったノードには <名前>_primitive_N という子ができるので、子孫を全部たどって切り替える必要があります。

頭の上の漫符(ハート、音符、汗、怒りマークなど)は、小さな Image に描いて Node.sprite() で出しています。BLAST ARENA では、アイテムを取ると音符、やられると汗、勝つとハートが出ます。

BLAST ARENA:勝つとハートを出して喜ぶ

8. モーションを付ける

モーションは、CC0 の VRMA(Quaternius、KayKit)を使いました。VRMA は別の体型向けに作られているので、そのままでは使えません。

  • リターゲット:元のモーションの「ワールド空間での骨の回転の変化」を、アバターの骨に移します。モデルが −Z を向いているので、Y 軸まわりに 180° の向きの変換をはさみます。
  • 接地:クリップごとに「いちばん低い足を床に合わせる」と、倒れる・座るモーションで大きく狂いました(寝るモーションで −55 cm など)。全クリップに共通の補正をかけ、床に寝る系だけフレームごとに補正する方式に変えました。
  • GLB に焼き込む:変換したモーションを GLB のアニメーションとして保存します。格闘ゲームは 18 本(構え、歩く、ジャブ、フック、キック、ガード、やられ、勝利など)を入れて 2.3 MB に収めました。

1 本あたりは約 20 KB なので、3 MB の枠にはおよそ 70 本入ります。

もう 1 つ、apply_motion は、そのノードを作ったのと同じ Mesh から読んだモーションしか受け付けないという制約がありました。たくさんのモーションを使いたいときは、骨格だけの GLB にモーションを入れて別に読み込み、見えない Node で再生して、骨の角度を本体にコピーします。218 本で 1.28 MB、コピーは 1 フレーム 27 µs でした。

9. ハマりどころ:オイラー角の符号(ボウリング)

ボウリングでは、投げる・構えるなどのモーションを手で作りました。最初は骨ごとにオイラー角(x・y・z 軸まわりの回転の角度)で書いていましたが、腕が背中側に回ったり、がっかりするポーズで首が後ろに 90° 折れたりしました。

原因は、角度の符号の取り違えでした。このアバターは −Z を向いているので、たとえば下ろした腕は x 軸まわりのプラスの回転で「前」に振られます。直感と逆です。

そこで、ポーズを「体の前・上・右」の向きで書き、手の位置は 2 本の骨の IK(手首の目標位置から肩とひじの角度を計算する方法)で決めるようにしました。角度の符号を人が書かないので、取り違えが起きません。

左:オイラー角で書いたもの(腕が逆に回る) 右:体の向き + IK で書き直したもの

直したあとの「がっかり」

スペアで喜ぶ

10. 3 作品で使ったもの

VRM CYBER FIGHTER '95 STRIKE '95: RETRO BOWL BLAST ARENA
体 硬い部品 硬い部品 自分:髪 + 体スキニング / CPU:硬い部品
目元(MASK) ○ ○ ○
陰の表 2 階調(肌の色を守る) 自作の表 標準の表(光の向きだけ調整)
色違い Shading で 2P をピンク — 画像を塗り替えて赤・青・黄
表情 勝利時の顔のアップ がっかりの顔のアップ 目と口の切り替え + 漫符
髪の揺れ — — ○(スプリングボーン)
モーション 18 本を GLB に焼き込み 5 本(4 本は体の向き + IK で手作り、喜ぶのは CC0) 22 本
ファイル GLB 1 つ(2.3 MB) tmx 1 つ(1.9 MB) tmx 1 つ(2.6 MB)

VRM CYBER FIGHTER '95:勝ったあとの顔のアップ

髪の揺れ(スプリングボーン)は、VRM に入っている揺れものの設定(硬さ、重力、当たり判定の球)を読み出し、VRM 0.x と同じ計算で毎フレーム骨を回しています。1 フレーム約 0.2 ms です。

Code & Magic の 3 MB 制限には、GLB・スキニング用のデータ・揺れものの設定・パレットを zlib で圧縮してから base64 にし、1 つの .tmx ファイルにまとめて対応しました。GLB の頂点データは zlib でよく縮みます。

まとめ

  • 大きさ:骨ごとの硬い部品に分けると、約 15 MB の VRM が約 1/10 になる。
  • 見た目:目元は MASK に、肌の陰は専用の表に。色違いは Shading か、読み込む前のテクスチャの塗り替えで。
  • 動き:CC0 のモーションをリターゲットして GLB に焼き込む。手で作るポーズは、オイラー角ではなく体の向き + IK で。
  • なめらかさ:継ぎ目の穴は numpy の CPU スキニングで消える。Code & Magic でも 4 体まで 30 fps。
  • 表情:目と口を焼き込んで切り替える。子ノードの表示は自分で切り替える。

ライセンス

  • アバター:VRoid Studio サンプルモデル「AvatarSample_A」(pixiv Inc.)。CC0 ではありません。公式の利用条件の範囲で、ゲーム内のキャラクターとして使っています。
  • モーション:Quaternius、KayKit(CC0)。VRMA への変換は open-vrma を使いました。
  • Pyxel:MIT License
2
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?