Alpha Piscium

Language: English | 简体中文

High-quality realistic Minecraft shaderpack featuring global illumination, volumetric clouds, atmospheric scattering, and stunning visual effects.

Official Website link: https://alphapiscium.org/
Discord server link: https://discord.gg/E2Uq2MmHgq

Features

• Real-time Global Illumination
  • Reservoir-based SpatioTemporal Importance Resampling (ReSTIR) based Screen-Space Global Illumination
  • ReBLUR based denoising
• Realistic, real-time, and fast Atmospheric Scattering
  • Unreal Engine Sky Atmosphere Rendering Technique
  • Epipolar Sampling
• Real-time Volumetric Clouds
  • Nubis
• High-quality adaptive Shadows
  • Rectilinear Texture Warping (RTWSM)

Installation

1. Download the Alpha Piscium shaders for Minecraft from Modrinth or GitHub Release.
2. Install Iris shader loader.
3. Open the Minecraft launcher and choose the Iris profile you just created with the version you're playing.
4. Launch Minecraft.
5. Go to Options → Video Settings → Shader Packs, then click Open Shader Pack Folder.
6. Move the downloaded ZIP file into this folder (.minecraft/shaderpacks).
7. In-game, select the newly installed pack from the shaders list. (If you select a shader pack using Iris, its filename will turn yellow.)
8. Click Done or Apply and the shader will be loaded.

FAQ

• No lighting at night: Please use PBR resource packs. For vanilla style, SPBR is recommended. Otherwise, try Patrix.
• Can't load shaderpack: Please use Iris with version 1.7 or higher.
• Everything goes dark when turning back: This is due to the limitations of screenspace techniques. There isn't a perfect way to fix this.
• Intel GPU: Alpha Piscium uses cutting-edge graphics technology. Unfortunately, Intel doesn't maintain their OpenGL driver well, so Intel GPUs are not supported.
• AMD GPU: Check if your GPU driver is newer than 22.7.1. If older, please update your driver.
• Other loading errors: Press Ctrl+D in Iris's shaderpack selection screen, then reload the shaderpack. Make an issue with the error message and the relevant files in .minecraft/patched_shaders as shown in the error message.

AI / LLM Code Disclosure & Compliance Notice

Please be advised that this codebase incorporates software components generated or assisted by Large Language Models (LLMs). If your personal policy, regulatory constraints, or usage criteria prohibit the deployment or execution of AI-generated software, you are requested to immediately cease utilization and remove all instances of Alpha Piscium from your systems.

License

Files under the scripts directory are licensed under the MIT License. All other files are licensed under the GNU General Public License v3.0.

Development

Alpha Piscium keeps pass entry points, reusable rendering techniques, generated bindings, and developer tooling separate. Start with the English developer documentation, then use the quick start, project structure, workflow guide, and pipeline overview.

Project outline:

• shaders/pass/: shader entry points with main.
• shaders/techniques/: reusable rendering modules.
• shaders/util/: shared math, sampling, material, and data helpers.
• shaders/base/: common interfaces and generated option/texture bindings.
• scripts/: Kotlin/PowerShell generators, packaging, and asset tools.
• docs/: project-specific workflows and module maps.

Ordinary .glsl edits need no generation step. Run the owning generator after changing the program list, options, the hand-maintained scripts/shaders.properties, or shaders/shadesmith.json; the exact commands are listed in the quick start.