@funpixel/tools 0.1.0 → 0.1.1

package/templates/common/AGENTS.md

@@ -87,7 +87,7 @@ the demo with your game (`rules.ts`, `session.ts`, `game.ts`, `feel.ts`, `hud.ts
   paths, an environment map (they render flat grey without one), and `mixer.update(dt)` every frame.
 - Pixi: every display object gets a `.label`; `window.__PIXI_APP__ = app` after `app.init()`.
 - Room codes, share codes and seeds carry `data-funpixel-selectable` (else they cannot be copied).
-- `@funpixel/sdk` is pinned exactly (`"0.6.0"`). Import the root only for `setupGameResize`;
+- `@funpixel/sdk` is pinned exactly (`"0.7.0"`). Import the root only for `setupGameResize`;
   everything else from a subpath. Multiplayer is `Room.autoJoin(getGameKey(), …)`, never a raw
   WebSocket (skill `funpixel-game-spine`).
 - A performance fix changes how a frame is made (pooling, atlases, instancing), never what it shows.

package/templates/common/src/platform.ts

@@ -2,7 +2,7 @@
 // quiet while its tab is hidden or a host holds it, progress flushed when the page goes (save.ts), fullscreen
 // with the orientation lock on the first tap on a phone, a haptic pulse, and which input the player is using
 // (on-screen controls show only for touch: the owner, 1 Oct, "no need for mobile controls on desktop").
-// The owner's web games carry the same seams (The Last Good Robot: platform.ts, save.ts, fullscreen.ts,
+// The owner's web games carry the same seams (one has platform.ts, save.ts, fullscreen.ts,
 // portal.ts; its platform test boots with storage that throws). What a check reads is the outcome: progress
 // survives a reload, the game pauses when hidden, the page boots where storage is blocked.
 

package/templates/common/src/probe-human.ts

@@ -1,13 +1,13 @@
 // probe-human.ts — a probe player at a human rate, for test/probes.ts beside the sharp bot: sim reads a level the
-// 60-decisions-a-second bot clears and this one cannot as a wall for people (Saltwake's Dusk Cup, 30 Sep).
+// 60-decisions-a-second bot clears and this one cannot as a wall for people (one race, 30 Sep).
 
 import type { Policy } from './probe-kit.ts';
 
 /**
  * The same player at a human rate: a fresh decision `hz` times a second (a thumb makes 10–15), each landing `reactMs`
  * late (~200 ms to see and react). Between decisions the hand rests (`rest`, e.g. no press) or, with `hold`, keeps the
- * last input (a steer held down). A level the 60-a-second bot clears and this one cannot is a wall for people (Saltwake's
- * Dusk Cup, 30 Sep). Wrap a policy that decides each call; one with its own press timer slows further.
+ * last input (a steer held down). A level the 60-a-second bot clears and this one cannot is a wall for people (one
+ * race, 30 Sep). Wrap a policy that decides each call; one with its own press timer slows further.
  */
 export function humanRate<R, I>(p: Policy<R, I>, dt: number, o: { rest: I; hold?: boolean; hz?: number; reactMs?: number }): Policy<R, I> {
   const hz = o.hz ?? 12, reactMs = o.reactMs ?? 200;

package/templates/common/src/save.ts

@@ -1,7 +1,7 @@
 // Saving, engine-free so the rules' tests can load it: storage that never throws and progress kept through the
 // SDK's SaveManager. Yours to reshape (a chapter list, a level map, settings); what a check reads is the
 // outcome: progress survives a reload, and the page boots where storage is blocked (test/platform.test.ts;
-// The Last Good Robot boots its own with storage that throws).
+// one of the owner's games boots its own with storage that throws).
 
 import { SaveManager } from '@funpixel/sdk/save';
 

package/templates/common/test/platform.test.ts

@@ -1,5 +1,5 @@
 // The page boots where storage is blocked, and progress survives a reload: outcomes a player meets in a
-// sandboxed frame, private browsing or a full disk (The Last Good Robot's platform test, in small).
+// sandboxed frame, private browsing or a full disk (one of the owner's games' platform test, in small).
 // save.ts is engine-free so this runs under Node beside the rules.
 
 import { test } from 'node:test';

package/templates/three-world/src/budget.ts

@@ -2,7 +2,7 @@
 // fps when a frame stays under ~120 draw calls and ~300k triangles at a pixel ratio of at most 1.5. The
 // pixel ratio steps down by itself when frames run long (and the shadows go first), and back up when there
 // is room. `funtools profile` and `look --hud` read the same facts. Raise a number only after measuring.
-// The quality tier follows the GPU, never the pointer (Held Note, src/view/device.ts): a desktop window in
+// The quality tier follows the GPU, never the pointer: a desktop window in
 // touch emulation reports a coarse pointer and would get the phone's budget. The touch LAYOUT still follows
 // the pointer (controls.tsx). The GPU's name rides in state.render too: a frame time means nothing without
 // it (headless Chrome draws on SwiftShader, no GPU).

package/templates/three-world/src/cutouts.ts

@@ -1,5 +1,5 @@
-// Many painted cut-outs for one draw call. One THREE.Sprite per cut-out is a draw call each (the Blue
-// Freight build reached 164 against a budget of 150); here every cut-out sharing an atlas is ONE
+// Many painted cut-outs for one draw call. One THREE.Sprite per cut-out is a draw call each (one
+// game's build reached 164 against a budget of 150); here every cut-out sharing an atlas is ONE
 // InstancedMesh. Each instance has its place, height, tint, atlas frame and mirror, and a sway and
 // squash the vertex shader bends it by (the foot stays planted, the top moves: animation, not a card
 // bobbing on a stick). They turn round the vertical axis to the camera and cut their edge by alphaTest,

package/templates/three-world/src/game.ts

@@ -61,7 +61,7 @@ export async function startGame(host: HTMLElement): Promise<void> {
   Object.assign(window, { __THREEJS_SCENE__: scene, __THREEJS_RENDERER__: renderer, __THREEJS_CAMERA__: camera, camera, THREE, __FPX_CAMERA__: () => cameraReport(rig, renderer.toneMappingExposure) });
   setupGameResize((width, height) => { camera.aspect = width / height; camera.updateProjectionMatrix(); renderer.setSize(width, height); stage.setSize(width, height); });
   startSession(); build();
-  // Warm-up: compile every material's shader before the first frame, so play never hitches on one (Held Note).
+  // Warm-up: compile every material's shader before the first frame, so play never hitches on one.
   await renderer.compileAsync(scene, camera).catch(() => {});
   const clock = new THREE.Clock(), life = new Living('player', ROLE.hero), lean = { x: 0 }, PLAY_SCREENS = new Set<string>(['playing', 'paused', 'won', 'lost']);
   let lastScreen = '';

package/templates/three-world/src/models.ts

@@ -34,7 +34,7 @@ export async function model(name: string, height: number, placeholder: () => THR
     m.scale.setScalar(height / Math.max(size.y, 1e-6));
     m.position.y = -box.min.y * m.scale.y;
     // A skinned mesh's bounds are its bind pose: an animated limb leaves them and the mesh vanishes at the frame's
-    // edge (Held Note, vfx frames.md). One hero is cheap to never cull; a crowd gets real bounds instead.
+    // edge. One hero is cheap to never cull; a crowd gets real bounds instead.
     m.traverse((o) => { if ((o as THREE.Mesh).isMesh) o.castShadow = true; if ((o as THREE.SkinnedMesh).isSkinnedMesh) o.frustumCulled = false; });
     return new THREE.Group().add(m);
   };

package/unity/com.funpixel.probe/Runtime/Player/Args.cs

@@ -1,5 +1,5 @@
 // Launch flags, from the command line and from the FUNPIXEL_PROBE_ARGS environment variable. On iOS, Mono does not see
-// `simctl launch` arguments (Joydle Core reads them through a native plugin); an environment variable needs no plugin:
+// `simctl launch` arguments (a package can read them through a native plugin); an environment variable needs no plugin:
 // `SIMCTL_CHILD_FUNPIXEL_PROBE_ARGS="-fp-probe -fp-remote 7611" xcrun simctl launch <udid> <bundle>` sets it for the app.
 // funtools passes both ways on a Mac and the variable on a Simulator. A device run (later) can use the same variable
 // through Xcode's scheme or devicectl's --environment-variables.

package/unity/com.funpixel.probe/Runtime/Player/Bridge.cs

@@ -1,6 +1,6 @@
 // The player bridge: a TCP server on 127.0.0.1 inside a development player (an iOS Simulator shares the Mac's network,
-// so funtools on the Mac reaches a Simulator's player the same way). Lifted from Pocket Crew's RemotePlay.cs (the
-// owner's, joydle-games/games/pocket-crew, 661 lines with tools/pcplay.py) and made game-agnostic: the game's own facts,
+// so funtools on the Mac reaches a Simulator's player the same way). Lifted from one game's remote-play server (the
+// owner's, 661 lines with a Python driver) and made game-agnostic: the game's own facts,
 // targets, views and commands come in through FunpixelProbe; the rest is here.
 //
 // One JSON object per line in ({"cmd": "tap", "x": 100, "y": 200, "id": 7}), one JSON reply per line out

package/unity/com.funpixel.probe/Runtime/Player/Capture.cs

@@ -1,7 +1,7 @@
 // Pictures and sound from inside the player, so nothing is read off the screen of the Mac: a still is the frame the
 // game drew (ScreenCapture after the frame, overlay UI included, upright in the game's own orientation, whatever way
-// a Simulator is held), and a recording is frames plus the game's own mix. The recording follows Floe Jam's
-// Recorder.cs (the owner's): game time steps at the recording's rate (Time.captureFramerate) and Unity's offline
+// a Simulator is held), and a recording is frames plus the game's own mix. The recording follows one game's
+// recorder (the owner's): game time steps at the recording's rate (Time.captureFramerate) and Unity's offline
 // audio renderer (AudioRenderer) hands over exactly one frame's samples each frame, so picture and sound stay in step
 // however slowly the frames are written. funtools joins them with ffmpeg. Every capture frame is marked for the probe.
 using System;

package/unity/com.funpixel.probe/Runtime/Player/Inject.cs

@@ -1,6 +1,5 @@
 // Input as real Input System device state, so a remote finger takes the whole path a real one does: the EventSystem and
-// its buttons, the game's own touch layer, a HUD's hit test. Lifted from Pocket Crew's RemotePlay.cs (the owner's, in
-// joydle-games/games/pocket-crew), with the game-specific parts left to FunpixelProbe.Target and .Command.
+// its buttons, the game's own touch layer, a HUD's hit test. Lifted from one game's remote-play server (the owner's), with the game-specific parts left to FunpixelProbe.Target and .Command.
 #if FUNPIXEL_INPUT_SYSTEM
 using System;
 using System.Collections.Generic;

package/unity/com.funpixel.probe/Runtime/Player/Probe.cs

@@ -1,7 +1,7 @@
 // The probe: every frame in the player, read from the engine's own counters (ProfilerRecorder), which work in
 // development players where UnityStats reads 0 in batch mode. Learned from the studio's five probes, each written for
-// one game: Knockout Lap's HitchProbe, Particle Rush's PerfProbe, The Hot Gates' PerfRecorder and Pocket Crew's
-// PerfProbe and Hitch (the Unity 6 draw counters, the player loop minus its waits as the frame's work).
+// one game: hitch probes, perf probes and a perf recorder
+// (the Unity 6 draw counters, the player loop minus its waits as the frame's work).
 //
 // A frame is reported by the frame after it: Unity's counters and a frame's length are known once it has ended, so
 // Update (first in the frame) records the one before. Frames are left out of the numbers, and counted, when they are

package/unity/com.funpixel.probe/Runtime/Player/UiTargets.cs

@@ -1,7 +1,7 @@
 // What a finger can press on screen, as rects in screen pixels (Unity's bottom-left origin): the game's registered
 // targets (FunpixelProbe.Target) and every interactable UGUI Selectable with its name, hierarchy path and text. The
 // text is read from any child component with a string `text` property (UGUI Text, TextMeshPro), so the package needs
-// no TextMeshPro reference. Generalised from Pocket Crew's RemotePlay.UiTargets.
+// no TextMeshPro reference. Generalised from one game's remote-play UI targets.
 using System;
 using System.Collections.Generic;
 using System.Reflection;

package/plugins/claude/skills/unity-game/references/studio-packages.md

@@ -1,127 +0,0 @@
-# The studio's Unity packages
-
-The studio's two packages, `com.joydle.core` (0.1.0) and `com.joydle.firebase`, are optional: the
-games inside its repository use both, Knockout Lap, Gallery Heist and Particle Rush the core only,
-and Floe Jam neither. They live in that repository, `joydle/joydle-games` (private: the person needs
-read access), under `packages/`. A game that uses them never writes their pieces again. The field report's starter
-is "the SDK wired, switched off" (Starter project), and a fix made in the package reached every game at
-once (§1). Read as of 9 Oct 2026, from the packages' own code; what changes there wins over this page.
-
-## Adding them
-
-Every project lists them by `file:` path. Inside the repository that is `file:../../../packages/…`;
-the three outside it (Knockout Lap, Gallery Heist, Particle Rush) use `file:../../joydle-games/packages/…`
-(Knockout Lap, one folder deeper, `../../../`), so `joydle-games` must be cloned beside them, and
-`funtools doctor` warns when the path is missing. A git URL pinned to a commit needs no sibling
-clone (`#main` moves under a store build); no project uses one yet. Run `git lfs install` first: the splash's pictures and sounds are LFS files, and without it they arrive as
-pointer files. Inside the repository the same holds for a checkout whose LFS files were never pulled.
-`funtools doctor` in the game finds pointer files in Assets, Packages, every local package and the
-package cache, and names the repository to run `git lfs pull` in; run it before a build.
-
-```json
-"dependencies": {
-  "com.joydle.core": "file:../../joydle-games/packages/com.joydle.core",
-  "com.joydle.firebase": "file:../../joydle-games/packages/com.joydle.firebase",
-  "com.unity.inputsystem": "1.20.0",
-  "com.unity.render-pipelines.universal": "17.6.0",
-  "com.unity.test-framework": "1.8.0",
-  "com.unity.ugui": "2.6.0"
-}
-```
-
-The pinned form is `https://github.com/joydle/joydle-games.git?path=/packages/com.joydle.core#<commit>`.
-
-- `com.unity.inputsystem` goes in the game's own manifest: the core's assembly references it and its
-  `package.json` does not pull it in. Set the player to the new Input System only.
-- `com.unity.purchasing` 5.4.3 comes with the core (StoreKit 2 on iOS, Play Billing on Android).
-- The Firebase package needs Google's packages at 13.17.0 (app, analytics, crashlytics) and the External
-  Dependency Manager 1.2.189. The games repository keeps their `.tgz` files in `packages/vendor/` (LFS)
-  and lists them by `file:` path; another project keeps the same versions in its own folder, in LFS.
-  Each game has its own Firebase project, with its config file under `Assets/`.
-- Take out what no game uses: collab-proxy, learn, visual scripting, the Aseprite and PSD importers
-  (Scrap Riot also dropped 2D animation, sprite shape, tilemap extras and timeline: 88 → 78 MiB). Keep
-  what a game uses: Gallery Heist loads its rooms through Addressables 4.1 (built into the app, no
-  remote catalog) and aims its camera with Cinemachine 6.6, beside VFX Graph, Splines and Timeline.
-  No game uses DOTween (`Juice` tweens).
-
-## What each piece gives, and the rule it settles
-
-Editor side of `com.joydle.core`:
-
-| Piece | What it does | Settles |
-|---|---|---|
-| `ProjectConfig.ApplyIOS(name, bundleId, version, landscape)` | Company name, bundle id, IL2CPP, iOS 16, iPhone only, a fixed orientation, status bar hidden, Unity splash off; switches the build target to iOS | settings by script, not a copied file (`fp:unity-game` step 6). It does not set colour space, 48 kHz, render scale, ProMotion, the accelerometer or physics: `Setup.Configure` sets those after it |
-| `ProjectConfig.ApplyAndroid(packageName)` | API 26 to 36 (pinned), ARM64, IL2CPP, App Category game, GameActivity, full screen under cutouts, R8 off (it strips Firebase and purchase classes reached by reflection) | the Android half of the same rule |
-| `BuildTools.Simulator`, `SimulatorDev`, `SimulatorMuted`, `Device`, `TestFlight` | Headless iOS builds (`-executeMethod Joydle.Core.Editor.BuildTools.TestFlight`) into `Builds/iOS-sim` or `Builds/iOS`. Every build applies the size settings (stripping High, engine stripping, IL2CPP OptimizeSize, unused mesh channels off); LZ4HC when `ProjectSettings/JoydleLz4hc.txt` exists. `TestFlight` sets the studio's team and automatic signing, and the build number (`JOYDLE_BUILD_NUMBER`, else a `yyMMddHHmm` stamp) and refuses to build without `Assets/_Game/Art/Icon/app_icon.png`. `SimulatorMuted` turns audio off for that one build and restores it | size settings and LZ4HC ([performance](performance.md) step 8); the icon gate (Porcelain Panic shipped Unity's default icon); the CoreAudio wedge on a Simulator relaunched many times |
-| `BuildTools.Android`, `AndroidApk`, `AndroidDev`, `VersionCode()` | A signed `.aab` with its symbols (refuses without `JOYDLE_KEYSTORE` and `JOYDLE_KEYSTORE_PASS`); a release `.apk` for tests that reads launch args (never upload it); versionCode = minutes since 1 Jan 2026, because the iOS stamp is over Play's 2,100,000,000 cap | Android, planned in the report and built since (§15) |
-| `IosPostprocess` | Writes `ITSAppUsesNonExemptEncryption` false and stamps every embedded framework's minimum OS with the app's | ITMS-90208 (`fp:store`) |
-| `JoydleLaunch` | A black launch storyboard under its own name, for games that play the splash | iOS caches a launch screen by name across updates (§10) |
-| `SplashImport` | Splash parts scaled to a power of two, mipmapped, compressed | 10.3 MB of raw splash in every game, now about 2.6 MB |
-| `TextureBudget` | Textures named `model__basecolor.png` (and `__normal`, `__mr`, `__emissive`) under an `Art/` or `Models/` folder: ASTC 6×6, mipmaps, sRGB only for base colour and emissive, at most 512 under `Food/`, `Props/` or `Characters/`, else 1024 | glTFast's raw RGBA32 model textures (`fp:3d`, Unity page) |
-| `AndroidManifestPost` | Adds the vibrate permission the haptics need | |
-
-Runtime side of `com.joydle.core`:
-
-| Piece | What it does | Settles |
-|---|---|---|
-| `Sfx.Create(music)`, `Play(clip, volume)`, `Sfx.EnsureListener()` | 8 pooled one-shots with pitch jitter 0.06, one looping music source at 0.45, and exactly one AudioListener | the four silent TestFlight builds (`fp:audio`, Unity page, step 1) |
-| `Haptics.Light`, `Medium`, `Heavy`, `Success`, `Error` | iOS taptics through the package's native plugin, Android vibration effects; off when `Settings.Haptics` is | haptics by strength (`fp:game-feel`, Unity page). The 80–90 ms throttle and the 120 ms merge are the game's |
-| `Juice.Tween`, `Pop`, `Shake`, `EaseOutBack`, `EaseOutCubic`, `EaseInQuad`, `Ring`, `Dot`, `Rounded` | Coroutine tweens with the defaults the games used (pop 0.18 over 0.22 s, shake 0.08 over 0.25 s); a pop keeps the true rest scale | the compounding pop, fixed once for every game |
-| `UiKit` | A canvas scaled at 1170×2532 (match 0.5), a `Safe` rect from `Screen.safeArea`, rounded panels, text, buttons that pop, modal cards, a dim layer, `FitToContent`; text and images take no taps | the code-built UI and the Restore label that covered the shop card (`fp:mobile-ui`, Unity page). `Safe` is read once when the kit is made, and the landscape island-side rule is not in it |
-| `LaunchArgs.Get()` | Launch arguments: on iOS from the native process (Mono never sees `simctl launch` args), on Android from the intent extra `joydle_args`, in development builds and test APKs only | the basis of every automation flag. On iOS it is not gated: read it through the game's own wrapper that returns nothing unless `Debug.isDebugBuild` (Scrap Riot's), or a release build obeys an unlock flag (§1) |
-| `Settings.Music`, `Sound`, `Haptics` | The three player toggles, kept in PlayerPrefs | |
-| `Telemetry.Event`, `LevelStart`, `LevelEnd`, `TutorialComplete`, `ShopOpen`, `Log`; `Telemetry.Muted` | The one analytics and crash boundary; logs to the console in a development build with no sink | mute it under every dev flag: autoplay and capture runs must not reach analytics |
-| `IapService(catalog, grant)` with `Init`, `Buy`, `Restore(done)`, `Price`, `Refetch` | Unity IAP 5. Grants in the pending-order handler once per transaction, then confirms; non-consumables come back from confirmed orders on every fetch; `Restore(done)` asks StoreKit to sync on iOS and answers true or false; `Price` is the store's localised string | the double grant (fixed on main on 7 Oct; a game built before needs a new build), Restore that ends (`fp:store`) |
-| `Ads.CreateDefault(font)`, `Ads.Available`, `Ads.ShouldShowInterstitial(level, noAds)` | Test ads in development builds and the Editor, none in release; interstitials from level 15, every third level, never for a No Ads buyer | hide every ad button and No Ads while `Ads.Service` is null |
-| `JoydleSplash` | The studio splash, 4.25 s, tap to skip after 1 s. A game opts in with a text asset `Resources/JoydleSplashOn`; it holds the game's audio, waits for the first scene and 10 smooth frames (1 s floor, 3 s cap), and is skipped in the Editor and on any launch with a `-flag` (`-splash` forces it); `JoydleSplash.Playing` says when it is up | "add joydle splash … as we did for other games" (the owner, twice) |
-| `BackButton.PressedThisFrame`, `AndroidSystem.MoveToBack()`, `AndroidSystem.Density` | Android Back read from input events, since Back arrives pressed and released inside one frame and polling misses it; leave the app from the root screen; the dp scale | |
-
-`com.joydle.firebase` boots itself before the first scene and installs Analytics and Crashlytics as
-`Telemetry`'s sink (uncaught exceptions are fatal reports); the Editor keeps the console. It hands its
-`link.xml` to the linker and marks its assembly always linked, because High stripping removed it and
-Firebase never started in release builds (3 broken uploads). It pins the no-tracking setup: no
-advertising identifier and no ad personalisation in the iOS plist, the advertising-id and ad-services
-permissions removed on Android. That is what lets the privacy answers say nothing is used for
-tracking, with no tracking prompt.
-
-## A studio splash
-
-A game never makes its own splash or a "Funpixel presents" card, package or not: the opening belongs
-to the studio that makes the game, or to nothing. A studio's splash comes from its package, so one
-fix reaches every game. Today
-that is Joydle Core's `Joydle.Core.JoydleSplash` (read from its code on 10 Oct 2026; the code wins
-over this table). A project on another studio's package wires that package's splash the same way; a
-project with none ships no splash.
-
-| Day-one rule | How `JoydleSplash` does it |
-|---|---|
-| Opt in, once | A text asset that `Resources.Load<TextAsset>("JoydleSplashOn")` finds, such as `Assets/_Game/Resources/JoydleSplashOn.txt` (the games write one line: what it does and "Delete this file to turn it off"), with its `.meta` committed. Nothing else is called: the package boots it before the first scene loads (`RuntimeInitializeOnLoadMethod(BeforeSceneLoad)`) |
-| Before the first scene, on top | A `DontDestroyOnLoad` object with an overlay canvas at sorting order 32000. It waits for the first scene and 10 smooth frames (1 s floor, 3 s cap), then plays 4.25 s; a tap skips it after 1 s. On iOS `JoydleLaunch` makes the launch screen the black it opens on |
-| Holds the game's audio | `AudioListener.pause` is true until it ends; its own sounds ignore the pause and follow `Settings.Sound` |
-| Skipped in the Editor and on any flag | `Application.isEditor`, or any argument from `LaunchArgs.Get()` that starts with `-` (every automation, capture and test launch passes one); `-splash` forces it, to see it on the Simulator |
-| Title music waits | `JoydleSplash.Playing` is true from before the first scene until the fade ends (false when it was skipped): start the title music once it is false. Pocket Crew also hides its loading view while it is up |
-| The studio credit | Every credit line (Settings, About, an end card) names the studio, Joydle, and never Funpixel |
-
-Its pictures and sounds are LFS files under the package's `Runtime/Resources/JoydleSplash/`. On a Mac
-where the studio repository's LFS files were not pulled they are pointer text: the splash draws
-blank parts and stays silent, and Unity logs "FSBTool ERROR: Failed decoding audio clip" for each
-`JoydleSplash/*.wav` in every build. `funtools doctor` fails on them and says where to pull.
-
-## What they do not give
-
-What each game still writes by hand (§1): import rules (or `funtools gen --unity`'s, for what it
-makes), the `SceneBuilder`, the TMP font builder, capture tools, the launch-flag dev gate, a safe-area
-root off `UiKit`, the frame governor, saves, Firebase's Simulator stubs (its C++ SDK has no arm64
-Simulator slice), a smoke driver and a UI audit. The repository's scripts are not in the packages.
-
-## Rules for changing them
-
-- Fix a shared bug in the package, once, never in one game's copy. The pop and the AudioListener fixes
-  reached four games at once; the purchase double grant lived on one branch while four games still had
-  it (§1).
-- A change to the build pipeline every game shares (`BuildTools`) comes with a per-game opt-in marker,
-  as `JoydleLz4hc.txt` does, and a person looks before it lands (§10).
-- Additive only: a game built on 0.1.0 keeps building.
-- `BuildTools.TestFlight` signs automatically for the studio's own Apple team (KBAT76634X), and
-  `ApplyIOS` writes its company name. A game for another team needs its own build method until the
-  package takes a team per game.

package/plugins/codex/skills/funpixel-unity-game/references/studio-packages.md

@@ -1,127 +0,0 @@
-# The studio's Unity packages
-
-The studio's two packages, `com.joydle.core` (0.1.0) and `com.joydle.firebase`, are optional: the
-games inside its repository use both, Knockout Lap, Gallery Heist and Particle Rush the core only,
-and Floe Jam neither. They live in that repository, `joydle/joydle-games` (private: the person needs
-read access), under `packages/`. A game that uses them never writes their pieces again. The field report's starter
-is "the SDK wired, switched off" (Starter project), and a fix made in the package reached every game at
-once (§1). Read as of 9 Oct 2026, from the packages' own code; what changes there wins over this page.
-
-## Adding them
-
-Every project lists them by `file:` path. Inside the repository that is `file:../../../packages/…`;
-the three outside it (Knockout Lap, Gallery Heist, Particle Rush) use `file:../../joydle-games/packages/…`
-(Knockout Lap, one folder deeper, `../../../`), so `joydle-games` must be cloned beside them, and
-`funtools doctor` warns when the path is missing. A git URL pinned to a commit needs no sibling
-clone (`#main` moves under a store build); no project uses one yet. Run `git lfs install` first: the splash's pictures and sounds are LFS files, and without it they arrive as
-pointer files. Inside the repository the same holds for a checkout whose LFS files were never pulled.
-`funtools doctor` in the game finds pointer files in Assets, Packages, every local package and the
-package cache, and names the repository to run `git lfs pull` in; run it before a build.
-
-```json
-"dependencies": {
-  "com.joydle.core": "file:../../joydle-games/packages/com.joydle.core",
-  "com.joydle.firebase": "file:../../joydle-games/packages/com.joydle.firebase",
-  "com.unity.inputsystem": "1.20.0",
-  "com.unity.render-pipelines.universal": "17.6.0",
-  "com.unity.test-framework": "1.8.0",
-  "com.unity.ugui": "2.6.0"
-}
-```
-
-The pinned form is `https://github.com/joydle/joydle-games.git?path=/packages/com.joydle.core#<commit>`.
-
-- `com.unity.inputsystem` goes in the game's own manifest: the core's assembly references it and its
-  `package.json` does not pull it in. Set the player to the new Input System only.
-- `com.unity.purchasing` 5.4.3 comes with the core (StoreKit 2 on iOS, Play Billing on Android).
-- The Firebase package needs Google's packages at 13.17.0 (app, analytics, crashlytics) and the External
-  Dependency Manager 1.2.189. The games repository keeps their `.tgz` files in `packages/vendor/` (LFS)
-  and lists them by `file:` path; another project keeps the same versions in its own folder, in LFS.
-  Each game has its own Firebase project, with its config file under `Assets/`.
-- Take out what no game uses: collab-proxy, learn, visual scripting, the Aseprite and PSD importers
-  (Scrap Riot also dropped 2D animation, sprite shape, tilemap extras and timeline: 88 → 78 MiB). Keep
-  what a game uses: Gallery Heist loads its rooms through Addressables 4.1 (built into the app, no
-  remote catalog) and aims its camera with Cinemachine 6.6, beside VFX Graph, Splines and Timeline.
-  No game uses DOTween (`Juice` tweens).
-
-## What each piece gives, and the rule it settles
-
-Editor side of `com.joydle.core`:
-
-| Piece | What it does | Settles |
-|---|---|---|
-| `ProjectConfig.ApplyIOS(name, bundleId, version, landscape)` | Company name, bundle id, IL2CPP, iOS 16, iPhone only, a fixed orientation, status bar hidden, Unity splash off; switches the build target to iOS | settings by script, not a copied file (`funpixel-unity-game` step 6). It does not set colour space, 48 kHz, render scale, ProMotion, the accelerometer or physics: `Setup.Configure` sets those after it |
-| `ProjectConfig.ApplyAndroid(packageName)` | API 26 to 36 (pinned), ARM64, IL2CPP, App Category game, GameActivity, full screen under cutouts, R8 off (it strips Firebase and purchase classes reached by reflection) | the Android half of the same rule |
-| `BuildTools.Simulator`, `SimulatorDev`, `SimulatorMuted`, `Device`, `TestFlight` | Headless iOS builds (`-executeMethod Joydle.Core.Editor.BuildTools.TestFlight`) into `Builds/iOS-sim` or `Builds/iOS`. Every build applies the size settings (stripping High, engine stripping, IL2CPP OptimizeSize, unused mesh channels off); LZ4HC when `ProjectSettings/JoydleLz4hc.txt` exists. `TestFlight` sets the studio's team and automatic signing, and the build number (`JOYDLE_BUILD_NUMBER`, else a `yyMMddHHmm` stamp) and refuses to build without `Assets/_Game/Art/Icon/app_icon.png`. `SimulatorMuted` turns audio off for that one build and restores it | size settings and LZ4HC ([performance](performance.md) step 8); the icon gate (Porcelain Panic shipped Unity's default icon); the CoreAudio wedge on a Simulator relaunched many times |
-| `BuildTools.Android`, `AndroidApk`, `AndroidDev`, `VersionCode()` | A signed `.aab` with its symbols (refuses without `JOYDLE_KEYSTORE` and `JOYDLE_KEYSTORE_PASS`); a release `.apk` for tests that reads launch args (never upload it); versionCode = minutes since 1 Jan 2026, because the iOS stamp is over Play's 2,100,000,000 cap | Android, planned in the report and built since (§15) |
-| `IosPostprocess` | Writes `ITSAppUsesNonExemptEncryption` false and stamps every embedded framework's minimum OS with the app's | ITMS-90208 (`funpixel-store`) |
-| `JoydleLaunch` | A black launch storyboard under its own name, for games that play the splash | iOS caches a launch screen by name across updates (§10) |
-| `SplashImport` | Splash parts scaled to a power of two, mipmapped, compressed | 10.3 MB of raw splash in every game, now about 2.6 MB |
-| `TextureBudget` | Textures named `model__basecolor.png` (and `__normal`, `__mr`, `__emissive`) under an `Art/` or `Models/` folder: ASTC 6×6, mipmaps, sRGB only for base colour and emissive, at most 512 under `Food/`, `Props/` or `Characters/`, else 1024 | glTFast's raw RGBA32 model textures (`funpixel-3d`, Unity page) |
-| `AndroidManifestPost` | Adds the vibrate permission the haptics need | |
-
-Runtime side of `com.joydle.core`:
-
-| Piece | What it does | Settles |
-|---|---|---|
-| `Sfx.Create(music)`, `Play(clip, volume)`, `Sfx.EnsureListener()` | 8 pooled one-shots with pitch jitter 0.06, one looping music source at 0.45, and exactly one AudioListener | the four silent TestFlight builds (`funpixel-audio`, Unity page, step 1) |
-| `Haptics.Light`, `Medium`, `Heavy`, `Success`, `Error` | iOS taptics through the package's native plugin, Android vibration effects; off when `Settings.Haptics` is | haptics by strength (`funpixel-game-feel`, Unity page). The 80–90 ms throttle and the 120 ms merge are the game's |
-| `Juice.Tween`, `Pop`, `Shake`, `EaseOutBack`, `EaseOutCubic`, `EaseInQuad`, `Ring`, `Dot`, `Rounded` | Coroutine tweens with the defaults the games used (pop 0.18 over 0.22 s, shake 0.08 over 0.25 s); a pop keeps the true rest scale | the compounding pop, fixed once for every game |
-| `UiKit` | A canvas scaled at 1170×2532 (match 0.5), a `Safe` rect from `Screen.safeArea`, rounded panels, text, buttons that pop, modal cards, a dim layer, `FitToContent`; text and images take no taps | the code-built UI and the Restore label that covered the shop card (`funpixel-mobile-ui`, Unity page). `Safe` is read once when the kit is made, and the landscape island-side rule is not in it |
-| `LaunchArgs.Get()` | Launch arguments: on iOS from the native process (Mono never sees `simctl launch` args), on Android from the intent extra `joydle_args`, in development builds and test APKs only | the basis of every automation flag. On iOS it is not gated: read it through the game's own wrapper that returns nothing unless `Debug.isDebugBuild` (Scrap Riot's), or a release build obeys an unlock flag (§1) |
-| `Settings.Music`, `Sound`, `Haptics` | The three player toggles, kept in PlayerPrefs | |
-| `Telemetry.Event`, `LevelStart`, `LevelEnd`, `TutorialComplete`, `ShopOpen`, `Log`; `Telemetry.Muted` | The one analytics and crash boundary; logs to the console in a development build with no sink | mute it under every dev flag: autoplay and capture runs must not reach analytics |
-| `IapService(catalog, grant)` with `Init`, `Buy`, `Restore(done)`, `Price`, `Refetch` | Unity IAP 5. Grants in the pending-order handler once per transaction, then confirms; non-consumables come back from confirmed orders on every fetch; `Restore(done)` asks StoreKit to sync on iOS and answers true or false; `Price` is the store's localised string | the double grant (fixed on main on 7 Oct; a game built before needs a new build), Restore that ends (`funpixel-store`) |
-| `Ads.CreateDefault(font)`, `Ads.Available`, `Ads.ShouldShowInterstitial(level, noAds)` | Test ads in development builds and the Editor, none in release; interstitials from level 15, every third level, never for a No Ads buyer | hide every ad button and No Ads while `Ads.Service` is null |
-| `JoydleSplash` | The studio splash, 4.25 s, tap to skip after 1 s. A game opts in with a text asset `Resources/JoydleSplashOn`; it holds the game's audio, waits for the first scene and 10 smooth frames (1 s floor, 3 s cap), and is skipped in the Editor and on any launch with a `-flag` (`-splash` forces it); `JoydleSplash.Playing` says when it is up | "add joydle splash … as we did for other games" (the owner, twice) |
-| `BackButton.PressedThisFrame`, `AndroidSystem.MoveToBack()`, `AndroidSystem.Density` | Android Back read from input events, since Back arrives pressed and released inside one frame and polling misses it; leave the app from the root screen; the dp scale | |
-
-`com.joydle.firebase` boots itself before the first scene and installs Analytics and Crashlytics as
-`Telemetry`'s sink (uncaught exceptions are fatal reports); the Editor keeps the console. It hands its
-`link.xml` to the linker and marks its assembly always linked, because High stripping removed it and
-Firebase never started in release builds (3 broken uploads). It pins the no-tracking setup: no
-advertising identifier and no ad personalisation in the iOS plist, the advertising-id and ad-services
-permissions removed on Android. That is what lets the privacy answers say nothing is used for
-tracking, with no tracking prompt.
-
-## A studio splash
-
-A game never makes its own splash or a "Funpixel presents" card, package or not: the opening belongs
-to the studio that makes the game, or to nothing. A studio's splash comes from its package, so one
-fix reaches every game. Today
-that is Joydle Core's `Joydle.Core.JoydleSplash` (read from its code on 10 Oct 2026; the code wins
-over this table). A project on another studio's package wires that package's splash the same way; a
-project with none ships no splash.
-
-| Day-one rule | How `JoydleSplash` does it |
-|---|---|
-| Opt in, once | A text asset that `Resources.Load<TextAsset>("JoydleSplashOn")` finds, such as `Assets/_Game/Resources/JoydleSplashOn.txt` (the games write one line: what it does and "Delete this file to turn it off"), with its `.meta` committed. Nothing else is called: the package boots it before the first scene loads (`RuntimeInitializeOnLoadMethod(BeforeSceneLoad)`) |
-| Before the first scene, on top | A `DontDestroyOnLoad` object with an overlay canvas at sorting order 32000. It waits for the first scene and 10 smooth frames (1 s floor, 3 s cap), then plays 4.25 s; a tap skips it after 1 s. On iOS `JoydleLaunch` makes the launch screen the black it opens on |
-| Holds the game's audio | `AudioListener.pause` is true until it ends; its own sounds ignore the pause and follow `Settings.Sound` |
-| Skipped in the Editor and on any flag | `Application.isEditor`, or any argument from `LaunchArgs.Get()` that starts with `-` (every automation, capture and test launch passes one); `-splash` forces it, to see it on the Simulator |
-| Title music waits | `JoydleSplash.Playing` is true from before the first scene until the fade ends (false when it was skipped): start the title music once it is false. Pocket Crew also hides its loading view while it is up |
-| The studio credit | Every credit line (Settings, About, an end card) names the studio, Joydle, and never Funpixel |
-
-Its pictures and sounds are LFS files under the package's `Runtime/Resources/JoydleSplash/`. On a Mac
-where the studio repository's LFS files were not pulled they are pointer text: the splash draws
-blank parts and stays silent, and Unity logs "FSBTool ERROR: Failed decoding audio clip" for each
-`JoydleSplash/*.wav` in every build. `funtools doctor` fails on them and says where to pull.
-
-## What they do not give
-
-What each game still writes by hand (§1): import rules (or `funtools gen --unity`'s, for what it
-makes), the `SceneBuilder`, the TMP font builder, capture tools, the launch-flag dev gate, a safe-area
-root off `UiKit`, the frame governor, saves, Firebase's Simulator stubs (its C++ SDK has no arm64
-Simulator slice), a smoke driver and a UI audit. The repository's scripts are not in the packages.
-
-## Rules for changing them
-
-- Fix a shared bug in the package, once, never in one game's copy. The pop and the AudioListener fixes
-  reached four games at once; the purchase double grant lived on one branch while four games still had
-  it (§1).
-- A change to the build pipeline every game shares (`BuildTools`) comes with a per-game opt-in marker,
-  as `JoydleLz4hc.txt` does, and a person looks before it lands (§10).
-- Additive only: a game built on 0.1.0 keeps building.
-- `BuildTools.TestFlight` signs automatically for the studio's own Apple team (KBAT76634X), and
-  `ApplyIOS` writes its company name. A game for another team needs its own build method until the
-  package takes a team per game.

package/plugins/cursor/skills/funpixel-unity-game/references/studio-packages.md

@@ -1,127 +0,0 @@
-# The studio's Unity packages
-
-The studio's two packages, `com.joydle.core` (0.1.0) and `com.joydle.firebase`, are optional: the
-games inside its repository use both, Knockout Lap, Gallery Heist and Particle Rush the core only,
-and Floe Jam neither. They live in that repository, `joydle/joydle-games` (private: the person needs
-read access), under `packages/`. A game that uses them never writes their pieces again. The field report's starter
-is "the SDK wired, switched off" (Starter project), and a fix made in the package reached every game at
-once (§1). Read as of 9 Oct 2026, from the packages' own code; what changes there wins over this page.
-
-## Adding them
-
-Every project lists them by `file:` path. Inside the repository that is `file:../../../packages/…`;
-the three outside it (Knockout Lap, Gallery Heist, Particle Rush) use `file:../../joydle-games/packages/…`
-(Knockout Lap, one folder deeper, `../../../`), so `joydle-games` must be cloned beside them, and
-`funtools doctor` warns when the path is missing. A git URL pinned to a commit needs no sibling
-clone (`#main` moves under a store build); no project uses one yet. Run `git lfs install` first: the splash's pictures and sounds are LFS files, and without it they arrive as
-pointer files. Inside the repository the same holds for a checkout whose LFS files were never pulled.
-`funtools doctor` in the game finds pointer files in Assets, Packages, every local package and the
-package cache, and names the repository to run `git lfs pull` in; run it before a build.
-
-```json
-"dependencies": {
-  "com.joydle.core": "file:../../joydle-games/packages/com.joydle.core",
-  "com.joydle.firebase": "file:../../joydle-games/packages/com.joydle.firebase",
-  "com.unity.inputsystem": "1.20.0",
-  "com.unity.render-pipelines.universal": "17.6.0",
-  "com.unity.test-framework": "1.8.0",
-  "com.unity.ugui": "2.6.0"
-}
-```
-
-The pinned form is `https://github.com/joydle/joydle-games.git?path=/packages/com.joydle.core#<commit>`.
-
-- `com.unity.inputsystem` goes in the game's own manifest: the core's assembly references it and its
-  `package.json` does not pull it in. Set the player to the new Input System only.
-- `com.unity.purchasing` 5.4.3 comes with the core (StoreKit 2 on iOS, Play Billing on Android).
-- The Firebase package needs Google's packages at 13.17.0 (app, analytics, crashlytics) and the External
-  Dependency Manager 1.2.189. The games repository keeps their `.tgz` files in `packages/vendor/` (LFS)
-  and lists them by `file:` path; another project keeps the same versions in its own folder, in LFS.
-  Each game has its own Firebase project, with its config file under `Assets/`.
-- Take out what no game uses: collab-proxy, learn, visual scripting, the Aseprite and PSD importers
-  (Scrap Riot also dropped 2D animation, sprite shape, tilemap extras and timeline: 88 → 78 MiB). Keep
-  what a game uses: Gallery Heist loads its rooms through Addressables 4.1 (built into the app, no
-  remote catalog) and aims its camera with Cinemachine 6.6, beside VFX Graph, Splines and Timeline.
-  No game uses DOTween (`Juice` tweens).
-
-## What each piece gives, and the rule it settles
-
-Editor side of `com.joydle.core`:
-
-| Piece | What it does | Settles |
-|---|---|---|
-| `ProjectConfig.ApplyIOS(name, bundleId, version, landscape)` | Company name, bundle id, IL2CPP, iOS 16, iPhone only, a fixed orientation, status bar hidden, Unity splash off; switches the build target to iOS | settings by script, not a copied file (`funpixel-unity-game` step 6). It does not set colour space, 48 kHz, render scale, ProMotion, the accelerometer or physics: `Setup.Configure` sets those after it |
-| `ProjectConfig.ApplyAndroid(packageName)` | API 26 to 36 (pinned), ARM64, IL2CPP, App Category game, GameActivity, full screen under cutouts, R8 off (it strips Firebase and purchase classes reached by reflection) | the Android half of the same rule |
-| `BuildTools.Simulator`, `SimulatorDev`, `SimulatorMuted`, `Device`, `TestFlight` | Headless iOS builds (`-executeMethod Joydle.Core.Editor.BuildTools.TestFlight`) into `Builds/iOS-sim` or `Builds/iOS`. Every build applies the size settings (stripping High, engine stripping, IL2CPP OptimizeSize, unused mesh channels off); LZ4HC when `ProjectSettings/JoydleLz4hc.txt` exists. `TestFlight` sets the studio's team and automatic signing, and the build number (`JOYDLE_BUILD_NUMBER`, else a `yyMMddHHmm` stamp) and refuses to build without `Assets/_Game/Art/Icon/app_icon.png`. `SimulatorMuted` turns audio off for that one build and restores it | size settings and LZ4HC ([performance](performance.md) step 8); the icon gate (Porcelain Panic shipped Unity's default icon); the CoreAudio wedge on a Simulator relaunched many times |
-| `BuildTools.Android`, `AndroidApk`, `AndroidDev`, `VersionCode()` | A signed `.aab` with its symbols (refuses without `JOYDLE_KEYSTORE` and `JOYDLE_KEYSTORE_PASS`); a release `.apk` for tests that reads launch args (never upload it); versionCode = minutes since 1 Jan 2026, because the iOS stamp is over Play's 2,100,000,000 cap | Android, planned in the report and built since (§15) |
-| `IosPostprocess` | Writes `ITSAppUsesNonExemptEncryption` false and stamps every embedded framework's minimum OS with the app's | ITMS-90208 (`funpixel-store`) |
-| `JoydleLaunch` | A black launch storyboard under its own name, for games that play the splash | iOS caches a launch screen by name across updates (§10) |
-| `SplashImport` | Splash parts scaled to a power of two, mipmapped, compressed | 10.3 MB of raw splash in every game, now about 2.6 MB |
-| `TextureBudget` | Textures named `model__basecolor.png` (and `__normal`, `__mr`, `__emissive`) under an `Art/` or `Models/` folder: ASTC 6×6, mipmaps, sRGB only for base colour and emissive, at most 512 under `Food/`, `Props/` or `Characters/`, else 1024 | glTFast's raw RGBA32 model textures (`funpixel-3d`, Unity page) |
-| `AndroidManifestPost` | Adds the vibrate permission the haptics need | |
-
-Runtime side of `com.joydle.core`:
-
-| Piece | What it does | Settles |
-|---|---|---|
-| `Sfx.Create(music)`, `Play(clip, volume)`, `Sfx.EnsureListener()` | 8 pooled one-shots with pitch jitter 0.06, one looping music source at 0.45, and exactly one AudioListener | the four silent TestFlight builds (`funpixel-audio`, Unity page, step 1) |
-| `Haptics.Light`, `Medium`, `Heavy`, `Success`, `Error` | iOS taptics through the package's native plugin, Android vibration effects; off when `Settings.Haptics` is | haptics by strength (`funpixel-game-feel`, Unity page). The 80–90 ms throttle and the 120 ms merge are the game's |
-| `Juice.Tween`, `Pop`, `Shake`, `EaseOutBack`, `EaseOutCubic`, `EaseInQuad`, `Ring`, `Dot`, `Rounded` | Coroutine tweens with the defaults the games used (pop 0.18 over 0.22 s, shake 0.08 over 0.25 s); a pop keeps the true rest scale | the compounding pop, fixed once for every game |
-| `UiKit` | A canvas scaled at 1170×2532 (match 0.5), a `Safe` rect from `Screen.safeArea`, rounded panels, text, buttons that pop, modal cards, a dim layer, `FitToContent`; text and images take no taps | the code-built UI and the Restore label that covered the shop card (`funpixel-mobile-ui`, Unity page). `Safe` is read once when the kit is made, and the landscape island-side rule is not in it |
-| `LaunchArgs.Get()` | Launch arguments: on iOS from the native process (Mono never sees `simctl launch` args), on Android from the intent extra `joydle_args`, in development builds and test APKs only | the basis of every automation flag. On iOS it is not gated: read it through the game's own wrapper that returns nothing unless `Debug.isDebugBuild` (Scrap Riot's), or a release build obeys an unlock flag (§1) |
-| `Settings.Music`, `Sound`, `Haptics` | The three player toggles, kept in PlayerPrefs | |
-| `Telemetry.Event`, `LevelStart`, `LevelEnd`, `TutorialComplete`, `ShopOpen`, `Log`; `Telemetry.Muted` | The one analytics and crash boundary; logs to the console in a development build with no sink | mute it under every dev flag: autoplay and capture runs must not reach analytics |
-| `IapService(catalog, grant)` with `Init`, `Buy`, `Restore(done)`, `Price`, `Refetch` | Unity IAP 5. Grants in the pending-order handler once per transaction, then confirms; non-consumables come back from confirmed orders on every fetch; `Restore(done)` asks StoreKit to sync on iOS and answers true or false; `Price` is the store's localised string | the double grant (fixed on main on 7 Oct; a game built before needs a new build), Restore that ends (`funpixel-store`) |
-| `Ads.CreateDefault(font)`, `Ads.Available`, `Ads.ShouldShowInterstitial(level, noAds)` | Test ads in development builds and the Editor, none in release; interstitials from level 15, every third level, never for a No Ads buyer | hide every ad button and No Ads while `Ads.Service` is null |
-| `JoydleSplash` | The studio splash, 4.25 s, tap to skip after 1 s. A game opts in with a text asset `Resources/JoydleSplashOn`; it holds the game's audio, waits for the first scene and 10 smooth frames (1 s floor, 3 s cap), and is skipped in the Editor and on any launch with a `-flag` (`-splash` forces it); `JoydleSplash.Playing` says when it is up | "add joydle splash … as we did for other games" (the owner, twice) |
-| `BackButton.PressedThisFrame`, `AndroidSystem.MoveToBack()`, `AndroidSystem.Density` | Android Back read from input events, since Back arrives pressed and released inside one frame and polling misses it; leave the app from the root screen; the dp scale | |
-
-`com.joydle.firebase` boots itself before the first scene and installs Analytics and Crashlytics as
-`Telemetry`'s sink (uncaught exceptions are fatal reports); the Editor keeps the console. It hands its
-`link.xml` to the linker and marks its assembly always linked, because High stripping removed it and
-Firebase never started in release builds (3 broken uploads). It pins the no-tracking setup: no
-advertising identifier and no ad personalisation in the iOS plist, the advertising-id and ad-services
-permissions removed on Android. That is what lets the privacy answers say nothing is used for
-tracking, with no tracking prompt.
-
-## A studio splash
-
-A game never makes its own splash or a "Funpixel presents" card, package or not: the opening belongs
-to the studio that makes the game, or to nothing. A studio's splash comes from its package, so one
-fix reaches every game. Today
-that is Joydle Core's `Joydle.Core.JoydleSplash` (read from its code on 10 Oct 2026; the code wins
-over this table). A project on another studio's package wires that package's splash the same way; a
-project with none ships no splash.
-
-| Day-one rule | How `JoydleSplash` does it |
-|---|---|
-| Opt in, once | A text asset that `Resources.Load<TextAsset>("JoydleSplashOn")` finds, such as `Assets/_Game/Resources/JoydleSplashOn.txt` (the games write one line: what it does and "Delete this file to turn it off"), with its `.meta` committed. Nothing else is called: the package boots it before the first scene loads (`RuntimeInitializeOnLoadMethod(BeforeSceneLoad)`) |
-| Before the first scene, on top | A `DontDestroyOnLoad` object with an overlay canvas at sorting order 32000. It waits for the first scene and 10 smooth frames (1 s floor, 3 s cap), then plays 4.25 s; a tap skips it after 1 s. On iOS `JoydleLaunch` makes the launch screen the black it opens on |
-| Holds the game's audio | `AudioListener.pause` is true until it ends; its own sounds ignore the pause and follow `Settings.Sound` |
-| Skipped in the Editor and on any flag | `Application.isEditor`, or any argument from `LaunchArgs.Get()` that starts with `-` (every automation, capture and test launch passes one); `-splash` forces it, to see it on the Simulator |
-| Title music waits | `JoydleSplash.Playing` is true from before the first scene until the fade ends (false when it was skipped): start the title music once it is false. Pocket Crew also hides its loading view while it is up |
-| The studio credit | Every credit line (Settings, About, an end card) names the studio, Joydle, and never Funpixel |
-
-Its pictures and sounds are LFS files under the package's `Runtime/Resources/JoydleSplash/`. On a Mac
-where the studio repository's LFS files were not pulled they are pointer text: the splash draws
-blank parts and stays silent, and Unity logs "FSBTool ERROR: Failed decoding audio clip" for each
-`JoydleSplash/*.wav` in every build. `funtools doctor` fails on them and says where to pull.
-
-## What they do not give
-
-What each game still writes by hand (§1): import rules (or `funtools gen --unity`'s, for what it
-makes), the `SceneBuilder`, the TMP font builder, capture tools, the launch-flag dev gate, a safe-area
-root off `UiKit`, the frame governor, saves, Firebase's Simulator stubs (its C++ SDK has no arm64
-Simulator slice), a smoke driver and a UI audit. The repository's scripts are not in the packages.
-
-## Rules for changing them
-
-- Fix a shared bug in the package, once, never in one game's copy. The pop and the AudioListener fixes
-  reached four games at once; the purchase double grant lived on one branch while four games still had
-  it (§1).
-- A change to the build pipeline every game shares (`BuildTools`) comes with a per-game opt-in marker,
-  as `JoydleLz4hc.txt` does, and a person looks before it lands (§10).
-- Additive only: a game built on 0.1.0 keeps building.
-- `BuildTools.TestFlight` signs automatically for the studio's own Apple team (KBAT76634X), and
-  `ApplyIOS` writes its company name. A game for another team needs its own build method until the
-  package takes a team per game.