From 5edb152db190f82f8461faa149e1dba59905f380 Mon Sep 17 00:00:00 2001 From: pkuzic Date: Sat, 26 Sep 2026 14:27:33 +0100 Subject: [PATCH] =?UTF-8?q?README:=20Everwood=20graphics=20fork=20header?= =?UTF-8?q?=20=E2=80=94=20features,=20upstream=20link,=20open=20contributi?= =?UTF-8?q?ons?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- README.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) diff --git a/README.md b/README.md index 63e92bc2..129c6dab 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,61 @@ +# benilla — Everwood graphics + +A graphics fork of [**benilla**](https://github.com/samwhosung/benilla), the from-scratch World of Warcraft +1.12.1 client in Rust and Bevy by samwhosung. This repository adds an optional modern look on top of it. +Every feature has its own switch under **Options → Advanced Graphics**, and the **Classic** preset keeps +the original 1.12 image. + +**This repository is maintained and will stay open source. Contributions are welcome:** open an issue or a +pull request. + +## Graphics features + +**Lighting and shadows** +- Realtime sun shadows for characters and the world, including foliage; moon shadows at night +- Dynamic building interiors lit by their own fixtures +- Torches, braziers and lamps emit flickering light and cast cube-map shadows; terrain blocks torch light +- Daylight through doors and windows (including Stormwind's rooms and cathedral windows) +- Spell and ground-effect lights, lava glow +- Screen-space ambient occlusion (soft contact shadows) + +**Sky** +- Smooth sky gradient with dithering, soft sun glow +- Procedural star field with a Milky Way +- Sun-lit, detailed clouds +- Zone skyboxes (Burning Steppes, Blasted Lands, Mount Hyjal) and the 1.12 `LightSkybox` clear-weather slot + +**Fog and atmosphere** +- Modern fog model: the world fades into the horizon, sun-coloured toward the sun +- Volumetric fog with sun and moon light shafts +- Lamps glowing through fog at night +- Screen-space sun shafts +- Render distance up to 1497 yards + +**Post-processing** +- HDR bloom for fire, lava, spells and lit windows +- Per-zone colour grading (day/night LUTs) + +**Water** +- Enhanced water: refraction, caustics, depth colour, screen-space reflections +- Enhanced city and building water (Stormwind canals) +- Gerstner waves with whitecaps, finer mesh up close + +**Weather and nature** +- Rain: wet ground, puddles, glossy stone, rings on water, shelter under roofs and bridges +- Wind: grass and tree sway with gusts, grass parts around characters + +**Settings** +- One Graphics Preset: Classic / Low / Medium / High / Ultra / Custom (default High) +- Every feature individually switchable on the Advanced Graphics page + +Details: [`LIGHTING.md`](LIGHTING.md), [`WATER.md`](WATER.md). Third-party credits, including code ported +from [WarcraftXL](https://github.com/WarcraftXL) by iThorgrim: [`THIRD-PARTY.md`](THIRD-PARTY.md). +Licence: same as upstream benilla, MIT OR Apache-2.0. + +--- + +*The upstream benilla README follows.* +

benilla

A from-scratch World of Warcraft 1.12.1 client in Rust and Bevy