@funpixel/tools 0.1.0 → 0.1.1

package/plugins/kiro/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/robin/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/robin/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/templates/common/.agents/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.