Skip to content

feat: --asset-bundles forwards local-ab=true into the Explorer deep link - #1539

Merged
dalkia merged 1 commit into
mainfrom
feat/local-ab-deeplink
Aug 12, 2026
Merged

feat: --asset-bundles forwards local-ab=true into the Explorer deep link#1539
dalkia merged 1 commit into
mainfrom
feat/local-ab-deeplink

Conversation

@dalkia

@dalkia dalkia commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

What

sdk-commands start --asset-bundles now just adds local-ab=true to the Desktop Explorer deep link. Nothing else: no sidecar process, no binary download, no proxy endpoints.

Why

The Desktop Explorer now owns asset-bundle conversion for local scene development (decentraland/unity-explorer#9704): when it receives local-ab, it spawns and supervises its own abgen JIT converter pointed at the preview's content server (which the realm already in the deep link carries). Conversion progress, caching, and failure reporting all live in the client's scene dev console.

That makes the sdk-commands side of #1498 unnecessary — this PR is the minimal replacement: declare the flag, forward it.

Creator Hub compatibility (no Hub changes needed)

The merged decentraland/creator-hub#1396 flow works unchanged against this:

  • The Hub feature-detects support by grepping the installed sdk-commands dist/commands/start/index.js for the quoted literal --asset-bundles — declaring the flag in args satisfies that.
  • With the Optimize Assets checkbox on, the Hub spawns sdk-commands start --explorer-alpha --hub --asset-bundles ... — accepted here.
  • The Hub keys its sidecar-aware behavior (restart-on-toggle-mismatch, option flips on a running preview, stripping local-ab when the toggle goes off) on local-ab being present in the captured deep link — emitted here.
  • The Hub's "Optimizing…" button state clears as soon as the deep link is captured; since there is no sidecar to wait for, the client opens immediately and conversion progress is shown inside the Explorer instead.

Test plan

  • explorer-alpha.spec.ts: --asset-bundles → deep link contains local-ab=true; flag absent → no local-ab param.
  • Manual: Creator Hub with Optimize Assets checked launches the Explorer with local-ab=true in the deep link and the Explorer's AB console shows the conversion; unchecked launches carry no local-ab.

🤖 Generated with Claude Code

The Desktop Explorer now owns asset-bundle conversion for local scene
development (decentraland/unity-explorer#9704): with local-ab it spawns
its own JIT converter against the preview's content server. sdk-commands
therefore only needs to declare the flag and pass it through the deep
link — no sidecar, no binary management, no extra endpoints.

The flag name matches what the Creator Hub already spawns
(decentraland/creator-hub#1396 feature-detects the quoted literal
--asset-bundles in the installed sdk-commands and keys sidecar-aware
behavior on local-ab being present in the captured deeplink), so this
slots into the released Hub flow unchanged.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying js-sdk-toolchain with  Cloudflare Pages  Cloudflare Pages

Latest commit: 4ef4ada
Status: ✅  Deploy successful!
Preview URL: https://46383e82.js-sdk-toolchain.pages.dev
Branch Preview URL: https://feat-local-ab-deeplink.js-sdk-toolchain.pages.dev

View logs

@github-actions

Copy link
Copy Markdown
Contributor

Test this pull request

  • The @dcl/sdk package can be tested in scenes by running

    npm install "https://sdk-team-cdn.decentraland.org/@dcl/js-sdk-toolchain/branch/feat/local-ab-deeplink/dcl-sdk-7.25.1-31632543313.commit-f74944a.tgz"
  • The @dcl/js-runtime package can be tested in scenes by running

    npm install "https://sdk-team-cdn.decentraland.org/@dcl/js-sdk-toolchain/branch/feat/local-ab-deeplink/@dcl/js-runtime/dcl-js-runtime-7.25.1-31632543313.commit-f74944a.tgz"
  • To test with npx init

    export SDK_COMMANDS="https://sdk-team-cdn.decentraland.org/@dcl/js-sdk-toolchain/branch/feat/local-ab-deeplink/dcl-sdk-commands-7.25.1-31632543313.commit-f74944a.tgz"
    npx $SDK_COMMANDS init
  • The /changerealm command to test test in-world

    /changerealm https://sdk-team-cdn.decentraland.org/ipfs/feat/local-ab-deeplink-e2e
    
  • You can preview this build entering:
    https://playground.decentraland.org/?sdk-branch=feat/local-ab-deeplink

@dalkia dalkia self-assigned this Aug 12, 2026
@dalkia
dalkia merged commit cff2a72 into main Aug 12, 2026
14 of 15 checks passed
@dalkia
dalkia deleted the feat/local-ab-deeplink branch August 12, 2026 19:44
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.

2 participants