Community编程与开发github.com

纸艺立体场景

在浏览器里把游戏、网页、动画和视频做成翻开的立体纸艺:卡纸铰链、暖色软阴影、微距移轴,题材不限。

纸艺立体场景 是什么?

一套可复用的网页纸艺视觉。插画卡纸从印刷地面上沿铰链立起,带一点过冲,投下柔软阴影,看起来像被微距拍到的纸模型。可用 three.js,也可用 Canvas、SVG 和 CSS。不依赖生图,也不是可打印的手工图纸。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xikhar/papercraft/tree/HEAD/skills/papercraft

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

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

文档

纸艺

一种风格,任意主题:内部视角的弹出式立体模型。插画卡片用墨水印刷在纤维纸板上,剪裁后通过铰链从印刷地面立起;它们会带着弹性过冲快速升起,然后稳定下来,在地面及彼此身上投下温暖柔和阴影,并通过一个向下观察这个世界的长焦微距镜头观看,带有浅移轴聚焦带,仿佛拍摄的是真实的纸质模型。这里的一切都源自以此风格发布的一款浏览器游戏,并通过评论轮次和用户反馈获得了报酬;这些数字是经得起考验的起点,并非装饰。需求始终优先于这些默认设置。

此技能教授一种方法:是什么让这种风格被识别,如何构建和打印任意作品,如何打光、构图、移动和检查它。您需要自己编写主题的作品。assets/ 中的代码是您可以导入的管道(纸张、卡片、分层打印、铰链、光线、镜头、行走场),以及从一个乡村世界阅读的工作示例,绝不是用于组装新主题的零件目录。

1. 材质模型(是什么让它读起来像纸)

在每次运行中正确设置这些;每一行都说明了原因。详细信息和更多数字位于 references/look.md 中。

  1. 一切都是具有厚度的平板。 形状仅来自切割、折叠、分层和插接,从未来自雕刻的体积。卡片厚度为主题物高度的 1.5-3%。零厚度的平面读起来像贴纸,而厚平面则像泡沫板。
  2. 死哑光。 仅漫射光,柔和的明暗交界线(环绕约 0.3),无镜面反射,无反射,无光泽。裁剪后的像素低于约 1%(只有小的被照亮窗格可能会裁剪)。任何掠射角度的光泽都读起来像塑料或湿的。
  3. 一种温暖的低调,柔和的彩色阴影。 主光源从侧面,与相机轴成 45-65 度角,向上 45-55 度(仅在黄金时刻和黄昏时为 20-35 度),并稍微朝向相机,以便阴影落在侧面和后面,即相机能看到的地方(相机后面的主光源会隐藏所有阴影)。正面补光约为主光源的 1/4-1/3,可防止面向相机的卡片变成灰色。阴影在卡片与地面接触处清晰,并随间隙扩大(半影约 0.2-0.3 x 间隙)。它们的色调来自世界:白天在温暖地面上呈暖琥珀色,雪地上呈淡紫色蓝色,水下呈深蓝绿色,夜晚呈深蓝色;作品本身在每一种色调中都保持温暖。永远不要有灰色或黑色的阴影,也不要有彩色雾气或滤镜覆盖画面。每个立着的作品都明显接触地面(接触变暗);仅使用主光源检查阴影(look.md 第 8b 节)。
  4. 每张印刷品都是一个小的分层纸拼贴画。 在每个厚实的剪影内部:3-5 种墨水,3+ 个明度层次,加上一个装饰,作为切割层从前到后铺在基材上,并带有一种质朴的纤维(绝不是长毛绒毡布或编织物):首先是结构(四肢、层级、瓦片行、框架、面板、条带),然后是与基底形成对比的醒目图案(叶子花瓣、铆钉面板线、鳞片、扇形、条纹、窗户)。每一层都会在其下方的东西上投下一个短暂柔软温暖的阴影,并在其受光边缘显示一条细淡色唇边;大的图层还会显示均匀的淡色切割边缘。这一对特征就是作品读起来像分层纸张而不是矢量填充的原因。没有裸露、单薄或尖锐的东西:没有线条低于作品约 2-3%,图案大且可数(乡村例子中的树冠携带 15-25 片叶子,每片约冠宽的 1/7)。在源项目中,印刷插图是最大的质量提升(在盲测中以 6/6 的比分完胜普通卡片)。工具包:P.layer、P.parts、drawnPiece、P.marks、P.rim。
  5. 切割边缘。 在剪影处有一条细的黑棕色线(卡片的厚度和印刷轮廓,在屏幕上约 1.5-2.5 像素),并且仅在面向光线的边缘处有一条位于其内侧的淡色高光。永远不要在四周形成均匀的淡色或白色条带(贴纸光晕),永远不要发光,永远不要撕裂。折叠不是切割:铰链底座和面板接合处没有边缘。任何卡片都不能被看到侧面像刀刃一样薄的切片。
  6. 一个向下观察世界的微距镜头。 长焦镜头(24-32 度垂直视场角),相机向下 40-55 度,印刷地面延伸至画面边缘之外:视野中看不到地平线、天空、背景、书边或桌子(除非需求字面上是一本书或 UI 内的页面)。一个清晰的条带覆盖主角场景画面高度的约 36-45%(测量:measure.py focusHeight >= 0.35),模糊度向上和向下增加到 12-18 像素半径(在 1080p 下)(3D 模板为 18;2D 模板为 9,作为 Canvas blur() 的 sigma 值),由深度和屏幕高度共同驱动。与底部边缘重叠的大而模糊的作品体现了微缩模型的尺度感。
  7. 需求自身的调色板,以纸张方式构建。 从您的主题、情绪和时间推导颜色(palettes.md 第 3 节):切勿直接使用示例场景或起始调色板的十六进制颜色(盲测中,有人将示例的屋顶和绿色复制到了空间站)。保持不变的是:作品承载的一个主导色系,位于浅色、柔和的基底上(比卡片亮约 0.16-0.22,饱和度低约 0.16-0.25),因此作品承载了颜色;每件作品有一到两个与其基底形成对比的强调色(锈色圆顶上的奶油色铆钉,橙色树上的红色叶子),绝不使用同色系搭配。用鼠尾草绿代替电子游戏绿,用奶油色代替白色,用暖墨色代替黑色。画面平均饱和度(HSV S)约 0.55-0.75。色彩分级会暖化已写的颜色(橄榄卡其色地面变为芥末色,灰色蓝绿色鼠尾草变为蓝绿色):创作者将基底和水面调得更蓝更灰一度,然后检查画面(measure.py --palette)。
  8. 密集、厚实、可读。 一个完整的模型世界,而不是平地上的道具:大约 20 种共 100-250 个作品(底座在画面内的站立卡片),以 4-8 个不同作品为一组紧密排列(乡村示例:一棵树、灌木卡片、一块岩石、花朵、一只动物;珊瑚礁:一个珊瑚头、海绵、海带、一条鱼;车站:板条箱、一段管道、一盏灯、一个机器人),视野中最多约 3 个相同的道具,清晰区域密集(measure.py barePct <= ~55),开放地面主要位于其外部(路径、水域、少量空地)。地面保持平坦:高度来自嵌套的平行卡片(3-5 个弧形帆,明度阶梯变化约 10-15%:山丘、沙丘、堤岸、雪堆)和露头岩石,绝不用凸起的地形块(mechanisms.md 第 8 节)。主角是比例人物(3D 中 3.6 个单位,2D 中约 3.2 个单位;仅展示地点而无角色的需求可保留几个人物),占画面高度的 6-10%:一个小的 3D 纸质模型(约 10-20 张卡片),从各个侧面都能识别,并转向其行走方向(每个部分由一张正面卡片和一张其后的侧面轮廓卡片组成;腿和手臂在枢轴上,随行走距离摆动;前倾并倾斜进入转弯),绝不是一张平面卡片,拥有可识别的面部、服饰细节、厚实的玩具般比例以及与环境形成对比的颜色,并站在清晰区域内(mechanisms.md 第 12 节,motion.md 第 8 节;示例场景中的 heroDoll 就是一个模型)。作品相对于他显得厚实(尺寸和布局:worlds.md 第 8-9 节);本身是地标的主角可能占据画面的 25-35%;高大地标是顶部被画面边缘切割的分层平板。
  9. 被行走在其上、下或内部的东西是用 3D 构建的,绝不是立着的平面。 立着的卡片仅用于从正面看并绕行的物体(树木、灌木、道具、小动物、远背景山丘)。可行走的高度是开放式结构:桥梁是具有冠面板(横跨的木板)的甲板斜坡,介于向外倾斜的拱形切割栏杆侧面之间;码头、栈桥或观景台是柱子上的木板甲板(platform() 带有柱面,缺口切割至底部);楼梯是两个阶梯式侧板上的薄木板踏板(踏步高度 <= 英雄身高的约 1/8);走道是两个侧卡片之间的木板甲板。带有印刷面的实心盒子(terrace())仅用于需求中明确提到的砌体结构(如码头墙、舞台),绝不用于自然地形。任何可进入的物体都是带开口的折叠盒子;水域、路径和田野被印刷到页面中。行走逻辑读取相同的结构:脚在甲板上;栏杆、墙壁和水域阻止英雄前进(WalkField,mechanisms.md 第 14 节)。
  10. 纸张通过绕折痕旋转来移动。 快速升起,带有 8-15% 的超调量和 2-3 周期的颤抖,约 1 秒内静止;落下较柔和,有一次轻微拍打地面;部件之间延迟 0.05-0.1 秒;无不缩放、拉伸或淡入淡出。连续运动(空闲摇摆、行走上下颠簸)保持微妙:用户将评论要求的上下颠簸削减了 2-3 倍。
  11. 声音(如果有)应柔和、低沉、沉闷且稀疏。 基于噪音的扑动声,每姿态一次,至少间隔约 0.5 秒。

2. 编码之前:编写纸张规格

将此块写入您的计划(或主文件顶部的注释),并用数字填写每一行。然后审核它:“对于任何类似提示,我会写出完全相同的规格吗?”如果是,则将调色板、印刷图案和剪影推向主题自身的世界(火星穹顶获得带有印刷铆钉和面板线的锈色和氧化物卡片;珊瑚礁获得带有扇形边缘的珊瑚、海带和蓝绿色水面卡片;绝不使用模板的乡村默认设置)。随主题变化的是:剪影和印刷图案、调色板和情绪光、构建形式的机制、英雄行走的场所、布局以及世界在纸页扑动声下的自身声音。永不改变的是:法则 1-11。

主题   世界及其独特之处(只有此项目具备的内容),以及读者首先看到的内容
纸张   每层使用的纸(卡片纸 / 牛皮纸 / 水彩纸 / 建筑纸 / 薄绵纸 / 瓦楞纸),纤维含量
调色板 从此需求派生的 4-7 个十六进制颜色(palettes.md 第 3 节),并指定角色:浅/深色地面、主导色系、
        2 个对比强调色、墨水色、阴影色调、雾状色;不从示例中复制
光线   主光源颜色 + 方向(方位角 / 仰角度数),正面补光比例,阴影色调,夜间 / 实用光源
镜头   视场角,俯仰角(40-55),清晰带占画面百分比,最大模糊半径 px@1080,与底部边缘重叠的部分
地面   此世界的地面材质及其自身特征(甲板板、沙波纹、雪堆、苔藓、瓷砖);仅当需求包含时才使用水域
布局   主题自身的引导线(小路、走廊、洋流、滑雪道、航道)、地标、英雄位置、
        分组和空地、作品类型(15-25 种)
运动   使用的机制,升起/落下时序,延迟,空闲摇摆幅度,相机行为
声音   无 | 扑动声 + 脚步声(+ 音乐);音量级别
禁忌   特征标志(look.md 第 12 节)+ 任何此作品不应成为的东西
质量保证 将捕获的帧/尺寸及其分别展示的内容

3. 选择构建路径

仅在需要时阅读任务所需的内容(references/ 中的所有文件)。第一帧之前的最低要求:

  • 3D 场景或游戏: 从 assets/templates/popup-3d/ 开始(按原样使用 harness.js + 您自己的 scene.js);阅读 three-js.md 的第 1、3、5、8 节,procedural-art.md 的第 0、3、4 节,mechanisms.md 的第 5、7、8、12、14 节,look.md 的第 5、8b、11 节以及 palettes.md 的第 3 节。
  • 2D 场景、插图、横向卷轴游戏: 从 assets/templates/popup-2d/ 开始(按原样使用 harness-2d.js + 您自己的 scene.js);阅读内容相同,但将 three-js.md 替换为 web-2d.md 的第 2-3 节。
  • 网页或应用 UI、HUD、菜单: 阅读 paper-ui.md、web-2d.md 的第 4-5 节(CSS 和 SVG)、palettes.md 的第 3 节。
  • 视频: 阅读 motion.md 的第 11 节,然后遵循 2D 或 3D 路径及其 step() 捕获。
  • 非浏览器引擎(Godot、Unity、Unreal、Blender):阅读 engines.md(移植说明,未经测试)以及 scripts/paper_textures.py 以获取纹理文件。

然后,当问题出现时:

问题阅读工具包
您的作品:道具、角色、建筑、生物、机器、植物procedural-art.mdprintCard + P.layer / P.parts 或 drawnPiece
您的结构:十字形、盒子折叠、平台、分层平板、桥梁、码头、楼梯mechanisms.md(第14节:构建地面)hinge、crossCard、layeredCard、boxFold、platform、WalkField
时序、弹簧、木偶、相机motion.mdFlapSpring、windSway、FixedClock (lib/paper-motion.js)
无尽世界、跟随英雄的相机、构图worlds.md示例 scene.js 中的填充
颜色;声音和音乐palettes.md;sound.mdassets/palettes.json;lib/paper-sound.js
规划、测量、评论、收尾process.mdscripts/measure.py、scripts/ab_sheet.py

编写您自己的作品。 assets/lib/ 是此风格下每个项目都可以导入的管道(将其复制到您自己的文件夹:three-js.md 第 1 节,web-2d.md 第 3 节)。您世界中的每一个物体(树木或珊瑚、房屋或穹顶、桥梁或龙门架、生物、英雄)都需要您使用参考资料中的配方为您的主题设计。assets/examples/ 和模板场景是一个以此方式构建的乡村世界:阅读它们以了解配方如何变成代码,但绝不能从这些部件中组装一个火星基地或珊瑚礁并配上新的调色板;替换场景,保留框架。来自 examples/built-ground.js 的构建(bridge、stairs、ramp;terrace 仅用于砌体结构)在合适时可以导入,并通过 paints 应用您的印刷图案;大多数需求需要它们自己的构建(高跷码头、下垂的索桥、龙门架),使用相同的方式在 platform、boxFold、makeCard 和 hinge 上构建。

4. 工作流程

  1. 规格和目标。 填写纸张规格。如果您有一个目标图像(用户提供或生成的),使用 scripts/measure.py 测量它;否则,规格中的数字就是目标。
  2. 在一张测试卡片上证明材质 在构建内容之前:一张印刷卡片立在印刷地面上,使用最终的光线和镜头(3D:?test,一旦您的场景根据 H.flags.TEST 分支:three-js.md 第 1 节)。检查:哑光、温暖的接触阴影、切割边缘(暗线 + 受光侧高光)、纤维

…

[为翻译而截断]

相关技能