{"id":17721217,"url":"https://github.com/nicopap/bevy_mod_fbx","last_synced_at":"2025-04-30T22:11:00.402Z","repository":{"id":43720517,"uuid":"497136468","full_name":"nicopap/bevy_mod_fbx","owner":"nicopap","description":"Autodesk Filmbox (*.fbx) loader for Bevy Engine","archived":false,"fork":false,"pushed_at":"2023-05-19T15:42:22.000Z","size":120,"stargazers_count":20,"open_issues_count":7,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-13T03:11:13.845Z","etag":null,"topics":["bevy","bevy-plugin","fbx","loader"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nicopap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE-APACHE","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},"funding":{"github":["nicopap","HeavyRain266"]}},"created_at":"2022-05-27T20:57:43.000Z","updated_at":"2024-10-12T06:21:11.000Z","dependencies_parsed_at":"2024-03-10T09:39:19.813Z","dependency_job_id":"462fb6ca-f528-42fc-b5b9-2b04355ac22f","html_url":"https://github.com/nicopap/bevy_mod_fbx","commit_stats":{"total_commits":57,"total_committers":4,"mean_commits":14.25,"dds":0.368421052631579,"last_synced_commit":"22666481afa537803a35b769e4289204fd5046c1"},"previous_names":["heavyrain266/bevy_mod_fbx"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicopap%2Fbevy_mod_fbx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicopap%2Fbevy_mod_fbx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicopap%2Fbevy_mod_fbx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicopap%2Fbevy_mod_fbx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicopap","download_url":"https://codeload.github.com/nicopap/bevy_mod_fbx/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245955257,"owners_count":20699891,"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":["bevy","bevy-plugin","fbx","loader"],"created_at":"2024-10-25T15:32:25.900Z","updated_at":"2025-03-31T17:31:01.702Z","avatar_url":"https://github.com/nicopap.png","language":"Rust","funding_links":["https://github.com/sponsors/nicopap","https://github.com/sponsors/HeavyRain266"],"categories":[],"sub_categories":[],"readme":"# bevy_mod_fbx\r\n\r\nAutodesk Filmbox (*.fbx) loader for Bevy Engine.\r\n\r\n**Special Credit**: Thanks to the original author HeavyRain266 for starting the project.\r\n`bevy_mod_fbx` is now maintained by someone else.\r\n\r\n### Features\r\n\r\n- Load meshes, textures \u0026 material properties\r\n- Supported material properties:\r\n  - normal maps\r\n  - occlusion maps\r\n  - diffuse texture\r\n- Maya PBR material support\r\n- Scene tree transform hierarchy support\r\n\r\n#### Planned features\r\n\r\n- Skeleton rig imports\r\n- `bevy_animation` support\r\n- Optional lambert material shader support\r\n- Optional phong shading model support\r\n- Extended compatibility:\r\n  - `IndexToDirect`\r\n  - Handle file-based axis properties\r\n  - Handle backed cameras \u0026 lights\r\n  - N-gon triangulation\r\n\r\n### Limitations\r\n\r\n- FBX v7.4 \u0026 7.5 are the only supported versions\r\n- FBX doesn't support multiple scenes in single file, use multiple files instead\r\n- There are no plans for loading ASCII format, export FBX as binary v7.4/7.5\r\n- There is no support for complex shapes at the moment, see [#11]\r\n\r\n### Cargo features\r\n\r\n#### `profile`\r\n\r\nEnables spans, in combination with bevy's `bevy/trace` feature,\r\nyou can generate profiling reports you can open with any trace reading software.\r\nUseful for debugging why your assets are so slow to load.\r\n\r\n#### `maya_3dsmax_pbr`\r\n\r\nEnable handling of Maya's PBR material extension for FBX (presumebly also 3DS max).\r\nThis is highly experimental and only tested with a single model!\r\nPlease report if your model's materials do not load properly.\r\n\r\nThis material loader do not work with every type of texture files,\r\nthe textures must be readable from CPU and have each component (color channel)\r\nbe exactly 8 bits (such as PNG).\r\n\r\n### Examples\r\n\r\n- `cube`: Load simple cube with point light\r\n- `scene_viewer`: Load any FBX files from `/path/to/file.fbx`, defaults to `assets/cube.fbx`\r\n\r\nRun example:\r\n\r\n```sh\r\n# Regular dev build\r\ncargo run --example \u003cexample_name\u003e\r\n\r\n# Faster asset loading\r\ncargu run --example \u003cexample_name\u003e --release --features bevy/dynamic\r\n```\r\n\r\n### Version matrix\r\n\r\n| bevy | bevy_mod_fbx |\r\n|------|--------------|\r\n| 0.10 | 0.4          |\r\n| 0.9  | 0.3          |\r\n| 0.8  | 0.1.0-dev    |\r\n\r\n## Contributing\r\n\r\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed informations.\r\n\r\n## License\r\n\r\nOriginal loader and triangulation code (`loader.rs` and `triangulate.rs`) from [fbx_viewer] by YOSHIOKA Takuma.\r\nOriginal scene viewer code (`scene_viewer.rs`) from [scene_viewer] by Bevy contributors.\r\nAll additions and modifications authored by `bevy_mod_fbx` contributors (see git log).\r\n\r\nCode copyrights go to their respective authors.\r\n\r\nAll code in `bevy_mod_fbx` is licensed under either:\r\n\r\n- Apache License 2.0\r\n- MIT License\r\n\r\nat your option.\r\n\r\n[#11]: https://github.com/HeavyRain266/bevy_mod_fbx/issues/11\r\n\r\n[fbx_viewer]: https://github.com/lo48576/fbx-viewer/\r\n[bevy_scene_viewer]: https://github.com/bevyengine/bevy/blob/115211161b783a2f5c39346caeb8ee6b3b202bef/examples/tools/scene_viewer.rs\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicopap%2Fbevy_mod_fbx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicopap%2Fbevy_mod_fbx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicopap%2Fbevy_mod_fbx/lists"}