{"id":13733452,"url":"https://github.com/silverslade/aframe_blender_exporter","last_synced_at":"2025-05-08T09:32:11.659Z","repository":{"id":43586700,"uuid":"278875421","full_name":"silverslade/aframe_blender_exporter","owner":"silverslade","description":"Blender Exporter for A-Frame VR","archived":false,"fork":false,"pushed_at":"2023-05-07T09:06:54.000Z","size":9095,"stargazers_count":104,"open_issues_count":7,"forks_count":17,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-11-15T01:34:03.522Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/silverslade.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"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":"2020-07-11T14:15:29.000Z","updated_at":"2024-10-10T11:47:20.000Z","dependencies_parsed_at":"2024-08-03T03:12:38.518Z","dependency_job_id":null,"html_url":"https://github.com/silverslade/aframe_blender_exporter","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silverslade%2Faframe_blender_exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silverslade%2Faframe_blender_exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silverslade%2Faframe_blender_exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silverslade%2Faframe_blender_exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/silverslade","download_url":"https://codeload.github.com/silverslade/aframe_blender_exporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253036610,"owners_count":21844247,"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":[],"created_at":"2024-08-03T03:00:43.382Z","updated_at":"2025-05-08T09:32:07.473Z","avatar_url":"https://github.com/silverslade.png","language":"Python","funding_links":[],"categories":["Web-Based Frameworks","🔮Add-ons [^](#table)","Game Development"],"sub_categories":["Motion Controllers inside Unity!","🪀Misc [^](#table)","XR, AR \u0026 VR: Resources"],"readme":"# Blender Exporter to A-Frame VR\n\nThis Blender add-on allows you to model your scene in Blender and export it to an A-Frame VR project with a single click. \nThe generated sources can be modified manually according to your project needs and can use a baking process to use baked Lightmaps.\n\nThis is an open source project under MIT terms, so feel free to email me or ask for a pull request, or just offer me a coffe!\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/silverslade/aframe_blender_exporter/raw/master/images/aframe_exporter_0_0_9.png\"\u003e\n\u003c/p\u003e\n\n## Features\n\n+ Pure Blender Add-On (tested on Blender 3.5.1)\n+ Simple UI for configuration\n+ It exports and creates a new A-Frame project\n+ Optimized Pipeline: Model with blender -\u003e export -\u003e test on browser\n+ Use of a A-Frame html template saved inside the blend file (to make a higher customisation)\n+ Open Source (MIT)\n\n\n## Changelog \u0026 todo\n\nSee [here](https://github.com/silverslade/aframe_blender_exporter/blob/master/CHANGELOG.md) for the updated changelog.\n\n## Main Configuration\nThis Addon manages the following settings (all of them switchable inside the UI):\n\n+ Stats window\n+ Joystick controller on screen\n+ HTC and Quest controllers\n+ Cube Map Env (for objects with reflections)\n+ Cast Shadows\n+ Raycast Management\n+ Player's speed and height Management\n+ Project name and final export directory\n+ Use of the Lightmapper add-on to add lightmaps to the exported models\n+ Use an embedded HTTP Server for quick preview\n\n## Contents\n\n+ [Installation](#installation)\n+ [How to use the Addon](#How-to-use-the-Addon)\n+ [Credits](#Credits)\n+ [Help](#Help)\n+ [License](#License)\n\n## Installation\n\n+ Download the latest release version from [Itch.io](https://silverslade.itch.io/a-frame-blender-exporter)\n+ Open Blender (3.5.1)\n+ Edit -\u003e Preferences -\u003e Add-ons -\u003e Install\n+ Browse and choose the addon zip file\n+ Enable the addon\n+ Note: This addon requires the glTF Exporter 2.0\n\n## How to use this A-Frame Blender Exporter\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/silverslade/aframe_blender_exporter/raw/master/images/main-window.png\"\u003e\n\u003c/p\u003e\n\n\n+ Open a new/existing blender scene.\n+ Open the View3D window (`n` key) to show the export window.\n+ Set up best settings for your scene\n+ Click on `Export to A-Frame project` -\u003e a-frame web project will be generated\n+ Customize the 'index.html'-template in the Script-tab for future exports\n+ Use `Custom Properties` of blender-objects to control tags/attributes ([example](https://gist.github.com/coderofsalvation/2468dc3dfbaca0520cd65c20dfad7eb8))\n\n\n## How to view the 3D scene\n\n### How to execute the A-Frame 3D scene from Blender\n+ click on `Start Serving` -\u003e a simple http server in python will start \n+ click on `Open Preview` -\u003e to launch your local server web with the 3D scene\n+ click on `Stop Serving` -\u003e to stop the http server\n+ Note: Don't close Blender until you stop the http server. Always click on \"Stop Serving\" before close Blender\n\n\n### How to execute the A-Frame 3D scene standalone\nSeveral possibilities for running a local web server to test or delivery your WebVR page: \n\n+ with Nodejs: run `live-server` under npm (install it with `npm install -g live-server`)\n+ with Python: run `python -m SimpleHTTPServer` \n+ with a Python script: run `python start_web_server.py` inside the output directory\n+ Note: For massive exports, 'live-server' could be more useful because it can manage a content auto-refresh.\n\nFor further instructions, see the official [project page](https://silverslade.itch.io/a-frame-blender-exporter).\n\n### Main UI configuration\n\nMain Ui for the current version 0.0.10.\nFor a better usability, the add-on is divided into 6 main panels: \n+ A-frame\n+ Renderer\n+ Player\n+ Interactive/action\n+ Exporter\n\n\n#### A-Frame Panel\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/silverslade/aframe_blender_exporter/raw/master/images/aframe_panel_0_0_7.png\"\u003e\n\u003c/p\u003e\n\n| Property       | Description      | Default Value                          |\n|----------------|------------------|----------------------------------|\n| A-Frame | A-Frame Version  | `1.2.0` | \n| Show Stats | Show the A-Frame stats window. For debug purpose.  | `False`| \n| Show Joystick | Show a icon controller to move player  | `False` | \n| Enable VR Controllers (HTC, Quest) | Enable Controllers for further inteactions  | `False` | \n| Cube Env Map | For skybox reflections (but not objects reflections). To get objects reflections also, enable the `Camera Cube Env` | `False` | \n| Camera Cube Env | with objects reflections | `False` | \n| Show Enviroment Sky | Activate a default skybox | `False` | \n| Enable Background | Camera cube env with background sky | `False` | \n| Path | directory path for the equirectangular sky  | `/env/` | \n| Ext | with objects reflections | `jpg` | \n| Cast Shadows | For dynamic lights and shadows.| `False` | \n\n#### Renderer Panel\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/silverslade/aframe_blender_exporter/raw/master/images/renderer_panel_0_0_7.png\"\u003e\n\u003c/p\u003e\n\n| Property       | Description      | Default Value                          |\n|----------------|------------------|----------------------------------|\n| Antialiasing | A-Frame's Scene Setting | `True` | \n| Color Management | A-Frame's Scene Setting | `True` | \n| Physically Correct Lights | A-Frame's Scene Setting  | `True` | \n\n#### Player Panel\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/silverslade/aframe_blender_exporter/raw/master/images/player_panel_0_0_7.png\"\u003e\n\u003c/p\u003e\n\n| Property       | Description      | Default Value                          |\n|----------------|------------------|----------------------------------|\n| Enable Raycast | Activate a raycast for interactions. You can set length and interval values | `False` | \n| Raycast Length | Set the Length of the raycast. Shorter or turned off is for better performance | `4.0` | \n| Raycast Interval | Set the polling interval in msec. Higher is for better performance  | `2000.0` | \n| Player Height | Set the Height of the main camera | `1.70` | \n| Player Speed | Set the Speed of the player | `0.1` | \n\n#### Interactive/Action Panel\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/silverslade/aframe_blender_exporter/raw/master/images/interactive_panel_0_0_7.png\"\u003e\n\u003c/p\u003e\n\n| Property       | Description      | Default Value                          |\n|----------------|------------------|----------------------------------|\n| Add Cubemap | Enable the reflections for the selected object  |  | \n| Add Rotation on Z | Enable rotation animation on Z axis for the selected object  |  | \n| Add Toggle Images | set 2 images toggling with click on the selected object (plane mesh)  |  | \n| Add Link Web | Enable html link when clicking on the selected object  |  | \n| Add Video | set a mp4 video for the selected object  (plane mesh) |  | \n\n#### Exporter Panel\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/silverslade/aframe_blender_exporter/raw/master/images/export_panel_0_0_7.png\"\u003e\n\u003c/p\u003e\n\n| Property       | Description      | Default Value                          |\n|----------------|------------------|----------------------------------|\n| Name | Project name. It's the target directory where your project will be created. | `aframe-prj`       | \n| Export To | Target Directory where the `Name` Directory will be created | `C:/temp/` | \n| Clear Assets Directory | To remove old 3d models from the main assets dir |  | \n\n\n# Credits\n\n## Contributors\n+ Gltf Exporter \u0026 Collaboration - [@AndreaRotondo](http://virtual-art.it)\n+ Code Refactoring - [@fsoft72](https://github.com/fsoft72)\n+ HTTP Embedded Server - [@msfeldstein](https://github.com/msfeldstein)\n+ embedded index.html template - [@coderofsalvation](https://github.com/coderofsalvation)\n+ PNG fix code - [@jure](https://github.com/jure)\n\n## Third Party Components\nThis Addon Uses the following 3rd Party Software (or their integration/modification):\n+ Aframe Joystick - https://github.com/mrturck/aframe-joystick\n+ Aframe Components - https://github.com/colinfizgig/aframe_Components\n+ Icons - https://ionicons.com/\n\n\n# Help\n\nIf you like the project and want to help, these are the main activities:\n\n+ Writing documentation (wiki)\n+ Writing Official Manual or (video/text) tutorial\n+ Tests on different O.S. (i.e. MacOSX, Linux)\n+ Python script programming\n+ Add new features\n\nIn this case, drop me a line.\n\n# License\nThe MIT License (MIT)\n\nCopyright (c) 2023 Alessandro Schillaci\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsilverslade%2Faframe_blender_exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsilverslade%2Faframe_blender_exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsilverslade%2Faframe_blender_exporter/lists"}