t1k:unity:sexygame:setup
| Field | Value |
|---|---|
| Module | sexygame |
| Version | 1.7.2 |
| Effort | high |
| Tools | — |
Keywords: feature entry, gameplay seam, lucky pick, screen protection, sexy card shop, sexy game, sexy game setup, sexy layer, tof integration, wallpaper collection
How to invoke
Section titled “How to invoke”/t1k:unity:sexygame:setupSexy 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:
| Check | Already-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.3rd | no TheOneFeature/UITemplate/com.gdk.* submodule exists |
Assets/Scripts/GameLifetimeScope.cs exists | file exists and contains RegisterUITemplate / RegisterGameFoundation / RegisterSecretStore | file absent (or present but contains no Register* TOF call) |
Assets/Resources/GameConfigs/FeatureEntryLocationConfig.asset | file exists | absent |
Assets/Editor/ExternalDataManagerSettings.asset | file exists and has remote: + destination: | absent |
Assets/AddressableAssetsData/AddressableAssetSettings.asset labels | contains PreloadGameObject / Locale tof-style labels | absent or no such labels |
Assets/Secrets/ asmref | Assets/Secrets/TheOne.Features.SecretStore.asmref exists | absent |
link.xml under Assets/Scripts/ | contains <assembly fullname="Game"> / preserve="all" TOF block | absent |
Packages/manifest.json | declares 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 array | no scoped registry, no com.theone.* dep |
ProjectSettings/ProjectSettings.asset scripting defines | contains THEONE / APPLOVIN / X_WALLPAPER_COLLECTION | contains 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.
- Stage 0 — intake (
references/stage-0-intake.md):python3 <SkillDir>/scripts/sgs-preflight.py --project <UnityProjectRoot>derives what is knowable, reportsmissing/blockers, then ONE batched question set takes every unknowable input up front — never a mid-run prompt. - 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.jsonlets a resumed run continue rather than restart. - 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. - Unity policy, every editor mutation: drive the already-open Editor through the
t1k unityfacade (t1k-unity-editor-cli); binding is by working directory, sot1k unity instance currentproves this project’s Editor before you mutate it. Take the idle interlock (t1k unity play status→playing:falseandpgrep -cf AssetImportWorker≤ 1, trap 8) first. Stop only if no Editor is open (exit 14). - 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.
2 · Phase table
Section titled “2 · Phase table”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.
| # | Phase | Reference | Gate (falsifiable check) |
|---|---|---|---|
| −1 | Bootstrap — 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 defines | phase-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 |
| 0 | Gameplay seam — exactly one IGameplayService, progression, currency | phase-0 (references/phase-0-gameplay-seam.md) | exactly one concrete IGameplayService in the app domain |
| 1 | Base TOF wiring — composition root (98 live Register* calls, 5 load-bearing orderings), 9 serialized refs, asmdef, link.xml, defines, three scene scopes | phase-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 |
| 2 | Data pipeline — blueprints, CSV contract, encryption, addressables, localization | phase-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) |
| 2b | Addressables — 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) |
| 2c | TOF 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 consumer | phase-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) |
| 3 | Feature 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 |
| 4 | Monetization — ads, IAP, remote config, analytics | phase-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 |
| 5 | Sexy layer — the five TOF features (WallpaperCollection, LuckyPick, SexyCardShop, Donate, ScreenProtection), CDN media, wallpaper/pool contracts | phase-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 |
| 6 | Gameplay flow — win / lose / transition sequencing: the 13 flow keys, the go-home formula, win-flow slot competition, level-chest widget | phase-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 |
| 7 | FTUE — tutorial runtime, FTUEConfig + the four overlay prefabs, authored sequences | phase-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) |
3 · How to use
Section titled “3 · How to use”- 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 47Register*()features with no phase of their own). - 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. - 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 (ExternalFileVersionManagerblueprint /WallpaperRemoteServicemedia), whose failure mode is silent (a missing secret passes ciphertext through untouched — no crash). - 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 permanentmaster-sexy-themebranch, Phase −1) ·t1k-unity-base-wallpaper-ab-test-config(wallpaper/LuckyPick media-path & pool audit, Phase 5) · project-localads-config-fill(populatingThirdPartiesConfig.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.
4 · Workflow constraints
Section titled “4 · Workflow constraints”- 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 containCLOUDX, 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 plusAndroidResolverDependencies.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.
Hard rules
Section titled “Hard rules”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 throwsAlready 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 aUniTaskCompletionSource<T>(any number of awaiters) and awaittcs.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
IAsyncLateLoadableon 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.