Mod：MarumaSign

#概要

MarumaSignとは、AdminのMarumasaUSB氏が長きにわたり保守しているModです。
マインクラフト内にウェブからフェッチした画像を表示することができます。
4.0から、音声/動画/3Dモデルにも対応しました。4.0からFabric/Forge/NeoForge/LiteLoaderで動くようです。

Adminしゃけ氏の解説動画 (MarumaSignバージョン4.0未満の情報です)

YouTube: 【Minecraft 1.20.1 Mod】Marumasa Sign 導入解説

#目次

• 概要
• 目次
• 導入手順
  • 1. Modローダーの導入
    • Prism Launcherの導入
    • Fabric Loaderの導入
  • 2. FFmpegの導入
  • 3. MarumaSignを追加
• 使用方法
• 互換性

#導入手順

#1. Modローダーの導入

すでにFabric, NeoForge, Forgeのいずれかが導入されている人は次章へスキップ可能です。
この導入ガイドでは、1.19以降の主流ModローダーであるFabricを推奨します。
また、この導入ガイドでは詳しくない人でもクリックだけでMod管理ができるサードパーティーランチャーソフトと呼ばれるソフトウェアを用いて進めていきます。

#Prism Launcherの導入

この導入ガイドではオープンソースで軽量で広告などが付いてないPrism Launcherを導入してみます。
まずは下記リンクからダウンロードして、インストーラーを起動します。
https://prismlauncher.org/download/
インストーラーは基本的に次へでOKです。
英語読めるなら、お好みのちょっとした設定ができます。
スタートメニューに追加しますか?とかデスクトップにショートカットを追加しますか?って訊かれてるだけです。

下の画像はWindowsの場合。

導入し終えたら、起動してみましょう。
以下の画面が出てきたらOKです。Microsoftアカウントを追加を押します。
そして、「Microsoftアカウントにサインイン」を押してログインを済ませれば、ホーム画面に移動できるはずです。

#Fabric Loaderの導入

「起動構成を追加」をクリックします。

「カスタム」を選んでバージョンは正式リリースの「26.2」
Modローダーは「Fabric」を選んでから、できるだけリリース日が新しいものを選択し、OKを押します。

これで起動構成ができました。ホームで右のバーの「起動」をクリックして、問題なく起動することを確認したらインストールは終了です。

#2. FFmpegの導入

FFmpegとは、主に動画などのメディアを操作するために非常に昔から保守されてきたOSS(オープンソースソフトウェア)です。
本項では、環境ごとに導入方法が異なります。

winget install --id Gyan.FFmpeg -e

ffmpeg -version

brew -v

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew install ffmpeg

ffmpeg -version

sudo apt update && sudo apt install ffmpeg

sudo dnf install epel-release && sudo dnf install ffmpeg

sudo pacman -S ffmpeg

ffmpeg -version

#3. MarumaSignを追加

MarumaSign本体をダウンロードしましょう。以下のサイトにアクセスして「Show all <数字> assets」の部分をクリックしてください。
https://github.com/TORO-Server/MarumaSign/releases

そして、「MarumaSign-バージョン番号.jar」というファイルをダウンロードします。
Prism Launcherに戻ります。起動構成を選んで右側バーの「編集」をクリックし、続けて「Mod」をクリックしてください。

そして、「ファイルを追加」からMarumaSignのjarファイルを選んで開きます。

これで導入は完了です。「起動」ボタンで起動しましょう。

#使用方法

デフォルトでBキー(26.3ではデフォルトでF9キー、いずれも設定からキーを変更可能)で、MarumaSignの設定 兼 新規作成画面を開けます。
ファイルを選び、座標などを調節して「看板に書き込む」を押したあと、看板を設置することで表示が可能です。

#互換性

MarumaSignの対応しているファイル形式/コーデックはFFmpegのバージョンや環境により左右する可能性があります。

FFmpegの対応しているメディア形式:

• 動画: MP4, MOV, MKV, AVI, FLV, WebM, MXF, TS, M2TS, WMV, OGV など
• 音声: MP3, AAC, WAV, FLAC, Ogg Vorbis, Opus, WMA, AIFF など
• 画像: PNG, JPEG, GIF, BMP, TIFF, WebP

また、MarumaSignはglTF形式(.gltf, .glb)の3Dモデルが読み込めます。
3Dモデル読み込みにおける制限は以下の通りです: (README.mdより)

• 三角形は 15 万枚まで、ファイルは外部ファイルを含めて 64 MB まで
• 透過 (transmission) は屈折を計算せず、半透明として表示します。分散 (dispersion) は見た目に反映しません
• カメラの定義は使いません
• 上に挙げていない拡張が必須 (extensionsRequired) のモデルは読み込めません

また、シェダーパック(影mod)との互換性も公式に確認されているようです。詳しくはここから。
https://github.com/TORO-Server/MarumaSign/blob/main/docs/verification.md

4.1からライブ配信に対応しました。上級者向けですが、ライブ配信の読み込みが可能なようです。詳しくは公式のREADME.mdから。