---
title: Iris Shaders 光影模組
description: Iris Shaders 的簡易安裝教學
tags: 教學, Iris, 光影, Fabric, 模組
---
###### 本篇由 @Nanako0129 主撰：[原文連結](https://hackmd.io/@Nanako0129/iris-shaders)
# Iris Shaders 光影模組

## 什麼是 [Iris Shaders](https://irisshaders.net/index.html)

**Iris** 是一項高效能的Fabric光影模組開源專案，並致力於確保模組的相容性作為第一優先度。另外可與 [Sodium](https://github.com/CaffeineMC/sodium-fabric) 模組一同使用，大幅增進光影性能。

_了解更多關於 IRIS 的資訊： https://irisshaders.net/about.html_

## 如何安裝 Iris+Sodium
以下提供三種安裝方式作為參考：

* 一般使用者之簡易安裝方式
* Fabric 客戶端的使用者
* 自行編譯
:::warning
:warning: Sodium 模組目前不能直接使用原作者專案中的版本，需使用 Iris 官方公開釋出版自帶整合的，或是自行編譯該 Iris 分支的 Sodium
:::

---

### 一般使用者之簡易安裝方式：

直接至 [Iris官網](https://irisshaders.net/download.html) 下載自動安裝的jar執行檔
[](https://irisshaders.net/download.html)

執行所下載的jar檔，選擇希望安裝的版本，點 Install 安裝

重啟啟動器即會看到多了 **Iris & Sodium** 的啟動配置

---

### Fabric 客戶端的使用者：

**==該版本自帶整合 Sodium，毋須再額外安裝==**

下載對應版本的 Iris+Sodium 模組後並放置於Mod資料夾。

**第三方載點：**
 **Modrinth:** https://modrinth.com/mod/iris
 **CurseForge:** https://www.curseforge.com/minecraft/mc-mods/irisshaders

---

### 自行編譯 Iris 模組：
==**編譯後的Iris不會整合自帶Sodium，需額外自行編譯分別安裝**==

透過 [Gradle](https://gradle.org/install/) 進行編譯

> `1.16` 分支: https://github.com/IrisShaders/Iris
`1.17` 分支: https://github.com/IrisShaders/Iris/tree/1.17
:::info
:bulb: 編譯 1.17.x 版本需要 [JDK 16](https://adoptopenjdk.net/?variant=openjdk16&jvmVariant=hotspot) 環境，推薦使用 [AdoptOpenJDK - HotSpot JVM](https://adoptopenjdk.net/?variant=openjdk16&jvmVariant=hotspot)
:::
#### (以Windows 環境為例)
下載對應分支版本原始碼後，解壓並於原始碼根目錄路徑下，執行

.\gradlew build


編譯完成後，將會位於 `.\build\libs\` 中，請選擇**無** `-dev` `-sources` 後綴版本，安裝至你Fabric的mod的資料夾

#### ==(額外步驟)==
可以再執行 `publishToMavenLocal` 將編譯好的 Iris 安裝到本地儲存庫，以供 Iris 分支版的 Sodium 編譯使用。

## Extra
### 自行編譯相容Iris的Sodium模組：

> `1.16` 分支: https://github.com/IrisShaders/sodium-fabric
> `1.17` 分支: https://github.com/IrisShaders/sodium-fabric/tree/1.17.x/iris

:::danger
在Iris編譯完後，執行 `publishToMavenLocal` 將編譯好的 Iris 安裝到本地儲存庫，以供 Iris 分支版的 Sodium 編譯使用。否則會出現編譯錯誤。請參考 [自行編譯 Iris 模組：(額外步驟)](#額外步驟)
:::
下載對應分支版本原始碼後，解壓並於原始碼根目錄路徑下，執行

.\gradlew build


編譯完成後，將會位於 `.\build\libs\` 中，請選擇**無** `-dev` `-sources` 後綴版本，安裝至你Fabric的mod的資料夾