owo-lib（oωo）は、ほかのMODの画面・設定・通信などを支えるライブラリです。使いたいMODから導入を求められた場合は、owo-lib本体に加え、対象版のFabric APIもそろえます。
対象はglisco／Wisp Forestのowo-libです。Java版Minecraft1.21.1・Fabric用の通常版を例に、必要なファイル、導入先、owo-sentinelの不足表示、設定やマルチ接続の確認点を説明します。作者の配布・文書・対象タグのソースを確認した内容で、実機導入やSentinelの実行、マルチ接続は検証していません。
owo-libは画面・設定・通信を支えるライブラリ
作者のowo-lib配布説明では、MOD開発向けの汎用機能、GUI、設定のライブラリとして案内されています。ほかのMODが必要な機能を呼び出して使う土台です。
| 主な仕組み | 支える内容 | プレイヤーが確認するもの |
|---|---|---|
| owo-ui | 利用側MODの画面 | そのMODの画面を開く方法 |
| owo-config | 設定画面や設定の管理 | 利用側MODの設定項目と同期条件 |
| 通信・登録などの共通機能 | データのやり取りや機能の登録 | 本体と前提MODの対応版 |
owo-libを入れたことだけで、新しい冒険や専用アイテムが自動的に始まるわけではありません。新しい画面や設定を使いたい場合は、それを利用するMOD側の説明を確認してください。
「owo」という名前には、メニューの文章やチャットを変える別の配布物もあります。文字変換を目的とするMODやリソースパックと、gliscoの共有ライブラリを取り違えないようにします。
1.21.1用の通常版とFabric APIをそろえる
今回の対象は、owo-lib 0.12.15.4+1.21の通常配布です。配布名の末尾は+1.21ですが、対応ゲーム版には1.21・1.21.1が指定されています。
| 項目 | 今回の対象・例 | 確認する条件 |
|---|---|---|
| Minecraft | Java版1.21.1 | 利用側MODも同じゲーム版へ合わせます |
| Fabric Loader | 0.19.5は公開済みの例 | パックや併用MODの要求も満たします |
| Java | Java21 | 起動プロファイルのJavaを確認します |
| owo-lib | 0.12.15.4+1.21・通常版 | owo-lib-0.12.15.4+1.21.jarを配置します |
| Fabric API | 0.116.17+1.21.1は対応版の例 | Fabric Loaderとは別の必須MODです |
対象版の依存宣言はFabric Loader 0.15.0以降、Fabric API 0.100以降です。表では1.21.1向けのFabric API配布を選んでいます。表の構成は条件を確認した例で、既存パックすべての動作を保証する組み合わせではありません。
Minecraft公式の1.21.1情報はゲーム本体の案内です。MODの対応は、それぞれの配布条件を別途確認してください。今回のFabric用ファイルを、NeoForge用の代わりに使うことはできません。
Mod Menuは設定画面との連携がありますが、今回のowo-libを動かすための必須依存には指定されていません。Cloth Config、REI、EMIなども、一律の必須MODとして追加しません。利用側MODが別途要求している場合は、その条件に従います。
また、1.21向けの0.13.0-alpha.15はalphaとして公開され、作者は旧版向けMODとの互換性が十分に検証されていないことを明記しています。通常版0.12.15.4と同じものとして入れ替えず、パックが求める版と配布区分を確認してください。
起動するFabricプロファイルのmodsへ配置する
導入前にゲームを終了し、ワールド、現在のmodsとconfigを保存します。導入先は、実際に起動する1.21.1・Fabricプロファイルのゲームディレクトリです。
- 利用側MODのゲーム版・ローダー・owo-lib要求版を確認します。
- 対象プロファイルが1.21.1・Fabricになっているか確認します。
- 作者配布の通常JARと、対応するFabric APIを選びます。
- 対象の
modsへ、owo-lib、Fabric API、利用側MODと必要な前提を配置します。 - 同じowo-libの旧版が重複していないことを確認して起動します。
Fabric公式のMOD導入手順も、対象のゲーム版・ローダーを確認してJARをmodsへ移す流れを案内しています。別ランチャーや独立したプロファイルでは、その構成で指定されているゲームディレクトリを使ってください。
sources付きは開発者向けのソース用ファイルなので、プレイ用には通常JARを選びます。JARの解凍や直接実行、resourcepacksへの配置は不要です。作者文書にあるbuild.gradleやMavenの記述は開発者向けで、プレイヤーが遊ぶために編集するものではありません。
古いJARは、戻せるようにmodsの外へ保存します。新旧のowo-libを同時に置くと、重複や要求版の切り分けが難しくなるため、起動時に使う版をそろえてください。
owo-sentinelが出たら不足している本体を確認する
owo-sentinelは、利用側MODに同梱されることがある小さな補助部品です。owo-libが見つからないときに、その不足を知らせます。Sentinelがあることだけでは、owo-lib本体が導入できているとは限りません。
作者のSentinel説明では、必要なowo-libを案内する機能と、利用者が操作した場合の自動導入機能が説明されています。通知が出ただけで、利用者の操作なしにダウンロードが進む仕組みとはされていません。
手動でそろえる場合は、表示された利用側MODと要求版を控えてから通知を閉じます。正規配布ページで対応するowo-libとFabric APIを選び、起動対象のmodsへ配置して、ゲームを起動し直してください。
すでに置いたはずなのに通知される場合は、別プロファイルへの配置、通常JARではないファイル、ゲーム版やローダーの違いを確認します。ファイル名を書き換えたり、利用側MODからSentinelだけを抜き取ったりしても、必要なライブラリの導入にはなりません。
起動しない・接続できないときの確認点
最初に、エラーに出ているMOD名と要求版を確認します。「owo」と表示される場合も、今回のライブラリのMOD IDとして使われている名称です。ファイル名をowoへ変更する必要はありません。
| 表示・症状 | 先に確認すること | 対応の方向 |
|---|---|---|
| owoやowo-libが必要 | 通常JARの配置先と要求版 | 起動対象のmodsと配布条件を照合します |
| Fabric APIが不足 | Loaderだけで済ませていないか | 対応版のFabric APIも配置します |
| MODが重複している | owo-libの旧版が残っていないか | 使わない版をmodsの外へ保存します |
| 接続時に設定不一致が出る | 表示された設定名と両側の値 | 管理者の構成へ合わせ、必要なら再起動します |
| 更新後に画面などで落ちる | 利用側MOD・アドオンとの組み合わせ | 変更前の構成と詳しいログを比べます |
ライブラリがエラーに登場しても、原因がowo-lib単体だとは限りません。Minecraft、Java、Fabric Loader、Fabric API、owo-lib、利用側MODの版と、直前に変更したファイルを控えてください。
一度に全部を別版へ替える前に、保存した構成と比較します。MODパックの指定版がある場合は、それを基準に戻せるコピー環境で確認してください。
設定画面と同期ルールは利用側MODで確認する
owo-configは、利用側MODが設定画面や項目を作るための仕組みです。どの画面から開くか、どの項目が存在するかは利用側で異なります。全MODに共通する設定キーや、必ず編集する同名ファイルがあるとは限りません。
Mod Menuとの連携も、利用側が登録した設定画面を扱います。画面が見つからない場合は、そのMODの案内と対象版の対応を確認してください。owo-configを使っているからといって、別の設定ライブラリへファイルを置き換える方法ではありません。
対象版の設定同期処理では、接続先の設定を同期する一方、再起動が必要でその場では合わせられない項目が異なると、接続を止める場合があります。その際は「unrecoverable config mismatch」とともに、設定名やクライアント・サーバー側の値が示されます。
表示された項目を管理者に確認し、指定された値へ合わせてクライアントを再起動します。接続できないからといって、設定ファイル全体を消す前に、どの項目の差なのかを確認してください。
マルチプレイと更新・削除前の注意点
今回のowo-libの配布情報では、クライアント・サーバーの両方が必須側です。利用側MODを共有して遊ぶ場合は、管理者の指定するゲーム版・ローダー・ライブラリ・前提MODを両側でそろえます。
更新前にはゲームとサーバーを終了し、ワールド、MOD、設定をまとめて保存します。コピーした環境で、起動、利用側の画面、設定、マルチ接続を確認してから反映してください。ライブラリの番号だけを見てalphaへ切り替えないようにします。
削除する場合は、owo-libを必要とするMODをすべて確認します。あるMODを使わなくなっても、別のMODが依存していればowo-libやFabric APIは残す必要があります。
利用側MODも外す場合は、そのMODが追加したアイテムやブロックへの影響も確認してください。ライブラリを外すことと、ワールドを安全に元へ戻せることは同じではありません。問題が出た場合は、対応するワールドとMOD・設定を組で戻せるようにしておきます。
まとめ：owo-lib MODは利用側の要求版と前提を合わせる
owo-lib MODは、ほかのMODの画面・設定・通信を支える共有ライブラリです。今回のFabric1.21.1用通常版では、対応するFabric APIもそろえて、起動するプロファイルのmodsへ通常JARを配置します。
Sentinelは不足を知らせる補助部品で、本体の代わりではありません。通常版とalpha、別ローダー用を区別し、設定不一致では表示された項目と再起動の必要性を確認してください。更新・削除は利用側MODの依存関係を調べ、元の構成を保存してから進めます。
コメント