Community图像github.com

PS1/PSX 低多边形建模

用于在 Blender 中建模、优化或审查 PS1/PSX 风格的低多边形角色或道具——包括复古游戏资产、基于转描的低多边形肖像、刻面发型游戏网格,或任何需要符合 PlayStation 1 资产多边形预算和规范的内容。涵盖程序化构建脚本工作流、放样库、参考图比例测量、预算控制以及最耗时的失败模式。

PSX 低多边形建模 是什么?

该技能提供了一套完整的 PS1/PSX 风格低多边形建模工作流,基于实测的经典游戏资产规范,专门用于 Blender 环境。核心在于一个可复用的程序化构建脚本库 (`psx_build.py`),通过 `Build.loft()`、`Build.tube()` 等 API 快速生成并组合放样体,并内置了 `finish()`、`check()`、`report()` 等函数来合并对象、执行清洁度检测和预算统计。技能支持 Claude Code、Codex 等 AI 编程助手,建议用户在建模前使用 `scripts/measure_silhouette.py` 测量参考图比例以避免迭代返工,并使用 `scripts/compare.py` 与参考模型对比。此外,文档详细列出了 13 个常见陷阱(如壳交叉、头发面片化、镜像操作错误等),并提供了完整的建模工作流:测量参考 → 放样分件 → 素模渲染 → 对比验证 → 清洁检查 → 保存备份,确保输出的网格质量符合 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 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

PS1 / PSX 低多边形建模

风格定义

PS1 风格 = 小多边形预算 + 单张绘制纹理图集。它不是平面着色。 主体部分使用平滑着色;只有头发和硬表面道具保持刻面。对整个模型使用平面着色读起来像是 2005 年的低多边形,而不是 1997 年的。细节存在于纹理中,因此网格的评判标准是轮廓和边流——而不是表面细节。

规范(根据实际 PS1 时代参考模型测量而来,非猜测)

  • +Z 轴向上,角色面向 −Y,脚部在 Z=0,单位为米。
  • 一个对象,一个材质,一张纹理图集。衣服就是网格;不存在独立的衣物对象。
  • 100% 平滑着色,头发和硬表面道具除外。
  • 无法线贴图,无 PBR,无形变键。
  • 无游离顶点,无游离边,无零面积面,无非流形垃圾。
  • 主体壳使用四边面,只有形状需要的地方(尖端、顶盖)才使用三角面。

三个已发布参考模型的预算数据:

模型顶点数三角面数备注
带骨骼的男性基础网格772154084 根骨骼,256² 纹理图集,A 姿势,1.98 米
行走(PSX 道具)349645全三角面,512² 纹理图集,T 姿势,1.77 米
LE0GAR5489439 个对象,一张 256² 纹理图集,Rigify 绑定,2.4 米

这是一个带骨骼的裸体角色。头发体积和配件可以合理超出这个数字——一个拥有完整发型、眼镜、腰带和靴子的 1225 顶点 / 2294 三角面角色仍然是 PS1 角色。切勿为了达到裸体角色的预算数字而削减轮廓。

设置

scripts/psx_build.py 是库;两个管理器是配置在顶部的脚本。

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)

一个封闭的横截面环。e 是超椭圆指数:2 = 圆形,更大 = 更方。 常用值:2.1 用于四肢和头部,2.2 用于腿部,2.3 用于躯干和腰带,2.6 用于手掌。axis="X" 在 YZ 平面绘制环,用于沿 X 轴的肢体。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() → 传递给 Build.mirror_x(mark)

tube() 接受一系列点作为路径,并将每个环沿局部切线方向定向——用于链条、手指和任何扫掠形状。rx/ry 可以是列表,每个点对应一个值,用于实现锥度效果。

finish(name, *builds, material=..., color=..., uv=True)
check(ob)    # 关卡:游离顶点 / 游离边 / 零面积面必须为 0
report(ob)   # 顶点数、面数、三角面数、包围盒、高度

finish() 将一个或多个 Build 对象合并为单个对象,按面设置平滑标志,创建材质,重新计算法线,添加占位 UV 并打印构建报告。它会替换任何同名的已有对象,因此构建脚本可以安全地重复运行。

工作流

  1. 在建模前测量参考图。 对转描图运行 scripts/measure_silhouette.py:它会打印每 3% 高度处的轮廓宽度。把表格写下来。目测比例是导致迭代返工的最大原因——腰围偏差 2 厘米不会表现为“轻微错误”,而是会变成完全不同的角色。
  2. 使用放样进行分块。 在一个 Build 中,按顺序分件:躯干 → 腿部 → 脚 → 手臂 → 手 → 镜像 → 头部 → 头发 → 配件。每次构建后阅读打印的 PARTS 日志;它会告诉你哪个部分消耗了大量多边形。
  3. 渲染素模,而非材质预览。 使用 preview.py,灰色背景,无纹理。只评估轮廓和表面交汇处的着色过渡。
  4. 与参考模型对比,而非仅对比图片。 compare.py 将所有模型缩放到同一高度,并并排打印顶点数和三角面数。它比肉眼更快地发现短臂和扁平深度问题。
  5. 关卡。 check() 保持干净,脚部在 Z=0,三角面数在预算内。
  6. 另存副本。 bpy.ops.wm.save_as_mainfile(filepath=…, copy=True) 写入文件,不会劫持会话的当前文件路径。

陷阱——以下每个都至少导致过一次返工

  1. 分离的壳总会相互交叉。 两个半径相似的放样体在它们的表面相交处会产生锯齿状接缝,再多的调整也无法隐藏。让外层衣物控制接合点:裤子构成臀部,躯干逐渐变细成一个埋藏在裤子内部的小顶盖,交叉点隐藏在腰带下(腰带比身体宽)。同样的技巧用于手臂→肩膀和裤脚→靴子。
  2. 外露的顶盖看起来像撕裂的边缘。 与其他壳共享 Z 位置的顶盖会形成可见的锯齿状环。将顶盖严格保持在另一个壳内部,或者干脆不封顶。
  3. 填充裆部。 两个重叠的腿部管道会在 x=0 处留下一个深谷。用一个窄的躯干锥体桥接它,其前面与裤子齐平。太薄会形成黑色凹槽;太宽会变成尿布。
  4. 头发:不要从壳上切出面部插槽。 对于每一行,插槽内的列获得约 0.45 的径向缩放加上一个小的 +Y 推力,在大约超出插槽半角(按行 26–34°)10° 处逐渐过渡到完整半径。离开头部的四边面随后会从脸颊离开,而不是横穿面部。30° 的过渡会使头发覆盖整个面部;没有推力的缩小会在脸颊旁边留下一个大的苍白内壁。
  5. 切勿按列奇偶性交替发梢边缘。 在偶数列数上使用 j % 2 会在正中心产生一个深的牙齿缺口。使用列角度的平滑函数。
  6. 头发的放样体是封闭的体积,而不是卡片——例如 20 列 × 11 行,平面着色,并带有每顶点波动以实现参差不齐的效果。将较低的行向后扫掠,否则轮廓会看起来像兜帽。
  7. 链条会漂浮。 将项链弧线保持在胸部表面几毫米以内,否则在四分之三视角下看起来像挂在空中的线。
  8. 在按长度缩放之前,对每个方向向量进行归一化。 未归一化的向量曾产生过一个 1 米长的拇指。
  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 提供四个全身视图和两个特写视图,全部基于对象的包围盒生成。检查:锯齿状的壳交叉、显示为平坦台阶的顶盖、裆部、衣物接合处、头发轮廓是头发还是兜帽、面部插槽是否清晰。

最终关卡:

from psx_build import check
check(ob)   # 游离顶点、游离边、零面积面 → 全部为 0

以及:包围盒 z.min == 0、高度、三角面数、平滑标志是否正确。

实例——一个真实角色

一个 1.744 米高的哥特少女,T 姿势,仅网格,使用此库构建:1225 顶点 / 1079 面 / 2294 三角面,26 个 N 边形(顶盖),4 个三角形,其余为四边面;脚部在 0;一个材质,一张占位 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

数字本身不如方法重要:一张表格,一轮放样,然后通过渲染驱动的数值修正。在该构建中,臂长是唯一需要参考模型而非图片的地方——图片中的手臂下垂约 20°,因此其水平跨度(1.457 米)低估了真实臂长。对于任何以角度测量的东西,都要与 T 姿势的参考模型进行对比。

不在此范围

纹理绘制、绑定和导出。来自 smart_project 的占位 UV 是孤岛,而非真正的纹理图集。当开始绘制纹理时:使用一张 256² 或 512² 纹理图集,将头发的内表面保持在深色区域,以使壳边缘看起来有深度感,然后绘制面部——网格始终保持为遮罩。

相关技能