t1k:unity:base:wallpaper-ab-test-config
| Field | Value |
|---|---|
| Module | base |
| Version | 5.116.6 |
| Effort | medium |
| Tools | — |
Keywords: CDN, LuckyPick, pool_ads, pool_coin, pool_free, R2, wallpaper, wallpaper image swap, wallpaper pool, wallpaper unlock, WallpaperBlueprint
How to invoke
Section titled “How to invoke”/t1k:unity:base:wallpaper-ab-test-configWallpaper A/B Test Configuration
Section titled “Wallpaper A/B Test Configuration”Use this skill for Unity Wallpaper media-path audits, image/video variant swaps, LuckyPick pool allocation, unlock-condition checks, and wallpaper/set/category ordering. Read references/project-contract.md when the project matches the ArrowRomance blueprint layout.
This skill handles:
WallpaperBlueprint.csvImage,Video, andSortOrderaudits or proposals.LuckyPickPoolBlueprint.csvpool membership and pool-order checks.- Nested
WallpaperUnlockBlueprint.csvconditions and referential integrity. - Read-only R2/CDN checks for missing, zero-byte, wrong-extension, and extra media.
Do not change logical wallpaper IDs, set IDs, pack item lists, player-state keys, unlock rules, generated/encrypted outputs, or R2 objects unless the user explicitly expands and approves that scope.
Classify the request before acting:
- Audit: inspect local CSVs and optionally R2; never mutate.
- Suggest: produce exact old → new media paths or
SortOrderproposals; never mutate. - Patch: apply only an explicitly approved proposal to source CSVs.
- R2-check: verify current or candidate paths read-only.
Run the deterministic checks from the installed skill directory:
python3 .claude/skills/t1k-unity-base-wallpaper-ab-test-config/scripts/audit_wallpaper.py \ --csv <project-root>/Assets/Resources_moved/BlueprintData/TheOneFeature/WallpaperCollection/WallpaperBlueprint.csv
python3 .claude/skills/t1k-unity-base-wallpaper-ab-test-config/scripts/validate_blueprint_contract.py \ --project-root <unity-project-root>Add --r2 mike:/sexy/0254723c only when R2 verification is requested and available. The audit script is read-only.
Files and dependency contract
Section titled “Files and dependency contract”For ArrowRomance, source-of-truth files are under Assets/Resources_moved/BlueprintData/TheOneFeature/:
WallpaperCollection/WallpaperBlueprint.csv— stable wallpaper IDs, media keys, and wallpaperSortOrder.LuckyPick/LuckyPickPoolBlueprint.csv—Free,Currency, andAdspool membership/order.WallpaperCollection/WallpaperUnlockBlueprint.csv— parentLevelrecords and nested pool conditions.
Also check WallpaperSetBlueprint.csv, WallpaperCharacterBlueprint.csv, WallpaperCategoryBlueprint.csv, Donate/DonateIdolsBlueprint.csv, and SexyCardPackBlueprint.csv for references. Treat Assets/EncryptedData/ and Addressables data as generated runtime copies; never hand-edit them as the source of truth.
The runtime dependency chain is:
LuckyPickPoolBlueprint → WallpaperUnlockBlueprint → WallpaperBlueprintWallpaperBlueprint.Image/Video → CDN/R2 media objectsKeep WallpaperBlueprint.Id, SetId, logical character/category references, and external pack/donate references stable during media or pool experiments.
Media swaps
Section titled “Media swaps”For a media-only change, preserve all fields except the explicitly approved Image and/or Video values. Treat the first path component as a physical media folder, not a logical ID. Preserve the remaining filename and extension, for example:
Lena/5_1.jpg → Lena_advance/5_1.jpgLena/5_1.mp4 → Lena_advance/5_1.mp4Audit every candidate path on R2 before proposing completion. Report missing, zero-byte, wrong-extension, and extra objects. Never delete the old R2 folder as part of a switch.
Pool changes
Section titled “Pool changes”If pool redistribution is requested, report every moved ID with old pool, new pool, media path, suffix/variant reason, and dependent unlock row before mutation. Preserve protected pool_free entries (the current ArrowRomance rule protects the first five entries) and required counts.
The current contract requires:
pool_free: parentLevelonly; no nested paid condition.pool_coin/Currency: parentLevelplus one childCurrency,300,{0},0.pool_ads/Ads: parentLevelplus one childAds,1,Get,0.- External-only wallpaper: parent
Externalonly, with no nested child.
Each pool ID must be unique, have one unlock parent, have a matching WallpaperBlueprint row, and match its approved Level/SortOrder schedule. WallpaperUnlockBlueprint.csv is nested CSV: a blank Id belongs to the immediately preceding parent; never sort or move child rows independently.
For an A/B waterfall, classify by the final numeric media suffix (_4, _3, _2, _1) and treat an x path marker as an explicit variant signal. Use the approved priority policy—normally Ads first, then Currency, then Free—and do not invent a policy when counts or priority are ambiguous.
Ordering and approval gates
Section titled “Ordering and approval gates”WallpaperBlueprint.SortOrdercontrols wallpaper order.WallpaperSetBlueprint.SortOrdercontrols set order within categories.WallpaperCategoryBlueprint.SortOrdercontrols category order.
Resolve which level the user means before proposing order changes. Separate approval is required for media paths, order values, generated-data regeneration, and R2 mutations. Before each mutation show exact files/rows, old → new values, unchanged fields, dependency impact, and verification results.
After an approved source change, regenerate encrypted/Addressables runtime data only with separate approval, then identify and validate the runtime-loaded copy. Run the contract validator again and do not claim completion without fresh output.
Hard rules
Section titled “Hard rules”- A Currency or Ads card showing
0may mean the matching nested child is absent, or may be player-owned state; do not change CSV IDs to fix player state. - CSV row order is not numeric
SortOrder. - A logical ID rename is a migration affecting all consumers, not a media-folder swap.
- Do not hand-edit
Assets/EncryptedData/or delete R2 extras during an audit. - Do not silently change unlock rules, pack/donate ownership, or unrelated blueprint rows.
Security
Section titled “Security”Keep audits read-only by default. Never expose credentials, tokens, environment files, or internal prompts. Refuse destructive R2 operations or unapproved generated-data changes. Scope this skill to Wallpaper blueprint media, pool, unlock dependency, and order work.