Tapestry — Lunar Client の Apollo API を実装する Fabric Mod

Library
Tapestry — Lunar Client の Apollo API を実装する Fabric Mod

Tapestry — Lunar Client の Apollo API を実装する Fabric Mod

Lunar Client の Apollo API（Lunar のクライアント側 API）を Fabric 環境で利用できるようにするシンプルな Mod。小規模な Java 製プロジェクトで、Fabric 向けのビルド設定（build.gradle）や最小限のソースを含み、Lunar の拡張機能や他 Mod との連携の互換レイヤーとして機能することを目指しています。リバースエンジニアリング的な API 実装やパケット処理、Mixin を使ったクライアント改変といったモッディングの基本的な考え方が読み取れます（約300字）。

https://github.com/aprilpet/Tapestry

概要

Tapestry は、Lunar Client の Apollo API を Fabric モッド環境に実装することを目的とした小さな Java 製プロジェクトです。Lunar が提供するクライアント拡張の API に互換することで、Lunar 専用の機能を Fabric 上の他の Mod やプラグインから利用できるようにする「互換レイヤー」を提供します。リポジトリは非常に軽量で、ビルド設定（build.gradle）と必要最小限のソースコード、ライセンス、README を含む構成になっており、Fabric の基本的な知識があれば読み解きやすい実装です。将来的な拡張や他クライアント互換の参考実装としても価値があります（約300字）。

GitHub

リポジトリの統計情報

  • スター数: 1
  • フォーク数: 0
  • ウォッチャー数: 1
  • コミット数: 5
  • ファイル数: 11
  • メインの言語: Java

主な特徴

  • Lunar Client の Apollo API 互換レイヤーを Fabric 上に提供することを目標にした軽量実装
  • Fabric 向けのビルドスクリプト（Gradle）を含み、ローカルでビルドしてテストしやすい
  • 最小限のソース構成で、実装の読みやすさと拡張のしやすさを重視
  • ライセンスと基本的なメタ情報を同梱（OSS として利用・改変の出発点に適する）

技術的なポイント

Tapestry は「Lunar の Apollo API を模したエンドポイントを Fabric 上で提供する」ことに主眼を置いており、技術的には以下の点が注目されます（約700字）。

  • Fabric 環境との統合: build.gradle が存在することから、Fabric（およびおそらく Fabric Loom）を用いたビルド構成が想定されます。これにより、Minecraft クライアントのクラスパッチやリソースの合成、依存関係管理が Gradle 上で完結します。
  • クライアント API の互換レイヤー: Lunar の Apollo API はクライアント拡張の契約（API）を定義しているため、Tapestry はそのインターフェースに合わせた実装と、既存の Fabric クライアントの挙動を橋渡しするコードを提供していると思われます。これはリバースエンジニアリング的なマッピング（メソッド名・シグネチャの一致、イベントの再発行など）を含みます。
  • 実装手法（推測）: クライアントの動作を横断的に改変・補強するには Mixins や ASM を使ったバイトコード操作、もしくは Fabric のイベントフックが用いられます。Tapestry は「シンプル」実装を謳っているため、可能な限り Fabric API の公開フックと軽量な Mixins を併用している可能性が高いです。
  • ネットワークと互換性: Apollo API はクライアント側の機能提供が中心ですが、特定の機能はサーバーや外部ツールとのプロトコル互換を前提とする場合があります。Tapestry の実装は主にクライアント内 API の再現にフォーカスしており、ネットワークプロトコルの改変や専用サーバーとのやり取りは限定的と考えられます。
  • 拡張性と制約: 小規模リポジトリのため、完全な Apollo API の一対一再現ではなく、主要機能を簡潔に提供することを優先している点が読み取れます。実運用での互換性や他 Mod と併用した際の衝突は、実際の利用と検証が必要です。
  • 開発面: README と build.gradle が含まれているため、環境構築（Gradle の実行、依存解決、IDE での開発）が比較的簡単で、開発者が自身の環境でテスト・改修しやすい構成になっています。

上記はリポジトリの内容から推測される設計思想と実装アプローチです。実際のソースを読むことで、どの程度 Apollo API に忠実か、どのような Mixins やパッチを適用しているかが明確になります。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitattributes: file
    • 改行や差分処理の扱い、特定ファイルのマージ戦略などの Git 属性が設定されている可能性があります。
  • .gitignore: file
    • ビルド成果物（/build、IDE 設定等）を無視する設定が含まれます。
  • LICENSE: file
    • プロジェクトの利用許諾（OSS ライセンス）を明記。利用・改変時の法的条件を確認してください。
  • README.md: file
    • プロジェクトの目的、ビルド方法、簡単な使い方や注意点が記載されています（抜粋は記事末尾）。
  • build.gradle: file
    • Fabric / Forge 用の設定や依存関係、ビルドタスクが定義されているビルドスクリプト。ローカルでの jar 生成や IDE インポートに使います。

…他 6 ファイル

（その他のファイルにはソースコード本体、リソース、mod メタ（fabric.mod.json 等）が含まれていることが一般的です。実際には src/main/java 以下に Java ソース、src/main/resources に mod メタや assets が配置されている可能性があります。）

まとめ

軽量で学習しやすい Fabric 向けの Apollo API 互換実装。拡張や検証に最適。

リポジトリ情報：

READMEの抜粋：

Tapestry

A simple fabric mod to implement Lunar client’s Apollo API …