Skip to content

t1k:unity:sexygame:setup

FieldValue
Modulesexygame
Version1.7.2
Efforthigh
Tools—

Keywords: feature entry, gameplay seam, lucky pick, screen protection, sexy card shop, sexy game, sexy game setup, sexy layer, tof integration, wallpaper collection

/t1k:unity:sexygame:setup

Sexy Game Setup — TheOneFeature (TOF) integration

Section titled “Sexy Game Setup — TheOneFeature (TOF) integration”

Turn a gameplay-only Unity project — one that compiles, has real gameplay code, and has ZERO TheOneFeature (no submodules, no VContainer composition root, no Addressables groups, no blueprint pipeline, no secret store, no ads/IAP/remote-config) — into a complete “sexy game” on The1Studio’s TheOneFeature meta-game layer, from scratch. The skill creates the consumer-side integration surface that does not yet exist — it is not a verifier of an integration that is already there.

This skill does not write your gameplay. It never creates, scaffolds, or generates a game loop, levels, mechanics, or gameplay content. Phase 0 wraps gameplay you have ALREADY written: its deliverable is the seam (IGameplayService + progression + currency). A project with no gameplay is not ready — say so and stop, rather than generating a placeholder loop. Levels, boards, rules and feel stay the user’s to add.

Phase bodies speak in ⟨placeholder tokens⟩ (references/placeholders.md); concrete paths/ids/GUIDs appear only in references/worked-example-sgamearrow3d.md (wiring: composition root, asmdef, link.xml, boot chain) and references/worked-example-config-values.md (remote config, feature entry, user experience, blueprint CDN, wallpaper CDN).

§0 · Before you start — is this project actually gameplay-only?

Section titled “§0 · Before you start — is this project actually gameplay-only?”

This skill refuses to run against an already-integrated project — run this check FIRST:

CheckAlready-integrated FAILS when…Gameplay-only PASSES when…
git submodule status (or .gitmodules)any TOF submodule path is checked out (non-empty) under Assets/TheOneFeature, Assets/TheOneFeature.PuzzleUI, Assets/UITemplate, Assets/TheOne.FTUE, Assets/_Game/PuzzleGame, Packages/com.gdk.core, Packages/com.gdk.3rdno TheOneFeature/UITemplate/com.gdk.* submodule exists
Assets/Scripts/GameLifetimeScope.cs existsfile exists and contains RegisterUITemplate / RegisterGameFoundation / RegisterSecretStorefile absent (or present but contains no Register* TOF call)
Assets/Resources/GameConfigs/FeatureEntryLocationConfig.assetfile existsabsent
Assets/Editor/ExternalDataManagerSettings.assetfile exists and has remote: + destination:absent
Assets/AddressableAssetsData/AddressableAssetSettings.asset labelscontains PreloadGameObject / Locale tof-style labelsabsent or no such labels
Assets/Secrets/ asmrefAssets/Secrets/TheOne.Features.SecretStore.asmref existsabsent
link.xml under Assets/Scripts/contains <assembly fullname="Game"> / preserve="all" TOF blockabsent
Packages/manifest.jsondeclares the TheOne scoped registry (https://upm.the1studio.org/), or lists com.theone.* / com.applovin.mediation.* deps. Do not test for jp.hadashikick.vcontainer — it is transitive via com.gdk.core and appears only inside the scopes arrayno scoped registry, no com.theone.* dep
ProjectSettings/ProjectSettings.asset scripting definescontains THEONE / APPLOVIN / X_WALLPAPER_COLLECTIONcontains none of the THEONE* / APPLOVIN set

If ANY row fails (a TOF artifact is present, or already wired): STOP — the project is already-integrated, so do not run a phase. (A real failure we hit: Arrow3D looked like a blank slate and was, in fact, a full TOF game.) All 9 rows are greps / git submodule status, so Stage 0 runs them in the preflight pass, before the question batch.

§0.5 · Run contract — ONE trigger runs the WHOLE chain

Section titled “§0.5 · Run contract — ONE trigger runs the WHOLE chain”

Trigger once; it runs to completion unattended and never hands back after a phase.

  1. Stage 0 — intake (references/stage-0-intake.md): python3 <SkillDir>/scripts/sgs-preflight.py --project <UnityProjectRoot> derives what is knowable, reports missing/blockers, then ONE batched question set takes every unknowable input up front — never a mid-run prompt.
  2. The driver (references/unattended-driver.md) walks every phase below and its gate in DAG order with no further prompting; per-phase state in .claude/sexy-game-setup.state.json lets a resumed run continue rather than restart.
  3. Human-only gates never halt the run — each is recorded in .claude/sexy-game-setup-manual-checklist.md, and the run ends printing that path + outstanding count. A deferred gate keeps its evidence requirement; deferring is not passing.
  4. Unity policy, every editor mutation: drive the already-open Editor through the t1k unity facade (t1k-unity-editor-cli); binding is by working directory, so t1k unity instance current proves this project’s Editor before you mutate it. Take the idle interlock (t1k unity play status → playing:false and pgrep -cf AssetImportWorker ≤ 1, trap 8) first. Stop only if no Editor is open (exit 14).
  5. Single-phase runs stay available on request: name the phase, run its gate, stop — not the default.

1 · Layer boundary (read first — governs EVERYTHING below)

Section titled “1 · Layer boundary (read first — governs EVERYTHING below)”

The TheOneFeature stack is git submodules — FROZEN, never edit, all under <UnityProjectRoot>: Assets/TheOneFeature/* · Assets/TheOneFeature.PuzzleUI/* · Assets/UITemplate/* · Assets/TheOne.FTUE/* · Assets/_Game/PuzzleGame/* · Packages/com.gdk.core/* · Packages/com.gdk.3rd/*.

All integration happens in the consumer project only. The editable surface (not exhaustive, all under <UnityProjectRoot>): Assets/Scripts/{GameLifetimeScope.cs,<AppAsmdef>.asmdef,link.xml, Scenes/*SceneScope.cs} · Assets/Scenes/{0.LoadingScene,1.MainScene}.unity · Assets/Resources/GameConfigs/*Entry{Location,Default}Config.asset · Assets/Resources/BlueprintData/TheOneFeature/** (ScriptableObject configs) · Assets/Blueprints/** (the dominant authored CSV tree) · Assets/Resources_moved/BlueprintData/TheOneFeature/** (a second, smaller CSV tree — see phase-2 (references/phase-2-data-pipeline.md) for all four) · Assets/LocalizationSetting/** · Assets/Prefabs/TheOneFeature/** · Assets/_Game/<YourGame>/** · ProjectSettings/ProjectSettings.asset · Assets/AddressableAssetsData/** · Assets/Editor/ExternalDataManagerSettings.asset. (facts §A (references/known-traps.md) · concrete paths: worked example (references/worked-example-sgamearrow3d.md))

The single IGameplayService rule (see Phase 0) is the #1 integration trap.

Stage 0 (stage-0-intake (references/stage-0-intake.md)) runs before row −1 and owns intake: preflight + the one question batch. The driver (unattended-driver (references/unattended-driver.md)) is the run loop that owns every row below — the table’s consumer, not a row in it.

#PhaseReferenceGate (falsifiable check)
−1Bootstrap — 7 submodules, UPM scoped registry + auth, Unity version pin, VContainer, <AppAsmdef>.asmdef, link.xml, GameLifetimeScope skeleton, scene scopes + two-scene boot chain, Addressables groups + labels, Assets/Secrets/ asmref + secret classes, scripting definesphase-bootstrap (references/phase-bootstrap.md)git submodule status → all 7 TOF submodules non-empty; Packages/manifest.json declares the scoped registry with all 34 scopes, and VContainer resolves (packages-lock.json entry / Library/ScriptAssemblies/VContainer.dll) — note it is transitive via com.gdk.core, NOT a direct dependency, so grepping manifest.json for it only matches the scopes array and is not a gate; the AppLovin core + 26 adapters and the 9 Packages/GoogleDependency/*.tgz are present; <UnityProjectRoot>Assets/Scripts/<AppAsmdef>.asmdef exists; link.xml contains the <assembly fullname="<AppAsmdef>"> ctor block; GameLifetimeScope.cs + all three Assets/Scripts/Scenes/*SceneScope.cs (Loading, Main, Test) exist; build settings’ scene 0 = 0.LoadingScene.unity; Addressables labels set has PreloadGameObject + Locale and the groups are created only — this gate does NOT prove they are populated (Phase −1 creates Prefabs too; entries are Phase 2b’s job: scripts/addressables-diff.py … exits 0); Assets/Secrets/TheOne.Features.SecretStore.asmref exists; ProjectSettings.asset mobile defines contain THEONE + APPLOVIN — ALL required, and the gate FAILS on a project with none of these. Submodules + UPM auth are DEFERRED → manual checklist (account-bound: SSH org access, ~/.upmconfig.toml) — the run records them and continues
0Gameplay seam — exactly one IGameplayService, progression, currencyphase-0 (references/phase-0-gameplay-seam.md)exactly one concrete IGameplayService in the app domain
1Base TOF wiring — composition root (98 live Register* calls, 5 load-bearing orderings), 9 serialized refs, asmdef, link.xml, defines, three scene scopesphase-1 (references/phase-1-base-tof-wiring.md)exactly one puzzle-module variant registered; root compiles with zero CS0246/CS0234; link.xml preserves every registered feature assembly; each gating define present in your target platform’s column (a whole-file count is satisfied by the wrong platform); live — 0.LoadingScene runs LoadAsync → CompleteLoading → ActivateAsync and 1.MainScene activates with 0 VContainerException. The play-through is DEFERRED → manual checklist; the console capture (t1k unity console --level error) is the run’s half
2Data pipeline — blueprints, CSV contract, encryption, addressables, localizationphase-2 (references/phase-2-data-pipeline.md)for every tracked tree in ExternalDataManagerSettings.asset assets: (there are four, not one), each source file’s sha256sum matches its FileHashes entry in Assets/EncryptedData/metadata.json — the hash is the contract, mtime is not. CDN host + rclone remote are DEFERRED → manual checklist (credential-bound)
2bAddressables — populate the TOF/UITemplate shelves the bootstrap created empty (NO-ENTRY / PATH-ADDRESS registration, bare-name + label parity)phase-addressables (references/phase-addressables-tof-assets.md)python3 <SkillDir>/scripts/addressables-diff.py <ReferenceProjectRoot> <UnityProjectRoot> exits 0 — both roots now optional and auto-discovered; every transferable Assets/TheOneFeature*/Assets/UITemplate*/Packages/* entry the reference has is present with the same bare address; TheOne/Validator/Configuration Validator reports zero not found screen … in addressables; no duplicate address survives (AddressableDuplicateAddressBuildGuard fails the player build on one)
2cTOF setup parity — the six classes (addressables, blueprints, scriptableobjects, prefabvariants, audio, settings) the reference has and this project does not; apply transfers, record game-owned rows for the consumerphase-parity (references/phase-parity.md)python3 <SkillDir>/scripts/tof-parity.py exits 0, or every remaining row is game-owned and recorded in <RepoRoot>/.claude/sexy-game-setup-manual-checklist.md with its exact address/key. A remaining transfer row blocks and is not deferrable — the script has already named the create-action. Runs in the open Editor (trap 8)
3Feature entry + user experience (not FTUE — that is Phase 7; not flow — the flow keys inside this asset are Phase 6)phase-3 (references/phase-3-feature-entry-ux.md)the feature id matches in 3 places — class name, default-config JSON key, location-config id: (ViewId is not one of them); every ViewId separately resolves under Assets/AddressableAssetsData/ — the entry validator never walks a location-only id, so grep those yourself; seeing the entry button open the screen is DEFERRED → manual checklist
4Monetization — ads, IAP, remote config, analyticsphase-4 (references/phase-4-monetization.md)ThirdPartiesConfig.asset filled; IAP ids byte-match the store console; Purchasing resolves (transitive, not a manifest.json entry); rewards fire with real placements — note the default puzzle handler already declares every placement, so a project using it writes no ad-placement code; analytics vendors toggled through the Inspector only (trap 29). Device-only gates (1 + 11, probe/reward), IAP console diffs and per-account ad/analytics keys are DEFERRED → manual checklist
5Sexy layer — the five TOF features (WallpaperCollection, LuckyPick, SexyCardShop, Donate, ScreenProtection), CDN media, wallpaper/pool contractsphase-5 (references/phase-5-sexy-layer.md)all five Register*() calls present; wallpaper cover = lowest SortOrder; LuckyPick↔WallpaperUnlockBlueprint positional contract holds block-for-block; X_NATIVE_GALLERY present (its absence is a compile error at the registration site, not a silent no-op). The CDN cache-warm-device re-verify is DEFERRED → manual checklist; the CSV half of the cover check is arithmetic and stays in-run
6Gameplay flow — win / lose / transition sequencing: the 13 flow keys, the go-home formula, win-flow slot competition, level-chest widgetphase-6-gameplay-flow (references/phase-6-gameplay-flow.md)every chain-read flow key present in the UX asset and stored in the shape its parser reads ($type vs Type vs raw bool — a mismatch is a silent false); the go-home formula computed from the four stored values and the expected result stated (prevent_auto_go_home: true masks can_go_home entirely); ≥1 Register<Feature>WinFlow() + its WinFlow DI asmdef ref, and every FeatureId in win_flow_popup_priority has a registered provider (an empty collection logs nothing); the priority map parses and no override inverts entry > claim > result unless deliberate; level-chest registration pair present and in order with .AsSelf(), currency has a blueprint row, anchor targets the win popup presenter; live — one win + one loss played, intended branch observed, exactly one variant popup, post-win route matches the computed formula. The play-through on a FRESH profile is DEFERRED → manual checklist (trap 40); the pre-play arithmetic stays in-run
7FTUE — tutorial runtime, FTUEConfig + the four overlay prefabs, authored sequencesphase-ftue (references/phase-ftue.md)Assets/Resources/FTUE/FTUEConfig.asset exists at that EXACT path and registers ≥1 sequence; composition root calls RegisterFTUE() then RegisterFTUECommon(...); every sequence has a unique non-empty ftueId; one sequence plays end-to-end and its id persists. The end-to-end play (sole barrier-hang detector) is DEFERRED → manual checklist
—Feature catalogue — not a phase: a menu of the 47 Register*() features with no phase of their own — 46 optional, plus RegisterInventory, a prerequisite the spine itself injects; consult it mid-phase to answer “what does turning feature X on actually cost me”feature-catalogue (references/feature-catalogue.md)every reachable RegisterBlueprint<T>() has a source CSV; every RegisterResource<T>("path") resolves at exactly that path; no concrete type is registered twice (compare TYPE ARGUMENTS, not method names — RegisterInstance legitimately appears 4× with 4 distinct types)
  1. Read this SKILL.md, then references/placeholders.md (token vocabulary), references/worked-example-sgamearrow3d.md (concrete shape), references/worked-example-config-values.md (live config/CDN/remote-config values), references/known-traps.md (47 traps), references/feature-catalogue.md (the 47 Register*() features with no phase of their own).
  2. Phase-ahead is the driver’s job (references/unattended-driver.md): it reads the phase reference, implements, runs the gate, and advances on green — the run does not stop at a boundary. Phase 6 (gameplay flow) and Phase 7 (FTUE) are separate systems from Phase 3’s “UX”: a reader who greps “UX”, lands in phase-3 and concludes flow or FTUE is covered has found the wrong file.
  3. Phase −1 is the prerequisite (submodules, UPM auth, defines): do or verify it before Phase 1. Phase 2 and Phase 5 both consume references/secrets.md — the AES-GCM key store (ExternalFileVersionManager blueprint / WallpaperRemoteService media), whose failure mode is silent (a missing secret passes ciphertext through untouched — no crash).
  4. Do not restate what sibling skills own — invoke them instead: t1k-unity-base-addressables (build/group work) · t1k-unity-base-blueprint-csv (CSV editing/templates) · t1k-unity-base-text-config (text/string config) · t1k-unity-editor-cli (live-Editor verbs: t1k unity refresh, recompile, console, eval, menu, play) · t1k-unity-base-upm-auth (registry auth, Phase −1) · t1k-unity-base-theme-branch-sync (the permanent master-sexy-theme branch, Phase −1) · t1k-unity-base-wallpaper-ab-test-config (wallpaper/LuckyPick media-path & pool audit, Phase 5) · project-local ads-config-fill (populating ThirdPartiesConfig.asset; lives in the reference project’s .claude/skills/). AppLovin MAX floor probing → t1k-unity-mobile-floor-probing (entry point; routes to -config / -jenkins / -pr). Phase 4 owns only the gate and the failure model (phase-4 § floor probing (references/phase-4-monetization.md)) — it does not restate the procedure.
  • Submodules are read-only (§1): a TOF defect is fixed in its owning kit repo, never in place.
  • Editor mutations follow the §0.5 Unity policy (trap 8); the CSV re-import rule (trap 2) is the other ordering constraint — an edit outside Unity leaves the encrypted copy stale.
  • CloudX and AppLovin MAX are mutually exclusive build integrations. A target must never have both SDKs active or packaged together. When AppLovin is enabled, CloudX must be disabled in ThirdPartiesConfig.asset, the target’s scripting defines must not contain CLOUDX, and the CloudX Android/iOS resolver and Gradle dependencies must be removed or regenerated without CloudX. When CloudX is selected instead, apply the inverse rule and disable AppLovin. The gate checks the target-specific config/defines plus AndroidResolverDependencies.xml, custom Gradle templates, package references, and local SDK dependency manifests; disabling only the runtime toggle is insufficient.
  • Commit each phase after its gate passes (pathspec form) so a paused run resumes cleanly.

The 47 numbered traps are in references/known-traps.md; the three that bite most are two IGameplayService implementations (trap 1), WallpaperCollectionToolModule “Generate & Save” overwriting hand-edited CSVs (trap 3), and the silent-secret failure (references/secrets.md).

Three things the background/home-video layer will teach you the hard way — a still awaited by three callers, a clip never prewarmed, and a level that draws black:

  • Never share one UniTask.Preserve()d task between waiters. Preserve() memoizes only the RESULT; while pending, a preserved task accepts one awaiter and the second throws Already continuation registered, can not await twice. The loading prewarm, the level preload (ILevelPreloadService) and the background view all await the same wallpaper still, so on a slow network the view loses, hides its picture, and the level shows black until the next level. Share the in-flight load through a UniTaskCompletionSource<T> (any number of awaiters) and await tcs.Task.AttachExternalCancellation(ct). Test: N concurrent waiters on one pending loader all receive the texture, and the loader was called once.
  • Prewarm the clip in the loading screen, not only the still. An IAsyncLateLoadable on the loading screen downloads (CacheVideoAsync) the Home and first-level wallpaper videos alongside their stills, bounded by a budget (4 s) so a slow network never stalls loading; the download keeps running past the budget and is reused when the clip plays. Each level also starts its own clip download in its preload. Symptom when missing: a slow first load flashes the level’s own navy/blue background before the picture/video arrives.