gotchi-battler-game-logic 3.0.0 → 4.0.1

package/game-logic/v2.0/statuses.json

@@ -0,0 +1,439 @@
+[
+  {
+    "code": "spd_up",
+    "name": "Speed Buff",
+    "description": "+12% SPD per stack",
+    "category": "stat_modifier",
+    "isBuff": true,
+    "statModifiers": [
+      {
+        "statName": "speed",
+        "value": 12,
+        "valueType": "percent"
+      }
+    ]
+  },
+  {
+    "code": "atk_up",
+    "name": "Attack Buff",
+    "description": "+12% ATK per stack",
+    "category": "stat_modifier",
+    "isBuff": true,
+    "statModifiers": [
+      {
+        "statName": "attack",
+        "value": 12,
+        "valueType": "percent"
+      }
+    ]
+  },
+  {
+    "code": "def_up",
+    "name": "Defense Buff",
+    "description": "+16% DEF per stack",
+    "category": "stat_modifier",
+    "isBuff": true,
+    "statModifiers": [
+      {
+        "statName": "defense",
+        "value": 16,
+        "valueType": "percent"
+      }
+    ]
+  },
+  {
+    "code": "crt_up",
+    "name": "Critical-Rate Buff",
+    "description": "+12 CRT per stack",
+    "category": "stat_modifier",
+    "isBuff": true,
+    "statModifiers": [
+      {
+        "statName": "criticalRate",
+        "value": 12,
+        "valueType": "flat"
+      }
+    ]
+  },
+  {
+    "code": "crd_up",
+    "name": "Critical-Damage Buff",
+    "description": "+30 CRD per stack",
+    "category": "stat_modifier",
+    "isBuff": true,
+    "statModifiers": [
+      {
+        "statName": "criticalDamage",
+        "value": 30,
+        "valueType": "flat"
+      }
+    ]
+  },
+  {
+    "code": "res_up",
+    "name": "Resistance Buff",
+    "description": "+18 RES per stack",
+    "category": "stat_modifier",
+    "isBuff": true,
+    "statModifiers": [
+      {
+        "statName": "resist",
+        "value": 18,
+        "valueType": "flat"
+      }
+    ]
+  },
+  {
+    "code": "foc_up",
+    "name": "Focus Buff",
+    "description": "+15 FOC per stack",
+    "category": "stat_modifier",
+    "isBuff": true,
+    "statModifiers": [
+      {
+        "statName": "focus",
+        "value": 15,
+        "valueType": "flat"
+      }
+    ]
+  },
+  {
+    "code": "spd_down",
+    "name": "Speed Debuff",
+    "description": "-12% SPD per stack",
+    "category": "stat_modifier",
+    "isBuff": false,
+    "statModifiers": [
+      {
+        "statName": "speed",
+        "value": -12,
+        "valueType": "percent"
+      }
+    ]
+  },
+  {
+    "code": "atk_down",
+    "name": "Attack Debuff",
+    "description": "-12% ATK per stack",
+    "category": "stat_modifier",
+    "isBuff": false,
+    "statModifiers": [
+      {
+        "statName": "attack",
+        "value": -12,
+        "valueType": "percent"
+      }
+    ]
+  },
+  {
+    "code": "def_down",
+    "name": "Defense Debuff",
+    "description": "-16% DEF per stack",
+    "category": "stat_modifier",
+    "isBuff": false,
+    "statModifiers": [
+      {
+        "statName": "defense",
+        "value": -16,
+        "valueType": "percent"
+      }
+    ]
+  },
+  {
+    "code": "crt_down",
+    "name": "Critical-Rate Debuff",
+    "description": "-12 CRT per stack",
+    "category": "stat_modifier",
+    "isBuff": false,
+    "statModifiers": [
+      {
+        "statName": "criticalRate",
+        "value": -12,
+        "valueType": "flat"
+      }
+    ]
+  },
+  {
+    "code": "crd_down",
+    "name": "Critical-Damage Debuff",
+    "description": "-30 CRD per stack",
+    "category": "stat_modifier",
+    "isBuff": false,
+    "statModifiers": [
+      {
+        "statName": "criticalDamage",
+        "value": -30,
+        "valueType": "flat"
+      }
+    ]
+  },
+  {
+    "code": "res_down",
+    "name": "Resistance Debuff",
+    "description": "-18 RES per stack",
+    "category": "stat_modifier",
+    "isBuff": false,
+    "statModifiers": [
+      {
+        "statName": "resist",
+        "value": -18,
+        "valueType": "flat"
+      }
+    ]
+  },
+  {
+    "code": "foc_down",
+    "name": "Focus Debuff",
+    "description": "-15 FOC per stack",
+    "category": "stat_modifier",
+    "isBuff": false,
+    "statModifiers": [
+      {
+        "statName": "focus",
+        "value": -15,
+        "valueType": "flat"
+      }
+    ]
+  },
+  {
+    "code": "regenerate",
+    "name": "Regeneration",
+    "description": "Heals a small amount each turn",
+    "category": "turn_effect",
+    "isBuff": true,
+    "turnEffects": [
+      {
+        "type": "heal",
+        "value": 15,
+        "valueType": "flat"
+      }
+    ]
+  },
+  {
+    "code": "taunt",
+    "name": "Taunt",
+    "description": "Forces enemies to target this Gotchi; enables counter-attack",
+    "category": "custom",
+    "isBuff": true
+  },
+  {
+    "code": "fear",
+    "name": "Fear",
+    "description": "Gotchi skips its next turn",
+    "category": "turn_effect",
+    "isBuff": false,
+    "turnEffects": [
+      {
+        "type": "skip_turn"
+      }
+    ]
+  },
+  {
+    "code": "bleed",
+    "name": "Bleed",
+    "description": "Loses a small amount of HP each turn",
+    "category": "turn_effect",
+    "isBuff": false,
+    "turnEffects": [
+      {
+        "type": "damage",
+        "value": 8,
+        "valueType": "flat"
+      }
+    ]
+  },
+  {
+    "code": "wounding_strike",
+    "name": "Wounding Strike",
+    "description": "Attacks may apply Bleed (30%) to the target",
+    "category": "attack_effect",
+    "isBuff": true,
+    "attackEffects": [
+      {
+        "type": "apply_status",
+        "effectStatus": "bleed",
+        "effectChance": 0.30
+      }
+    ]
+  },
+  {
+    "code": "weakening_strike",
+    "name": "Weakening Strike",
+    "description": "Attacks may apply -ATK (30%) to the target",
+    "category": "attack_effect",
+    "isBuff": true,
+    "attackEffects": [
+      {
+        "type": "apply_status",
+        "effectStatus": "atk_down",
+        "effectChance": 0.30
+      }
+    ]
+  },
+  {
+    "code": "enlightening_strike",
+    "name": "Enlightening Strike",
+    "description": "Attacks may apply +FOC (30%) to the target",
+    "category": "attack_effect",
+    "isBuff": false,
+    "attackEffects": [
+      {
+        "type": "apply_status",
+        "effectStatus": "foc_up",
+        "effectChance": 0.30
+      }
+    ]
+  },
+  {
+    "code": "cleansing_strike",
+    "name": "Cleansing Strike",
+    "description": "Attacks may remove a debuff from the attacker (30%)",
+    "category": "attack_effect",
+    "isBuff": true,
+    "attackEffects": [
+      {
+        "type": "cleanse_self",
+        "effectChance": 0.30
+      }
+    ]
+  },
+  {
+    "code": "piercing_strike",
+    "name": "Piercing Strike",
+    "description": "Attacks may apply -DEF (30%) to the target",
+    "category": "attack_effect",
+    "isBuff": true,
+    "attackEffects": [
+      {
+        "type": "apply_status",
+        "effectStatus": "def_down",
+        "effectChance": 0.30
+      }
+    ]
+  },
+  {
+    "code": "confusing_strike",
+    "name": "Confusing Strike",
+    "description": "Attacks may apply -FOC (30%) to the target",
+    "category": "attack_effect",
+    "isBuff": true,
+    "attackEffects": [
+      {
+        "type": "apply_status",
+        "effectStatus": "foc_down",
+        "effectChance": 0.30
+      }
+    ]
+  },
+  {
+    "code": "lucky_strike",
+    "name": "Lucky Strike",
+    "description": "Attacks may apply +CRD (30%) to the target",
+    "category": "attack_effect",
+    "isBuff": false,
+    "attackEffects": [
+      {
+        "type": "apply_status",
+        "effectStatus": "crd_up",
+        "effectChance": 0.30
+      }
+    ]
+  },
+  {
+    "code": "terrifying_strike",
+    "name": "Terrifying Strike",
+    "description": "Attacks may apply Fear (25%) to the target",
+    "category": "attack_effect",
+    "isBuff": true,
+    "attackEffects": [
+      {
+        "type": "apply_status",
+        "effectStatus": "fear",
+        "effectChance": 0.25
+      }
+    ]
+  },
+  {
+    "code": "nurturing_strike",
+    "name": "Nurturing Strike",
+    "description": "Attacks may apply Regeneration (30%) to the target",
+    "category": "attack_effect",
+    "isBuff": false,
+    "attackEffects": [
+      {
+        "type": "apply_status",
+        "effectStatus": "regenerate",
+        "effectChance": 0.30
+      }
+    ]
+  },
+  {
+    "code": "slowing_strike",
+    "name": "Slowing Strike",
+    "description": "Attacks may apply -SPD (30%) to the target",
+    "category": "attack_effect",
+    "isBuff": true,
+    "attackEffects": [
+      {
+        "type": "apply_status",
+        "effectStatus": "spd_down",
+        "effectChance": 0.30
+      }
+    ]
+  },
+  {
+    "code": "blinding_strike",
+    "name": "Blinding Strike",
+    "description": "Attacks may apply -CRT (30%) to the target",
+    "category": "attack_effect",
+    "isBuff": true,
+    "attackEffects": [
+      {
+        "type": "apply_status",
+        "effectStatus": "crt_down",
+        "effectChance": 0.30
+      }
+    ]
+  },
+  {
+    "code": "empowering_strike",
+    "name": "Empowering Strike",
+    "description": "Attacks may apply +ATK (30%) to the attacker",
+    "category": "attack_effect",
+    "isBuff": true,
+    "attackEffects": [
+      {
+        "type": "gain_status",
+        "effectStatus": "atk_up",
+        "effectChance": 0.30
+      }
+    ]
+  },
+  {
+    "code": "corrosive_strike",
+    "name": "Corrosive Strike",
+    "description": "Attacks may apply -RES (30%) to the target",
+    "category": "attack_effect",
+    "isBuff": true,
+    "attackEffects": [
+      {
+        "type": "apply_status",
+        "effectStatus": "res_down",
+        "effectChance": 0.30
+      }
+    ]
+  },
+  {
+    "code": "dispelling_strike",
+    "name": "Dispelling Strike",
+    "description": "Attacks may remove a buff (35%) from the target",
+    "category": "attack_effect",
+    "isBuff": true,
+    "attackEffects": [
+      {
+        "type": "remove_buff",
+        "effectChance": 0.35
+      }
+    ]
+  }
+] 

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "gotchi-battler-game-logic",
-  "version": "3.0.0",
+  "version": "4.0.1",
   "main": "index.js",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "mocha \"tests/**/*.test.js\"",
+    "test:watch": "mocha --watch \"tests/**/*.test.js\"",
+    "test:report": "mocha \"tests/**/*.test.js\" --reporter spec",
+    "lint": "npx eslint .",
+    "lint:fix": "npx eslint . --fix"
   },
   "author": "Galaxy Brain Studios",
   "description": "The game logic for the Gotchi Battler game",
@@ -13,14 +17,17 @@
   },
   "dependencies": {
     "seedrandom": "^3.0.5",
-    "z-schema": "^6.0.2"
+    "zod": "^4.1.12"
   },
   "devDependencies": {
     "@google-cloud/storage": "^7.13.0",
     "axios": "^1.7.4",
     "axios-retry": "^4.5.0",
+    "chai": "^4.3.10",
     "dotenv": "^16.4.5",
+    "eslint": "^9.30.1",
     "ethers": "^6.13.4",
-    "json-csv": "^4.0.18"
+    "json-csv": "^4.0.18",
+    "mocha": "^11.7.1"
   }
 }

package/schemas/crystal.js

@@ -0,0 +1,14 @@
+const { z } = require('zod')
+
+const CrystalSchema = z.object({
+    code: z.string(),
+    name: z.string(),
+    slot: z.number().int().min(1).max(6),
+    rarity: z.enum(['common', 'uncommon', 'rare', 'legendary', 'mythical', 'godlike']),
+    stat: z.enum(['speed', 'health', 'attack', 'defense', 'criticalRate', 'criticalDamage', 'resist', 'focus']),
+    statValue: z.number().int(),
+})
+
+module.exports = { CrystalSchema }
+
+

package/schemas/effect.js

@@ -0,0 +1,25 @@
+const { z } = require('zod')
+
+const EffectTypeEnum = z.enum([
+    'status',
+    'heal',
+    'remove_buff',
+    'remove_debuff',
+    'remove_all_buffs',
+    'remove_all_debuffs',
+    'repeat_attack'
+])
+
+const EffectSchema = z.object({
+    id: z.number().int().optional(),
+    effectType: EffectTypeEnum,
+    value: z.number().nullable(),
+    chance: z.number().min(0).max(1).default(1.0),
+    special: z.string().nullable(),
+    target: z.string().nullable(),
+    status: z.string().nullable()
+})
+
+module.exports = { EffectSchema, EffectTypeEnum }
+
+

package/schemas/gotchi.js

@@ -0,0 +1,53 @@
+const { z } = require('zod')
+const { SpecialSchema } = require('./special')
+const { LeaderSkillSchema } = require('./leaderskill')
+const { ItemSchema } = require('./item')
+const { CrystalSchema } = require('./crystal')
+
+const GotchiSchema = z.object({
+    id: z.number().int(),
+    onchainId: z.number().int(),
+    name: z.string(),
+    type: z.enum(['gotchi', 'spirit', 'monster']),
+    visualCode: z.string(),
+    level: z.number().int(),
+    speed: z.number().int(),
+    health: z.number().int(),
+    attack: z.number().int(),
+    defense: z.number().int(),
+    criticalRate: z.number(),
+    criticalDamage: z.number().int(),
+    resist: z.number().int(),
+    focus: z.number().int(),
+
+    // Foreign keys
+    gotchiClass: z.string(),
+    special: z.string(),
+    leaderSkill: z.string(),
+    item: z.string().nullable(),
+    crystalSlot1: z.string().nullable(),
+    crystalSlot2: z.string().nullable(),
+    crystalSlot3: z.string().nullable(),
+    crystalSlot4: z.string().nullable(),
+    crystalSlot5: z.string().nullable(),
+    crystalSlot6: z.string().nullable(),
+
+    // Expanded
+    specialExpanded: SpecialSchema,
+    leaderSkillExpanded: LeaderSkillSchema,
+    itemExpanded: ItemSchema.optional(),
+    crystalSlot1Expanded: CrystalSchema.optional(),
+    crystalSlot2Expanded: CrystalSchema.optional(),
+    crystalSlot3Expanded: CrystalSchema.optional(),
+    crystalSlot4Expanded: CrystalSchema.optional(),
+    crystalSlot5Expanded: CrystalSchema.optional(),
+    crystalSlot6Expanded: CrystalSchema.optional(),
+
+    // Timestamps
+    createdAt: z.iso.datetime().optional(),
+    updatedAt: z.iso.datetime().optional(),
+})
+
+module.exports = { GotchiSchema }
+
+

package/schemas/ingameteam.js

@@ -0,0 +1,14 @@
+const { z } = require('zod')
+const { GotchiSchema } = require('./gotchi')
+
+const InGameTeamSchema = z.object({
+    name: z.string(),
+    owner: z.string(),
+    formation: z.object({
+        front: z.array(GotchiSchema.nullable()).min(5).max(5),
+        back: z.array(GotchiSchema.nullable()).min(5).max(5)
+    }),
+    leader: z.number().int()
+})
+
+module.exports = { InGameTeamSchema }

package/schemas/item.js

@@ -0,0 +1,13 @@
+const { z } = require('zod')
+
+const ItemSchema = z.object({
+    code: z.string(),
+    name: z.string(),
+    description: z.string(),
+    image: z.string(),
+    rarity: z.enum(['common', 'uncommon', 'rare', 'legendary', 'mythical', 'godlike']),
+    stat: z.enum(['speed', 'health', 'attack', 'defense', 'criticalRate', 'criticalDamage', 'resist', 'focus']),
+    statValue: z.number().int()
+})
+
+module.exports = { ItemSchema }

package/schemas/leaderskill.js

@@ -0,0 +1,15 @@
+const { z } = require('zod')
+const { LeaderSkillStatusSchema } = require('./leaderskillstatus')
+
+const LeaderSkillSchema = z.object({
+    code: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+    monstersOnly: z.boolean().default(false),
+    gotchiClass: z.string(),
+    statuses: z.array(LeaderSkillStatusSchema).optional(),
+})
+
+module.exports = { LeaderSkillSchema }
+
+

package/schemas/leaderskillstatus.js

@@ -0,0 +1,12 @@
+const { z } = require('zod')
+
+const LeaderSkillStatusSchema = z.object({
+    stackCount: z.number().int().min(1).default(1),
+    leaderSkill: z.string(),
+    status: z.string(),
+    leaderSkillExpanded: z.object({}).optional()
+})
+
+module.exports = { LeaderSkillStatusSchema }
+
+

package/schemas/special.js

@@ -0,0 +1,22 @@
+const { z } = require('zod')
+const { EffectSchema } = require('./effect')
+
+const ActionTypeEnum = z.enum(['attack', 'heal', 'none'])
+
+const SpecialSchema = z.object({
+    code: z.string(),
+    name: z.string(),
+    initialCooldown: z.number().int(),
+    cooldown: z.number().int(),
+    actionType: ActionTypeEnum.default('none'),
+    actionMultiplier: z.number().nullable(),
+    monstersOnly: z.boolean().default(false),
+    notes: z.string().optional(),
+    gotchiClass: z.string().nullable(),
+    target: z.string().nullable(),
+    effects: z.array(EffectSchema).optional(),
+})
+
+module.exports = { SpecialSchema, ActionTypeEnum }
+
+

package/schemas/team.js

@@ -0,0 +1,24 @@
+const { z } = require('zod')
+const { GotchiSchema } = require('./gotchi')
+
+const TeamSchema = z.object({
+    id: z.number().int().optional(),
+    name: z.string(),
+    leader: z.enum(['front1','front2','front3','front4','front5','back1','back2','back3','back4','back5']),
+
+    // Gotchis
+    front1Gotchi: GotchiSchema.nullable(),
+    front2Gotchi: GotchiSchema.nullable(),
+    front3Gotchi: GotchiSchema.nullable(),
+    front4Gotchi: GotchiSchema.nullable(),
+    front5Gotchi: GotchiSchema.nullable(),
+    back1Gotchi: GotchiSchema.nullable(),
+    back2Gotchi: GotchiSchema.nullable(),
+    back3Gotchi: GotchiSchema.nullable(),
+    back4Gotchi: GotchiSchema.nullable(),
+    back5Gotchi: GotchiSchema.nullable()
+})
+
+module.exports = { TeamSchema }
+
+