Repository navigation
Releases: niwanotorico/FreebirdCollabo
Release list
FreebirdCollabo v0.12.1 — Public Alpha
v0.12.1 — Blender 内で最新版へ更新できるようになりました
新しい版が公開されると、COLLAB パネルに Update available (vX.Y.Z) が出ます。ボタンを押したときだけ、Blender の中で最新版へ更新できます。
- 通知:アドオンを有効にしたとき、GitHub Releases を 1 回だけ確認します。新しい版があるときだけ、Create Room の上に赤い
Update availableボタンが出ます - 押したときだけ更新:ボタンを押すまで、ダウンロードも更新も一切しません(自動更新はしません)
- Release の
freebird_collab_addon.zipを自動取得:ボタンを押すと、その Release の配布 ZIP を取得して更新します - 検証してから安全に入れ替え:ダウンロード後に、サイズ・SHA-256・ZIP の中身・Python の構文・バージョンを確認してから入れ替えます
- 失敗時は旧版を維持:途中で失敗しても元の版に戻り、アドオンが壊れることはありません
- ルーム参加中は更新できません:ボタンは押せなくなります。ルームを抜けてから更新してください
- 更新後は Blender の再起動が必要:「Updated to vX.Y.Z. Please restart Blender.」と表示されたら、Blender を再起動してください(自動再起動や即時の読み込み直しはしません)
共同編集 / Relay / Undo の機能は変わっていません。
v0.12.0 以前をお使いの方
v0.12.0 以前のアドオンには更新通知がありません。今回だけ、下の freebird_collab_addon.zip を手動で入れてください(Blender の Edit > Preferences > Add-ons > Install from Disk。古い版は先に無効化して削除してください)。次の版からは、アドオンの中の Update available から更新できます。
確認済みの環境
- Blender 5.1.2 / 5.2.1 でテスト済み
- 実機で、古い版(0.0.1)から 0.12.1 への自己更新と、再起動後の通常動作(Create / Join・同期)を確認済み(Release を介さないローカル ZIP での確認)
わかっている制限
- 本物の GitHub Release 経由の自己更新は、この Release を作成してから最終確認します
- Windows でアドオンのフルパスが 260 文字を超える場所に入れている場合、更新は失敗します。このときも旧版はそのままで、エラー表示になるだけです
- 開発用の入れ方(git チェックアウト / リンク)のときは、ボタンは Release ページを開くだけです
インストール
下の freebird_collab_addon.zip を Blender の Edit > Preferences > Add-ons > Install from Disk で入れて、Freebird Collaboration Layer を有効化してください。COLLAB パネルに 0.12.1 と表示されれば OK です。
⚠️ Public Alpha です。重要なデータは必ずバックアップを取ってから使ってください。
PR: #8
FreebirdCollabo v0.12.0 — Public Alpha
v0.12.0 — 自分専用 Undo / Redo
ルーム中に Undo しても、相手の作業は巻き戻りません。
- Undo / Redo は自分の操作だけを戻す:Ctrl+Z / Ctrl+Shift+Z、Freebird の Undo / Redo(左スティック、コントローラーのボタン)
- 戻した結果は全員に反映:普段の同期で相手の画面にも届きます
- 対象:移動、オブジェクトの追加 / 削除、マテリアル、マテリアルスロット、Pose
- 相手が後から触った物は戻さない:自分の操作のあとに相手が変更した物は、相手の状態のまま残します
- 素早い Create / Duplicate も 1 回ずつ戻せる:複数選択の Duplicate や GLB 読み込みは 1 回でまとめて戻ります
- Edit / Sculpt Mode では今まで通り Blender の Undo
0.11.x との混在
通信の形式は変えていないので、0.11.x ともつながります。ただし 0.11.x 以前の人が Undo すると、Blender の Undo(ファイル全体)になって、ほかの人の作業も巻き戻ってしまいます。参加者全員を v0.12.0 にそろえてください。
わかっている制限
- Edit Mode のメッシュ編集・ボーン構造・ウェイトは、自分専用 Undo の対象外(Blender の Undo のまま)
- 新しく作ったマテリアルそのものは Undo できない(スロットへの割り当ては戻せる)
- メニューの Edit > Undo は Blender の Undo(ファイル全体)になる。ルーム中は Ctrl+Z / Ctrl+Shift+Z か Freebird の Undo / Redo を使う
- ルームを抜けたあとに Undo すると、ルーム中の状態まで戻ることがある
インストール
下の freebird_collab_addon.zip を Blender の Edit > Preferences > Add-ons > Install from Disk で入れて、Freebird Collaboration Layer を有効化してください。COLLAB パネルに 0.12.0 と表示されれば OK です。
⚠️ Public Alpha です。重要なデータは必ずバックアップを取ってから使ってください。
PR: #7
VR Studio v0.3.0
VR Studio v0.3.0 — first public build (alpha)
VR Studio is a plugin for Freebird XR that lets you colour, restyle and re-shade your Blender scene from inside VR with one trigger press. It is a separate download from the Freebird Collaboration Layer add-on and works without it.
This release is the Blender add-on wrapper build: install the zip with Blender's Install from Disk — no scripts, no manual copying into ~/.freebird/plugins.
Features
- Color — 32-colour palette. Select objects, point, pull the trigger.
- Look — 8 material presets: Clay / Matte / Glossy / Plastic / Metallic / Glass / Emission / Toon. Look and Color are independent of each other.
- View — VR View shading switch: Wireframe / Solid / Material Preview / Rendered.
- Panels live in a VR Studio area to the right of Freebird's main menu and follow your hand.
- Freebird's Undo / Redo work for Color and Look.
With Freebird Collaboration Layer
- Color / Look → synced to everyone in the session.
- View → local only (your own headset display setting; never synced).
Install (like any Blender add-on)
- Download
vr_studio-v0.3.0.zipbelow — don't unzip it. - Blender → Edit › Preferences › Add-ons › ⌄ › Install from Disk… → pick the zip → make sure VR Studio for Freebird XR is enabled.
- Start VR → Freebird menu → Plugins → Color / Look / View (restart Blender once if they're not there yet).
The add-on is only a wrapper that installs / updates / removes the VR Studio plugin for Freebird XR. Updating = installing a newer zip the same way; the old plugin is backed up to ~/.freebird/plugin_backups/ first. Disabling or removing the add-on does not remove the plugin. Uninstall: add-on preferences → Remove VR Studio Plugin, then remove the add-on.
Requirements
- Freebird XR 2.15.0 or newer
- Blender 5.2 (tested). Blender 4.2+ expected to work, not yet tested.
Tested
- Real-machine (headset) tested on 3 setups: RTX 3090 PC, RTX 5080 PC, and a remote tester's PC (Machida) — Windows, Blender 5.2, Freebird XR 2.15.0.
What is NOT changed
- Freebird XR itself: unchanged. VR Studio uses Freebird's plugin mechanism only.
- FreebirdCollabo core (
freebird_collab): unchanged. Color / Look sync reuses the existing material sync.
Known limitations
- Rendered with Cycles is very heavy in VR — use EEVEE.
- Glass transparency needs Raytracing enabled (EEVEE).
- Pressing a colour unplugs an image texture on Base Color (Undo restores it).
- Only tested on Windows with Blender 5.2 + Freebird XR 2.15.0 (Blender 4.2–5.1 and other OSes untested).
- Alpha / pre-release: expect rough edges.
Checksums
e0655e5f19ab7f77de6cf1e5560459da16cc714360e5a1a4c737cdafa4d90eae vr_studio-v0.3.0.zip
FreebirdCollabo v0.11.1 — Public Alpha
v0.11.1 — Room Code だけで接続
Relay URL を標準で設定し、参加者は 同じ Room Code を入力して Join するだけ でつながるようになりました。
- Relay URL を標準設定:既定の公開 Relay(
wss://freebird-relay.chickenos.workers.dev)が最初から入っています - 通常は Room Code だけで接続可能:ホストが Create Room → 参加者が同じ Room Code で Join Room
- Relay URL / Check Relay は通常触らなくてよい:自分の Relay を使いたい場合だけ書き換え可能(↺ ボタンで既定に戻せます)
- 既存の Direct (IP address) 接続はそのまま
- 0.11.0 と通信互換あり:同期の中身は変わっていません(0.11.0 側は Relay URL の手入力が必要)
インストール
下の freebird_collab_addon.zip を Blender の Edit > Preferences > Add-ons > Install from Disk で入れて、Freebird Collaboration Layer を有効化してください。
⚠️ Public Alpha です。重要なデータは必ずバックアップを取ってから使ってください。
PR: #4
FreebirdCollabo v0.11.0 — Public Alpha
FreebirdCollabo v0.11.0 — Public Alpha
Real-time multi-user collaboration for Blender. Works with or without VR.
FreebirdCollabo is a Blender add-on that synchronizes one Blender scene across multiple Blender instances in real time.
On desktop it works as a remote co-editing layer for Blender. Pair it with Freebird XR and the same workflow can be used from inside VR for collaborative VR creation.
Freebird XR is optional — no VR headset required.
⚠️ This is a Public Alpha. Always back up important .blend files before joining a session.
What syncs in v0.11.0
All features below have been confirmed on real machines with Blender 5.2.
- Objects — transform, create / delete, duplicate, rename, parent / child hierarchy
- Mesh Edit — vertices / faces in real time (including while in Edit Mode), UV
- Grease Pencil — create, draw, edit
- Materials — create / delete / rename, slots, main Principled BSDF inputs, image textures
- Material Node Tree — standard Shader Nodes: add / remove, values, links, Material Output
- Pose — Pose Mode bone transforms
- Armature / Bone — create armatures during a session, add / remove / rename bones, head / tail / roll, parent / connected
- Skinning — vertex groups, weights, Armature Modifier
- GLB Import — hierarchy, meshes, UVs, materials and textures
- Presence — selection, active tool; with Freebird XR also HMD, controllers and pointer ray
- Other data — Curve, Text, Light, Camera, Empty
Install
- Download
freebird_collab_addon.zipbelow - Blender → Preferences → Add-ons → Install from Disk → select the zip → enable Freebird Collaboration Layer
- Set Display Name / Color / Connection in the add-on preferences
- (Optional, Freebird XR only) Download
freebird_plugin/freebird_collab_menu.pyfrom the repository and copy it to your Freebird plugins folder.
For full feature synchronization, all participants should use v0.11.0.
Older versions can still connect, but newer features may not sync.
See the README:
https://github.com/niwanotorico/FreebirdCollabo/blob/v0.11.0/README.md
Tests
All 9 automated test suites pass (bpy 5.0.1, headless, two Blender instances).
Known limitations
- Moving objects between Collections is not synced
- No shared Undo
- No permissions
- No built-in voice chat
- Material Node Tree is still alpha quality
- Not synced: Node Group contents, Geometry Nodes, Compositor, World shader, constraints / IK / drivers, keyframes / actions / NLA, normals, modifiers other than Armature
- Not yet optimized for large groups
日本語の要約:
Blender 向けのリアルタイム複数人共同編集アドオンの公開α版です。VR なしでも使え、Freebird XR と組み合わせると VR 内での共同制作もできます。v0.11.0 では Material / Material Node Tree / Pose / Armature / Skinning / Grease Pencil / Mesh Edit / GLB Import などを同期できます。