Community画像github.com

ps1-modeling

Blender で PS1/PSX スタイルの低ポリゴン キャラクターや小道具をモデリング、調整、レビューするためのスキル。レトロゲームアセット、ターンアラウンド参照からの低ポリゴン肖像画、ファセット加工されたヘアメッシュなど、PlayStation 1 アセットのポリゴン予算と慣習に準拠する必要があるあらゆる作業をカバーします。手続き型ビルドスクリプト、ロフトライブラリ、参照用プロポーション計測、予算管理、そして最も時間を浪費する失敗パターンについて説明します。

ps1-modeling とは?

このスキルは、Blender を使用して PS1/PSX スタイルの低ポリゴン 3D アセットをモデリングするための包括的なガイドとワークフローを提供します。主な特徴は、少ないポリゴン予算と単一のペイントテクスチャアトラスであり、フラットシェーディングではなくスムーズシェーディングを基本とし、髪の毛やハードサーフェスのプロップのみをファセット処理します。メッシュはシルエットとエッジフローで評価され、詳細はテクスチャに委ねられます。スキルには、実在の PS1 時代のリファレンスモデルから計測された厳格なポリゴン予算、手続き型ビルドスクリプト (psx_build.py)、ロフトリングによるブロック作成、ファイナライズとチェック (check()) のための API、そして開発を迅速化するためのプレビュー、比較、シルエット計測用のスクリプトが含まれます。また、別々のシェルの交差、キャップのはみ出し、股間の処理、ヘアモデリングの落とし穴など、最も時間を浪費するよくある失敗パターンも詳述しています。このスキルは Claude Code、Cursor、Codex などの AI エージェントと連携して使用することを想定しており、開発者が PS1 スタイルのアセットを効率的かつ正確に作成できるよう支援します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IAmTheParsifal/Low-Poly-Modeling-Skill/tree/HEAD

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

PS1 / PSX 低ポリゴンモデリング

スタイルの定義

PS1 スタイル = 少ないポリゴン予算 + 1枚のペイントテクスチャアトラス。フラットシェーディングではありません。 ボディはスムーズシェーディングされ、髪の毛と硬いプロップのみがファセット処理されます。モデル全体をフラットシェーディングすると、1997年ではなく2005年の低ポリゴンに見えます。ディテールはテクスチャに依存するため、メッシュはシルエットとエッジフローで判断されます。表面のディテールは評価対象になりません。

慣習(推測ではなく、実際のPS1時代のリファレンスモデルから計測)

  • +Z 上方向、キャラクターは −Y 方向を向き、足は Z=0、単位はメートル。
  • 1つのオブジェクト、1つのマテリアル、1つのテクスチャアトラス。服はメッシュそのものであり、別個の衣服オブジェクトは存在しません。
  • 100% スムーズシェーディング。ただし、髪の毛とハードサーフェスのプロップは除く。
  • ノーマルマップ、PBR、シェイプキーは使用しません。
  • ルーズな頂点、ルーズなエッジ、面積0の面、非多様体のゴミは禁止。
  • ボディシェルはクアッド。三角形は形状上必要な場所(先端、キャップ)のみ。

3つの出荷済みリファレンスモデルからの予算:

モデル頂点数三角形数備考
リグ付き男性ベースメッシュ772154084 ボーン、256² アトラス、Aポーズ、1.98 m
Walking (PSXProp)349645すべて三角形、512² アトラス、Tポーズ、1.77 m
LE0GAR5489439 オブジェクト、1つの256² アトラス、Rigify、2.4 m

これはリグ付きの裸のボディです。髪の毛のボリュームやアクセサリーは当然それを上回ります。例えば、1225 頂点 / 2294 三角形のキャラクターがたてがみ、メガネ、ベルト、ブーツを持っていても、それは PS1 キャラクターです。裸のボディの数値に合わせるためにシルエットを犠牲にしてはいけません。

セットアップ

scripts/psx_build.py がライブラリであり、2つのハーネスは先頭に設定があるスクリプトです。

scripts/psx_build.py           ring / ring_dir / Build / finish / check / report
scripts/preview.py             オルソ クレイ レンダリング、バウンディングボックスから派生したショット
scripts/compare.py             統計テーブル + リファレンス FBX/OBJ モデルとの比較表示
scripts/measure_silhouette.py  リファレンス PNG の幅対高さスキャン

scripts/ を sys.path に追加してインポートするか、ハーネスをビルドスクリプトの隣にコピーします。 すべて Blender 内で実行します:

import sys
sys.path.insert(0, r"…/scripts")
from psx_build import Build, ring, finish

API

ring(cx, cy, cz, rx, ry, n=12, e=2.0, axis="Z", phase=0.0, yoff=None)

1つの閉じた断面。e はスーパー楕円の指数: 2 = 円、大きいほど四角くなります。 便利な値: 2.1 四肢と頭、2.2 脚、2.3 胴体とベルト、2.6 手のひら。axis="X" はリングを X に沿った四肢用に YZ 平面に配置します。yoff={index: dy} は個々の頂点を押し出します — これにより、リングを追加せずにバストのふくらみ、腰椎のカーブ、お尻の部分を作成できます。

Build.loft(rings, cap_start=..., cap_end=..., flat=..., part="…")
Build.tube(path, rx, ry, n=4, e=2.0, caps=True, part="…")
Build.box(cx, cy, cz, sx, sy, sz, flat=True, part="…")
Build.add(verts, faces, flat=..., part="…")
Build.mark() → pass to Build.mirror_x(mark)

tube() は点のパスを受け取り、各リングをその点での接線に沿って方向付けます。チェーン、指、およびスイープされるものに使用します。rx/ry は、テーパリングのために点ごとに1つの値を持つリストにすることができます。

finish(name, *builds, material=..., color=..., uv=True)
check(ob)    # ゲート: ルーズ頂点 / エッジ / 面積0の面は 0 でなければならない
report(ob)   # 頂点数、面数、三角形数、バウンディングボックス、高さ

finish() は1つ以上の Build を単一のオブジェクトにマージし、面ごとにスムーズフラグを適用し、マテリアルを作成し、法線を再計算し、プレースホルダー UV を追加し、ビルドレポートを出力します。同じ名前の既存のオブジェクトを置き換えるため、ビルドスクリプトは再実行しても安全です。

ワークフロー

  1. モデリングの前にリファレンスを計測する。scripts/measure_silhouette.py をターンアラウンド画像に対して実行します。高さの3%ごとにシルエット幅が出力されます。その表を書き留めてください。プロポーションを目視で判断することは、ラウンドを失う最大の原因です。2 cm ずれたウエストは「少し間違っている」とは見なされず、「別のキャラクター」として認識されます。
  2. **ロフトでブロックする。**1つの Build で、パーツの順序: 胴体 → 脚 → 足 → 腕 → 手 → ミラー → 頭 → 髪の毛 → アクセサリー。ビルドごとに出力される PARTS ログを読み、どのパーツがポリゴンを消費しているかを把握します。
  3. シェーディングではなく、クレイでレンダリングする。preview.py、灰色の背景、テクスチャなし。シルエットと、サーフェスが接する部分のシェーディングの切れ目だけを判断します。
  4. 画像だけでなく、リファレンスモデルと比較する。compare.py はすべてを1つの高さにスケーリングし、頂点数/三角形数を並べて表示します。短い腕や奥行きの不足を、目で見るよりも早く検出できます。
  5. ゲートを通す。check() がクリーン、足が Z=0、三角形数が予算内。
  6. コピーを保存する。bpy.ops.wm.save_as_mainfile(filepath=…, copy=True) は、セッションの現在のファイルパスを乗っ取らずにファイルを書き込みます。

落とし穴 — これらのそれぞれが少なくとも1回のやり直しを引き起こしました

  1. **別々のシェルは必ず交差する。**同程度の半径を持つ2つのロフトは、サーフェスが交差する場所にギザギザの継ぎ目を生成し、いくら調整しても隠せません。外側の衣服にジョイントを任せてください: ズボンがヒップを形成し、胴体はそれらの内側に埋め込まれた小さなキャップに向かって先細りになり、クロスオーバー部分はベルトの下に隠れます(ベルトは体よりも幅広にする)。腕→肩、ズボンの裾→ブーツでも同じテクニックを使用します。
  2. **突き出たキャップは破れたエッジのように見える。**別のシェルと Z を共有するキャップは、目に見えるギザギザのリングを生成します。キャップは他のシェルの厳密に内側に保つか、キャップを使用しないでください。
  3. **股間を埋める。**2つの重なった脚の管は、x=0 に深い谷を作ります。前面がズボンと同じ高さの細い胴体コーンでブリッジしてください。薄すぎると黒い溝ができ、広すぎるとオムツのようになります。
  4. **髪の毛: シェルから顔のスロットを切り抜かないこと。**各行について、スロット内の列は約0.45の半径スケールと小さな +Y 方向への押し出しを受け、スロットの半角(行によって 26–34°)を約10°過ぎたあたりで完全な半径に戻ります。頭部を離れるクアッドは、顔の正面ではなく頬のラインに沿って出ていきます。30°のランプは髪を顔全体にかぶせます。押し出しなしで縮小すると、頬の横に大きな薄い内壁が残ります。
  5. **前髪の裾を列のパリティで交互にしないこと。**偶数列数の場合、j % 2 は中心に深い歯のノッチを作成します。列の角度の滑らかな関数を使用してください。
  6. **髪の毛は閉じたロフトボリュームであり、カードではありません。**例: 20 列 × 11 行、フラットシェーディング、切り刻まれた外観のための頂点ごとのゆらぎ。下の行を後方にスイープしないと、プロファイルがフードのように見えます。
  7. **チェーンは浮く。**ネックレスの弧は胸の表面から数ミリメートル以内に保ってください。そうしないと、斜めからのビューで空間に浮いたワイヤーのように見えます。
  8. **長さでスケーリングする前に、すべての方向ベクトルを正規化する。**正規化されていないベクトルは、1 m の親指を生成しました。
  9. **mirror_x は mark() から (len(v), len(f)) を受け取る。**ミラーリングされた面は巻き順を逆にする必要があります。頂点インデックスを渡すと、メッシュが静かに破損します。
  10. **最初にすべての選択を解除せずに join() してはいけない。**残ったデフォルト キューブがキャラクターに吸収される可能性があります。オブジェクト名で選択をフィルタリングしてください。
  11. リファレンス FBX のインポートでは、アーマチュアを削除する前に parent_clear(type="CLEAR_KEEP_TRANSFORM") が必要です。リグは一般的にスケール 0.01 で、100 スケールのメッシュがそれにペアレントされています。その後、トランスフォームを適用し、バウンディングボックスの中心(最小値ではない)に配置します。そうしないとモデルが並びません。
  12. 高さのあるプレビューカメラ: 水平オフセットは cos(elev) でスケーリングする必要があります。そうしないと、ショットが空の背景をフレーミングします。
  13. **レンダリングではなく、ジオメトリに対してゲートを実行する。**縮退したクアッドは正面図では問題なく見えても、ワイヤーフレームを台無しにする可能性があります。そのために check() が存在します。

レビューパス

preview.py は、オブジェクトのバウンディングボックスから派生した、4つの全身ビューと2つのクローズアップを提供します。確認するポイント: ギザギザのシェル交差、平らな棚のように見えるキャップ、股間、衣服の接合部、髪のプロファイルが髪かフードか、顔のスロットがクリアかどうか。

最終ゲート:

from psx_build import check
check(ob)   # ルーズ頂点、ルーズエッジ、面積0の面 → すべて 0

さらに: バウンディングボックスの z.min == 0、高さ、三角形数、スムーズフラグが正しいこと。

実例 — 実際のキャラクター

このライブラリで構築された、身長 1.744 m のゴシック少女、Tポーズ、メッシュのみ: 1225 頂点 / 1079 面 / 2294 三角形、26 の n-gon(キャップ)、4 の三角形、残りはすべてクアッド。足は 0 に。1つのマテリアル、1つのプレースホルダー UV マップ。

リファレンスシートから計測された幅(z → シルエット幅(メートル))。これはボディテーブルの基になったものです:

z幅z幅
1.660.2451.050.242
1.5750.3220.960.295
1.490.3490.8750.314
1.400.4030.610.330
1.2250.2650.260.452
1.140.1800.05250.449

数値自体よりも、方法が重要です: 1つの表、1回のロフトパス、そしてレンダリングに基づく数値補正。そのビルドでは、腕の長さだけは画像ではなくリファレンスモデルを必要としました。画像の腕は約20°垂れ下がっているため、水平スパン(1.457 m)は実際の腕の長さを過小評価しています。角度のある状態で計測されたものは、Tポーズのリファレンスモデルと比較してください。

ここでは対象外

テクスチャリング、リギング、エクスポート。smart_project からのプレースホルダー UV はアイランドであり、実際のアトラスではありません。テクスチャリングを開始する際: 1つの 256² または 512² アトラス。髪の内側のサーフェスを暗い領域に保ち、シェルのエッジが奥行きとして読まれるようにし、顔をペイントします — メッシュはマスクのままです。

関連スキル