com.robotsquid.squidhub 0.5.9 → 0.5.10

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 0.5.10
+
+**Fullscreen: the check that makes it actually work.**
+
+`Check WebGL Settings` and every build now warn when **Run In Background** is
+off. Unity WebGL pauses its main loop when the canvas loses focus, and on
+SquidHub every control the player can see — mute, fullscreen, the back link —
+belongs to the PORTAL, in the parent document. Clicking one takes focus off the
+canvas and stops the game.
+
+⚠️ **Fullscreen is where it shows, and the pause is invisible.** The portal
+fullscreens its own container, the frame gets bigger and the canvas CSS box
+grows — but the engine loop is what syncs the WebGL render target to that box.
+A paused game keeps drawing at the old resolution and is upscaled across the
+whole screen. Measured: a 2560x1290 frame still rendering a 1800x1120 target,
+unchanged after 24 seconds, correct within two seconds of a real click into the
+game. A player sees a blurry game that sharpens when they touch it, which nobody
+ever reports as a focus bug.
+
+⚠️ **A warning, not fatal.** The build runs, and a game that is genuinely
+unplayable unfocused is entitled to pause. It is the wrong default here, not an
+impossibility.
+
+**And the button only exists if you declare it.** `display.fullscreen` defaults
+to false, so the portal draws no fullscreen control at all until the manifest
+opts in — tick **Fullscreen button** in `SquidHub → Game Manifest…`. That is
+separate from this check, and both are needed.
+
 ## 0.5.9
 
 **Build and Upload just uploads.** The "Upload N files (X MB)?" confirmation is

package/Editor/SquidHubAudit.cs

@@ -38,6 +38,7 @@ namespace SquidHub.Editor
             CheckJslib(findings);
             CheckThreads(findings);
             CheckCompression(findings);
+            CheckRunInBackground(findings);
 
             return findings;
         }
@@ -106,6 +107,41 @@ namespace SquidHub.Editor
                 "Player Settings > Publishing Settings > Compression Format to Disabled.");
         }
 
+        /// <summary>
+        /// ⚠️ Unity WebGL PAUSES ITS MAIN LOOP when the canvas loses focus, and on
+        /// this platform the canvas loses focus constantly: every control the
+        /// player can see — mute, fullscreen, the back link — belongs to the
+        /// PORTAL, in the parent document, not to the game. Clicking any of them
+        /// takes focus off the canvas and stops the game.
+        ///
+        /// ⚠️ The worst of it is fullscreen, because the pause is invisible. The
+        /// portal fullscreens its own container, the frame gets bigger, and the
+        /// canvas CSS box grows — but the engine loop is what syncs the WebGL
+        /// render target to that box, so a paused game keeps rendering at the old
+        /// resolution and is upscaled across the whole screen. Measured here: a
+        /// 2560x1290 frame still drawing a 1800x1120 target, unchanged after 24
+        /// seconds, and correct within two seconds of a real click into the game.
+        /// The player sees a blurry game that sharpens when they touch it, which
+        /// nobody reports as a focus bug.
+        ///
+        /// ⚠️ A WARNING, not fatal. The build runs, and a game that is genuinely
+        /// unplayable unfocused — a turn-based puzzle, say — is entitled to
+        /// pause. It is the wrong default here, not an impossibility.
+        /// </summary>
+        private static void CheckRunInBackground(List<Finding> findings)
+        {
+            if (PlayerSettings.runInBackground) return;
+
+            Warn(findings,
+                "Run In Background is off (Player Settings > Resolution and Presentation). " +
+                "Unity WebGL pauses when the canvas loses focus, and on SquidHub every visible " +
+                "control belongs to the portal rather than to the game — so the mute and " +
+                "fullscreen buttons stop the game as a side effect of being clicked. " +
+                "Fullscreen is the one that shows: the frame grows, the paused engine never " +
+                "resizes its render target to match, and the game is upscaled and blurry until " +
+                "the player clicks into it. Turn it on.");
+        }
+
         private static bool AllowsThreads()
         {
             var defines = PlayerSettings.GetScriptingDefineSymbols(NamedBuildTarget.WebGL);

package/README.md

@@ -175,6 +175,7 @@ The package checks these for you, but for reference:
 | Setting | Value | Why |
 |---|---|---|
 | Native C/C++ Multithreading | **off** | SquidHub's default tier is not cross-origin isolated, so `SharedArrayBuffer` does not exist. A pthreads build cannot start. Ask about the isolated tier if you genuinely need threads — it carries no ads |
+| Run In Background | **on** | ⚠️ Unity WebGL pauses when the canvas loses focus, and every control on SquidHub — mute, fullscreen, back — belongs to the portal, not the game. Left off, clicking any of them stops the game; fullscreen then keeps rendering at the pre-fullscreen resolution, so the game is blurry until the player clicks into it |
 | Compression Format | **Disabled** | ⚠️ Required, and the build is refused otherwise. SquidHub stores assets uncompressed and Cloudflare compresses them at the edge, per client. A precompressed build cannot be served correctly at all |
 
 ## Things that will otherwise bite
@@ -189,6 +190,14 @@ data:`. A CDN font, a remote texture or a third-party analytics snippet is
 blocked at load and shows up as a console error, not as a missing style.
 Everything must ship inside the build.
 
+⚠️ **Fullscreen needs two things, and neither is the Unity fullscreen button.**
+Tick **Fullscreen button** in `SquidHub → Game Manifest…` — `display.fullscreen`
+defaults to false and the portal draws no control without it — and turn on **Run
+In Background**, or the game pauses the moment the player clicks that control and
+stays at the old resolution while the frame grows. The portal fullscreens its own
+container rather than asking your game to do it, so your build needs no fullscreen
+code at all; Unity's own button is hidden for you.
+
 ⚠️ **Do not write your own rotate prompt or call `screen.orientation.lock()`.**
 Declare the orientations you support in `SquidHub → Game Manifest…` and the
 portal draws the prompt outside your frame. Two prompts fight, and yours is the one the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.robotsquid.squidhub",
-  "version": "0.5.9",
+  "version": "0.5.10",
   "displayName": "SquidHub",
   "description": "Cloud saves, analytics and the coin economy for Unity WebGL games published on SquidHub. Installs the C# wrapper, the .jslib half and the page bridge, and rewrites the exported index.html so it survives the platform's CSP.",
   "unity": "2021.3",