Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

feat(editor): the quality settings page has a Level · Water group for waves, ripple cells, displacement, mirror and caustics

yhhb22ec68bacb8
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 710c738e6..69f5d6245 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -35,6 +35,7 @@ published separately; it ships inside the editor.
- **Contact shadows and screen-space bounce light.** Contact Shadows and Screen Space GI effects add small sharp shadows at contacts and one bounce of colour between surfaces, and the weather softens the sun's shadows. `contactShadows` marches a short ray toward the scene's sun in the depth buffer; `ssgi` gathers eight rays a pixel over the G-buffer's normals at half size into a float target and averages the neighbours on the same surface before laying the light, times the receiver's colour, over the picture. The Weather component raises the sun's `sourceAngle` and lowers its `shadowStrength` as the sky clouds over.
- **Terrain and Foliage.** A Terrain component makes ground from a heightmap or noise, paints it with grass, dirt, snow and rock layers and draws it in chunks that coarsen with distance; a Foliage component scatters grass or a mesh over it, swaying in the wind and thinning out with distance.
- **Separate material maps packed on import.** Importing an FBX with separate metalness, roughness and occlusion images now packs them into the one map the Model shader samples, instead of dropping them. Occlusion goes in red, roughness in green and metal in blue, each from its image's red channel (a glossiness map is inverted); a channel with no image stays at full so the material's own value speaks. Only PNG and DDS can be read.
+- **Water rows in the quality settings.** Project Settings → Rendering has a Level · Water group for the five water quality fields (waves, ripple cells, displacement, mirror, caustics) of the level chosen under Editing level. Each is saved as a difference to that level only, and the group is hidden while quality is off or the project excludes the water module.
- **Built-in shaders ship with their modules.** The Water, Terrain, Foliage, Hair, Skin and Eye built-in shaders now ship with their modules instead of the core: a package that installs none of them no longer carries about 80 KB of shader source (a blank web package is 80 KB smaller, a blank WeChat bundle 7% smaller). A material that names one of them is what brings its module into an export, with no component in a scene needed; the three character shaders are a new `esengine/character-shaders` module.
- **Opaque models no longer vanish beside glass.** Opaque draws are told from blended ones by the stage they are sorted in, not by their blend mode, when a frame has both a refracting surface and blended draws; before, a lit material whose blend mode was not None (the Model material) was treated as blended and could vanish from such a frame.
- **Water quality levels and a lite water.** Water spends what the quality level allows. Each level's profile has `waterWaves` (waves summed, 2 / 3 / 4), `waterRippleCells` (the ripple grid's side, 32 / 64 / 128), `waterDisplacement` (off is the lite water: flat geometry with the waves in the shading only), `waterMirror` and `waterCaustics`. What `Waters.sample` answers follows what is drawn, and a minigame with no quality policy gets the Low level's water.
diff --git a/desktop b/desktop
index ecaf8469b..7affc79fe 160000
--- a/desktop
+++ b/desktop
@@ -1 +1 @@
-Subproject commit ecaf8469bd358b1e543a11af22eaf6035f77cd2f
+Subproject commit 7affc79fed72ae29aa99139f2784e1a8fdb9e8c6
diff --git a/docs/astro/src/content/docs/graphics/water.mdx b/docs/astro/src/content/docs/graphics/water.mdx
index 93f7a5113..be5df9170 100644
--- a/docs/astro/src/content/docs/graphics/water.mdx
+++ b/docs/astro/src/content/docs/graphics/water.mdx
@@ -175,7 +175,7 @@ Select a lake or a river and its points are handles in the viewport, the way a p
## Quality levels
-Water spends what the project's quality level says it may. The five fields are in each level's profile (`project.esproject`, `features.rendering.quality.profiles`), and a project can change what a level means:
+Water spends what the project's quality level says it may. The five fields are in each level's profile (`project.esproject`, `features.rendering.quality.profiles`), and a project can change what a level means. **Project Settings → Rendering → Level · Water** edits them for the level chosen under Editing level; the group is hidden while quality is off or the project excludes the water module.
| Field | Low | Medium | High | What it does |
|---|---|---|---|---|
diff --git a/docs/astro/src/content/docs/zh-cn/graphics/water.mdx b/docs/astro/src/content/docs/zh-cn/graphics/water.mdx
index a430441da..5add19652 100644
--- a/docs/astro/src/content/docs/zh-cn/graphics/water.mdx
+++ b/docs/astro/src/content/docs/zh-cn/graphics/water.mdx
@@ -118,7 +118,7 @@ Details 只显示水体这种形态用得到的字段:湖有尺寸、边界和
## 画质档位
-水只花项目画质档位允许它花的。五个字段在每个档位的配置里(`project.esproject`,`features.rendering.quality.profiles`),项目可以改变一个档位的含义:
+水只花项目画质档位允许它花的。五个字段在每个档位的配置里(`project.esproject`,`features.rendering.quality.profiles`),项目可以改变一个档位的含义。**项目设置 → 渲染 → 档位 · 水体**为“正在编辑的档位”编辑它们;画质关闭或项目排除了水体模块时,这一组不显示:
| 字段 | 低 | 中 | 高 | 作用 |
|---|---|---|---|---|
diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjs
index d47d6970a..3ac79597a 100644
--- a/tools/releaseNotes.mjs
+++ b/tools/releaseNotes.mjs
@@ -2567,6 +2567,8 @@ export const NOTED = {
{"note":"Water holds things up. A Floating component on an entity with a RigidBody3D floats it: a buoyant force against gravity (`buoyancy` is the water's density against the body's, so 2 floats it half under) and a drag against its velocity relative to the water, which brings it to rest in a lake and carries it with a river's current, applied at a few points of the body so waves tip it. It works from the CPU's own water surface, so it needs no renderer, and it needs the 3D physics module, which gains force and mass queries."},
"feat(water): a camera under the surface sees through the water, fogged and tinted by what it has crossed":
{"note":"A camera under water sees through it. Whenever the active camera is below a water body's surface an Underwater effect is added to the post-process volumes: the light of each pixel is taken out colour by colour (red first) by the distance it crossed, with the same absorption and density the surface's material draws with, and the water gives back its own colour, dimmer the deeper the camera is. The surface seen from below turns over and, past the critical angle, reflects whole (Snell's window)."},
+ "feat(editor): the quality settings page has a Level · Water group for waves, ripple cells, displacement, mirror and caustics":
+ {"note":"Project Settings → Rendering has a Level · Water group for the five water quality fields (waves, ripple cells, displacement, mirror, caustics) of the level chosen under Editing level. Each is saved as a difference to that level only, and the group is hidden while quality is off or the project excludes the water module."},
"feat(sdk): the Water, Terrain, Foliage, Hair, Skin and Eye shaders ship with their modules, and a material that names one brings its module into an export":
{"note":"The Water, Terrain, Foliage, Hair, Skin and Eye built-in shaders now ship with their modules instead of the core: a package that installs none of them no longer carries about 80 KB of shader source (a blank web package is 80 KB smaller, a blank WeChat bundle 7% smaller). A material that names one of them is what brings its module into an export, with no component in a scene needed; the three character shaders are a new `esengine/character-shaders` module."},
"fix(render): opaque draws are told from blended ones by their stage, so a lit model no longer vanishes in a frame with glass":