SuperAPI AI 工具集

genre-metroidvania-roguelike

设计与创作

查看项目

更新于 10-31 12:25

技能介绍

用途

该技能面向 Metroidvania 与 Roguelike 类型的关卡搭建,核心是模块化房间、能力门(ability gate)、生物群系(biome)掌控,以及可在多次跑图之间保持可读性的修饰符。它属于 Blender AI 插件中的一类关卡生成配方,通过组合多个已有脚本完成从房间外壳到灯光、相机与预算检查的完整流程。

主要能力

  • 侧视模块化房间:基于 1 米网格,房间尺寸约 16×9 米,屏幕大小,采用 85mm 镜头营造正交感,每个生物群系使用一套独立调色板。
  • 房间外壳与平台:用 blockout.py 生成房间外壳(约 16×9 米、6 米高),并放置跳跃高度台阶的盒状平台(1.0–1.5 米抬升、3–4 米间隙)以及层间楼梯。
  • 房间套件模块:用 bevel_stack.py 在墙/地板模块上制作倒角(宽度 0.02、段数 1),使瓦片能够吸附并对齐、边缘清晰。
  • 道具布置:用 scatter_props.py 装饰每个房间(数量 6、簇 2)。
  • 能力门标记:用 pbr_material.py 为能力门道具赋予独特的自发光材质(emission_color 青色、emission_strength 3)。
  • 生物群系氛围:用 light_rig.py 添加一种生物群系氛围光(洞穴用 moonlight,遗迹用 horror_practical)。
  • 侧视相机:用 camera_rig.py 设置相机(azimuth_deg 0、elevation_deg 0、lens_mm 85、aspect 16:9)。
  • 预算检查:用 scene_audit.py 按每房间 tri_budget 20000 检查三角面预算。

使用方式

资料提供了一段 Python 配方代码,通过 runpy.run_path 依次调用各脚本,并传入 ARGS 参数。使用前需将 skills 变量设为该技能所在插件 skills/ 目录的父文件夹路径,target 设为要样式化/装饰的对象(示例为 SM_Asset)。代码依次执行:blockout.py 生成房间与平台/楼梯;bevel_stack.py 对目标对象倒角;scatter_props.py 散布道具;pbr_material.py 创建名为 MAT_AbilityGate 的自发光材质并应用到对象;light_rig.py 应用 moonlight 预设;camera_rig.py 创建名为 CAM_Room 的相机;scene_audit.py 执行场景审计。最终结果汇总在 result 字典中。

参考数值

资料给出的关键尺寸包括:房间(屏幕)16×9 米;网格单位 1 米;站立角色 1.8 米;单次跳跃 3–4 米高、5–6 米长;门洞 2×3 米;能力门开口从 1×1 米(变形球形态)到 2×3 米。

适用场景

适合在 Blender 中快速搭建 Metroidvania 或 Roguelike 风格的侧视关卡房间,尤其是需要模块化瓦片、能力门视觉标记、生物群系氛围与统一相机视角的迭代流程。

限制

资料未说明该技能对 Blender 版本、插件依赖、运行环境或性能上限的要求;未提供收费、价格或平台信息;未说明各脚本的完整参数列表与错误处理方式。以上内容暂未提供。