Skip to content

Local asset bundles#142

Open
nearnshaw wants to merge 3 commits into
mainfrom
local-asset-bundles
Open

Local asset bundles#142
nearnshaw wants to merge 3 commits into
mainfrom
local-asset-bundles

Conversation

@nearnshaw

Copy link
Copy Markdown
Member

Documents the new option to convert a scene's assets to asset bundles locally during preview (Creator Hub Optimize Assets checkbox / sdk-commands start --asset-bundles). This runs the same conversion the servers already perform after publishing, so the preview runs smoother and compression issues surface before deploying. It has no effect on the published result.

Related PRs: creator-hub#1396, js-sdk-toolchain#1498

Changes

  • creator/sdk7/getting-started/preview-scene.md — main documentation:
    • New "Preview with optimized assets" section: what the conversion does, why to use it (smoother preview, catch compression issues early), that publishing is unaffected, how to enable it from the Creator Hub and the CLI, the .dcl-optimized-assets cache folder (only new or modified assets reconvert; excluded from deployments), and the fallback to raw models if conversion fails.
    • Added the Optimize Assets checkbox to the Creator Hub preview options list and the --asset-bundles flag to the CLI parameters list.
    • Added a tip at the top of "Advanced: Fast iteration with remote asset bundles" pointing to the new local option as the simpler alternative.
  • creator/scene-editor/get-started/about-editor.md — added the Optimize Assets checkbox to the Scene Editor's preview options list.
  • creator/sdk7/optimizing/performance-optimization.md — noted in "Asset Bundle conversion" that the same conversion can now run locally during preview.
  • creator/sdk7/debugging/troubleshooting.md — under "my 3D models look different once deployed", noted that the conversion can be reproduced locally to debug without deploying.
  • creator/sdk7/getting-started/dev-workflow.md — added a bullet about the option in "Run a local preview".
  • creator/sdk7/getting-started/using-the-cli.md — added the --asset-bundles flag with a snippet in "Run a preview".

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant