closer

battle_system_design.md

@@ -17,14 +17,12 @@ The battle system is built on **composable building blocks** that can be combine
   "name": "Zephyr Sprite",
   "description": "A mysterious floating creature that manipulates wind currents",
   "tier": "medium",
-  "primaryType": "wind",
+  "primaryType": "space",
   "secondaryType": null,
   "baseStats": {
     "hp": 65,
-    "attack": 50,
+    "attack": 85,
     "defense": 40,
-    "fieldAttack": 85,
-    "fieldDefense": 70,
     "speed": 90
   },
   "nature": "hasty",
@@ -43,8 +41,7 @@ The battle system is built on **composable building blocks** that can be combine
   "movepool": [
     {
       "name": "Gust Strike",
-      "type": "wind",
-      "category": "physical",
+      "type": "space",
       "power": 65,
       "accuracy": 95,
       "pp": 20,
@@ -54,14 +51,13 @@ The battle system is built on **composable building blocks** that can be combine
         {
           "type": "damage",
           "target": "opponent",
-          "formula": "standard"
+          "amount": "normal"
         }
       ]
     },
     {
       "name": "Piercing Gale",
-      "type": "wind", 
-      "category": "special",
+      "type": "space", 
       "power": 80,
       "accuracy": 85,
       "pp": 15,
@@ -71,7 +67,7 @@ The battle system is built on **composable building blocks** that can be combine
         {
           "type": "damage",
           "target": "opponent",
-          "formula": "standard"
+          "amount": "normal"
         },
         {
           "type": "modifyStats",
@@ -83,8 +79,7 @@ The battle system is built on **composable building blocks** that can be combine
     },
     {
       "name": "Tailwind Boost",
-      "type": "wind",
-      "category": "status",
+      "type": "space",
       "power": 0,
       "accuracy": 100,
       "pp": 10,
@@ -100,8 +95,7 @@ The battle system is built on **composable building blocks** that can be combine
     },
     {
       "name": "Reckless Dive",
-      "type": "wind",
-      "category": "physical", 
+      "type": "space", 
       "power": 120,
       "accuracy": 80,
       "pp": 5,
@@ -111,7 +105,7 @@ The battle system is built on **composable building blocks** that can be combine
         {
           "type": "damage",
           "target": "opponent",
-          "formula": "standard"
+          "amount": "normal"
         },
         {
           "type": "damage",
@@ -136,10 +130,7 @@ All battle effects are built from these atomic operations:
 {
   "type": "damage",
   "target": "opponent" | "self" | "all" | "allies",
-  "formula": "standard" | "fixed" | "recoil" | "drain" | "custom",
-  "value": 80,          // Fixed damage amount or percentage for recoil/drain
-  "multiplier": 1.0,    // Damage multiplier
-  "condition": "always" | "ifLowHp" | "ifHighHp" | "afterKO" | "custom"
+  "amount": "weak" | "normal" | "strong" | "extreme"
 }
 ```
 
@@ -169,9 +160,7 @@ All battle effects are built from these atomic operations:
 {
   "type": "applyStatus",
   "target": "opponent" | "self",
-  "status": "burn" | "freeze" | "paralyze" | "poison" | "sleep" | "confuse",
-  "chance": 30,         // Percentage chance
-  "condition": "onHit" | "always"
+  "status": "burn" | "freeze" | "paralyze" | "poison" | "sleep" | "confuse"
 }
 ```
 
@@ -180,9 +169,7 @@ All battle effects are built from these atomic operations:
 {
   "type": "heal",
   "target": "self" | "ally",
-  "amount": "percentage" | "fixed",
-  "value": 50,          // 50% of max HP or 50 fixed HP
-  "condition": "always" | "ifLowHp" | "endOfTurn"
+  "amount": "small" | "medium" | "large" | "full"
 }
 ```
 
@@ -192,8 +179,7 @@ All battle effects are built from these atomic operations:
   "type": "manipulatePP",
   "target": "opponent",
   "action": "drain" | "restore" | "disable",
-  "amount": 3,          // PP to drain/restore
-  "targetMove": "last" | "random" | "strongest"
+  "amount": "small" | "medium" | "large"
 }
 ```
 
@@ -212,8 +198,7 @@ All battle effects are built from these atomic operations:
 {
   "type": "counter",
   "counterType": "physical" | "special" | "any",
-  "multiplier": 2.0,    // Damage multiplier when countering
-  "condition": "ifDamagedThisTurn"
+  "strength": "weak" | "normal" | "strong"
 }
 ```
 
@@ -231,12 +216,44 @@ All battle effects are built from these atomic operations:
 ```json
 {
   "type": "removeStatus",
-  "target": "self" | "opponent" | "allies" | "all",
-  "status": "burn" | "freeze" | "paralyze" | "poison" | "sleep" | "confuse" | "all",
-  "condition": "always" | "onSwitchIn" | "endOfTurn"
+  "target": "self" | "opponent" | "allies",
+  "status": "burn" | "freeze" | "paralyze" | "poison" | "sleep" | "confuse"
 }
 ```
 
+### Move Flags
+
+Moves can have flags that affect how they interact with abilities and other mechanics:
+
+#### **Combat Flags**
+- **contact**: Move makes physical contact (triggers contact abilities like Rough Skin)
+- **bite**: Biting move (affected by Strong Jaw ability, blocked by certain defenses)  
+- **punch**: Punching move (affected by Iron Fist ability)
+- **sound**: Sound-based move (bypasses Substitute, blocked by Soundproof)
+- **explosive**: Explosive move (affected by Damp ability)
+- **draining**: Move that drains HP (affected by Liquid Ooze ability)
+- **ground**: Ground-based attack (blocked by Sky Dancer, Levitate abilities)
+
+#### **Priority Flags**
+- **priority**: Move has natural priority (+1 to +5)
+- **lowPriority**: Move has negative priority (-1 to -5)
+
+#### **Special Mechanics**
+- **charging**: Move requires charging turn (Sky Attack, Solar Beam)
+- **recharge**: User must recharge next turn (Hyper Beam)
+- **multiHit**: Hits multiple times (2-5 hits)
+- **twoTurn**: Takes two turns to execute
+- **sacrifice**: Move involves self-sacrifice or major cost
+- **gambling**: Move has random outcomes
+- **reckless**: Move gains power but has drawbacks (affected by Reckless ability)
+
+#### **Interaction Flags**
+- **reflectable**: Can be reflected by Magic Coat
+- **snatchable**: Can be stolen by Snatch
+- **copyable**: Can be copied by Mirror Move
+- **protectable**: Blocked by Protect/Detect
+- **bypassProtect**: Ignores Protect/Detect
+
 ### Triggers and Conditions
 
 Effects can be triggered by various battle events:
@@ -291,6 +308,9 @@ Special abilities can override or alter fundamental battle mechanics:
 - **contactDamage**: Attackers take damage when using contact moves
 - **drainInversion**: HP draining moves heal the target instead
 - **weatherImmunity**: Unaffected by weather damage/effects
+- **flagImmunity**: Immune to moves with specific flags
+- **flagWeakness**: Takes extra damage from moves with specific flags
+- **flagResistance**: Takes reduced damage from moves with specific flags
 
 ### Advanced Ability Examples
 
@@ -331,15 +351,15 @@ Special abilities can override or alter fundamental battle mechanics:
 }
 ```
 
-#### 3. **Sap Sipper** - Healed by nature-type moves
+#### 3. **Photosynthesis** - Healed by flora-type moves
 ```json
 {
-  "name": "Sap Sipper",
-  "description": "Absorbs nature-type moves to restore HP",
+  "name": "Photosynthesis",
+  "description": "Absorbs flora-type moves to restore HP",
   "triggers": [
     {
       "event": "onDamageTaken",
-      "condition": "ifMoveType:nature",
+      "condition": "ifMoveType:flora",
       "effects": [
         {
           "type": "mechanicOverride",
@@ -520,30 +540,20 @@ Special abilities can override or alter fundamental battle mechanics:
 
 ### Status-Specific Abilities
 
-#### **Frost Walker** - Heal when frozen
+#### **Frost Walker** - Alternative effect when frozen
 ```json
 {
   "name": "Frost Walker",
-  "description": "Thrives in frozen conditions, healing instead of being immobilized",
+  "description": "Instead of being frozen, gains +50% attack",
   "effects": [
     {
       "type": "mechanicOverride",
-      "mechanic": "statusEffect:freeze",
-      "value": "invert"
-    }
-  ],
-  "triggers": [
-    {
-      "event": "onStatusInflicted",
-      "condition": "ifStatus:freeze",
-      "effects": [
-        {
-          "type": "heal",
-          "target": "self",
-          "amount": "percentage",
-          "value": 12
-        }
-      ]
+      "mechanic": "statusReplacement:freeze",
+      "value": {
+        "type": "modifyStats",
+        "target": "self",
+        "stats": { "attack": "greatly_increase" }
+      }
     }
   ]
 }
@@ -709,6 +719,128 @@ Special abilities can override or alter fundamental battle mechanics:
 }
 ```
 
+### Flag-Based Immunities and Weaknesses
+
+#### **Sky Dancer** - Immune to ground-flagged attacks
+```json
+{
+  "name": "Sky Dancer",
+  "description": "Floating in air, immune to ground-based attacks",
+  "effects": [
+    {
+      "type": "mechanicOverride", 
+      "mechanic": "flagImmunity",
+      "value": ["ground"]
+    }
+  ]
+}
+```
+
+#### **Sound Barrier** - Immune to sound attacks
+```json
+{
+  "name": "Sound Barrier",
+  "description": "Natural sound dampening prevents sound-based moves",
+  "effects": [
+    {
+      "type": "mechanicOverride",
+      "mechanic": "flagImmunity", 
+      "value": ["sound"]
+    }
+  ]
+}
+```
+
+#### **Soft Body** - Weak to punch moves, immune to explosive
+```json
+{
+  "name": "Soft Body",
+  "description": "Gelatinous form absorbs explosions but vulnerable to direct hits",
+  "effects": [
+    {
+      "type": "mechanicOverride",
+      "mechanic": "flagImmunity",
+      "value": ["explosive"]
+    },
+    {
+      "type": "mechanicOverride", 
+      "mechanic": "flagWeakness",
+      "value": ["punch"]
+    }
+  ]
+}
+```
+
+#### **Ethereal Form** - Immune to contact moves
+```json
+{
+  "name": "Ethereal Form",
+  "description": "Ghostly body cannot be touched by physical contact",
+  "effects": [
+    {
+      "type": "mechanicOverride",
+      "mechanic": "flagImmunity",
+      "value": ["contact"]
+    }
+  ]
+}
+```
+
+#### **Fragile Shell** - Takes double damage from explosive moves
+```json
+{
+  "name": "Fragile Shell", 
+  "description": "Hard shell provides defense but shatters from explosions",
+  "effects": [
+    {
+      "type": "modifyStats",
+      "target": "self", 
+      "stats": { "defense": "increase" }
+    },
+    {
+      "type": "mechanicOverride",
+      "mechanic": "flagWeakness",
+      "value": ["explosive"]
+    }
+  ]
+}
+```
+
+#### **Liquid Body** - Immune to punch/bite, weak to sound
+```json
+{
+  "name": "Liquid Body",
+  "description": "Fluid form flows around physical attacks but resonates with sound",
+  "effects": [
+    {
+      "type": "mechanicOverride",
+      "mechanic": "flagImmunity",
+      "value": ["punch", "bite"]
+    },
+    {
+      "type": "mechanicOverride",
+      "mechanic": "flagWeakness", 
+      "value": ["sound"]
+    }
+  ]
+}
+```
+
+#### **Thick Hide** - Reduced damage from contact moves
+```json
+{
+  "name": "Thick Hide",
+  "description": "Tough skin reduces impact from physical contact",
+  "effects": [
+    {
+      "type": "mechanicOverride",
+      "mechanic": "flagResistance",
+      "value": ["contact"]
+    }
+  ]
+}
+```
+
 ### Event Triggers for Abilities
 
 Extended list of trigger events:
@@ -732,8 +864,8 @@ Extended list of trigger events:
 
 ### Physical vs Special Attacks
 
-- **Physical**: Use attack vs defense stats, affected by contact abilities
-- **Special**: Use fieldAttack vs fieldDefense stats, no contact interactions
+- **Physical**: Direct combat using attack vs defense stats, affected by contact abilities
+- **Special**: Ranged/magical attacks using attack vs defense stats, no contact interactions
 - **Status**: No damage, focus on effects and stat manipulation
 
 ### Move Flags
@@ -805,15 +937,12 @@ Moves can have flags that affect interactions:
     {
       "type": "damage",
       "target": "opponent",
-      "formula": "standard",
-      "multiplier": 1.0,
-      "condition": "always"
+      "amount": "normal"
     },
     {
       "type": "damage", 
       "target": "opponent",
-      "formula": "standard",
-      "multiplier": 2.0,
+      "amount": "strong",
       "condition": "ifDamagedThisTurn"
     }
   ]
@@ -828,7 +957,6 @@ Powerful moves with dramatic sacrifices create high-stakes decision making:
 ```json
 {
   "name": "Self Destruct",
-  "category": "physical",
   "power": 200,
   "accuracy": 100,
   "pp": 1,
@@ -856,7 +984,6 @@ Powerful moves with dramatic sacrifices create high-stakes decision making:
 ```json
 {
   "name": "Life Drain Overload",
-  "category": "special",
   "power": 0,
   "accuracy": 100,
   "pp": 3,
@@ -872,7 +999,7 @@ Powerful moves with dramatic sacrifices create high-stakes decision making:
     {
       "type": "modifyStats",
       "target": "self",
-      "stats": { "attack": "greatly_decrease", "fieldAttack": "greatly_decrease" },
+      "stats": { "attack": "greatly_decrease" },
       "condition": "afterUse"
     }
   ]
@@ -882,8 +1009,7 @@ Powerful moves with dramatic sacrifices create high-stakes decision making:
 #### **Berserker's End** - More damage as HP gets lower, but can't heal
 ```json
 {
-  "name": "Berserker's End",
-  "category": "physical", 
+  "name": "Berserker's End", 
   "power": 80,
   "accuracy": 95,
   "pp": 10,
@@ -893,23 +1019,19 @@ Powerful moves with dramatic sacrifices create high-stakes decision making:
     {
       "type": "damage",
       "target": "opponent",
-      "formula": "standard",
-      "multiplier": 1.0,
-      "condition": "ifHighHp"
+      "amount": "normal"
     },
     {
       "type": "damage",
       "target": "opponent", 
-      "formula": "standard",
-      "multiplier": 2.0,
+      "amount": "strong",
       "condition": "ifLowHp"
     },
     {
       "type": "mechanicOverride",
       "target": "self",
       "mechanic": "healingBlocked",
-      "value": true,
-      "condition": "afterUse"
+      "value": true
     }
   ]
 }
@@ -918,8 +1040,7 @@ Powerful moves with dramatic sacrifices create high-stakes decision making:
 #### **Mirror Shatter** - Reflect all damage taken this turn back doubled
 ```json
 {
-  "name": "Mirror Shatter", 
-  "category": "status",
+  "name": "Mirror Shatter",
   "power": 0,
   "accuracy": 100,
   "pp": 5,
@@ -947,7 +1068,6 @@ Powerful moves with dramatic sacrifices create high-stakes decision making:
 ```json
 {
   "name": "Temporal Overload",
-  "category": "status",
   "power": 0,
   "accuracy": 100,
   "pp": 2,
@@ -976,7 +1096,6 @@ Powerful moves with dramatic sacrifices create high-stakes decision making:
 ```json
 {
   "name": "Blood Pact",
-  "category": "status",
   "power": 0,
   "accuracy": 100,
   "pp": 3,
@@ -1004,7 +1123,6 @@ Powerful moves with dramatic sacrifices create high-stakes decision making:
 ```json
 {
   "name": "Soul Burn",
-  "category": "special",
   "power": 150,
   "accuracy": 90,
   "pp": 5,
@@ -1032,7 +1150,6 @@ Powerful moves with dramatic sacrifices create high-stakes decision making:
 ```json
 {
   "name": "Cursed Gambit",
-  "category": "status",
   "power": 0,
   "accuracy": 100,
   "pp": 1,
@@ -1061,7 +1178,6 @@ Powerful moves with dramatic sacrifices create high-stakes decision making:
 ```json
 {
   "name": "Apocalypse Strike",
-  "category": "special",
   "power": 120,
   "accuracy": 85,
   "pp": 1,
@@ -1097,7 +1213,6 @@ Complex moves can have multiple phases:
 ```json
 {
   "name": "Charging Blast",
-  "category": "special",
   "power": 120,
   "accuracy": 90,
   "pp": 5,
@@ -1175,6 +1290,411 @@ The system encourages diverse strategies through:
 
 This creates a dynamic battle system where player skill and strategic thinking matter more than raw stat advantages.
 
+## Complete System Reference
+
+### Available Conditions
+- **always**: Effect always applies when triggered
+- **onHit**: Effect applies only if the move hits successfully
+- **afterUse**: Effect applies after move execution regardless of hit/miss
+- **onCritical**: Effect applies only on critical hits
+- **ifLowHp**: Effect applies if user's HP < 25%
+- **ifHighHp**: Effect applies if user's HP > 75%
+- **thisTurn**: Effect lasts only for the current turn
+- **nextTurn**: Effect applies on the next turn
+- **turnAfterNext**: Effect applies two turns from now
+- **restOfBattle**: Effect persists for the remainder of the battle
+- **onCharging**: Effect applies during charging phase of two-turn moves
+- **afterCharging**: Effect applies after charging phase completes
+- **ifDamagedThisTurn**: Effect applies if user took damage this turn
+- **ifNotSuperEffective**: Effect applies if move would not be super effective
+- **ifMoveType:[type]**: Effect applies if move is of specified type
+- **ifStatus:[status]**: Effect applies if user has specified status
+- **whileFrozen**: Effect applies while user is frozen
+- **ifWeather:[weather]**: Effect applies if weather condition is active
+- **ifStatusMove**: Effect applies if move is a status move
+- **ifLucky50**: Effect applies on 50% random chance (good outcome)
+- **ifUnlucky50**: Effect applies on 50% random chance (bad outcome)
+
+### Available Mechanic Overrides
+- **criticalHits**: Modify critical hit behavior
+- **statusImmunity**: Immunity to specific status effects
+- **statusReplacement:[status]**: Replace status effect with different effect
+- **damageReflection**: Reflect damage back to attacker
+- **damageAbsorption**: Absorb damage of specific types
+- **damageCalculation**: Modify damage calculation rules
+- **damageMultiplier**: Multiply all damage dealt
+- **healingInversion**: Healing effects cause damage instead
+- **healingBlocked**: Prevent all healing
+- **priorityOverride**: Override move priority
+- **accuracyBypass**: Moves cannot miss
+- **typeImmunity**: Immunity to specific damage types
+- **typeChange**: Change Piclet's type
+- **contactDamage**: Deal damage to contact move users
+- **drainInversion**: HP drain heals target instead
+- **weatherImmunity**: Immunity to weather effects
+- **flagImmunity**: Immunity to moves with specific flags
+- **flagWeakness**: Extra damage from moves with specific flags
+- **flagResistance**: Reduced damage from moves with specific flags
+- **statModification**: Modify how stat changes work
+- **targetRedirection**: Change move targets
+- **extraTurn**: Grant additional turns
+
+### Available Event Triggers
+- **onDamageTaken**: When this Piclet takes damage
+- **onDamageDealt**: When this Piclet deals damage
+- **onContactDamage**: When hit by a contact move
+- **onStatusInflicted**: When a status is applied to this Piclet
+- **onStatusMove**: When targeted by a status move
+- **onStatusMoveTargeted**: When targeted by opponent's status move
+- **onCriticalHit**: When this Piclet lands/receives a critical hit
+- **onHPDrained**: When HP is drained from this Piclet
+- **onKO**: When this Piclet knocks out an opponent
+- **onSwitchIn**: When this Piclet enters battle
+- **onSwitchOut**: When this Piclet leaves battle
+- **onWeatherChange**: When battlefield weather changes
+- **beforeMoveUse**: Just before this Piclet uses a move
+- **afterMoveUse**: Just after this Piclet uses a move
+- **onLowHP**: When HP drops below 25%
+- **onFullHP**: When HP is at 100%
+- **endOfTurn**: At the end of each turn
+- **onOpponentContactMove**: When opponent uses contact move
+
+### Available Status Effects
+- **burn**: Ongoing fire damage
+- **freeze**: Cannot act (unless replaced by ability)
+- **paralyze**: Speed reduction and chance to be unable to move
+- **poison**: Ongoing poison damage
+- **sleep**: Cannot act for several turns
+- **confuse**: Chance to hit self instead of target
+
+### Available Move Flags
+- **contact**: Makes physical contact
+- **bite**: Biting attack
+- **punch**: Punching attack
+- **sound**: Sound-based attack
+- **explosive**: Explosive attack
+- **draining**: Drains HP from target
+- **ground**: Ground-based attack
+- **priority**: Has natural priority
+- **lowPriority**: Has negative priority
+- **charging**: Requires charging turn
+- **recharge**: User must recharge after
+- **multiHit**: Hits multiple times
+- **twoTurn**: Takes two turns to execute
+- **sacrifice**: Involves self-sacrifice
+- **gambling**: Has random outcomes
+- **reckless**: High power with drawbacks
+- **reflectable**: Can be reflected
+- **snatchable**: Can be stolen
+- **copyable**: Can be copied
+- **protectable**: Blocked by Protect
+- **bypassProtect**: Ignores Protect
+
+### Available Types
+
+Types correspond to photographed objects in the real world:
+
+- **beast** 🐾: Vertebrate wildlife — mammals, birds, reptiles. Raw physicality, instincts, and region-based variants
+- **bug** 🐛: Arthropods great and small: butterflies, beetles, mantises. Agile swarms, precision strikes, metamorphosis
+- **aquatic** 🌊: Life that swims, dives, sloshes: fish, octopus, ink-creatures, sentient puddles. Masters of tides and pressure
+- **flora** 🌿: Plants and fungi captured in bloom or decay. Growth, spores, vines, seasonal shifts
+- **mineral** 🪨: Stones, crystals, metals shaped by earth's depths. High durability, reflective armor, seismic shocks
+- **space** ✨: Stars, moon, cosmic objects not of this world. Stellar energy, gravitational effects, void manipulation
+- **machina** ⚙️: Engineered devices from gadgets to heavy machinery. Gears, circuits, drones, power surges
+- **structure** 🏛️: Buildings, bridges, monuments, ruins as titans. Fortification, terrain shaping, zone denial
+- **culture** 🎨: Art, fashion, toys, written symbols. Buffs, debuffs, illusion, story-driven interactions
+- **cuisine** 🍣: Dishes, drinks, culinary artistry. Flavors, aromas, temperature shifts for support or offense
+- **normal** 👤: Attack type only (no Piclets are Normal type). Represents mundane, non-specialized attacks
+
+### Type Effectiveness Chart
+
+| ATK \ DEF         | 🐾 Beast | 🐛 Bug  | 🌊 Aquatic | 🌿 Flora | 🪨 Mineral | ✨Space   | ⚙️ Machina | 🏛️ Structure   | 🎨 Culture | 🍣 Cuisine |
+| ----------------- | :------: | :----: | :--------: | :------: | :--------: | :------: | :--------: | :-----------: | :--------: | :--------: |
+| **🐾 Beast**      |     1    | **×2** |      1     |     1    |     ×½     |   **0**  |     ×½     |       ×½      |   **×2**   |   **×2**   |
+| **🐛 Bug**        |  **×2**  |    1   |      1     |  **×2**  |     ×½     |    ×½    |      1     |     **0**     |     ×½     |     ×½     |
+| **🌊 Aquatic**    |     1    |    1   |      1     |    ×½    |   **×2**   |  **×2**  |   **×2**   |       1       |     ×½     |     ×½     |
+| **🌿 Flora**      |     1    | **×2** |   **×2**   |     1    |   **×2**   |    ×½    |    **0**   |     **×2**    |      1     |     ×½     |
+| **🪨 Mineral**    |  **×2**  | **×2** |     ×½     |    ×½    |      1     |    ×½    |   **×2**   |       1       |      1     |    **0**   |
+| **✨ Space**  |   **0**  | **×2** |     ×½     |  **×2**  |   **×2**   |     1    |     ×½     |     **×2**    |     ×½     |     ×½     |
+| **⚙️ Machina**    |  **×2**  |   ×½   |     ×½     |  **×2**  |     ×½     |    ×½    |      1     |     **×2**    |      1     |      1     |
+| **🏛️ Structure**  |    ×½    |   ×½   |      1     |     1    |      1     |    ×½    |   **×2**   |       1       |   **×2**   |   **×2**   |
+| **🎨 Culture**    |    ×½    |   ×½   |      1     |     1    |    **0**   |  **×2**  |   **×2**   |     **×2**    |      1     |     ×½     |
+| **🍣 Cuisine**    |  **×2**  |   ×½   |     ×½     |     1    |    **0**   |  **×2**  |      1     |       ×½      |   **×2**   |      1     |
+| **👤 Normal**    |     1    |    1   |      1     |     1    |      1     |     0    |      1     |        1      |      1     |      1     |
+
+**Legend:**
+- **×2** = Super effective (2x damage)
+- **×½** = Not very effective (0.5x damage)  
+- **0** = No effect (0x damage)
+- **1** = Normal effectiveness (1x damage)
+
+## JSON Schema
+
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Piclet Definition",
+  "required": ["name", "description", "tier", "primaryType", "baseStats", "nature", "specialAbility", "movepool"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the Piclet"
+    },
+    "description": {
+      "type": "string", 
+      "description": "Flavor text describing the Piclet"
+    },
+    "tier": {
+      "type": "string",
+      "enum": ["low", "medium", "high", "legendary"],
+      "description": "Power tier of the Piclet"
+    },
+    "primaryType": {
+      "type": "string",
+      "enum": ["beast", "bug", "aquatic", "flora", "mineral", "space", "machina", "structure", "culture", "cuisine"],
+      "description": "Primary type of the Piclet"
+    },
+    "secondaryType": {
+      "type": ["string", "null"],
+      "enum": ["beast", "bug", "aquatic", "flora", "mineral", "space", "machina", "structure", "culture", "cuisine", null],
+      "description": "Optional secondary type"
+    },
+    "baseStats": {
+      "type": "object",
+      "required": ["hp", "attack", "defense", "speed"],
+      "properties": {
+        "hp": {"type": "integer", "minimum": 1, "maximum": 255},
+        "attack": {"type": "integer", "minimum": 1, "maximum": 255},
+        "defense": {"type": "integer", "minimum": 1, "maximum": 255},
+        "speed": {"type": "integer", "minimum": 1, "maximum": 255}
+      },
+      "additionalProperties": false
+    },
+    "nature": {
+      "type": "string",
+      "description": "Personality trait affecting stats or behavior"
+    },
+    "specialAbility": {
+      "$ref": "#/definitions/SpecialAbility"
+    },
+    "movepool": {
+      "type": "array",
+      "items": {"$ref": "#/definitions/Move"},
+      "minItems": 1,
+      "maxItems": 8
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "SpecialAbility": {
+      "type": "object",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {"type": "string"},
+        "description": {"type": "string"},
+        "effects": {
+          "type": "array",
+          "items": {"$ref": "#/definitions/Effect"}
+        },
+        "triggers": {
+          "type": "array", 
+          "items": {"$ref": "#/definitions/Trigger"}
+        }
+      },
+      "additionalProperties": false
+    },
+    "Move": {
+      "type": "object",
+      "required": ["name", "type", "power", "accuracy", "pp", "priority", "flags", "effects"],
+      "properties": {
+        "name": {"type": "string"},
+        "type": {
+          "type": "string",
+          "enum": ["beast", "bug", "aquatic", "flora", "mineral", "space", "machina", "structure", "culture", "cuisine", "normal"]
+        },
+        "power": {"type": "integer", "minimum": 0, "maximum": 250},
+        "accuracy": {"type": "integer", "minimum": 0, "maximum": 100},
+        "pp": {"type": "integer", "minimum": 1, "maximum": 50},
+        "priority": {"type": "integer", "minimum": -5, "maximum": 5},
+        "flags": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["contact", "bite", "punch", "sound", "explosive", "draining", "ground", "priority", "lowPriority", "charging", "recharge", "multiHit", "twoTurn", "sacrifice", "gambling", "reckless", "reflectable", "snatchable", "copyable", "protectable", "bypassProtect"]
+          },
+          "uniqueItems": true
+        },
+        "effects": {
+          "type": "array",
+          "items": {"$ref": "#/definitions/Effect"},
+          "minItems": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "Effect": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["damage", "modifyStats", "applyStatus", "heal", "manipulatePP", "fieldEffect", "counter", "priority", "removeStatus", "mechanicOverride"]
+        },
+        "target": {
+          "type": "string",
+          "enum": ["self", "opponent", "allies", "all", "attacker", "field", "playerSide", "opponentSide"]
+        },
+        "condition": {
+          "type": "string",
+          "enum": ["always", "onHit", "afterUse", "onCritical", "ifLowHp", "ifHighHp", "thisTurn", "nextTurn", "turnAfterNext", "restOfBattle", "onCharging", "afterCharging", "ifDamagedThisTurn", "ifNotSuperEffective", "ifStatusMove", "ifLucky50", "ifUnlucky50", "whileFrozen"]
+        }
+      },
+      "allOf": [
+        {
+          "if": {"properties": {"type": {"const": "damage"}}},
+          "then": {
+            "required": ["amount"],
+            "properties": {
+              "amount": {
+                "type": "string",
+                "enum": ["weak", "normal", "strong", "extreme"]
+              }
+            }
+          }
+        },
+        {
+          "if": {"properties": {"type": {"const": "modifyStats"}}},
+          "then": {
+            "required": ["stats"],
+            "properties": {
+              "stats": {
+                "type": "object",
+                "properties": {
+                  "hp": {"type": "string", "enum": ["increase", "decrease", "greatly_increase", "greatly_decrease"]},
+                  "attack": {"type": "string", "enum": ["increase", "decrease", "greatly_increase", "greatly_decrease"]},
+                  "defense": {"type": "string", "enum": ["increase", "decrease", "greatly_increase", "greatly_decrease"]},
+                  "speed": {"type": "string", "enum": ["increase", "decrease", "greatly_increase", "greatly_decrease"]},
+                  "accuracy": {"type": "string", "enum": ["increase", "decrease", "greatly_increase", "greatly_decrease"]}
+                },
+                "additionalProperties": false,
+                "minProperties": 1
+              }
+            }
+          }
+        },
+        {
+          "if": {"properties": {"type": {"const": "applyStatus"}}},
+          "then": {
+            "required": ["status"],
+            "properties": {
+              "status": {
+                "type": "string",
+                "enum": ["burn", "freeze", "paralyze", "poison", "sleep", "confuse"]
+              }
+            }
+          }
+        },
+        {
+          "if": {"properties": {"type": {"const": "heal"}}},
+          "then": {
+            "required": ["amount"],
+            "properties": {
+              "amount": {"type": "string", "enum": ["small", "medium", "large", "full"]}
+            }
+          }
+        },
+        {
+          "if": {"properties": {"type": {"const": "manipulatePP"}}},
+          "then": {
+            "required": ["action", "amount"],
+            "properties": {
+              "action": {"type": "string", "enum": ["drain", "restore", "disable"]},
+              "amount": {"type": "string", "enum": ["small", "medium", "large"]}
+            }
+          }
+        },
+        {
+          "if": {"properties": {"type": {"const": "fieldEffect"}}},
+          "then": {
+            "required": ["effect"],
+            "properties": {
+              "effect": {"type": "string"},
+              "stackable": {"type": "boolean"}
+            }
+          }
+        },
+        {
+          "if": {"properties": {"type": {"const": "counter"}}},
+          "then": {
+            "required": ["counterType", "strength"],
+            "properties": {
+              "counterType": {"type": "string", "enum": ["physical", "special", "any"]},
+              "strength": {"type": "string", "enum": ["weak", "normal", "strong"]}
+            }
+          }
+        },
+        {
+          "if": {"properties": {"type": {"const": "priority"}}},
+          "then": {
+            "required": ["value"],
+            "properties": {
+              "value": {"type": "integer", "minimum": -5, "maximum": 5}
+            }
+          }
+        },
+        {
+          "if": {"properties": {"type": {"const": "removeStatus"}}},
+          "then": {
+            "required": ["status"],
+            "properties": {
+              "status": {
+                "type": "string",
+                "enum": ["burn", "freeze", "paralyze", "poison", "sleep", "confuse"]
+              }
+            }
+          }
+        },
+        {
+          "if": {"properties": {"type": {"const": "mechanicOverride"}}},
+          "then": {
+            "required": ["mechanic", "value"],
+            "properties": {
+              "mechanic": {
+                "type": "string",
+                "enum": ["criticalHits", "statusImmunity", "damageReflection", "damageAbsorption", "damageCalculation", "damageMultiplier", "healingInversion", "healingBlocked", "priorityOverride", "accuracyBypass", "typeImmunity", "typeChange", "contactDamage", "drainInversion", "weatherImmunity", "flagImmunity", "flagWeakness", "flagResistance", "statModification", "targetRedirection", "extraTurn"]
+              },
+              "value": {}
+            }
+          }
+        }
+      ],
+      "additionalProperties": false
+    },
+    "Trigger": {
+      "type": "object",
+      "required": ["event", "effects"],
+      "properties": {
+        "event": {
+          "type": "string",
+          "enum": ["onDamageTaken", "onDamageDealt", "onContactDamage", "onStatusInflicted", "onStatusMove", "onStatusMoveTargeted", "onCriticalHit", "onHPDrained", "onKO", "onSwitchIn", "onSwitchOut", "onWeatherChange", "beforeMoveUse", "afterMoveUse", "onLowHP", "onFullHP", "endOfTurn", "onOpponentContactMove"]
+        },
+        "condition": {
+          "type": "string",
+          "enum": ["always", "onHit", "afterUse", "onCritical", "ifLowHp", "ifHighHp", "thisTurn", "nextTurn", "turnAfterNext", "restOfBattle", "onCharging", "afterCharging", "ifDamagedThisTurn", "ifNotSuperEffective", "ifStatusMove", "ifLucky50", "ifUnlucky50", "whileFrozen"]
+        },
+        "effects": {
+          "type": "array",
+          "items": {"$ref": "#/definitions/Effect"},
+          "minItems": 1
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}
+```
+
 ## Complete Example: Tempest Wraith
 
 Here's a full example of a Piclet using the complete schema with advanced abilities and dramatic moves:
@@ -1182,16 +1702,14 @@ Here's a full example of a Piclet using the complete schema with advanced abilit
 ```json
 {
   "name": "Tempest Wraith",
-  "description": "A ghostly creature born from violent storms, wielding lightning and shadow in equal measure",
+  "description": "A ghostly creature born from violent storms, wielding cosmic energy and shadowy illusions",
   "tier": "high",
-  "primaryType": "storm",
-  "secondaryType": "shadow",
+  "primaryType": "space",
+  "secondaryType": "culture",
   "baseStats": {
     "hp": 75,
-    "attack": 60,
+    "attack": 95,
     "defense": 45,
-    "fieldAttack": 95,
-    "fieldDefense": 80,
     "speed": 85
   },
   "nature": "timid",
@@ -1221,7 +1739,7 @@ Here's a full example of a Piclet using the complete schema with advanced abilit
           {
             "type": "modifyStats",
             "target": "self",
-            "stats": { "fieldAttack": "increase" }
+            "stats": { "attack": "increase" }
           }
         ]
       }
@@ -1230,8 +1748,7 @@ Here's a full example of a Piclet using the complete schema with advanced abilit
   "movepool": [
     {
       "name": "Shadow Pulse",
-      "type": "shadow",
-      "category": "special",
+      "type": "culture",
       "power": 70,
       "accuracy": 100,
       "pp": 15,
@@ -1241,21 +1758,18 @@ Here's a full example of a Piclet using the complete schema with advanced abilit
         {
           "type": "damage",
           "target": "opponent",
-          "formula": "standard"
+          "amount": "normal"
         },
         {
           "type": "applyStatus",
           "target": "opponent",
-          "status": "confuse",
-          "chance": 20,
-          "condition": "onHit"
+          "status": "confuse"
         }
       ]
     },
     {
-      "name": "Lightning Strike",
-      "type": "storm",
-      "category": "special",
+      "name": "Cosmic Strike",
+      "type": "space",
       "power": 85,
       "accuracy": 90,
       "pp": 10,
@@ -1265,21 +1779,18 @@ Here's a full example of a Piclet using the complete schema with advanced abilit
         {
           "type": "damage",
           "target": "opponent",
-          "formula": "standard"
+          "amount": "normal"
         },
         {
           "type": "applyStatus",
           "target": "opponent",
-          "status": "paralyze",
-          "chance": 15,
-          "condition": "onHit"
+          "status": "paralyze"
         }
       ]
     },
     {
       "name": "Spectral Drain",
-      "type": "shadow",
-      "category": "special",
+      "type": "culture",
       "power": 60,
       "accuracy": 95,
       "pp": 12,
@@ -1295,16 +1806,13 @@ Here's a full example of a Piclet using the complete schema with advanced abilit
         {
           "type": "heal",
           "target": "self",
-          "amount": "percentage",
-          "value": 50,
-          "condition": "onHit"
+          "amount": "medium"
         }
       ]
     },
     {
-      "name": "Storm's Sacrifice",
-      "type": "storm",
-      "category": "special",
+      "name": "Void Sacrifice",
+      "type": "space",
       "power": 130,
       "accuracy": 85,
       "pp": 1,
@@ -1321,15 +1829,13 @@ Here's a full example of a Piclet using the complete schema with advanced abilit
           "type": "damage",
           "target": "self",
           "formula": "percentage",
-          "value": 75,
-          "condition": "afterUse"
+          "value": 75
         },
         {
           "type": "fieldEffect",
-          "effect": "electricStorm",
+          "effect": "voidStorm",
           "target": "field",
-          "stackable": false,
-          "condition": "afterUse"
+          "stackable": false
         }
       ]
     }