minecraft-space-rift
制作 Minecraft Forge 1.20.1 程序化空间裂缝、横向动态星河、立体蓝紫撕裂边缘及开合动画,提供共享 GLSL、14 个 JSON 预设和 Forge 源码接口。用于算法裂隙,不用于贴图裂缝、真实地形破坏或可穿越第二世界。
SKILL.mdskills/minecraft-space-rift/SKILL.md
GitHub程序化空间裂缝
先检查目标工程已有 Shader、参数系统、天空和异空间接口,优先复用。公开包包含独立 WebGL2 工作台、算法和接入资源。
- 使用
python scripts/create_project.py <新目录>复制资源。阅读生成目录的 README.md 和 NOTICE.md。 shader/geometry.js生成稳定种子的分形骨架;shader/parameters.js管理参数、质量及预设。改变种子或几何后更新骨架 Uniform,普通视觉变化直接更新 Uniform。rift_core.glsl计算开口,rift_rim.glsl和rift_horizon.glsl计算边缘及深度;保留物理局部坐标采样和导数抗锯齿,不拉伸固定纹理。- 横向干净裂隙选
horizon-slash、horizon-tear、horizon-giant,保留horizon=1。其它预设允许分支、破碎演出及算法风格。按需求禁用外围装饰。 - 内部渲染通过
interior-adapter.glsl替换;复用目标天空或子场景时明确相机、坐标与遮罩。内部只在真实开口可见。 - 用
python scripts/build.py生成 WebGL2、Shadertoy 和 Forge GLSL150;不手改生成文件。通过长度、宽度、progress/open/shrink/sequence 等参数控制演出。 - Forge 接入读
forge/src:使用世界位置与朝向,正确管理场景颜色副本、深度、混合及缓冲生命周期。背景折射必须使用真实场景缓冲;测试背景不能称为真实折射。 - 验证
node scripts/check_geometry.mjs、生成脚本、可选桌面 GL 测试和 Java17 Gradle 构建。游戏运行验收另行完成;浏览器或桌面 GL 通过不等于已验证 Minecraft。
修改前优先研究相关 Shadertoy 算法并保留来源;无法读取时说明限制。保留 psrdnoise 作者和 MIT 通知;附件衍生代码的许可边界见 NOTICE,不将组合整体宣称为 MIT。
随包统一工作台
运行 python assets/space-rift-kit/workbench/serve.py,或双击工作台目录的“启动空间裂缝工作台.bat”。入口 workbench/index.html,14 个预设共用同一画布,支持参数编辑、JSON 导入导出和 PNG 保存。样式与研究标签保留来源与验证边界。