{"id":24304501,"url":"https://github.com/alters-mit/asset_bundle_creator","last_synced_at":"2026-02-22T07:31:04.663Z","repository":{"id":157354889,"uuid":"531587546","full_name":"alters-mit/asset_bundle_creator","owner":"alters-mit","description":"Asset Bundle Creator combines several open-source tools to make it easy to convert source files such as .fbx files into Unity prefabs and asset bundles.","archived":false,"fork":false,"pushed_at":"2025-02-21T18:06:10.000Z","size":15960,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-06T15:51:58.016Z","etag":null,"topics":["unity","unity3d"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alters-mit.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,"zenodo":null}},"created_at":"2022-09-01T15:53:42.000Z","updated_at":"2025-02-18T00:49:43.000Z","dependencies_parsed_at":"2025-07-17T10:25:53.404Z","dependency_job_id":"087525f7-0a72-4512-80f5-3049eca89a3f","html_url":"https://github.com/alters-mit/asset_bundle_creator","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/alters-mit/asset_bundle_creator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alters-mit%2Fasset_bundle_creator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alters-mit%2Fasset_bundle_creator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alters-mit%2Fasset_bundle_creator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alters-mit%2Fasset_bundle_creator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alters-mit","download_url":"https://codeload.github.com/alters-mit/asset_bundle_creator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alters-mit%2Fasset_bundle_creator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29706569,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-22T05:59:28.568Z","status":"ssl_error","status_checked_at":"2026-02-22T05:58:46.208Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["unity","unity3d"],"created_at":"2025-01-17T01:40:03.007Z","updated_at":"2026-02-22T07:31:04.646Z","avatar_url":"https://github.com/alters-mit.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Asset Bundle Creator\n\nAsset Bundle Creator combines several open-source tools to make it easy to convert source files such as .fbx files into Unity prefabs and asset bundles.\n\nAll import processes can be interrupted. This can allow you to combine automatic and manual asset creation methods. You can, for example, automatically generate a prefab from a .fbx file, manually edit to the prefab, and then automatically generate asset bundles.\n\nAll 3D objects, articulated or otherwise, receive [hull mesh colliders](doc/hull_mesh_colliders.md), a group of convex mesh colliders generated with [VHACD](https://github.com/kmammou/v-hacd). This means that mesh colliders will always be form-fitting.\n\n![](doc/images/spider.png)\n\nYou can import .urdf robot files with [RobotCreator](doc/api/robot_creator.md), which is very similar to [Unity's own URDF importer;](https://github.com/Unity-Technologies/URDF-Importer) it's a little more limited in functionality but it also tends to work better. \n\n![](doc/images/ur5.png)\n\nYou can also import [PartNet Mobility](https://sapien.ucsd.edu/browse) .urdf files; to my knowledge, Asset Bundle Creator is the only such importer for Unity. It is also possible to convert models or .urdf files referenced by [.sdf](https://sdformat.org) and [.lisdf](https://learning-and-intelligent-systems.github.io/kitchen-worlds/tut-lisdf/) files into asset bundles.\n\nThere are two caveats:\n\n1. This software uses command-line calls and doesn't have a user interface. A user interface will (hopefully) be added soon.\n2. Please review the [license](LICENSE.md).\n\n## Requirements\n\n- Windows, OS X, or Linux\n- Unity 2020.3.48, ideally installed via Unity Hub. \n  - When installing, add build options for Windows, OS X, and Linux.\n- *Linux only:*\n  - To install on a Linux server, [read this.](doc/linux_server.md)\n  - libgconf-2-4 (`sudo apt install libgconf-2-4`)\n  - From the ubuntu-toolchain ppa (`sudo add-apt-repository ppa:ubuntu-toolchain-r/test`):\n    - gcc-9 (`sudo apt install gcc-9`)\n    - libstdc++6 (`sudo apt install libstdc++6`)\n- *OS X only:*\n  - assimp (`brew install assimp`)\n- *Windows only*:\n  - Visual C++ 2012 Redistributable\n\n\n## Usage\n\n1. Close Unity Editor \n2. Open a terminal shell\n3. Type in the command and press enter\n\nThis is an example command-line call:\n\n```powershell\n\u0026\"C:/Program Files/Unity/Hub/Editor/2020.3.24f1/Editor/Unity.exe\" -projectpath \"C:/Users/USER/asset_bundle_creator\" -quit -batchmode -executeMethod ModelCreator.SourceFileToPrefab -name=\"model\" -source=\"D:/models/model.obj\" -output_directory=\"D:/asset_bundles/model\"\n```\n\n**All command-line calls include these arguments:**\n\n| Argument                          | Example                                                      | Description                                                  |\n| --------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |\n| The path to the Unity executable. | `\u0026\"C:/Program Files/Unity/Hub/Editor/2020.3.24f1/Editor/Unity.exe\"` | This example is for Windows Powershell. For OS X or Linux, replace `\u0026` with `./` |\n| `-projectPath`                    | `\"C:/Users/USER/asset_bundle_creator\"`                       | The path to the `asset_bundle_creator` Unity Project. Replace `USER` with your user name. |\n| `-quit`                           |                                                              | This tells Unity Editor to quit after the call.              |\n| `-batchmode`                      |                                                              | This tells Unity Editor to run in the background.            |\n| `-executeMethod`                  | `ModelCreator.SourceFileToPrefab`                            | The name of the creator launcher and the method you want to invoke. *Note that there are no double quotes around this value.* |\n\nAll other arguments in this call such as `-name=\"model\"` are specific to the method (in this case, `ModelCreator.SourceFileToPrefab`).\n\nThis example calls `Cleanup` which will remove all intermediary source file and prefabs from the Unity Project:\n\n```powershell\n\u0026\"C:/Program Files/Unity/Hub/Editor/2020.3.24f1/Editor/Unity.exe\" -projectpath \"C:/Users/USER/asset_bundle_creator\" -quit -batchmode -executeMethod ModelCreator.Cleanup -cleanup\n```\n\n## API Documentation\n\n| Type of creator                                           | Source file types                                            | Description                                                  |\n| --------------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |\n| [ModelCreator](doc/model_creator.md)                      | .fbx or .obj                                                 | Generates *non-articulated* Unity GameObjects; these GameObjects will have exactly one Rigidbody (at the root object). There may be many visual meshes and mesh colliders. |\n| [RobotCreator](doc/robot_creator.md)                      | [.urdf](http://wiki.ros.org/urdf)                            | Generates *articulated* Unity robots. Each joint has an ArticulationBody component (*not* a Rigidbody), visual meshes, and mesh colliders. |\n| [CompositeObjectCreator](doc/composite_object_creator.md) | [.urdf](http://wiki.ros.org/urdf)                            | Generates *articulated* Unity GameObjects. Each joint has an Rigidbody component, a Joint component (e.g. a HingeJoint),  visual meshes, and mesh colliders. |\n| [AnimationCreator](doc/animation_creator.md)              | .anim or .fbx                                                | Generates asset bundles of .anim files.                      |\n| [HumanoidCreator](doc/humanoid_creator.md)                | .fbx                                                         | Generates asset bundles of .fbx files.                       |\n| [LisdfReader](doc/lisdf_reader.md)                        | [.sdf](http://sdformat.org/spec?ver=1.9\u0026elem=sdf) or [.lisdf](https://learning-and-intelligent-systems.github.io/kitchen-worlds/tut-lisdf/) | Generates multiple GameObject asset bundles using a combination of RobotCreator and CompositeObjectCreator. |\n\n## Usage with ThreeDWorld (TDW)\n\nThis software was originally made for [TDW](https://github.com/threedworld-mit/tdw) and offers some TDW-specific functionality, notably record metadata. TDW includes helpful Python wrapper classes for every command-line call in Asset Bundle Creator:\n\n| Asset Bundle Creator Class                                | TDW Python class                                             |\n| --------------------------------------------------------- | ------------------------------------------------------------ |\n| [ModelCreator](doc/model_creator.md)                      | [ModelCreator](https://github.com/threedworld-mit/tdw/blob/master/Documentation/lessons/custom_models/custom_models.md) |\n| [RobotCreator](doc/robot_creator.md)                      | [RobotCreator](https://github.com/threedworld-mit/tdw/blob/master/Documentation/lessons/robots/custom_robots.md) |\n| [CompositeObjectCreator](doc/composite_object_creator.md) | [CompositeObjectCreator](https://github.com/threedworld-mit/tdw/blob/master/Documentation/lessons/composite_objects/create_from_urdf.md) |\n| [HumanoidCreator](doc/humanoid_creator.md)                | [HumanoidCreator](https://github.com/threedworld-mit/tdw/blob/master/Documentation/lessons/non_physics_humanoids/custom_humanoids.md) |\n| [AnimationCreator](doc/animation_creator.md)              | [HumanoidAnimationCreator](https://github.com/threedworld-mit/tdw/blob/master/Documentation/lessons/non_physics_humanoids/custom_animations.md) |\n| [LisdfReader](doc/lisdf_reader.md)                        | [LisdfReader](https://github.com/threedworld-mit/tdw/blob/master/Documentation/lessons/read_write/lisdf.md) |\n\n## Misc. Documentation\n\n- [Changelog](doc/changelog.md)\n- [Hull Mesh Colliders](doc/hull_mesh_colliders.md)\n- [RobotCreator vs. CompositeObjectCreator](doc/robot_creator_vs_composite_object_creator.md)\n- [How to install Unity Editor on a Linux server](doc/linux_server.md)\n- [Troubleshooting](doc/troubleshooting.md)\n\n## Roadmap\n\n- Add a Unity Editor user interface\n- Add a MaterialCreator\n- Add support for ROS\n- Update Unity to the latest 2020.3 release","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falters-mit%2Fasset_bundle_creator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falters-mit%2Fasset_bundle_creator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falters-mit%2Fasset_bundle_creator/lists"}