ink-wash-shaderpack
is an Iris shader pack for Minecraft, inspired by traditional Chinese ink wash painting art. Using post-processing shader technology, it transforms the game's visuals into a real-time ink painting style—featuring natural gradations of ink tones, varied bru
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
ink-wash-shaderpack
🎨 Ink Wash Painting Shader Pack
> *Transform your Minecraft world into a flowing Chinese ink wash painting.*
---
✨ Overview
Ink Wash Shader Pack is an Iris shader pack for Minecraft, inspired by traditional Chinese ink wash painting art. Using post-processing shader technology, it transforms the game's visuals into a real-time ink painting style—featuring natural gradations of ink tones, varied brushstrokes, distant mountains fading into a dreamlike white space, and foliage swaying in the wind.
Unlike simple desaturation filters, this shader pack deeply simulates multiple traditional ink painting techniques:
- Rice Paper Texture (宣纸) — Natural transitions between burnt, heavy, dark, light, and clear ink tones. - Rice Paper Texture (宣纸) — Multi-scale edge detection to simulate the texture of a traditional ink brush. - Rice Paper Texture (宣纸) — Distant scenery and skies fade into large areas of preserved white space, mimicking the ethereal emptiness found in traditional landscapes. - Rice Paper Texture (宣纸) — A soft, natural bleeding effect simulating wet ink seeping into rice paper. - Rice Paper Texture (宣纸) — Fractal noise reproduces the authentic fiber texture of traditional Xuan paper.
🖼️ Core Features
🖌️ Global Ink Tone Palette
All blocks are mapped to ink tones based on luminance. Nearby objects show texture details (like light ink sketches), while distant objects gradually dissolve into negative space.
✒️ Three-Tier Brush Outlines
| Brush Size | Detection Method | Visual Effect | |------------|------------------|---------------| | Fine | Depth + Normal Edges (2x sample) | Major structure outlines (mountains, buildings) | | Fine | Depth + Normal + Color (1x sample) | Block-level edges | | Fine | Color Edges (0.5x sample) | Fine texture detail lines |
🌿 Wind Sway Animation
Grass and flowers sway dynamically with a 3-layer wind system (main gust + rustle + fine tremor). Leaf blocks sway gently like entire branches. The shader intelligently differentiates foliage using texture transparency so solid ground blocks will not animate.
🌫️ Distant Fading
A depth-based fading system: foregound ink is sharp and clear → midground lightens → background dissolves completely into paper white, much like distant mountains in traditional landscape paintings.
💧 Ink Diffusion
A dedicated post-processing pass simulates wet ink seeping into the paper. Light ink areas spread naturally, strong ink remains crisp, and ink flow is subtly influenced by micro-gravity.
📜 Rice Paper & Mounting
- Vermilion Seal (朱印) — Tri-scale fractional brownian motion noise with horizontal fiber bias to recreate authentic papermaking textures. - Vermilion Seal (朱印) — Adds a traditional mounted scroll frame around the screen. - Vermilion Seal (朱印) — A toggleable traditional red stone seal stamp.
🌙 Time & Dimensions
- Ink tones automatically adapt to Minecraft time—light and elegant during the day, heavy and dark at night. - Automatically detects the Nether dimension and applies a brightness boost and a subtle warm red tint perfectly fitting the lava atmosphere. - Subtle "Ink Flow" animation brings a breathing, hand-painted feel to the entire display.
⚙️ Configurable Parameters (18 Settings)
All parameters can be tuned in real-time via the Iris Shader settings menu, featuring full English/Chinese translations. Options include: - Vignette, Scroll Border, and Seal Stamp (Subtle original color preservation up close) - Vignette, Scroll Border, and Seal Stamp - Vignette, Scroll Border, and Seal Stamp for all three brush tiers - Vignette, Scroll Border, and Seal Stamp animations - Vignette, Scroll Border, and Seal Stamp - Vignette, Scroll Border, and Seal Stamp - Vignette, Scroll Border, and Seal Stamp toggles
📦 Installation
1. Requires Minecraft with Iris Shaders and Iris Shaders. 2. Place the downloaded `.zip` file into your `.minecraft/shaderpacks/` folder. 3. Enable the pack in-game: *Options → Video Settings → Shader Packs*. 4. Press `O` in-game to access shader settings and tweak the look to your liking!