📖 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

WireSight rendering a Minecraft world as green wireframe geometry

🎨 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

🔌 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)"