# Gameplay Surface Aftermath

> 为倾倒或碰撞后的水洼等表面余效实现承载面采样、边界截断与受控网格生成，修复悬空和穿边；不负责真实流体或玩法碰撞。

- Skill: `ziyou-lu/gameplay-surface-aftermath` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx get-skill add ziyou-lu/gameplay-surface-aftermath`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ziyou-lu/gameplay-surface-aftermath/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ziyou-lu (https://skillmd.com/u/ziyou-lu)
- Updated: 2026-11-19
- Page: https://skillmd.com/skills/ziyou-lu/gameplay-surface-aftermath

---


# 表面余效的贴地与边界适配

## 效果预览

同一瓶水倒向台阶；左侧平水片跨过低面悬空，右侧分段贴合高低表面。

左侧为使用前，右侧为使用后；斜视 2.5D 短循环，用途示意（非引擎实测；音频相关预览仅示意触发关系，不含声音）。

![水洼贴住台阶，不悬在半空：使用前后对比](assets/before-after.webp)

## 触发条件

- 倾倒、碰撞等事件留下的水洼或其他表面余效悬空、穿出边缘，或无法顺应台阶高低。
- 固定平面/圆形水片不匹配窄槽或阻挡物，需要独立处理余效覆盖与承载地形的一致性。

## 输入与前置条件

真实事件位置、允许承载的表面、必须截断的边界/阻挡物、视觉覆盖范围、生命期与生成频率，以及余效仅为视觉还是影响真实玩法。另确认项目可承担的采样/网格更新成本。

## 实施步骤

1. 固定事件位置，调试显示允许承载的面与必须截断的边界，区分高度悬空和横向穿边问题。
2. 选择能满足地形约束的表示；简单地形可保留低成本表示，复杂台阶/窄槽再考虑采样网格，不强制所有余效使用同一管线。
3. 采用扩散采样方案时，从中心按有界 BFS 扩展候选球/体积样本；先设范围、采样间距和数量上限，确保队列终止。
4. 横向查询墙/阻挡并剔除不合法样本，向下查询允许地面后设置高度；无支撑、跨禁区或落到错误层的样本不生成。明确射线层和有效距离。
5. 用保留样本构建体积场并选择合适网格提取方法，例如 Marching Cubes；检查台阶、边缘和窄槽的视觉连通性，单独控制更新频率与缓存。
6. 绑定余效寿命、连续生成上限和卸载清理。视觉覆盖若承载危险信息需服从真实规则；网格贴地不自动产生流体、体积守恒或碰撞。

## 调参顺序

先调采样间距与边界误差，再调网格细度和更新频率；记录连续生成的峰值成本。保持采样范围/数量有限，以窄槽和台阶用例决定精度，不给通用体素大小。

## 失败处理

无有效支撑时不悬空生成；预算耗尽时采用明确截断/降级，不继续无界扩散。穿边查阻挡过滤，浮空查承载层，网格细节失败不能用真实碰撞变化补救。

## 验收

- [ ] 在同一事件位置与相机下比较平地、台阶、边缘、窄槽和墙边，逐个确认目标承载面贴合与边界处理符合设计，不跳过边界用例。
- [ ] 视觉覆盖不误导玩家对可行走/危险区域的判断；只改表现时不擅自改变碰撞和玩法范围，规则改动另有测试。
- [ ] 连续生成与清理时，实例数、采样/网格更新成本和残留状态受控；明确所选表示的适用场景，不由少数视觉结果推定复杂地形一律可用。

## 组合与边界

只在需要相应机制时读取，保留表面余效独立的承载面与边界职责：

- [接触闪光、冲击帧与粒子](../gameplay-impact-visuals/SKILL.md)：处理事件发生瞬间的接触标记、爆发和尾迹；不在这里复制其命中反馈流程。
- [攻击预警与反制可读性](../gameplay-attack-readability/SKILL.md)：仅当表面余效承载真实危险区域时，复用表现与判定对齐的验收，不凭水面外形新增伤害规则。

需要核对案例、参数出处或证据边界时，读取[来源参考](references/sources.md)。

