Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Hubs-Foundation/hubs-blender-exporter
The Hubs Blender Add-on enables artists to export their creations to the immersive web with Hubs
https://github.com/Hubs-Foundation/hubs-blender-exporter
blender blender-addon immersive-web
Last synced: about 1 month ago
JSON representation
The Hubs Blender Add-on enables artists to export their creations to the immersive web with Hubs
- Host: GitHub
- URL: https://github.com/Hubs-Foundation/hubs-blender-exporter
- Owner: Hubs-Foundation
- License: mpl-2.0
- Created: 2019-09-07T02:00:09.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-19T08:06:45.000Z (about 2 months ago)
- Last Synced: 2024-10-20T09:41:23.940Z (about 2 months ago)
- Topics: blender, blender-addon, immersive-web
- Language: Python
- Homepage:
- Size: 18.5 MB
- Stars: 165
- Watchers: 22
- Forks: 51
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-metaverse - Hubs Blender Exporter
README
# Hubs Blender Exporter and Importer
This addon extends the glTF 2.0 exporter to support the `MOZ_hubs_components` and `MOZ_lightmap` extensions allowing you to add behavior to glTF assets for Hubs.
[](https://github.com/Hubs-Foundation/hubs-blender-exporter/actions/workflows/test.yml)
[](https://github.com/Hubs-Foundation/hubs-blender-exporter/actions/workflows/publish.yml)
# To Install
Find the latest [release](https://github.com/Hubs-Foundation/hubs-blender-exporter/releases) and download the add-on zip file.
In Blender: `Edit > Preferences > Add-ons`
Click install and select the zip file of the latest release.
Ensure the Hubs add-on is checked and enabled.
# Adding Components
To add components, go to the "Hubs" section of the properties panel for the thing you want to add a component to. Currently adding components is supported on Scenes, Objects, Bones, and Materials.
Click "Add Component" and select the component you wish to add from the list. Only components appropriate for the object type you are currently editing and have not already been added will be shown.
# Using Lightmaps
To use a lightmap, create a `MOZ_lightmap` node from the `Add > Hubs` menu and hook up a image texture to the `Lightmap` input. Use a `UV Map` node to control what UV set should be used for the lightmap, as you would any other texture in Blender.
Note that for use in Hubs, you currently **MUST** use the second UV set, as ThreeJS is currently hardcoded to use that for lightmaps. This will likely be fixed in the future so the add-on does not enforce this.
# Exporting
This addon works in conjunction with the official glTF add-on, so exporting is done through it. Select "File > Export > glTF 2.0" and then ensure "Hubs Components" is enabled under "Extensions".
# Import into Hubs
The easiest way to use your scene file is through the Spoke project creation page and selecting _Import From Blender_:
This will bring up the Publish Scene From Blender dialog where you can upload your GLB file and a thumbnail picture for your scene:
It is also possible to use the GLB file to replace the scene for an existing Hubs room directly by going to Room Settings > Change Scene > Custom Scene and entering the URL of the GLB file. This assumes the file has been already uploaded to an online storage provider.
# Scene debugger
The Hubs Blender add-on includes a scene debugger, enabling you to see the Blender scene updates in Hubs with just one click. For additional information, please visit: https://github.com/Hubs-Foundation/hubs-blender-exporter/wiki/Hubs-scene-debugger/
# Development
## Code Completion
To enable code completion for the Blender Python API you can install the [Fake Blender Python API module collection](https://github.com/nutti/fake-bpy-module/). You can download the modules using the `setup.sh` script from the repository root or using [pip](https://github.com/nutti/fake-bpy-module/#install-via-pip-package).
## Code style
Tis repository follows the [PEP8](https://peps.python.org/pep-0008/) style convention for python files. If you use VSCode this repository already includes a setting to autoformat every python file when saved. If you don't use VSCode you can probably add a similar setting in your favorite editor. We are happy to add settings for other editors so feel free to open a PR if you want you editor's settings included.
We also includes a `format.py` python script that will formats the whole codebase when run. You can run it before pushing the PR to make sure that all the new code follows PEP8.
Both the python script and the VSCode settings rely on the [autopep8](https://pypi.org/project/autopep8/) command line tool for formatting so make sure that it's installed in your system.
## Addon development
It might be useful while developing to be able to load the addon directly from the checkout folder without needing to install it. You can do it in two ways:
- ### Overriding the Blender user scripts directory
You can override the Blender user scripts directory from the console to point to the addon repo directory.
**MacOS**
`BLENDER_USER_SCRIPTS=full_path_to_/hubs-blender-exporter /Applications/Blender.app/Contents/MacOS/Blender`
**Linux**
`BLENDER_USER_SCRIPTS=full_path_to_/hubs-blender-exporter blender`
- ### Symlinking your addon to the Blender user scripts directory
You can create a symbolic link pointing to `full_path_to_/hubs-blender-exporter/addons/io_hubs_addon` in your current Python scripts directory in Blender. This way you will also load any other addons that you have in that directory.
**MacOS and Linux**
`ln -s full_path_to/hubs-blender-exporter/addons/io_hubs_addon full_path_to/blender_user_scrips_dir`
You can set or see the current Blender user scripts in the Preferences -> File Paths -> Scripts
# Debugging
You can debug the addon code with PyCharm or VSCode:
- [Debug with PyCharm](https://code.blender.org/2015/10/debugging-python-code-with-pycharm) **NOTE:** If you are using Blender 2.80+, you need the [updated debugger script](https://github.com/ux3d/random-blender-addons/blob/master/remote_debugger.py)
- [Debug with VSCode](DEBUGGING.md)
# Continuous Integration Tests
To run the tests locally, your system should have a blender executable in the path that launches the desired version of Blender.
The latest version of [Yarn](https://yarnpkg.com/en/) should also be installed.
Then, in the tests folder of this repository, run yarn install, followed by yarn run test.