CommunityImagegithub.com

modélisation-ps1

À utiliser pour modéliser, affiner ou réviser un personnage ou accessoire low-poly de style PS1/PSX dans Blender — un asset de jeu rétro, un portrait low-poly à partir d'une référence de tournevis, un maillage de cheveux à facettes, ou tout ce qui doit respecter le budget de polygones et les conventions des assets PlayStation 1.

Qu'est-ce que modélisation-ps1 ?

Ce skill spécialisé pour agents IA (Claude Code, Cursor, Codex, etc.) guide la modélisation low-poly de style PS1/PSX dans Blender. Il est conçu pour les développeurs de jeux, artistes techniques et ingénieurs logiciels créant des assets rétro avec des contraintes sévères de polygones (500-1500 sommets / 1000-2500 triangles) et utilisant un seul atlas de textures peint. Le skill fournit une API Python complète (`psx_build.py`), des outils de vérification (`check()`, `report()`, `preview.py`, `compare.py`), et une méthodologie éprouvée basée sur des modèles de référence de jeux PS1 réels. Il automatise les étapes clés : mesure des proportions à partir d'une référence, construction par lofts, miroir, finition avec UVs et material, validation des contraintes (pas de sommets flottants, pas d'arêtes libres, budget de triangles). Il documente également les pièges fréquents (jointures de coques, crotch, cheveux) et fournit un exemple complet de personnage (1225 sommets, 2294 triangles) pour démontrer le workflow. Ce n'est pas un tutoriel basique mais un outil professionnel reproductible pour la production.

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

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Modélisation PS1 / PSX low-poly

Quel est le style

Le style PS1 = petit budget de polygones + un seul atlas de textures peint. Ce n'est pas de l'ombrage plat. Le corps est lissé (smooth shading) ; seuls les cheveux et les accessoires durs restent facettés. Ombrage plat sur tout le modèle évoque du low-poly de 2005, pas de 1997. Le détail vit dans la texture, donc le maillage est jugé sur la silhouette et le flux d'arêtes — jamais sur le détail de surface.

Conventions (mesurées sur des modèles de référence réels de l'ère PS1, pas devinées)

  • +Z vers le haut, le personnage fait face à −Y, les pieds sur Z=0, en mètres.
  • Un objet, un matériau, un atlas de textures. Les vêtements sont le maillage ; il n'y a pas d'objets séparés pour les habits.
  • 100 % d'ombrage lissé, sauf pour les cheveux et les accessoires durs.
  • Pas de normal maps, pas de PBR, pas de shape keys.
  • Pas de sommets flottants, pas d'arêtes libres, pas de faces d'aire nulle, pas de déchets non-manifold.
  • Des quads pour les coques du corps, des triangles uniquement là où la forme l'exige (pointes, bouchons).

Budgets de trois modèles de référence de jeux commercialisés :

modèlesommetstrianglesnotes
basemesh masculin riggé772154084 os, atlas 256², pose A, 1,98 m
Walking (PSXProp)349645tout triangles, atlas 512², pose T, 1,77 m
LE0GAR5489439 objets, un atlas 256², Rigify, 2,4 m

Ce sont les chiffres pour un corps nu riggé. Le volume des cheveux et des accessoires les dépasse légitimement — un personnage de 1225 s / 2294 tri avec une crinière complète, des lunettes, une ceinture et des bottes est toujours un personnage PS1. Ne sacrifiez jamais la silhouette pour atteindre un nombre dérivé d'un corps nu.

Configuration

scripts/psx_build.py est la bibliothèque ; les deux harnais sont des scripts avec configuration en haut.

scripts/psx_build.py           ring / ring_dir / Build / finish / check / report
scripts/preview.py             rendus ortho argile, vues dérivées de la bbox
scripts/compare.py             table de stats + comparaison côte à côte avec des modèles de référence FBX/OBJ
scripts/measure_silhouette.py  balayage largeur vs hauteur d'une PNG de référence

Mettez scripts/ dans sys.path et importez, ou copiez un harnais à côté de votre script de construction. Tout s'exécute dans Blender :

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

L'API

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

Une section transversale fermée. e est l'exposant de la superellipse : 2 = cercle, plus grand = plus cubique. Utile : 2,1 membres et tête, 2,2 jambes, 2,3 torse et ceinture, 2,6 paume. axis="X" place l'anneau dans YZ pour les membres le long de X. yoff={index: dy} pousse des sommets individuels — c'est ainsi qu'une bosse de poitrine, une courbe lombaire ou un siège est créé sans ajouter d'anneaux.

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é à Build.mirror_x(mark)

tube() prend un chemin de points et oriente chaque anneau le long de la tangente locale — utilisez-le pour les chaînes, les doigts et tout ce qui est balayé. rx/ry peuvent être des listes, une par point, pour un effilement.

finish(name, *builds, material=..., color=..., uv=True)
check(ob)    # la porte : sommets flottants / arêtes libres / faces d'aire nulle doivent être à 0
report(ob)   # sommets, faces, triangles, bbox, hauteur

finish() fusionne un ou plusieurs Builds en un seul objet, applique les indicateurs de lissage par face, crée le matériau, recalcule les normales, ajoute des UVs provisoires et imprime le rapport de construction. Il remplace tout objet existant du même nom, donc un script de construction peut être réexécuté en toute sécurité.

Workflow

  1. Mesurez la référence avant de modéliser. Exécutez scripts/measure_silhouette.py sur le tournevis : il imprime la largeur de la silhouette à chaque 3 % de la hauteur. Notez le tableau. Évaluer les proportions à l'œil est la plus grande source de tours perdus — une taille 2 cm décalée ne donne pas l'impression de « légèrement faux », elle donne l'impression d'un personnage différent.
  2. Esquissez avec des lofts. Un seul Build, pièces dans l'ordre : torse → jambes → pieds → bras → mains → miroir → tête → cheveux → accessoires. Lisez le journal PARTS imprimé après chaque construction ; il vous indique quelle pièce consomme des polygones.
  3. Rendez en argile, pas en ombré. preview.py, fond gris, pas de textures. Jugez uniquement la silhouette et la rupture d'ombrage là où les surfaces se rencontrent.
  4. Comparez avec des modèles de référence, pas seulement l'image. compare.py met tout à l'échelle à une hauteur et imprime les sommets/triangles côte à côte. Il détecte les bras courts et la profondeur plate plus rapidement qu'un regard.
  5. Porte. check() propre, pieds sur Z=0, nombre de triangles dans le budget.
  6. Sauvegardez une copie. bpy.ops.wm.save_as_mainfile(filepath=…, copy=True) écrit le fichier sans détourner le chemin du fichier en cours de la session.

Pièges — chacun d'eux a coûté au moins un aller-retour

  1. Des coques séparées se croisent toujours. Deux lofts de rayon similaire produisent une couture irrégulière là où leurs surfaces se croisent, et aucun réglage ne la cache. Laissez le vêtement extérieur posséder la jointure : le pantalon forme les hanches, le torse s'effile en un petit bouchon enterré à l'intérieur, et le croisement se cache sous la ceinture (ceinture plus large que le corps). Même astuce au bras→épaule et à l'ourlet du pantalon→botte.
  2. Un bouchon qui dépasse ressemble à un bord déchiré. Un bouchon partageant un Z avec une autre coque crée un anneau irrégulier visible. Gardez les bouchons strictement à l'intérieur de l'autre coque, ou ne mettez pas de bouchon.
  3. Remplissez l'entrejambe. Deux tubes de jambe qui se chevauchent laissent une vallée profonde à x=0. Reliez-la avec un cône de torse étroit dont l'avant est au niveau du pantalon. Trop fin et vous obtenez un sillon noir ; trop large et vous obtenez une couche.
  4. Cheveux : ne découpez pas l'emplacement du visage dans la coque. Pour chaque rangée, les colonnes à l'intérieur de l'emplacement reçoivent une échelle radiale d'environ 0,45 plus une petite poussée +Y, montant jusqu'au rayon complet environ 10° après le demi-angle de l'emplacement (26–34° selon la rangée). Le quad qui quitte la tête part ensuite à la joue au lieu de traverser le visage. Une rampe de 30° met les cheveux sur tout le visage ; un rétrécissement sans la poussée laisse une grande paroi intérieure pâle à côté de la joue.
  5. N'alternez jamais une frange par parité de colonne. j % 2 sur un nombre pair de colonnes met une encoche profonde de dent en plein centre. Utilisez une fonction lisse de l'angle de la colonne.
  6. Les cheveux sont un volume lofté fermé, pas des cartes — par exemple 20 colonnes × 11 rangées, ombrage plat, avec une ondulation par sommet pour l'aspect haché. Balayez les rangées inférieures vers l'arrière ou le profil ressemble à une capuche.
  7. Les chaînes flottent. Gardez un arc de collier à quelques millimètres de la surface de la poitrine ou il donne l'impression d'un fil suspendu dans l'espace dans les vues trois-quarts.
  8. Normalisez chaque vecteur de direction avant de le mettre à l'échelle par une longueur. Un vecteur non normalisé a produit un pouce de 1 m.
  9. mirror_x prend (len(v), len(f)) de mark(), et les faces miroirées ont besoin d'une inversion de l'ordre des sommets. Passer des indices de sommets corrompt le maillage en silence.
  10. Ne faites jamais join() sans d'abord tout désélectionner. Un cube par défaut restant est absorbé dans le personnage. Filtrez la sélection par nom d'objet.
  11. Les imports FBX de référence ont besoin de parent_clear(type="CLEAR_KEEP_TRANSFORM") avant la suppression de l'armature — les rigs sont souvent à l'échelle 0,01 avec un maillage à l'échelle 100 parenté dessus. Ensuite, appliquez les transformations et centrez sur le centre de la bbox, pas le min de la bbox, ou les modèles ne s'aligneront jamais.
  12. Caméras de prévisualisation élevées : le décalage horizontal doit être mis à l'échelle par cos(elev), ou le plan cadre un fond vide.
  13. Exécutez la porte sur la géométrie, pas sur le rendu. Un quad dégénéré peut avoir l'air correct dans une vue de face et ruiner le wireframe. check() existe pour cela.

Vérification

preview.py donne quatre vues en pied plus deux gros plans, toutes dérivées de la bbox de l'objet. Recherchez : des croisements de coques irréguliers, des bouchons apparaissant comme des rebords plats, l'entrejambe, les jonctions entre vêtements, si le profil des cheveux ressemble à des cheveux ou à une capuche, si l'emplacement du visage est clair.

Porte finale :

from psx_build import check
check(ob)   # sommets flottants, arêtes libres, faces d'aire nulle → tous à 0

plus : bbox z.min == 0, hauteur, nombre de triangles, indicateurs de lissage corrects.

Exemple concret — un personnage réel

Une fille gothique de 1,744 m, pose T, maillage uniquement, construite avec cette bibliothèque : 1225 sommets / 1079 faces / 2294 triangles, 26 n-gons (bouchons), 4 triangles, tout le reste en quads ; pieds à 0 ; un matériau, une carte UV provisoire.

Largeurs mesurées à partir de sa feuille de référence (z → largeur de silhouette en mètres), qui est ce à partir de quoi les tableaux du corps ont été construits :

zlargeurzlargeur
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

Les chiffres importent moins que la méthode : un tableau, un passage de lofts, puis des corrections numériques pilotées par les rendus. Dans cette construction, la longueur du bras était la seule chose qui nécessitait les modèles de référence plutôt que l'image — les bras de l'image pendent d'environ 20°, donc son envergure horizontale (1,457 m) sous-estime la véritable longueur du bras. Comparez avec un modèle de référence en pose T pour tout ce qui est mesuré avec un angle.

Hors de portée ici

Texturing, rigging et export. Les UVs provisoires de smart_project sont des îlots, pas un véritable atlas. Quand le texturing commence : un atlas 256² ou 512², gardez les surfaces intérieures des cheveux dans une région sombre pour que les bords de la coque ressemblent à de la profondeur, et peignez le visage — le maillage reste un masque.

Skills associés