{"id":23864465,"url":"https://github.com/scanmountgoat/ldr_tools_blender","last_synced_at":"2026-04-11T14:13:22.811Z","repository":{"id":156442242,"uuid":"612333059","full_name":"ScanMountGoat/ldr_tools_blender","owner":"ScanMountGoat","description":"LDraw Blender importer addon","archived":false,"fork":false,"pushed_at":"2024-11-08T18:10:02.000Z","size":193,"stargazers_count":17,"open_issues_count":10,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-08T19:23:25.998Z","etag":null,"topics":["blender-addon","ldraw","lego"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/ScanMountGoat.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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":"2023-03-10T17:54:17.000Z","updated_at":"2024-11-08T18:10:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"5a04e45b-44ec-40f7-8c3a-7a16724cd8d7","html_url":"https://github.com/ScanMountGoat/ldr_tools_blender","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScanMountGoat%2Fldr_tools_blender","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScanMountGoat%2Fldr_tools_blender/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScanMountGoat%2Fldr_tools_blender/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScanMountGoat%2Fldr_tools_blender/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ScanMountGoat","download_url":"https://codeload.github.com/ScanMountGoat/ldr_tools_blender/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232310594,"owners_count":18503479,"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-addon","ldraw","lego"],"created_at":"2025-01-03T08:26:17.898Z","updated_at":"2026-01-05T17:16:35.420Z","avatar_url":"https://github.com/ScanMountGoat.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ldr_tools_blender [![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/ScanMountGoat/ldr_tools_blender?include_prereleases)](https://github.com/ScanMountGoat/ldr_tools_blender/releases/latest)\n\n![falcon render](https://github.com/ScanMountGoat/ldr_tools_blender/assets/23301691/6cfd557b-243d-491e-bd05-a7ae93db7eca)\n\n\u003e Cycles render of [10179-1 Millennium Falcon UCS (LDraw OMR)](https://omr.ldraw.org/files/347)\n\nAn addon for importing LDraw and Studio files into Blender 4.1 or later. Check out [discussions](https://github.com/ScanMountGoat/ldr_tools_blender/discussions) for reading announcements, asking questions, or discussing new features. Report bugs or request new features in [issues](https://github.com/ScanMountGoat/ldr_tools_blender/issues). Download the latest version from [releases](https://github.com/ScanMountGoat/ldr_tools_blender/releases).\n\n## Features\nThe goal of this project is to provided a reliable and performant way to import digital LEGO models into modern versions of Blender for rendering. This includes importing and rendering [Bricklink Studio](https://www.bricklink.com/v3/studio/download.page) models or models built with [LDraw editing programs](https://www.ldraw.org/downloads-2/third-party-software.html). \n\n* Compatible with LDR and MPD files. If you have a file that doesn't open correctly or an LDraw extension you'd like supported, please report it in [issues](https://github.com/ScanMountGoat/ldr_tools_blender/issues).\n* Compatible with newer versions of Bricklink Studio .io files.\n* Easily load LEGO models with hundreds of thousands of parts. For extremely large scenes, see [performance](#performance).\n* Create photorealistic renders taking full advantage of Blender Cycles with generated materials with accurate colors and procedurally generated surface detail. \n\n## Bricklink Studio Compatibility\nBricklink Studio models from newer versions of the program can be imported directly from .io files. Older Studio models that fail to import as .io files should be resaved with a newer version of Studio. This avoids an issue with password protection on older .io files. Studio can also export files as LDraw under File \u003e Export As before importing into Blender. \n\n## Getting Started\n1. Install the [LDraw parts library](https://www.ldraw.org/help/getting-started.html) if you haven't already. Bricklink Studio bundles its own LDraw library and should be detected automatically by the addon.\n2. Download the appropriate version of the addon for your system from [releases](https://github.com/ScanMountGoat/ldr_tools_blender/releases). For older Blender versions, download one of the previous releases.\n3. In Blender, navigate to Edit \u003e Preferences \u003e Addon and click Install. Select the zip downloaded in step 2. Do not extract the zip file!\n4. The addons menu should now allow you to check the ldr_tools_blender addon to enable it.\n5. Import an LDraw model into Blender by clicking File \u003e Import \u003e LDraw and selecting a .mpd, .ldr, or .io file.\n\n## Uninstalling/Upgrading\nUpgrading the addon requires uninstalling the addon, downloading the latest version from releases, and then reinstalling the addon. Windows users will need to disable the addon, restart Blender, and then uninstall the addon to properly remove the previous version.\n\n## Performance\nThis project is built from the ground up with performance in mind. The ldr_tools_blender addon can easily handle very large models with hundreds of thousands of parts. The addon will always instance geometry by part name and color to reduce memory usage and improve import times. Memory usage will be similar for both methods.  \n\nBlender itself does not scale well with the number of objects created in the scene. For large scenes with more than 10000 parts, it's recommended to use \"Geometry Nodes\" as the instance type before importing. Geometry nodes make the individual objects harder to edit but avoids most of the Blender overhead for scenes with high object counts. \n\nFor scenes that don't need to be rendered up close, setting the resolution to \"Normal\" and stud type to \"Normal\" to remove stud logos can greatly reduce the number of vertices.\n\n## Projects\n### ldr_tools\nA Rust library for working with LDraw files. This performs all the parsing and geometry handling. This project can be used in \nother Rust projects by adding the following line to the `Cargo.toml`. ldr_tools is used for loading models in the [ldr_wgpu](https://github.com/ScanMountGoat/ldr_wgpu) renderer.  \n\n`ldr_tools = { git = \"https://github.com/ScanMountGoat/ldr_tools_blender\" }` \n\n### ldr_tools_py\nPython bindings to ldr_tools using PyO3. This enables ldr_tools to be usable in Blender. ldr_tools_py makes heavy use of numpy arrays \nto reduce the overhead for converting data from Rust to Python to Blender.\n\n### ldr_tools_blender\nThe Blender addon for importing LDraw files making use of ldr_tools_py. This is not a pure Python project. See the building instructions for details on how to build this from source.\n\n## Building\nThe easiest way to see the steps used to create a new release is to check the [release.yaml](https://github.com/ScanMountGoat/ldr_tools_blender/blob/main/.github/workflows/release.yml) script that runs using Github actions. See [development](https://github.com/ScanMountGoat/ldr_tools_blender/blob/main/DEVELOPMENT.md) for working on your personal machine.  See [contributing](https://github.com/ScanMountGoat/ldr_tools_blender/blob/main/CONTRIBUTING.md) for contributing to this project.\n## Copyrights\nLDraw™ is a trademark owned and licensed by the Jessiman Estate, which does not sponsor, endorse, or authorize this project.  \n\nLEGO® is a registered trademark of the LEGO Group, which does not sponsor, endorse, or authorize this project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscanmountgoat%2Fldr_tools_blender","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscanmountgoat%2Fldr_tools_blender","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscanmountgoat%2Fldr_tools_blender/lists"}