create-remix-game 1.2.11 → 1.2.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-remix-game",
-  "version": "1.2.11",
+  "version": "1.2.12",
   "description": "CLI for scaffolding Remix games",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",

package/templates/base/CLAUDE.md.template

@@ -172,21 +172,38 @@ window.FarcadeSDK.on('purchase_complete', (data: { success: boolean }) => {
 
 ### Purchased Items / Boost Tiers
 
-Check if player owns specific items (boost rewards):
+**IMPORTANT**: The `purchasedItems` array and `hasItem()` contain **reward IDs only**, NOT tier names.
 
 ```typescript
-// Check if player has a specific reward
+// ❌ WRONG - Tier names are NOT in purchasedItems
+if (window.FarcadeSDK.hasItem('tier-1')) { } // NEVER works in production
+if (window.FarcadeSDK.hasItem('tier-2')) { } // NEVER works in production
+if (window.FarcadeSDK.hasItem('tier-3')) { } // NEVER works in production
+
+// ✅ CORRECT - Check for specific reward IDs
 if (window.FarcadeSDK.hasItem('double-jump')) {
   this.player.enableDoubleJump()
 }
 
-// Get all purchased items
-const items = window.FarcadeSDK.purchasedItems // string[]
+if (window.FarcadeSDK.hasItem('speed-boost')) {
+  this.player.speed *= 1.5
+}
+```
+
+**How Boost Tiers Work:**
+1. Users purchase a **tier** (Bronze/Silver/Gold aka tier-1/tier-2/tier-3)
+2. Each tier contains **rewards** configured by the game developer
+3. When purchased, the **reward IDs** (not tier names) are added to `purchasedItems`
+4. Use `hasItem('reward-id')` to check if a player owns that reward
+
+```typescript
+// Get all purchased reward IDs
+const items = window.FarcadeSDK.purchasedItems // ['double-jump', 'speed-boost', ...]
 
 // Initiate a purchase (opens platform modal)
 const result = await window.FarcadeSDK.purchase({ item: 'tier-1' })
 if (result.success) {
-  // Purchase completed
+  // Rewards from tier-1 are now in purchasedItems
 }
 ```
 
@@ -207,23 +224,28 @@ The `.remix` directory stores local development state. This is NOT deployed to p
 
 ### boost-config.json
 
-Defines boost tier rewards. When a tier is "purchased" in dev mode, its rewards become available via `hasItem()`.
+Defines boost tier rewards. When a tier is "purchased" in dev mode, its **rewards** (not tier names) become available via `hasItem()`.
 
 ```json
 {
-  "purchasedItems": ["tier-1"], // Owned tier slugs
+  "purchasedItems": ["tier-1"], // Tracks which tiers are owned (internal only)
   "tierRewards": {
-    "tier-1": ["Reward 1"], // Rewards for tier 1
-    "tier-2": ["Reward 2"], // Rewards for tier 2
-    "tier-3": ["Reward 3"] // Rewards for tier 3
+    "tier-1": ["Double Jump", "Speed Boost"], // Rewards unlocked by tier 1
+    "tier-2": ["Extra Life"],                  // Rewards unlocked by tier 2
+    "tier-3": ["Invincibility"]                // Rewards unlocked by tier 3
   }
 }
 ```
 
+**How it works:**
+- When `tier-1` is in `purchasedItems`, `hasItem('double-jump')` and `hasItem('speed-boost')` return true
+- `hasItem('tier-1')` does **NOT** work - tier names are never in the SDK's purchasedItems
+
 **Reward Slugs**: Reward names are converted to slugs for `hasItem()`:
 
 - "Double Jump" → `double-jump`
-- "Reward 1" → `reward-1`
+- "Speed Boost" → `speed-boost`
+- "Extra Life" → `extra-life`
 
 ### saved-states/
 
@@ -676,6 +698,18 @@ Phaser is loaded via CDN, not npm. Use the global `Phaser` constant.
 
 ### hasItem() returning false
 
-1. Check `.remix/boost-config.json` has the tier in `purchasedItems`
-2. Verify the reward is listed under that tier in `tierRewards`
-3. Reward names are slugified: "My Reward" → `my-reward`
+1. **Never check for tier names** - `hasItem('tier-1')` will ALWAYS fail in production
+2. Check `.remix/boost-config.json` has the tier in `purchasedItems`
+3. Verify the reward is listed under that tier in `tierRewards`
+4. Reward names are slugified: "My Reward" → `my-reward`
+
+### Common Boost Tier Mistakes
+
+```typescript
+// ❌ WRONG - Will fail in production
+const boostTier = sdk.hasItem('tier-3') ? 3 : sdk.hasItem('tier-2') ? 2 : sdk.hasItem('tier-1') ? 1 : 0
+
+// ✅ CORRECT - Check for actual reward IDs
+const hasDoubleJump = sdk.hasItem('double-jump')
+const hasSpeedBoost = sdk.hasItem('speed-boost')
+```