com.robotsquid.squidhub 0.5.9 → 0.5.12

package/CHANGELOG.md

@@ -1,5 +1,78 @@
 # Changelog
 
+## 0.5.12
+
+**A manifest change is a new version now — the platform changed underneath this.**
+
+Editing `manifest.json` and re-uploading used to report "these exact bytes are
+already published, nothing to upload" and discard the edit. Server migration
+0029 makes version identity `(build_hash, manifest_sha256)`, so a changed
+declaration registers a new version and takes effect.
+
+⚠️ **`manifest.json` is still excluded from the build hash and must be** — it
+CONTAINS that hash, so folding it in has no fixed point. A separate digest of
+the manifest file has no such circularity, because a manifest never contains its
+own digest. The bytes are still deduped: two versions differing only in
+declaration share one copy in R2.
+
+⚠️ **The 0.5.11 "your manifest was ignored" explanation is GONE**, because it is
+now false. That message fired when the bytes matched; the bytes matching now
+also means the manifest matched. Telling a publisher their edit was discarded at
+the one moment we know it was not is worse than saying nothing.
+
+**Requires the api deployed with migration 0029.** Against an older server this
+package still works and a manifest-only change still silently does nothing.
+
+## 0.5.11
+
+**"Nothing to upload" now says what it did to your manifest.**
+
+Editing `manifest.json` and pressing Build and Upload reported *"These exact
+bytes are already published. Nothing to upload."* and stopped — never mentioning
+that the declaration had not been applied. With a manifest editor in the package
+that is a normal thing to do, and the result was unreadable.
+
+`manifest.json` is excluded from the build hash — it CONTAINS that hash, so
+including it would have no fixed point — so a build whose only difference is its
+declaration hashes identically and matches a version already registered.
+
+⚠️ **It stops at `start`, before a byte moves, which is EARLIER than the
+server's own `manifest-ignored` warning.** That one is raised at `complete`, and
+such a build never gets there, so this message is the only thing that will ever
+say it.
+
+The dialog now names the manifest and both ways forward: change a real file and
+rebuild, or set the override in the publisher console — display settings are
+live-tunable there and need no new build at all.
+
+## 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/Editor/SquidHubUploader.cs

@@ -186,9 +186,26 @@ namespace SquidHub.Editor
             if (SquidHubBuildScan.JsonField(startResponse, "alreadyPublished") == "true")
             {
                 EditorUtility.ClearProgressBar();
+
+                // ⚠️ A no-op now means the BYTES AND THE DECLARATION both match.
+                // It used to mean only the bytes did, so a changed manifest.json
+                // landed here and was discarded — this dialog carried a long
+                // explanation of that trap. Migration 0029 made version identity
+                // (build_hash, manifest_sha256), so a declaration change
+                // registers a new version and never reaches this branch.
+                //
+                // ⚠️ Do NOT reinstate the old wording. Telling a publisher their
+                // manifest was ignored, at the one moment we know it was not, is
+                // worse than saying nothing.
+                var hash = SquidHubBuildScan.JsonField(startResponse, "buildHash");
+                Debug.Log("[SquidHub] " + hash + " is already published — same bytes, same " +
+                          "manifest. Nothing to upload.");
+
                 EditorUtility.DisplayDialog("SquidHub",
-                    "These exact bytes are already published as " + SquidHubBuildScan.JsonField(startResponse, "buildHash") +
-                    ". Nothing to upload.", "OK");
+                    "Already published as " + hash + ".\n\n" +
+                    "Nothing to upload: both the build and its manifest.json match what is " +
+                    "already registered.",
+                    "OK");
                 yield break;
             }
 

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
@@ -200,10 +209,14 @@ on your `AudioContext`. It works without you doing anything — but only because
 the bridge is injected ahead of the loader, which is why step 2 above is not
 merely tidy. Tick **Sound** in `SquidHub → Game Manifest…` or no button appears.
 
-⚠️ **Editing `manifest.json` alone changes nothing.** It is excluded from the
-build hash, so a manifest-only re-upload registers no new version and your edit
-is discarded — the server now says so in a warning rather than staying silent.
-Change a real file and rebuild, or set an override in the console.
+⚠️ **Editing `manifest.json` alone registers a new version.** It used not to —
+the manifest is excluded from the build hash, so the build looked identical and
+the edit was discarded. A version is now identified by its bytes *and* its
+declaration, so a manifest-only change ships. The bytes are still deduped: the
+two versions share one copy in R2.
+
+To change display on a build that is already live, the publisher console's
+override is still the faster path — it needs no upload at all.
 
 ## ⚠️ Status
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.robotsquid.squidhub",
-  "version": "0.5.9",
+  "version": "0.5.12",
   "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",