Q2PRO-X 1.6 Beta 5 by ly

AVFX Surface Objects

Project author: ly

AVFX Surface Objects

English edition • Q2PRO-X 1.6 Beta 5 by ly • 2026-10-10

Contents

The entries are links: click one to jump to that section.

AVFX three-dimensional surface objects

Object types

Hanging ivy

Ferns and grass

Rocks and soil

Fallen and falling leaves

Shadows and the flashlight

Object lighting

Reflections and saving

AVFX three-dimensional surface objects

Project author: ly. Q2PRO-X 1.6 Beta 5.

Objects add three-dimensional detail to map architecture. They form a separate AVFX layer: flat greenery, brick, metal and floor-covering materials remain independent. Objects are decorative and do not change collision.

Location: Main menu → Advanced Visual Effects → AVFX Detailed Settings → Surfaces & Water → Surface Objects

The master switch and six surface-object submenus.

Object types

Enable both the object master and the required type. A similarly named flat material is not required: wall ivy and the Greenery material are different effects. Results depend on suitable map surfaces.

Grass, ferns and wall ivy in one game scene.

Hanging ivy

Clustering shifts distribution from individual twigs to dense groups. At the maximum, groups contain many branches and leaves. Variety breaks up repeated shapes and lengths; some clusters may be much longer than others. Height distribution gradually favours the upper part of the receiving BSP surface. It is not a filter based on the entire level's height.

Wall-ivy clustering, variety and distribution. Russian reference screenshot.

Wall foliage

Ferns and grass

Fern variety combines different silhouettes instead of identical plants. Wind controls motion; density controls placement. Disabling user LOD does not itself truncate grass distance, although the renderer still handles visibility, hidden surfaces and subpixel detail. Higher density remains more expensive.

Fern variety settings. Russian reference screenshot.

Ferns and weeds

Grass

Rocks and soil

Size sets the basic scale; size variation determines differences between objects. Wide rock variation can mix small pebbles and boulders. Shape variety, texture and colour variation reduce repetition together. There is no need to maximise everything at once: choose the basic size first, then variation and density.

Rock size, size variation, colour and texture. Russian reference screenshot.

Different-sized rocks, soil and fallen leaves on the floor.

Stones and rubble

Soil clumps

Fallen and falling leaves

Colour variation changes shades around the chosen colour. Sizes stay leaf-like; damaged and torn forms make up a small fraction of the set. Clustering controls floor distribution.

Falling Leaves has a separate master. Its count is independent of floor density: the default is much lower than the original dense stream, and can be decreased or increased. Falling speed and wind produce gentle descent with turning and sway.

Sky Only affects both kinds of leaf. Enabling it excludes roofed areas; some maps may contain no suitable locations.

Separate falling-leaf count and the open-sky restriction. Russian reference screenshot.

Leaves falling beneath open sky above fallen leaves.

Fallen leaves

Shadows and the flashlight

Grass, ivy, ferns and rocks have separate shadow strength. The default is zero, which disables that type's shadow calculation. Soil and fallen leaves have no separate shadow pass.

Ordinary shadows connect objects to surfaces; hanging ivy casts onto its wall. This is not a full shadow system for every map light. The flashlight adds a directional projection from objects in its beam onto receiving floors and walls. It uses the same shadow strength and requires flashlight shadows to be enabled. The original shadow remains; the shape follows the object's silhouette.

Ordinary plant shadows on the floor and wall.

The same scene with additional flashlight projection.

Object lighting

Ivy, ferns, rocks, soil and leaves have their own Lighting submenu at the end of their settings. Grass keeps its existing menu. Each type independently controls its lighting master, minimum brightness, static map light, response to Sun/Moon and cloud cover, night tint, flashlight, lightning/meteors and dynamic or emissive map sources.

Local-light strength and colour transfer are independent. Leaf settings cover both fallen and falling leaves. Disabling the master retains static lighting; zero strength for a local source excludes its calculation. Defaults match grass. These settings belong to AVFX presets and the generator.

With sunlight, ordinary floor and slope shadows change direction with the Sun. Without it, the old projection remains; wall-ivy shadows do not change. Shadow strength stays separate, and the flashlight adds its own projection.

Reflections and saving

Mirrors support surface-object reflections. Puddles have a separate switch for grass, ivy, ferns and falling leaves. Rocks, soil and fallen leaves are excluded from this puddle pass.

Plants reflected in a puddle.

Settings are included in ordinary AVFX presets. The generator selects surface objects independently; shadows are generated only from Quality mode upwards. High density, large objects, shadows and extra reflections increase load. No quality level promises the same FPS on different maps.