Merge pull request #70 from TriVR-TRPG/docs/update-overview-video-links

docs: update tool overview docs and intro video links

Author: blhsrwznrghfzpr

README.ja.md

@@ -90,3 +90,12 @@ MIT
 - [ユドナリウム（Udonarium）](https://github.com/TK11235/udonarium#readme) - Webブラウザで動作するオンラインセッションツール
 - [ResoniteLink](https://github.com/Yellow-Dog-Man/ResoniteLink) - Resonite連携ツール
 - [tsrl](https://www.npmjs.com/package/@eth0fox/tsrl) - ResoniteLink接続に使用しているTypeScriptライブラリ
+
+## MMC26 エントリー
+
+このツールは Metaverse Maker Competition 2026 にエントリーした作品です。
+エントリー時点のバージョン: [v1.0.0-beta.4](https://github.com/TriVR-TRPG/udonarium-resonite-importer/releases/tag/v1.0.0-beta.4)
+
+- イベント: [Metaverse Maker Competition 2026](https://youtu.be/MHxobH-TkKc)
+- カテゴリ: other tau
+- ワールド: [[MMC26] Udonarium Resonite Importer - Resonite](https://go.resonite.com/world/G-1Nc5BgekFJQ/R-b0e1dc28-fec9-48cb-8fee-58459f3f637a)

README.md

@@ -92,3 +92,12 @@ MIT
 - [Udonarium](https://github.com/TK11235/udonarium) - Web-based virtual tabletop
 - [ResoniteLink](https://github.com/Yellow-Dog-Man/ResoniteLink) - Resonite integration tool
 - [tsrl](https://www.npmjs.com/package/@eth0fox/tsrl) - TypeScript library used for ResoniteLink connectivity
+
+## MMC26 Entry
+
+This tool was submitted to Metaverse Maker Competition 2026.
+Version at the time of entry: [v1.0.0-beta.4](https://github.com/TriVR-TRPG/udonarium-resonite-importer/releases/tag/v1.0.0-beta.4)
+
+- Event: [Metaverse Maker Competition 2026](https://youtu.be/MHxobH-TkKc)
+- Category: other tau
+- World: [[MMC26] Udonarium Resonite Importer - Resonite](https://go.resonite.com/world/G-1Nc5BgekFJQ/R-b0e1dc28-fec9-48cb-8fee-58459f3f637a)

docs/tool-overview.ja.md

@@ -0,0 +1,108 @@
+# Udonarium Resonite Importer
+
+Resonite ユーザーが、ユドナリウムで配布されているセーブデータを取り込んで遊べるようにするツールです。
+
+## 紹介動画
+
+[![紹介動画（YouTube）](https://img.youtube.com/vi/3CHq_KOcIwQ/maxresdefault.jpg)](https://youtu.be/3CHq_KOcIwQ)
+
+動画リンク: https://youtu.be/3CHq_KOcIwQ
+
+## このツールで何ができる？
+
+ユドナリウムのセーブ ZIP を Resonite にインポートし、盤面の見た目と配置をまとめて再現できます。
+キャラクター、カードと山札、ダイス、テーブル、地形、マップマスクに対応しています。
+
+## ユドナリウムって何？
+
+ユドナリウムは、Web ブラウザで動くオンラインセッション用ツール（Virtual Tabletop）です。
+主にボードゲーム、TTRPG、マーダーミステリーなどで使われています。
+
+日本語圏では、ユドナリウム用のセーブデータ（ZIP）が多数配布されています。
+このツールは、それらのデータを Resonite に持ち込んで遊ぶことを目的にしています。
+
+## どうやって使う？
+
+### 1. アプリを入手
+
+[Booth](https://trivr.booth.pm/items/8034445) または [GitHub Releases](https://github.com/TriVR-TRPG/udonarium-resonite-importer/releases/latest) から ZIP をダウンロードし、展開した `Udonarium Resonite Importer` を起動してください。
+
+### 2. Resonite 側を準備
+
+Resonite を起動し（未インストールの場合は Steam から導入）、新規ワールドを作成してください。
+ダッシュメニューのセッションタブで「ResoniteLinkを有効化」を実行し、「ResoniteLink がポート [数字] で動作中」と表示されたら準備完了です。
+
+Steam: https://store.steampowered.com/app/2519830
+
+### 3. インポート実行
+
+アプリでユドナリウムのセーブ ZIP を選択し、手順 2 のポート番号を入力して「Resoniteにインポート」を押してください。
+
+![GUI版の使用イメージ](images/gui.ja.png)
+
+---
+
+## もっと詳しく
+
+### インポート時の挙動
+
+- インポートしたオブジェクトは RootSlot 直下に生成されます。
+- ルートスロット名は `Udonarium Import - [ZIPファイル名]` です。
+- ルートには `udonarium-resonite-importer:root` タグが付きます。
+- RootSlot 直下に同タグを持つ既存スロットがある場合は、既存スロットを置き換えます。
+- 置き換え時は同じ Transform（位置・回転・大きさ）で再配置します。
+
+### 高度なオプション
+
+通常はデフォルトのまま使えます。必要な場合のみ変更してください。
+
+- ルートにGrabbableを付ける（初期値: オフ）
+  - 盤面全体を掴めるようにします。
+- ルートスケール（初期値: 1 (m)）
+  - ルートスケールを変更できます。
+  - 既存の `udonarium-resonite-importer:root` タグ付きスロットがある場合、そのスケールが優先されます。
+  - 初期状態では 1 マス = 1 m になるよう変換されます。
+- テーブルと固定された地形にコライダーを付ける（初期値: オフ）
+  - CharacterCollider を付与し、乗れるようにしつつ壁のすり抜けを防げます。
+  - 固定されていない地形には付与しません。
+- 半透明画像の描画方法（初期値: Cutout）
+  - 半透明画像の BlendMode を一括で設定できます（個別設定はできません）。
+  - `Cutout`: 透明度しきい値未満を描画しません（切り抜き向け）。
+  - `Alpha`: 透明度に応じて描画します（重なり時に奥側の表示が欠ける場合あり）。
+- SimpleAvatarProtectionを付ける（初期値: オン）
+  - 自分以外が保存できないようにできます。
+  - 誰でも保存してよいものをインポートする場合のみオフにしてください。
+- ResoniteLinkホスト（初期値: localhost）
+  - localhost 以外の ResoniteLink を使う場合に指定できます（未検証）。
+
+### MMC26 エントリー
+
+- イベント: [Metaverse Maker Competition 2026](https://youtu.be/MHxobH-TkKc)
+- カテゴリ: other tau
+- ワールド: [[MMC26] Udonarium Resonite Importer - Resonite](https://go.resonite.com/world/G-1Nc5BgekFJQ/R-b0e1dc28-fec9-48cb-8fee-58459f3f637a)
+
+### クレジット
+
+- 開発者: yoshi1123_
+- テスター: ankou, ifura, KTY, usaturn, Karabina
+- フィードバック: lill
+
+使用アセット:
+
+- ユドナリウム公式アセット: https://github.com/TK11235/udonarium
+
+使用ツール:
+
+- Vibe Coding & 翻訳: Claude Code, GitHub Copilot, ChatGPT/Codex
+- tsrl: ResoniteLink の TypeScript 実装ライブラリ https://www.npmjs.com/package/@eth0fox/tsrl
+- 動画編集: Davinci Resolve
+
+動画内で使用しているアセット:
+
+- BGM: [魔王魂](https://maou.audio/bgm_cyber13/) - CC BY 4.0 https://creativecommons.org/licenses/by/4.0/
+- ユドナ用ルームデータ（テーブル数47） | ouma https://ouma.booth.pm/items/5499018
+- 【D&D5版】ダンジョン＆ドラゴンズ第5版シナリオ「囚われの花嫁」 | しらたき置き場 https://nabenosoko.booth.pm/items/3694104
+
+
+
+

docs/tool-overview.md

@@ -0,0 +1,104 @@
+# Udonarium Resonite Importer
+
+A tool for Resonite users to import and play save data distributed for Udonarium.
+
+## Intro Video
+
+[![Intro Video (YouTube)](https://img.youtube.com/vi/3CHq_KOcIwQ/maxresdefault.jpg)](https://youtu.be/3CHq_KOcIwQ)
+
+Video link: https://youtu.be/3CHq_KOcIwQ
+
+## What Can This Tool Do?
+
+You can import Udonarium save ZIP files into Resonite and recreate both the board visuals and object placement.
+It supports characters, cards/decks, dice, tables, terrain, and map masks.
+
+## What Is Udonarium?
+
+Udonarium is an online session tool (Virtual Tabletop) that runs in a web browser.
+It is mainly used for board games, TTRPGs, and murder mystery games.
+
+In Japanese-speaking communities, many Udonarium save files (ZIP) are shared.
+This tool is built to bring those data sets into Resonite so you can play them there.
+
+## How Do I Use It?
+
+### 1. Get the App
+
+Download the ZIP from [Booth](https://trivr.booth.pm/items/8034445) or [GitHub Releases](https://github.com/TriVR-TRPG/udonarium-resonite-importer/releases/latest), then launch `Udonarium Resonite Importer` from the extracted folder.
+
+### 2. Prepare Resonite
+
+Start Resonite (if not installed, install it from Steam), then create a new world.
+Open the Session tab in the dash menu, enable "ResoniteLink," and wait until you see "ResoniteLink is running on port [number]".
+
+Steam: https://store.steampowered.com/app/2519830
+
+### 3. Run Import
+
+In the app, choose a Udonarium save ZIP, enter the port number from step 2, and click "Import to Resonite".
+
+![GUI usage image](images/gui.en.png)
+
+---
+
+## More Details
+
+### Import Behavior
+
+- Imported objects are created directly under RootSlot.
+- The root slot name is `Udonarium Import - [ZIP filename]`.
+- The root gets the `udonarium-resonite-importer:root` tag.
+- If a slot with the same tag already exists under RootSlot, it is replaced.
+- During replacement, the new slot is placed with the same Transform (position, rotation, scale).
+
+### Advanced Options
+
+In most cases, default settings are fine. Change these only when needed.
+
+- Add Grabbable to Root (default: Off)
+  - Makes the whole imported board grabbable.
+- Root Scale (default: 1 (m))
+  - Changes the root scale.
+  - If an existing slot with `udonarium-resonite-importer:root` exists, that slot's scale takes priority.
+  - By default, size is converted so that 1 tile = 1 meter.
+- Add colliders to table and fixed terrain (default: Off)
+  - Adds CharacterCollider so players can stand on them and not pass through walls.
+  - Not applied to non-fixed terrain.
+- Transparent image render mode (default: Cutout)
+  - Sets BlendMode for all transparent images in bulk (no per-image setting).
+  - `Cutout`: Pixels below alpha threshold are not rendered (good for cutout images).
+  - `Alpha`: Renders by transparency (overlap may cause objects behind to appear broken).
+- Add SimpleAvatarProtection (default: On)
+  - Prevents users other than you from saving.
+  - Turn this off only when importing content that anyone is allowed to save.
+- ResoniteLink Host (default: localhost)
+  - Lets you specify a non-localhost ResoniteLink host (not verified).
+
+### MMC26 Entry
+
+- Event: [Metaverse Maker Competition 2026](https://youtu.be/MHxobH-TkKc)
+- Category: other tau
+- World: [[MMC26] Udonarium Resonite Importer - Resonite](https://go.resonite.com/world/G-1Nc5BgekFJQ/R-b0e1dc28-fec9-48cb-8fee-58459f3f637a)
+
+### Credits
+
+- Developer: yoshi1123_
+- Testers: ankou, ifura, KTY, usaturn, Karabina
+- Feedback: lill
+
+Assets used:
+
+- Official Udonarium assets: https://github.com/TK11235/udonarium
+
+Tools used:
+
+- Vibe Coding & translation: Claude Code, GitHub Copilot, ChatGPT/Codex
+- tsrl: TypeScript implementation library for ResoniteLink https://www.npmjs.com/package/@eth0fox/tsrl
+- Video editing: Davinci Resolve
+
+Assets used in the video:
+
+- BGM: [MaouDamashii](https://maou.audio/bgm_cyber13/) - CC BY 4.0 https://creativecommons.org/licenses/by/4.0/
+- Udonarium room data (47 tables) | ouma https://ouma.booth.pm/items/5499018
+- [D&D 5e] Scenario "Toraware no Hanayome" | Shirataki Okiba https://nabenosoko.booth.pm/items/3694104