decentraland · pravusjif · May 21, 2026 · May 5, 2026 · May 6, 2026 · May 7, 2026
@@ -0,0 +1,170 @@
+name: Visual Regression
+
+# Slash-command-driven visual regression runner. The actual mechanics live in
+# decentraland/explorer-automation's `run-visual-suite.yml` reusable workflow;
+# this file only handles trigger validation, branch matching, and dispatching
+# to that workflow.
+#
+# Trigger:
+#   Comment "/visual-tests" on a PR. Restricted to OWNER / MEMBER /
+#   COLLABORATOR author associations — anyone else's comment is silently
+#   ignored to keep this from becoming a free-CPU buffet for drive-by PRs.
+#
+# Branch matching:
+#   We look up the PR's head branch in explorer-automation. If that branch
+#   exists, we pass it as `tests_ref` so visual baselines and test fixtures
+#   from the matching feature branch are used. Otherwise we fall back to
+#   explorer-automation's default branch (metaforge handles the empty case
+#   internally).
+#
+# Required secrets / vars (configure once on the repo):
+#
+# Used directly by this dispatcher:
+#   - vars.DEV_EXPLORER_TEAM_S3_BUCKET_PUBLIC_URL  Constructs the Explorer build download URL
+#
+# Inherited by the reusable workflow via `secrets: inherit` — must exist
+# on this repo even though the dispatcher itself doesn't reference them:
+#   - secrets.ALTTESTER_LICENSE
+#   - secrets.REPOS_READ_ONLY_TOKEN
+#   - secrets.DEV_EXPLORER_TEAM_S3_BUCKET
+#   - secrets.DEV_EXPLORER_TEAM_AWS_DEFAULT_REGION
+#   - secrets.DEV_EXPLORER_TEAM_AWS_ACCESS_KEY_ID
+#   - secrets.DEV_EXPLORER_TEAM_AWS_SECRET_ACCESS_KEY
+
+on:
+  issue_comment:
+    types: [created]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+concurrency:
+  group: visual-regression-${{ github.event.issue.number }}
+  cancel-in-progress: true
+
+jobs:
+  resolve:
+    name: Resolve trigger
+    if: |
+      github.event.issue.pull_request &&
+      startsWith(github.event.comment.body, '/visual-tests')
+    runs-on: ubuntu-latest
+    outputs:
+      authorized: ${{ steps.gate.outputs.authorized }}
+      pr_number: ${{ steps.pr.outputs.number }}
+      build_url: ${{ steps.pr.outputs.build_url }}
+      tests_ref: ${{ steps.match.outputs.tests_ref }}
+      head_sha: ${{ steps.pr.outputs.head_sha }}
+      head_short_sha: ${{ steps.pr.outputs.head_short_sha }}
+      head_ref: ${{ steps.pr.outputs.head_ref }}
+
+    steps:
+      - name: Gate by author association
+        id: gate
+        env:
+          ASSOC: ${{ github.event.comment.author_association }}
+        run: |
+          set -euo pipefail
+          case "$ASSOC" in
+            OWNER|MEMBER|COLLABORATOR)
+              echo "authorized=true" >> "$GITHUB_OUTPUT"
+              ;;
+            *)
+              echo "::notice::Ignoring /visual-tests from $ASSOC ${{ github.event.comment.user.login }} — write access required."
+              echo "authorized=false" >> "$GITHUB_OUTPUT"
+              ;;
+          esac
+
+      - name: React to the trigger comment
+        if: steps.gate.outputs.authorized == 'true'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh api -X POST \
+            "repos/${{ github.repository }}/issues/comments/${{ github.event.comment.id }}/reactions" \
+            -f content=eyes >/dev/null
+
+      - name: Resolve PR head + build URL
+        id: pr
+        if: steps.gate.outputs.authorized == 'true'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PR_NUMBER: ${{ github.event.issue.number }}
+          PUBLIC_URL_PREFIX: ${{ vars.DEV_EXPLORER_TEAM_S3_BUCKET_PUBLIC_URL }}
+        run: |
+          set -euo pipefail
+
+          # 1. Fetch PR head — issue_comment events don't carry it in the payload.
+          PR_JSON=$(gh api "repos/${{ github.repository }}/pulls/${PR_NUMBER}")
+          HEAD_SHA=$(echo "$PR_JSON" | jq -r '.head.sha')
+          HEAD_REF=$(echo "$PR_JSON" | jq -r '.head.ref')
+          SHORT_SHA="${HEAD_SHA:0:7}"
+
+          # 2. Find the most recent successful Unity Cloud Build run for this SHA.
+          RUN_JSON=$(gh api "repos/${{ github.repository }}/actions/runs?head_sha=${HEAD_SHA}&status=success&per_page=20" \
+            --jq '[.workflow_runs[] | select(.name == "Unity Cloud Build")] | .[0]')
+          if [ -z "$RUN_JSON" ] || [ "$RUN_JSON" = "null" ]; then
+            echo "::error::No successful Unity Cloud Build run found for SHA ${SHORT_SHA}. Is the build still in progress, or did it fail?"
+            exit 1
+          fi
+          RUN_NUMBER=$(echo "$RUN_JSON" | jq -r '.run_number')
+          ORIGINAL_EVENT=$(echo "$RUN_JSON" | jq -r '.event')
+
+          # /visual-tests is only meaningful against a PR build. If the
+          # latest successful Unity Cloud Build for this SHA was triggered
+          # by something else (push to dev, scheduled run, manual dispatch),
+          # the artifact path uses a different prefix and our URL would
+          # 404. Fail loudly so the user knows to wait for a PR build
+          # rather than chasing a phantom 404 inside metaforge.
+          if [ "$ORIGINAL_EVENT" != "pull_request" ]; then
+            echo "::error::Latest successful Unity Cloud Build for ${SHORT_SHA} was triggered by '${ORIGINAL_EVENT}', not 'pull_request'. Visual tests can only run against PR builds."
+            exit 1
+          fi
+
+          ARTIFACT_PATH="@dcl/${{ github.event.repository.name }}/branch/${HEAD_REF}/pr-${RUN_NUMBER}-${SHORT_SHA}"
+          BUILD_URL="${PUBLIC_URL_PREFIX}/${ARTIFACT_PATH}/Decentraland_macos.zip"
+
+          {
+            echo "number=${PR_NUMBER}"
+            echo "head_sha=${HEAD_SHA}"
+            echo "head_short_sha=${SHORT_SHA}"
+            echo "head_ref=${HEAD_REF}"
+            echo "build_url=${BUILD_URL}"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Look up matching explorer-automation branch
+        id: match
+        if: steps.gate.outputs.authorized == 'true'
+        env:
+          GH_TOKEN: ${{ secrets.REPOS_READ_ONLY_TOKEN }}
+          HEAD_REF: ${{ steps.pr.outputs.head_ref }}
+        run: |
+          set -euo pipefail
+          # 200 = branch exists on explorer-automation, use it as tests_ref.
+          # 404 = no matching branch, fall back to default (empty string =>
+          # metaforge resolves to main).
+          if gh api "repos/decentraland/explorer-automation/branches/${HEAD_REF}" --silent >/dev/null 2>&1; then
+            echo "tests_ref=${HEAD_REF}" >> "$GITHUB_OUTPUT"
+            echo "::notice::Using matching explorer-automation branch '${HEAD_REF}'."
+          else
+            echo "tests_ref=" >> "$GITHUB_OUTPUT"
+            echo "::notice::No matching explorer-automation branch '${HEAD_REF}' — using default."
+          fi
+
+  run-suite:
+    name: Run visual suite
+    needs: resolve
+    if: needs.resolve.outputs.authorized == 'true'
+    # @main pins us to the merged version of the reusable workflow so PRs to
+    # explorer-automation that touch run-visual-suite.yml don't accidentally
+    # affect every unity-explorer PR's visual run.
+    uses: decentraland/explorer-automation/.github/workflows/run-visual-suite.yml@main
+    with:
+      mode: test
+      pr_number: ${{ needs.resolve.outputs.pr_number }}
+      build_url: ${{ needs.resolve.outputs.build_url }}
+      tests_ref: ${{ needs.resolve.outputs.tests_ref }}
+      commit_sha: ${{ needs.resolve.outputs.head_short_sha }}
+      branch_label: ${{ needs.resolve.outputs.head_ref }}
+    secrets: inherit
@@ -8,6 +8,7 @@ public static class AppArgsFlags
         public const string SKIP_VERSION_CHECK = "skip-version-check";
         public const string SIMULATE_VERSION = "simulateVersion";
         public const string FORCE_MINIMUM_SPECS_SCREEN = "forceMinimumSpecsScreen";
+        public const string SKIP_MINIMUM_SPECS_SCREEN = "skip-minimum-specs-screen";
 
         public const string SCENE_CONSOLE = "scene-console";
 
@@ -57,9 +58,11 @@ public static class AppArgsFlags
         public const string CREATOR_HUB_BIN_PATH = "creator-hub-bin-path";
 
         public const string USE_LOG_MATRIX = "use-log-matrix";
+        public const string GRAPHICS = "graphics";
         public const string WINDOWED_MODE = "windowed-mode";
         public const string RESOLUTION = "resolution";
         public const string DISABLE_WINDOW_RESTRICTIONS = "disable-window-restrictions";
+        public const string DISABLE_HUD = "disable-hud";
 
         public const string BANNED_USERS_FROM_SCENE = "include-banned-users-from-scene";
 

@@ -359,10 +359,29 @@ await dynamicWorldContainer.UserInAppInAppInitializationFlow.ExecuteAsync(
             splashScreen.Hide();
         }
 
-        private static void OpenDefaultUI(IMVCManager mvcManager, CancellationToken ct)
+        private void OpenDefaultUI(IMVCManager mvcManager, CancellationToken ct)
         {
             mvcManager.ShowAsync(NewNotificationController.IssueCommand(), ct).Forget();
             mvcManager.ShowAsync(MainUIController.IssueCommand(), ct).Forget();
+
+            if (appArgs.HasFlag(AppArgsFlags.DISABLE_HUD))
+                DisableHudOnStartupAsync(mvcManager, ct).Forget();
+        }
+
+        internal static async UniTask DisableHudOnStartupAsync(IMVCManager mvcManager, CancellationToken ct)
+        {
+            try
+            {
+                // Wait a frame so lazily-mounted MVC views exist before toggling.
+                await UniTask.NextFrame(ct).SuppressCancellationThrow();
+
+                if (ct.IsCancellationRequested)
+                    return;
+
+                // Bypass ToggleUIRequest (used by U key) so scene SDK UIDocuments stay visible.
+                mvcManager.SetAllViewsCanvasActive(false);
+            }
+            catch (Exception e) { ReportHub.LogException(e, ReportCategory.STARTUP); }
         }
 
         private void InitializeDebugPanel(IDebugContainerBuilder debugContainerBuilder, UIDocument debugUiRoot)

@@ -421,9 +421,10 @@ private async UniTask<IReadOnlyList<SpecResult>> VerifyMinimumHardwareRequiremen
                 new PlatformDriveInfoProvider());
 
             bool forceShow = applicationParametersParser.HasFlag(AppArgsFlags.FORCE_MINIMUM_SPECS_SCREEN);
+            bool skipScreen = applicationParametersParser.HasFlag(AppArgsFlags.SKIP_MINIMUM_SPECS_SCREEN) && !forceShow;
             bool hasMinimumSpecs = minimumSpecsGuard.HasMinimumSpecs() && !forceShow;
 
-            if (!hasMinimumSpecs)
+            if (!hasMinimumSpecs && !skipScreen)
                 SavedQualitySettingsApplier.EnforceLowPreset();
 
             bool userWantsToSkip = DCLPlayerPrefs.GetBool(DCLPrefKeys.DONT_SHOW_MIN_SPECS_SCREEN);
@@ -450,7 +451,7 @@ private async UniTask<IReadOnlyList<SpecResult>> VerifyMinimumHardwareRequiremen
 
             analytics.Track(AnalyticsEvents.General.MEETS_MINIMUM_REQUIREMENTS, specsProperties);
 
-            bool shouldShowScreen = forceShow || (!userWantsToSkip && !hasMinimumSpecs);
+            bool shouldShowScreen = forceShow || (!skipScreen && !userWantsToSkip && !hasMinimumSpecs);
 
             if (!shouldShowScreen)
                 return minimumSpecsGuard.Results;

@@ -0,0 +1,48 @@
+using Cysharp.Threading.Tasks;
+using Global.Dynamic;
+using MVC;
+using NSubstitute;
+using NUnit.Framework;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace Global.Tests.PlayMode
+{
+    public class BootstraperShould
+    {
+        private IMVCManager mvcManager;
+
+        [SetUp]
+        public async void Setup()
+        {
+            mvcManager = Substitute.For<IMVCManager>();
+            await UniTask.Yield();
+        }
+
+        [Test]
+        public async Task DisableHudOnStartup_OnlyTouchesMVCCanvases_NotSceneUIDocuments()
+        {
+            // Workaround for Unity bug not awaiting async Setup correctly
+            await UniTask.WaitUntil(() => mvcManager != null);
+
+            await Bootstrap.DisableHudOnStartupAsync(mvcManager, CancellationToken.None);
+
+            mvcManager.Received(1).SetAllViewsCanvasActive(false);
+            mvcManager.DidNotReceiveWithAnyArgs().SetAllViewsCanvasActive(default(IController), default);
+        }
+
+        [Test]
+        public async Task DisableHudOnStartup_DoesNothing_WhenCancelledBeforeFrameAdvances()
+        {
+            // Workaround for Unity bug not awaiting async Setup correctly
+            await UniTask.WaitUntil(() => mvcManager != null);
+
+            var cts = new CancellationTokenSource();
+            cts.Cancel();
+
+            await Bootstrap.DisableHudOnStartupAsync(mvcManager, cts.Token);
+
+            mvcManager.DidNotReceiveWithAnyArgs().SetAllViewsCanvasActive(default);
+        }
+    }
+}