SuperAPI AI 工具集

voxel-style

设计与创作

查看项目

更新于 10-31 12:24

技能介绍

Voxel Style 是 Blender AI 插件项目中的一项体素风格技能,核心是“方块网格语言”:限定色板、区块友好的形体,以及明确的体素占用规则。其页面说明了何时使用、核心原则、工作流、建模要点、材质要求、与 lowpoly 风格的区别、约束条件以及随附脚本。

用途与适用场景 该技能针对 Minecraft 邻近风格或体素游戏资产、作为最终风格使用的 blockout 美学,以及需要网格吸附的道具和角色。它强调与 lowpoly-style 的区别:lowpoly 允许不规则低面数与 PS1 质感,而 voxel-style 强制网格占用美学。

主要能力与原则 核心原则包括:在明确的体素尺寸(如 0.1m 或 1.0m)上做占用与网格吸附;不使用对角线式有机倒角,坚持立方体与阶梯形体;采用少量颜色、可读方块的小色板图集;通过阶梯而非平滑曲线塑造轮廓;保证区块模块化,使部件适配瓦片尺寸。

使用方式与工作流 推荐流程为:选择体素尺寸 → 规划方块占用 → 合并立方体 → 设置色板材质 → 可选几何节点实例化 → 导出。建模提示包括:从立方体开始,使用布尔并集或按距离合并;角色使用阶梯状肢体与清晰头部方块;避免细分曲面以免破坏体素语言;仅当从平滑模型转换时才重网格化为方块。材质方面使用平色或最近邻纹理,优先图集,发光块少量使用自发光。

脚本 随附 scripts/voxelize.py,通过 Remesh 修改器的 Blocks 模式对网格进行非破坏性体素化,启用平面着色,可选应用修改,并报告体素数量估算。脚本经官方 Blender MCP 在 Blender 5.2 LTS 上测试,可通过 execute_blender_code 或 headless 方式运行;运行前应阅读脚本头部了解各参数。页面给出的调用示例为 import runpy; result = runpy.run_path("<skill_dir>/scripts/voxelize.py", init_globals={"ARGS": {...}})["result"],ARGS 包括 objects、voxel_size、apply。若用户自行在 Blender 中粘贴代码,应提供指向该已安装脚本绝对路径的简短 runpy 调用,不要内联或重写脚本。

约束与限制 必须做到:在任务说明中声明体素尺寸、保持一致吸附、保持小色板。不得做到:为 Blender 5.2 之前版本编写代码或版本回退(插件面向 5.2+,旧分支会教授已不存在的 API);使用隐藏方块边缘的平滑着色(刻意玻璃除外);添加有机雕刻细节。参考文档包括 references/voxel-grid.md 与 references/voxel-characters.md,按需加载。