Lophine/README_ZH_TW.md

Lophine

Lophine 是一個基於 Folia 的 fork，具備許多好用的最佳化與可設定的原版特性，目標是在 Folia 上實現更多生電向的內容（完整生電支援請使用 Fabric）

English | 中文（簡體） | 中文（繁體）

---

✨ 核心特性

• 🔧 可設定的原版特性 - 彈性調整遊戲機制，以符合不同伺服器的需求
• 📊 Tpsbar 支援 - 即時顯示伺服器 TPS 狀態
• 🐛 Folia Bug 修復 - 針對 Folia 已知問題的專項修復
• 💾 多種存檔格式支援 - 支援 linear 與 b_linear（linear 重新實作）存檔格式
• 🔬 生電功能強化 - 在 Folia 上實現更多生電內容（完整生電請使用 Fabric）
• 🛠️ 更多實用功能 - 持續新增有用的伺服器功能

額外啟動參數

• morninggloryclip.useMojangSource 強制伺服器端使用 Mojang 官方來源下載檔案
• morninggloryclip.enable.mixin 為伺服器插件啟用 mixin 支援

📥 下載

穩定版本

所有正式發布版本都可以在 Releases 頁面找到。

開發版本

如果你想搶先體驗最新功能，可以照下面的步驟自行建置。

建置步驟

# Clone 這個專案
git clone https://github.com/LophineLabs/Lophine.git
cd Lophine

# 套用 patch 並建置 Paperclip JAR
./gradlew applyAllPatches && ./gradlew createPaperclipJar

建置完成後，你可以在 lophine-server/build/libs 目錄中找到產生的 JAR 檔案。

🔌 API 使用

Gradle 設定

repositories {
    maven {
        url = "https://repo.bacteriawa.com/repository/maven-public/"
    }
}

dependencies {
    compileOnly("fun.bm.lophine:lophine-api:26.2.build.+")
}

java {
  toolchain.languageVersion.set(JavaLanguageVersion.of(25))
}

Maven 設定

<repositories>
    <repository>
        <id>repository</id>
        <url>https://repo.bacteriawa.com/repository/maven-public/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>fun.bm.lophine</groupId>
        <artifactId>lophine-api</artifactId>
        <version>[26.2.build,)</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

💬 社群與支援

如果你對這個專案有興趣，或有任何問題，歡迎隨時來問我們。

加入我們的社群

• QQ 群: 1020403749
• Discord: 點我加入

取得協助

• 📋 提交 Issue
• 💬 GitHub Discussions
• 📖 專案文件

🐛 問題回報

當你遇到任何問題時，歡迎來問我們，我們會盡力協助解決。請記得：

• 📝 清楚描述問題 - 詳細說明問題的具體狀況
• 📋 提供完整記錄檔 - 附上錯誤記錄與相關設定資訊
• 🔍 環境資訊 - 說明伺服器版本、插件清單等環境細節
• 🔄 重現步驟 - 如果可以，請提供重現問題的具體步驟

🤝 貢獻程式碼

我們歡迎社群貢獻！詳細的貢獻指南請參考：

• 📖 貢獻指南（English）
• 📖 貢獻指南（簡體中文）
• 📖 貢獻指南（繁體中文）
• 📖 貢獻指南（日本語）

📊 專案統計

BStats 資料

⭐ 給我們一個 Star 吧！

你給的每一個免費 ⭐Star，都是我們前進的動力。