{"id":20498119,"url":"https://github.com/vr-voyage/blender_bones_merger","last_synced_at":"2025-04-13T18:41:42.019Z","repository":{"id":56712757,"uuid":"523947092","full_name":"vr-voyage/blender_bones_merger","owner":"vr-voyage","description":"A tool to merge bones, along with associated vertex groups, for quickly reducing the amount of bones in 3D models","archived":false,"fork":false,"pushed_at":"2025-01-21T00:17:06.000Z","size":6092,"stargazers_count":32,"open_issues_count":1,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-27T09:22:52.971Z","etag":null,"topics":["blender","blender-addon","bones"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vr-voyage.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-08-12T03:48:59.000Z","updated_at":"2025-02-19T07:33:40.000Z","dependencies_parsed_at":"2025-01-20T22:21:09.601Z","dependency_job_id":"6a383279-6499-437d-b17f-14f830af77ab","html_url":"https://github.com/vr-voyage/blender_bones_merger","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vr-voyage%2Fblender_bones_merger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vr-voyage%2Fblender_bones_merger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vr-voyage%2Fblender_bones_merger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vr-voyage%2Fblender_bones_merger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vr-voyage","download_url":"https://codeload.github.com/vr-voyage/blender_bones_merger/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248764376,"owners_count":21158074,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blender","blender-addon","bones"],"created_at":"2024-11-15T18:13:06.219Z","updated_at":"2025-04-13T18:41:42.006Z","avatar_url":"https://github.com/vr-voyage.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# About\n\nThis tool add an option to the Armature \"Edit Mode\" context menu, in order\nto merge bones **and** their respective weight paint in one operation.\n\nI mainly use this to clean up unused bones on 3D avatars for VRChat.\n\n# Screenshots\n\n**Invoking the menu**\n![Merge with Active](screenshots/Menu.png)\n\n**Results afterward**\n![Results after](screenshots/After.png)\n\n**Testing in Pose mode**\n![Posing after](screenshots/After-Pose.png)\n\n*Model in the photo : [RRRR by 広い部屋](https://booth.pm/ja/items/2019040)*\n\nThe tool will add a 'Merge with active' option to the Bones Context menu\nwhen **Edit**ing an Armature.  \nThis option will merge all the selected bones with the current active one,\nas long as the active one has an appropriate vertex group associated.  \nWhen merging, all the weights (weight paint) associated to the removed\nbones vertex groups will be added to the vertex group of the remaining bone.  \nMeaning that the remaining bone will accumulate all the weight paint information\nof the removed bones.\n\n# Installation\n\n* Download the latest release Zip file.\n* Open Blender\n* Open the Preferences panel (Edit \u003e Preferences)  \n![Open the Preferences panel](screenshots/Install-1.png)\n* Select Add-on in the left pane of this panel  \n* On the upper-right of this panel, click on 'Install...'\n![In Preferences, select Add-ons and click on Install](screenshots/Install-2.png)\n* Select the downloaded Zip file\n![Select the downloaded Zip file](screenshots/Install-3.png)\n* Check the 'Rigging: Merge bones with Vertex Groups' checkbox\n![Check the 'Rigging: Merge bones with Vertex Groups' checkbox](screenshots/Install-5.png)\n![Check the 'Rigging: Merge bones with Vertex Groups' checkbox](screenshots/Install-6.png)\n\nNow the Add-on is ready to be used\n\n# Usage\n\n* Select the Armature\n* Tab into 'Edit Mode'\n* Select all the bones you want to merge and remove\n* Select the destination bone last, so it becomes active.  \n  This one will remain after the merging process.\n* Right-click and select 'Merge with active'\n\n# But can't you already merge bones in Blender ?\n\nYou can merge bones in Blender using \"Dissolve Bones\".  \nHowever, dissolving will completley ignore the vertex groups associated to\nthe removed bones. Meaning that, when using Dissolve, the remaining bone\nweight paint will stay the same, and will certainly NOT contain the weight\npaint of the removed bones.  \nThis leads to that predictable 3D rigging disaster with overstretched vertices\ndue to some other vertices not moving at all when rotating the bones.\n\nMy tool takes care of merging the vertex groups, meaning that the remaining bone\nvertex group will accumulate all the weight painting information of the removed\nbones.  \nTHIS being the main reason why I made this tool actually.\n\nNote that, after merging the bones, this tool also remove the previous vertex\ngroups associated to the removed bones.\n\n\n# Why does the merged bone size remains the same ?\n\nAs you can see in the screenshot, most of the time, the bones merged are all\nover the place. In such situations, changing the bone size would just lead\nto oversized bones that just hinders the editing process.  \nIf you want to change the size of the bones, you'll have to do it manually,\never before or after using \"Merge bones with active\".\n\n\n---\n\n日本語版\n\n# 概要\n\nこのAddonはアーマチュアを編集する時に、ボーンと関連のウェイトペイントを一気に結合できるように、\n新しいオペレーターを追加します。\n\nVRCHATで使用する3Dモデルを最適化するために開発したツールです。\n\n# 説明動画\n\n## 使い方 \n\n[![使い方を説明する動画](https://img.youtube.com/vi/gIVQNNsAocI/0.jpg)](https://www.youtube.com/watch?v=gIVQNNsAocI)\n\n## 紹介動画\n\n[![作業をしながらアドオンを紹介する動画](https://img.youtube.com/vi/EwgADxojTj8/0.jpg)](https://www.youtube.com/watch?v=EwgADxojTj8)\n\n# 使い方\n\nまずは、アーマチュア編集モードに切り替えます。\n\nそして：\n1. 最初に消したいボーンを選択します。\n2. 最後にウェイトペイントの情報を受け取るボーンを選択します。\n3. そして、右クリックのメニューから「アクティブ・ボーンと結合」を選びます。\n\n詳細は説明動画をご覧ください。\n\n# インストール方法\n\n* 最新のリリース（Zipファイル）をダウンロードします。\n* Blenderを開きます。\n* **編集 \u003e プリファレンス**の画面を開きます。 \n* プリファレンス画面で、左にある「アドオン」をクリックします。  \n* 右上にある「インストール」ボタンをクリックします。  \n* ダウンロードしたリリースを選びます。  \n* 現れる'Rigging: Merge bones with Vertex Groups' のチェックを入れます。\n\n# クレジット\n\nスクリーンショットに写っているモデル：\n「2A-7-4 / RRRR　ヨツル」by「広い部屋」様\nhttps://booth.pm/ja/items/2019040\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvr-voyage%2Fblender_bones_merger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvr-voyage%2Fblender_bones_merger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvr-voyage%2Fblender_bones_merger/lists"}