09 · 组合独立光影包
把前四章的功能收敛为 Amber 独立光影包:轻微暖对比、昼夜/降水权重、石沙材质响应和可选柔光。前置:08。完成后能维护 fragment 边界、复现预设,并为缺失 Mod 内容提供 fallback。
本章修改与完整包
根 shaderpack.json 保留身份、shaderRoot、settings、frameTarget、sourceFormatVersion=1 与 fragments 顺序列表。options/resources/programs/passes 分别放进 manifest/,sceneCategories 跟随 passes;materials/customData 放在 data.json。新增三个完整选项预设和可选 Mod selector。
资源流
fragment 是声明组合,不是补丁:数组按根列出的顺序拼接,重复 ID 仍失败。settings 与 frameTarget 只属于根;当前组合式 v5 根不接受 sceneCategories,需放在 fragment。shader 文件相对根 shaderRoot,不随 fragment 所在目录改变。把所有 fragment、设置和 shader 一起打包,缺一个都不能用另一章补齐。
balanced 使用默认值;economy 保留 grade、关闭 glow、strength=0.4;neutral 关闭 grade/glow。presets/*.json 是 Analyzer 的选项覆盖文件和设置配方,当前宿主不会自动识别为预设菜单。按表在光影设置中应用相同值;number 选项即使数值为整数,也在覆盖 JSON 中保留 1.0,避免 Integer/Number 不匹配警告。
amberdemo:MarbleBlock 是虚构的 Mod 接入点,priority=20、onMissing=skip;不要求安装任何 Mod。缺失时跳过 mapping,其他未匹配内容进入 course:neutral。若要接真实 Mod,应先从本世界 WorldFinal 快照取得 logical/effective ID 与 owner,再修改 selector;不得按相似类名猜测内容身份。economy 只裁剪后处理,opaque 的材质表仍存在;完全恢复宿主画面用 BuiltIn。
活动分支矩阵
每行均已对照源码与新解压 ZIP。数量只统计活动节点;资源数包含存在的材质 buffer。
| 分支 | 覆盖值 | 资源 | 命令 |
|---|---|---|---|
default | {} | 5 | 7 |
grade-off | {"course:grade":false} | 3 | 5 |
strength-max | {"course:strength":1,"course:gain":1.2} | 5 | 7 |
glow-off | {"course:glow":false} | 4 | 6 |
all-off | {"course:grade":false,"course:glow":false} | 3 | 5 |
economy | {"course:grade":true,"course:glow":false,"course:strength":0.4,"course:gain":1} | 4 | 6 |
精确活动闭包
default
resource:course:materials, resource:course:post/color, resource:course:post/glow, resource:course:scene/color, resource:course:scene/depth
command:course:glow:0, command:course:grade:0, command:course:present-glow:0, command:course:terrain_alpha_tested:0, command:course:terrain_opaque:0, command:course:terrain_sorted_translucent:0, command:course:terrain_transparent:0
program:course:post/glow, program:course:post/grade, program:course:post/present, program:course:scene/terrain, program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent
活动 services: 0
grade-off
resource:course:materials, resource:course:scene/color, resource:course:scene/depth
command:course:present-raw:0, command:course:terrain_alpha_tested:0, command:course:terrain_opaque:0, command:course:terrain_sorted_translucent:0, command:course:terrain_transparent:0
program:course:post/present, program:course:scene/terrain, program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent
活动 services: 0
strength-max
resource:course:materials, resource:course:post/color, resource:course:post/glow, resource:course:scene/color, resource:course:scene/depth
command:course:glow:0, command:course:grade:0, command:course:present-glow:0, command:course:terrain_alpha_tested:0, command:course:terrain_opaque:0, command:course:terrain_sorted_translucent:0, command:course:terrain_transparent:0
program:course:post/glow, program:course:post/grade, program:course:post/present, program:course:scene/terrain, program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent
活动 services: 0
glow-off
resource:course:materials, resource:course:post/color, resource:course:scene/color, resource:course:scene/depth
command:course:grade:0, command:course:present-grade:0, command:course:terrain_alpha_tested:0, command:course:terrain_opaque:0, command:course:terrain_sorted_translucent:0, command:course:terrain_transparent:0
program:course:post/grade, program:course:post/present, program:course:scene/terrain, program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent
活动 services: 0
all-off
resource:course:materials, resource:course:scene/color, resource:course:scene/depth
command:course:present-raw:0, command:course:terrain_alpha_tested:0, command:course:terrain_opaque:0, command:course:terrain_sorted_translucent:0, command:course:terrain_transparent:0
program:course:post/present, program:course:scene/terrain, program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent
活动 services: 0
economy
resource:course:materials, resource:course:post/color, resource:course:scene/color, resource:course:scene/depth
command:course:grade:0, command:course:present-grade:0, command:course:terrain_alpha_tested:0, command:course:terrain_opaque:0, command:course:terrain_sorted_translucent:0, command:course:terrain_transparent:0
program:course:post/grade, program:course:post/present, program:course:scene/terrain, program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent
活动 services: 0
预设配方
| 配方 | grade | glow | strength | gain |
|---|---|---|---|---|
| balanced | true | true | 0.65 | 1.0 |
| economy | true | false | 0.4 | 1.0 |
| neutral | false | false | 0.65 | 1.0 |
完整着色器
shaders/fullscreen.vsh
#version 320 es
precision highp float;
out vec2 v_uv;
void main() {
const vec2 corners[4] = vec2[4](vec2(-1.0, -1.0), vec2(1.0, -1.0), vec2(-1.0, 1.0), vec2(1.0, 1.0));
vec2 position = corners[gl_VertexID & 3];
v_uv = position * 0.5 + 0.5;
gl_Position = vec4(position, 0.0, 1.0);
}shaders/glow.psh
#version 320 es
precision highp float;
uniform sampler2D u_source;
in vec2 v_uv;
layout(location = 0) out vec4 o_color;
void main() {
vec2 pixel = 1.0 / vec2(textureSize(u_source, 0));
vec3 center = texture(u_source, v_uv).rgb;
vec3 blur = center * 0.4;
blur += texture(u_source, v_uv + vec2(pixel.x * 2.0, 0.0)).rgb * 0.15;
blur += texture(u_source, v_uv - vec2(pixel.x * 2.0, 0.0)).rgb * 0.15;
blur += texture(u_source, v_uv + vec2(0.0, pixel.y * 2.0)).rgb * 0.15;
blur += texture(u_source, v_uv - vec2(0.0, pixel.y * 2.0)).rgb * 0.15;
o_color = vec4(clamp(center + max(blur - 0.55, 0.0) * 0.16, 0.0, 1.0), 1.0);
}shaders/grade.psh
#version 320 es
precision highp float;
uniform sampler2D u_sceneColor;
uniform float u_gain;
uniform float u_day;
uniform float u_rain;
in vec2 v_uv;
layout(location = 0) out vec4 o_color;
void main() {
vec3 source = texture(u_sceneColor, v_uv).rgb;
vec3 amber = (source - 0.5) * 1.06 + 0.5;
amber *= vec3(1.06, 1.0, 0.93);
float daylight = 0.5 + 0.5 * sin(6.2831853 * (u_day - 0.25));
amber *= mix(vec3(0.91, 0.96, 1.04), vec3(1.03, 1.01, 0.97), daylight);
amber = mix(amber, amber * vec3(0.91, 0.95, 1.0), u_rain * 0.45) * u_gain;
o_color = vec4(clamp(mix(source, amber, float(GRADE_STRENGTH)), 0.0, 1.0), 1.0);
}shaders/present.psh
#version 320 es
precision highp float;
uniform sampler2D u_postColor;
in vec2 v_uv;
layout(location = 0) out vec4 o_color;
void main() {
o_color = texture(u_postColor, v_uv);
}shaders/terrain.psh
#version 320 es
// <Sampler Name='u_samplerState' Texture='u_texture' />
precision highp float;
precision highp int;
#include "/dawnlight/materials-v1.glsl"
uniform sampler2D u_texture;
in vec2 v_texcoord;
in vec4 v_color;
flat in highp uint v_identifier;
layout(location = 0) out vec4 o_sceneColor;
void main() {
vec4 albedo = texture(u_texture, v_texcoord) * v_color;
highp uint record = LookupMaterial(v_identifier);
vec3 tint = AmberTint(record).rgb;
float response = AmberResponse(record);
if (MaterialHasTag(record, AMBER_MINERAL) && MaterialShaderId(record) == 1u)
response *= 0.75;
o_sceneColor = vec4(albedo.rgb * mix(vec3(1.0), tint, response), albedo.a);
}shaders/terrain.vsh
#version 320 es
// <Semantic Name='TEXCOORD' Attribute='a_texcoord' />
// <Semantic Name='POSITION' Attribute='a_position' />
// <Semantic Name='COLOR' Attribute='a_color' />
// <Semantic Name='IDENTIFIER' Attribute='a_identifier' />
// <Semantic Name='NORMAL' Attribute='a_normal' />
// <Semantic Name='LIGHTLEVEL' Attribute='a_lightLevel' />
// <Semantic Name='PURELIGHT' Attribute='a_pureLight' />
// <Semantic Name='HEIGHTDATA' Attribute='a_heightData' />
uniform mat4 u_viewProjectionMatrix;
uniform vec2 u_origin;
uniform float u_lightTable[96];
layout(location = 0) in vec2 a_texcoord;
layout(location = 1) in vec3 a_position;
layout(location = 2) in vec4 a_color;
layout(location = 3) in uint a_identifier;
layout(location = 4) in vec3 a_normal;
layout(location = 5) in float a_lightLevel;
layout(location = 6) in float a_pureLight;
layout(location = 7) in float a_heightData;
out vec2 v_texcoord;
out vec4 v_color;
out vec3 v_normalEncoded;
flat out highp uint v_identifier;
void main() {
int lightIndex = clamp(int(a_lightLevel) - 1, 0, 95);
float light = clamp(u_lightTable[lightIndex], 0.0, 1.0);
v_texcoord = a_texcoord;
v_color = vec4(a_color.rgb * light, a_color.a);
v_normalEncoded = clamp(a_normal / 255.0, 0.0, 1.0);
v_identifier = a_identifier;
vec3 relativePosition = vec3(a_position.x - u_origin.x, a_position.y, a_position.z - u_origin.y);
gl_Position = u_viewProjectionMatrix * vec4(relativePosition, 1.0);
OPENGL_POSITION_FIX;
}完整 Manifest 与设置
manifest/data.json
{
"materials": {
"abiVersion": 1,
"fallback": "course:neutral",
"properties": [
{
"id": "course:tint",
"type": "vec4",
"default": [
1,
1,
1,
1
],
"glsl": "AmberTint"
},
{
"id": "course:response",
"type": "float",
"default": 0,
"range": [
0,
1
],
"glsl": "AmberResponse"
}
],
"tags": [
{
"id": "course:mineral",
"glsl": "AMBER_MINERAL"
}
],
"definitions": [
{
"id": "course:neutral",
"shaderId": 0
},
{
"id": "course:stone",
"shaderId": 1,
"tags": [
"course:mineral"
],
"values": {
"course:tint": [
1.08,
1.01,
0.92,
1
],
"course:response": 0.25
}
},
{
"id": "course:sand",
"shaderId": 2,
"values": {
"course:tint": [
1.06,
1.02,
0.94,
1
],
"course:response": 0.4
}
}
],
"contentGroups": [
{
"id": "course:stones",
"ids": [
"survivalcraft:GraniteBlock",
"survivalcraft:BasaltBlock"
]
}
],
"mappings": [
{
"id": "course:stone-map",
"match": {
"groups": [
"course:stones"
]
},
"material": "course:stone",
"priority": 10,
"onMissing": "skip"
},
{
"id": "course:sand-map",
"match": {
"ids": [
"survivalcraft:SandBlock"
]
},
"material": "course:sand",
"priority": 10,
"onMissing": "skip"
},
{
"id": "course:optional-mod-stone",
"match": {
"ids": [
"amberdemo:MarbleBlock"
]
},
"material": "course:stone",
"priority": 20,
"onMissing": "skip"
}
]
},
"customData": {
"abiVersion": 1,
"variables": [
{
"id": "course:gain",
"type": "float",
"frequency": "generation",
"default": 1,
"onError": "useDefault",
"expression": {
"option": "course:gain",
"as": "float"
}
},
{
"id": "course:day",
"type": "float",
"frequency": "frame",
"unit": "day_fraction",
"default": 0.5,
"onError": "useDefault",
"expression": {
"input": "dawnlight:data/day_time",
"version": 1
}
},
{
"id": "course:rain",
"type": "float",
"frequency": "frame",
"unit": "dimensionless",
"default": 0,
"onError": "useDefault",
"expression": {
"call": "clamp",
"args": [
{
"input": "dawnlight:data/weather_precipitation",
"version": 1
},
{
"literal": 0,
"type": "float"
},
{
"literal": 1,
"type": "float"
}
]
}
}
]
}
}manifest/options.json
{
"options": [
{
"id": "course:grade",
"type": "boolean",
"default": true,
"impact": [
"pipeline",
"resources"
]
},
{
"id": "course:strength",
"type": "number",
"default": 0.65,
"min": 0,
"max": 1,
"impact": [
"program"
]
},
{
"id": "course:gain",
"type": "number",
"default": 1,
"min": 0.5,
"max": 1.5,
"impact": [
"uniform"
]
},
{
"id": "course:glow",
"type": "boolean",
"default": true,
"impact": [
"pipeline",
"resources"
]
}
]
}manifest/passes.json
{
"passes": [
{
"id": "course:terrain_opaque",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "world",
"phase": "opaque"
},
"services": [],
"programs": [
"course:scene/terrain"
],
"commands": [
{
"type": "engineDraw",
"sceneProvider": {
"id": "dawnlight:scene_draw/terrain_opaque",
"version": 2
},
"targets": {
"colors": [
{
"location": 0,
"resource": "course:scene/color",
"loadOp": "load",
"storeOp": "store"
}
],
"depth": {
"resource": "course:scene/depth",
"loadOp": "clear",
"storeOp": "store",
"clearValue": 1
}
},
"state": {
"blend": "opaque",
"depth": "default",
"rasterizer": "cullCounterClockwiseScissor"
},
"viewport": {
"source": "target",
"restore": "frame",
"synchronizeScissor": true
},
"program": "course:scene/terrain",
"sceneBindings": [
{
"symbol": "u_viewProjectionMatrix",
"contract": "dawnlight:scene_binding/view_projection",
"version": 1,
"frequency": "view"
},
{
"symbol": "u_origin",
"contract": "dawnlight:scene_binding/terrain_origin",
"version": 1,
"frequency": "view"
},
{
"symbol": "u_lightTable",
"contract": "dawnlight:scene_binding/light_table",
"version": 1,
"frequency": "batch"
},
{
"symbol": "u_texture",
"contract": "dawnlight:scene_binding/block_texture",
"version": 1,
"frequency": "draw",
"binding": 0
}
],
"bindings": [
{
"kind": "storageBuffer",
"symbol": "MaterialTable",
"binding": 4,
"resource": "course:materials",
"access": "readOnly"
}
]
}
],
"inputs": [
"course:scene/color",
"course:scene/depth",
"course:materials"
],
"outputs": [
"course:scene/color",
"course:scene/depth"
]
},
{
"id": "course:terrain_alpha_tested",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "world",
"phase": "opaque",
"ordering": {
"after": [
"course:terrain_opaque"
]
}
},
"services": [],
"programs": [],
"commands": [
{
"type": "engineDraw",
"sceneProvider": {
"id": "dawnlight:scene_draw/terrain_alpha_tested",
"version": 2
},
"targets": {
"colors": [
{
"location": 0,
"resource": "course:scene/color",
"loadOp": "load",
"storeOp": "store"
}
],
"depth": {
"resource": "course:scene/depth",
"loadOp": "load",
"storeOp": "store"
}
},
"state": {
"blend": "opaque",
"depth": "default",
"rasterizer": "cullCounterClockwiseScissor"
},
"viewport": {
"source": "target",
"restore": "frame",
"synchronizeScissor": true
}
}
],
"inputs": [
"course:scene/color",
"course:scene/depth"
],
"outputs": [
"course:scene/color",
"course:scene/depth"
]
},
{
"id": "course:terrain_transparent",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "world",
"phase": "transparent"
},
"services": [],
"programs": [],
"commands": [
{
"type": "engineDraw",
"sceneProvider": {
"id": "dawnlight:scene_draw/terrain_transparent",
"version": 2
},
"targets": {
"colors": [
{
"location": 0,
"resource": "course:scene/color",
"loadOp": "load",
"storeOp": "store"
}
],
"depth": {
"resource": "course:scene/depth",
"loadOp": "load",
"storeOp": "store"
}
},
"state": {
"blend": "alphaBlend",
"depth": "default",
"rasterizer": "cullCounterClockwiseScissor"
},
"viewport": {
"source": "target",
"restore": "frame",
"synchronizeScissor": true
}
}
],
"inputs": [
"course:scene/color",
"course:scene/depth"
],
"outputs": [
"course:scene/color",
"course:scene/depth"
]
},
{
"id": "course:terrain_sorted_translucent",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "world",
"phase": "transparent",
"ordering": {
"after": [
"course:terrain_transparent"
]
}
},
"services": [],
"programs": [],
"commands": [
{
"type": "engineDraw",
"sceneProvider": {
"id": "dawnlight:scene_draw/terrain_sorted_translucent",
"version": 2
},
"targets": {
"colors": [
{
"location": 0,
"resource": "course:scene/color",
"loadOp": "load",
"storeOp": "store"
}
],
"depth": {
"resource": "course:scene/depth",
"loadOp": "load",
"storeOp": "store"
}
},
"state": {
"blend": "alphaBlend",
"depth": "default",
"rasterizer": "cullCounterClockwiseScissor"
},
"viewport": {
"source": "target",
"restore": "frame",
"synchronizeScissor": true
}
}
],
"inputs": [
"course:scene/color",
"course:scene/depth"
],
"outputs": [
"course:scene/color",
"course:scene/depth"
]
},
{
"id": "course:grade",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "afterDraw",
"phase": "afterDraw"
},
"services": [],
"programs": [
"course:post/grade"
],
"commands": [
{
"type": "fullscreen",
"program": "course:post/grade",
"bindings": [
{
"kind": "sampler2D",
"symbol": "u_sceneColor",
"binding": 0,
"resource": "course:scene/color"
}
],
"state": {
"blend": "opaque",
"depth": "disabled",
"rasterizer": "cullNoneScissor"
},
"viewport": {
"source": "target",
"restore": "frame",
"synchronizeScissor": true
},
"targets": {
"colors": [
{
"location": 0,
"resource": "course:post/color",
"loadOp": "dontCare",
"storeOp": "store"
}
]
},
"customBindings": [
{
"symbol": "u_gain",
"variable": "course:gain"
},
{
"symbol": "u_day",
"variable": "course:day"
},
{
"symbol": "u_rain",
"variable": "course:rain"
}
]
}
],
"inputs": [
"course:scene/color"
],
"outputs": [
"course:post/color"
],
"enabledWhen": [
{
"option": "course:grade",
"equals": true
}
]
},
{
"id": "course:glow",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "afterDraw",
"phase": "afterDraw",
"ordering": {
"after": [
"course:grade"
]
}
},
"services": [],
"programs": [
"course:post/glow"
],
"commands": [
{
"type": "fullscreen",
"program": "course:post/glow",
"bindings": [
{
"kind": "sampler2D",
"symbol": "u_source",
"binding": 0,
"resource": "course:post/color"
}
],
"state": {
"blend": "opaque",
"depth": "disabled",
"rasterizer": "cullNoneScissor"
},
"viewport": {
"source": "target",
"restore": "frame",
"synchronizeScissor": true
},
"targets": {
"colors": [
{
"location": 0,
"resource": "course:post/glow",
"loadOp": "dontCare",
"storeOp": "store"
}
]
}
}
],
"inputs": [
"course:post/color"
],
"outputs": [
"course:post/glow"
],
"enabledWhen": [
{
"option": "course:grade",
"equals": true
},
{
"option": "course:glow",
"equals": true
}
]
},
{
"id": "course:present-grade",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "afterDraw",
"phase": "screenOutput",
"ordering": {
"after": [
"course:grade"
]
}
},
"services": [],
"programs": [
"course:post/present"
],
"commands": [
{
"type": "present",
"program": "course:post/present",
"bindings": [
{
"kind": "sampler2D",
"symbol": "u_postColor",
"binding": 0,
"resource": "course:post/color"
}
],
"state": {
"blend": "opaque",
"depth": "disabled",
"rasterizer": "cullNoneScissor"
},
"viewport": {
"source": "frame",
"restore": "none",
"synchronizeScissor": true
}
}
],
"inputs": [
"course:post/color"
],
"outputs": [],
"enabledWhen": [
{
"option": "course:grade",
"equals": true
},
{
"option": "course:glow",
"equals": false
}
]
},
{
"id": "course:present-raw",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "afterDraw",
"phase": "screenOutput"
},
"services": [],
"programs": [
"course:post/present"
],
"commands": [
{
"type": "present",
"program": "course:post/present",
"bindings": [
{
"kind": "sampler2D",
"symbol": "u_postColor",
"binding": 0,
"resource": "course:scene/color"
}
],
"state": {
"blend": "opaque",
"depth": "disabled",
"rasterizer": "cullNoneScissor"
},
"viewport": {
"source": "frame",
"restore": "none",
"synchronizeScissor": true
}
}
],
"inputs": [
"course:scene/color"
],
"outputs": [],
"enabledWhen": [
{
"option": "course:grade",
"equals": false
}
]
},
{
"id": "course:present-glow",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "afterDraw",
"phase": "screenOutput",
"ordering": {
"after": [
"course:glow"
]
}
},
"services": [],
"programs": [
"course:post/present"
],
"commands": [
{
"type": "present",
"program": "course:post/present",
"bindings": [
{
"kind": "sampler2D",
"symbol": "u_postColor",
"binding": 0,
"resource": "course:post/glow"
}
],
"state": {
"blend": "opaque",
"depth": "disabled",
"rasterizer": "cullNoneScissor"
},
"viewport": {
"source": "frame",
"restore": "none",
"synchronizeScissor": true
}
}
],
"inputs": [
"course:post/glow"
],
"outputs": [],
"enabledWhen": [
{
"option": "course:grade",
"equals": true
},
{
"option": "course:glow",
"equals": true
}
]
}
],
"sceneCategories": [
{
"id": "dawnlight:scene/terrain_opaque",
"version": 1,
"mode": "override",
"stage": "course:terrain_opaque"
},
{
"id": "dawnlight:scene/terrain_alpha_tested",
"version": 1,
"mode": "builtin"
},
{
"id": "dawnlight:scene/terrain_transparent",
"version": 1,
"mode": "builtin"
},
{
"id": "dawnlight:scene/terrain_sorted_translucent",
"version": 1,
"mode": "builtin"
}
]
}manifest/programs.json
{
"programs": [
{
"id": "course:scene/terrain",
"kind": "graphics",
"vertex": "terrain.vsh",
"fragment": "terrain.psh",
"compileMode": "officialCompatible"
},
{
"id": "course:post/grade",
"kind": "graphics",
"vertex": "fullscreen.vsh",
"fragment": "grade.psh",
"compileMode": "manifestDriven",
"defines": {
"GRADE_STRENGTH": {
"option": "course:strength"
}
}
},
{
"id": "course:post/present",
"kind": "graphics",
"vertex": "fullscreen.vsh",
"fragment": "present.psh",
"compileMode": "manifestDriven"
},
{
"id": "course:post/glow",
"kind": "graphics",
"vertex": "fullscreen.vsh",
"fragment": "glow.psh",
"compileMode": "manifestDriven"
}
]
}manifest/resources.json
{
"resources": [
{
"id": "course:scene/color",
"kind": "texture2D",
"lifetime": "persistent",
"size": {
"mode": "viewport"
},
"format": "rgba8"
},
{
"id": "course:scene/depth",
"kind": "texture2D",
"lifetime": "persistent",
"size": {
"mode": "viewport"
},
"format": "depth24"
},
{
"id": "course:post/color",
"kind": "texture2D",
"lifetime": "persistent",
"size": {
"mode": "viewport"
},
"format": "rgba8"
},
{
"id": "course:materials",
"kind": "buffer",
"lifetime": "persistent",
"usage": "staticDraw",
"content": {
"type": "materialTable",
"version": 1
}
},
{
"id": "course:post/glow",
"kind": "texture2D",
"lifetime": "persistent",
"size": {
"mode": "viewport",
"scale": [
0.5,
0.5
]
},
"format": "rgba8"
}
]
}presets/balanced.json
{
"course:grade": true,
"course:glow": true,
"course:strength": 0.65,
"course:gain": 1.0
}presets/economy.json
{
"course:grade": true,
"course:glow": false,
"course:strength": 0.4,
"course:gain": 1.0
}presets/neutral.json
{
"course:grade": false,
"course:glow": false,
"course:strength": 0.65,
"course:gain": 1.0
}settings.json
{
"schemaVersion": 1,
"defaultLocale": "en-US",
"translations": {
"zh-CN": {
"page.amber": "琥珀课程",
"course:grade": "调色",
"course:strength": "调色强度(重新编译)",
"course:gain": "曝光增益",
"course:glow": "半分辨率柔光"
},
"en-US": {
"page.amber": "Amber course",
"course:grade": "Color grade",
"course:strength": "Grade strength (recompile)",
"course:gain": "Exposure gain",
"course:glow": "Half-resolution glow"
}
},
"pages": [
{
"id": "amber",
"title": "page.amber",
"groups": [
{
"id": "look",
"controls": [
{
"id": "grade",
"option": "course:grade",
"widget": "toggle",
"label": "course:grade"
},
{
"id": "strength",
"option": "course:strength",
"widget": "slider",
"label": "course:strength",
"min": 0,
"max": 1,
"step": 0.05,
"format": "0.00",
"enabledWhen": [
{
"option": "course:grade",
"equals": true
}
]
},
{
"id": "gain",
"option": "course:gain",
"widget": "slider",
"label": "course:gain",
"min": 0.5,
"max": 1.5,
"step": 0.05,
"format": "0.00",
"enabledWhen": [
{
"option": "course:grade",
"equals": true
}
]
},
{
"id": "glow",
"option": "course:glow",
"widget": "toggle",
"label": "course:glow"
}
]
}
]
}
]
}shaderpack.json
{
"manifestVersion": 5,
"sceneAbiVersion": 2,
"expectedCatalogSha256": "4bc28c17beffea2311a422fff9f633d2e4f03784460d0254adda8af2e766d84c",
"id": "course:09-complete-pack",
"name": "Dawnlight Course · Amber 09-complete-pack",
"version": "1.0.0",
"author": "EltanceX",
"description": "Website-authored Amber course snapshot; see README for tested scope.",
"shaderRoot": "shaders",
"frameTarget": {
"targets": {
"colors": [
{
"location": 0,
"resource": "course:scene/color",
"loadOp": "clear",
"storeOp": "store",
"clearValue": [
0,
0,
0,
1
]
}
],
"depth": {
"resource": "course:scene/depth",
"loadOp": "clear",
"storeOp": "store",
"clearValue": 1
}
}
},
"settings": "settings.json",
"sourceFormatVersion": 1,
"fragments": [
"manifest/options.json",
"manifest/resources.json",
"manifest/programs.json",
"manifest/passes.json",
"manifest/data.json"
]
}验证与画面
解压为 shaderpacks 的新直接子目录,在包根目录使用环境准备中安装的固定 Analyzer。预期退出码 0、无诊断;材质未提供世界快照时 deferred 是预期。进入创造世界应用设置,再重载、调整尺寸并切回 BuiltIn。
$analyzer = "C:\Tools\Dawnlight\shaderpack-analyzer.exe"
& $analyzer pack validate . --format json
& $analyzer scene explain . --include-inactive --format json
& $analyzer graph dump . --contract 2 --include-inactive
& $analyzer program interface . --program course:scene/terrain --contract 2
& $analyzer program interface . --program course:post/grade --contract 2
& $analyzer program interface . --program course:post/present --contract 2
& $analyzer program interface . --program course:post/glow --contract 2
& $analyzer data explain . --format json
& $analyzer materials explain . --format json
& $analyzer scene explain . --options presets/economy.json --include-inactive --format json
& $analyzer data explain . --options presets/economy.json --format json以上 graph CLI 命令只检查默认值。已提交分支收据使用显式 inputs.options 的 JSON-RPC,见上表和维护流程。
实际映射需加载世界后运行 /switchshader content-export,将该文件以 --content-snapshot world-final.json 传给 materials explain。用 /switchshader export-data-driver-report 导出 Data 接口证据;世界快照保留在本地。
实际游戏观察 · W6
已在隔离创造世界完成 6 个选项分支的加载/切换、同名重载、真实窗口尺寸变化与返回 BuiltIn。Program 链接与帧缓冲完整;Data 接口报告匹配,未进行数值读回。
2753e348e5f83c84d1814aab1c40778a86d955a4312816ac3c4d8c5008cbe4cc

常见卡点
重复 ID:fragment 不覆盖已有定义,定位重复来源并保留一个。找不到 shader:仍以 shaderRoot 为根检查路径。UI 候选失败:所有 option 必须恰好被 control/hiddenOptions 覆盖。找不到 Mod:本例 skip 是预期;若你需要强依赖,改成 error 并在分发说明中写明。
动手练习
从新 ZIP 按 economy 配方加载,核对只剩一个全尺寸后处理目标。把 fictional selector 换成自己 WorldFinal 中真实存在的稳定 ID,观察匹配后还原。拆出另一 fragment 时,确认源码与 ZIP 两套检查都通过,且没有给 root 增加不支持的字段。