minecraft-water-ripples
从自然语言制作 Minecraft 高度场水波、落水涟漪、雨滴干涉和浅水回波,提供共享参数调试网页、预设、两种波动求解器和 Forge 1.20.1 可构建工程。用于可调式水面特效;不把二维波动系统当作完整流体、真实世界折射或焦散。
SKILL.mdskills/minecraft-water-ripples/SKILL.md
GitHub可调水波特效
将需求转换成共享 recipe.json,用工作台观察传播、衰减、干涉和材质,再生成 Forge 1.20.1 / Java 17 工程。附带模板是独立水面补片,并不自动替换原版所有水方块。
生成与调参
- 运行
node scripts/author.cjs --out <新目录> --preset rain。预设可选 default、rain、impact、shallow、magic。用--recipe <JSON路径>精确传入参数;两者同时指定时 JSON 覆盖预设。 - 生成目录的
workbench/index.html可直接打开。若环境需要 HTTP,运行node workbench/serve.cjs 8766,访问 localhost。优先给用户展示工作台,并根据其描述改半径、强度、传播速度、衰减、法线和色彩。网页可以导入和导出同一参数格式。 - 导出的文件放在目标实例
config/waterripple/recipe.json。/waterripple demo在玩家脚下创建水面;drop注入中心波纹;rain切换连续雨滴;reload重读配置并重建网格;off清除。 - 生成脚本只复制工程和写配置,不启动游戏、不自动向实例安装 JAR。实例启动和安装由当前用户任务决定。
参数含义与数值边界见 parameters.md。实现来源和三项目差异见 research.md。需要接入自己的物品、粒子或技能时读 forge.md。
实现约束
- 20 Hz 客户端 tick 内做三个子步,固定 60 Hz 模拟;帧渲染仅插值。不要跟随渲染 FPS 改传播速度。
- velocity 模式保存高度与速度;history 模式保存两时刻高度。切模式须重建,不能把已有速度当成上一高度。速度系数限定 0.1..1,超出需要重新推导数值稳定条件。
- 长度使用 Minecraft 格。半径先按
(grid-1)/width换到网格单位,网格分辨率会改变物理传播速度。需要指定“格/秒”时先根据宽度、分辨率与子步频率换算,不承诺分辨率无关的速度。 - 使用带吸收层或复制邻近边界的反射模式;正负高度可干涉。振幅限幅改变线性叠加行为,故测试干涉应在限幅未触发的区间。
- 客户端专用渲染,订阅器限制
Dist.CLIENT;ShaderInstance 由 RegisterShadersEvent 重建;独立缓冲立即完成该水面的 batch,防止不同参数串用。 - 水面透明且深度测试开启、仅写颜色;它是独立平面网格。原版水面附近应略微抬高,过大负振幅会穿进原版表面而被遮挡。不要宣称实现场景折射、SSR、反射地形或世界焦散。
- 网页是参数与算法预览,不能替代 Minecraft 截图验证;着色器包及半透明排序兼容性需要目标实例实测。
验证与交付
运行 node workbench/check-core.cjs,然后用 JDK 17 执行 gradlew build。Windows Unix socket 路径过长时可设置 JAVA_TOOL_OPTIONS=-Djdk.net.unixdomain.tmpdir=<短的可写目录>。勿更改用户全局 Java 配置。
若改了网页或求解器,检查预设、点击/拖动、暂停、清空、两模式、边界、JSON 导入导出以及 Java/JS 数值一致性。运行测试覆盖传播、衰减、正负干涉和限幅稳定性;说明构建、网页与游戏实测各自状态。交付参数、源码、JAR和工作台路径。