WireSight Shadery pre Minecraft 1.20.1, 1.21.1

📖 English 📖 简体中文(大陆)

🟢 WireSight

🧱 WireSight is an experimental, low-overhead Minecraft Java shaderpack that renders the world like a solid modeling view: dark green faces with bright green block edges.

⚙️ The pack targets the OptiFine shaderpack format shared by Iris, Oculus, and OptiFine. Its core path uses GLSL 1.20, a single terrain pass, normal depth writes, and no shadows or full-screen post-processing.

💬 Shaderpack usage / 🐛 Bug reports / 👨‍💻 Development discussion — Join our QQ Group: 259248174 🎉 (This group is gone)

💬 Shaderpack usage / 🐛 Bug reports / 👨‍💻 Development discussion — Join our QQ Group: 1085190201 🎉

💡 Mention me in the group for faster replies ~ ✨

🖼️ Preview

🎨 Default theme colors

🎯 WireSight uses the following base colors by default (RGB and hex denote the same color):

🎯 Render target - RGB - Hex - Appearance

🧱 Regular block faces - RGB(6, 17, 11) - #06110B - Dark green 🌊 Water and translucent terrain - RGB(5, 21, 19) - #051513 - Dark cyan-green ✨ Block edges - RGB(53, 255, 120) - #35FF78 - Fluorescent green 👤 Entities, held items, particles, and weather - RGB(14, 61, 34) - #0E3D22 - Flat green 🌌 Sky, sun, moon, and clouds - RGB(0, 0, 0) - #000000 - Black

💡 These values are base colors; directional face shading further darkens terrain and entity sides and undersides.

🎛️ Shader settings

⚙️ WireSight uses the common OptiFine ShaderPack option format supported by Iris, Oculus, and OptiFine. The loader skin may differ, but the controls and order remain the same.

🧭 Main screen

+--------------------------------+--------------------------------+ | Theme Preset: WireSight Green | Custom Theme Colors... | | Directional Face Shading: On | Edge Width: 1.5 | | Edge Fade Start: 96 blocks | Edge Fade Length: 64 blocks | +--------------------------------+--------------------------------+

• 🌓 Directional Face Shading uses fixed brightness levels for top, side, and underside faces; it is not dynamic lighting.
• 📏 Edge Width controls the approximate on-screen pixel width of block edges.
• 🌫️ Edge Fade Start is the distance where edges begin fading.
• 📐 Edge Fade Length is the distance used to complete that fade, so the defaults end at 96 + 64 = 160 blocks.

🌈 Custom theme colors

+----------------------+----------------------+----------------------+ | Theme Preset: Custom | +----------------------+----------------------+----------------------+ | Block Face R: 6 | Block Face G: 17 | Block Face B: 11 | | Water R: 5 | Water G: 21 | Water B: 19 | | Block Edge R: 53 | Block Edge G: 255 | Block Edge B: 120 | | Entity R: 14 | Entity G: 61 | Entity B: 34 | | Sky R: 0 | Sky G: 0 | Sky B: 0 | +----------------------+----------------------+----------------------+

⚠️ Important: Custom RGB values are applied only when Theme Preset is set to Custom.

🔢 Each channel has full integer precision from 0 to 255. Custom values remain saved when another preset is selected and return unchanged when switching back to Custom.

🧩 Built-in presets

🎨 Surface - WireSight Green - Cyan - Amber - Monochrome

🧱 Block faces - #06110B - #061116 - #171006 - #111111 🌊 Water - #051513 - #051522 - #071417 - #151515 ✨ Block edges - #35FF78 - #35E7FF - #FFC247 - #F2F2F2 👤 Entities - #0E3D22 - #0E3540 - #5E3D10 - #3D3D3D 🌌 Sky and celestials - #000000 - #000000 - #000000 - #000000

🟠 The Amber preset intentionally keeps water cool and dark to distinguish it from warm terrain. Changing an option may briefly recompile the shader.

🔍 Current scope

• 🧱 Visible 1x1 block boundaries on terrain and block entities
• 🌓 Three flat face shades for spatial readability
• ✨ Pixel-stable, antialiased theme-colored edges
• 🌫️ Automatic distant-grid filtering to reduce shimmer
• 🍃 Alpha preservation for cutout geometry such as leaves and plants
• 👤 Flat-color entities, particles, weather, and held items
• 🏷️ Original colors and transparency for name tags and world-space text
• 🌊 Opaque stylized water and a configurable sky

⚠️ Only visible geometry can be outlined. WireSight is not an X-ray shader and does not render faces that Minecraft removes from chunk meshes.

🧪 Compatibility target

🧪 This shaderpack intentionally avoids compute shaders, geometry shaders, and loader-specific extensions.

🔌 Environment - Minecraft - Shader loader - Companion component --- - :---: - --- - --- 🥽 Oculus - 1.20.1 - Oculus 1.8.0 - Embeddium 0.3.31 🌈 Iris - 1.21.8 - Iris 1.9.1 - Sodium 0.6.31 🔭 OptiFine - 1.8.9 - OptiFine HD U M5 - Forge 11.15.1.2318

📚 The OptiFine build targets every stable Minecraft release from 1.8 through 1.21.x. Unlisted combinations rely on compatible interfaces and have not been tested individually.

📦 Install

📥 Place the release zip in the Minecraft instance's shaderpacks directory, then select WireSight from the shader pack menu.

💻 VS Code

🧩 Install Shader languages support for VS Code for GLSL syntax highlighting. The tracked .vscode/settings.json maps .glsl, .fsh, and .vsh files to GLSL, while .vscode/extensions.json recommends the extension automatically.

code --install-extension slevesque.shader

🚀 Build, release, and publish

🐍 Build locally with uv and Python 3.13:

uv venv uv run python ./scripts/build_shaderpack.py uv run python ./scripts/validate_publish.py

📦 Two reproducible ZIPs and their matching SHA-256 files are written to dist/. metadata.toml is the single source of truth for the WireSight version, variant support ranges, platform project IDs, and loaders.

📦 Variant - Artifact - Modrinth loader - Minecraft range

🌈 Iris / Oculus - WireSight-X.Y.Z-iris-oculus.zip - iris - 1.20 through 1.21.x 🔭 OptiFine - WireSight-X.Y.Z-optifine.zip - optifine - 1.8 through 1.21.x

⚙️ GitHub Actions observes these exact commit-subject suffixes on pushes:

🎯 Mode - Commit subject suffix - Actions artifact - GitHub Release - Modrinth / CurseForge

🛠️ Build - (build action) - ✅ - ❌ - ❌ 🏷️ Release - (build release) - ✅ - ✅ - ❌ 🚀 Publish - (build publish) - ✅ - ✅ - ✅

📝 Only the subject line is inspected; matching text in the commit body is ignored.

🔁 Pull requests are always built. Builds, releases, and platform publishing can also be started manually; pushing a v* tag creates only the matching GitHub Release.

📖 See the build, release, and publish guide for the pipeline diagrams, platform project setup, required GitHub Secrets, release metadata, supported Minecraft versions, and release-note format.

🛠️ Build and upload an Actions artifact without creating a Release.

git commit --allow-empty -m "ci: test WireSight package (build action)"

🏷️ Build and publish the version declared in metadata.toml.

git commit -m "release: vX.Y.Z summary (build release)"

🚀 Build, create a GitHub Release, and publish to Modrinth and CurseForge.

git commit -m "release: vX.Y.Z summary (build publish)"