Skip to content

t1k:unity:base:wallpaper-ab-test-config

FieldValue
Modulebase
Version5.116.6
Effortmedium
Tools—

Keywords: CDN, LuckyPick, pool_ads, pool_coin, pool_free, R2, wallpaper, wallpaper image swap, wallpaper pool, wallpaper unlock, WallpaperBlueprint

/t1k:unity:base:wallpaper-ab-test-config

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.csv Image, Video, and SortOrder audits or proposals.
  • LuckyPickPoolBlueprint.csv pool membership and pool-order checks.
  • Nested WallpaperUnlockBlueprint.csv conditions 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:

  1. Audit: inspect local CSVs and optionally R2; never mutate.
  2. Suggest: produce exact old → new media paths or SortOrder proposals; never mutate.
  3. Patch: apply only an explicitly approved proposal to source CSVs.
  4. R2-check: verify current or candidate paths read-only.

Run the deterministic checks from the installed skill directory:

Terminal window
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.

For ArrowRomance, source-of-truth files are under Assets/Resources_moved/BlueprintData/TheOneFeature/:

  • WallpaperCollection/WallpaperBlueprint.csv — stable wallpaper IDs, media keys, and wallpaper SortOrder.
  • LuckyPick/LuckyPickPoolBlueprint.csv — Free, Currency, and Ads pool membership/order.
  • WallpaperCollection/WallpaperUnlockBlueprint.csv — parent Level records 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 → WallpaperBlueprint
WallpaperBlueprint.Image/Video → CDN/R2 media objects

Keep WallpaperBlueprint.Id, SetId, logical character/category references, and external pack/donate references stable during media or pool experiments.

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.jpg
Lena/5_1.mp4 → Lena_advance/5_1.mp4

Audit 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.

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: parent Level only; no nested paid condition.
  • pool_coin / Currency: parent Level plus one child Currency,300,{0},0.
  • pool_ads / Ads: parent Level plus one child Ads,1,Get,0.
  • External-only wallpaper: parent External only, 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.

  • WallpaperBlueprint.SortOrder controls wallpaper order.
  • WallpaperSetBlueprint.SortOrder controls set order within categories.
  • WallpaperCategoryBlueprint.SortOrder controls 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.

  • A Currency or Ads card showing 0 may 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.

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.