gotchi-battler-game-logic 4.0.13 → 4.0.15

package/game-logic/v2.0/constants.js

@@ -1,112 +1,10 @@
-const PASSIVES = ['sharp_blades', 'cloud_of_zen', 'frenzy', 'fortify', 'spread_the_fear', 'cleansing_aura', 'channel_the_coven', 'clan_momentum']
-const DEBUFF_STATUSES = ['bleed', 'stun', 'fear']
-const BUFF_STATUSES = ['taunt']
+const AUTO_ATTACK_MULTIPLIER = 0.85
+const COUNTER_ATTACK_MULTIPLIER = 0.5
 
-const BUFF_MULT_EFFECTS = {
-    cloud_of_zen: {
-        magic: 0.138,
-        physical: 0.138
-    },
-    power_up_2: {
-        magic: 0.75,
-        physical: 0.50
-    },
-    frenzy: {
-        crit: 1.14
-    },
-    fortify: {
-        armor: 1
-    },
-    taunt: {
-        armor: 1.65
-    },
-    channel_the_coven: {
-        magic: 0.18
-    },
-    clan_momentum: {
-        physical: 0.16
-    }
-}
-
-const BUFF_FLAT_EFFECTS = {
-
-}
-
-// Combine all buffs
-const BUFFS = [...PASSIVES, ...BUFF_STATUSES, ...Object.keys(BUFF_MULT_EFFECTS), ...Object.keys(BUFF_FLAT_EFFECTS)]
-
-const DEBUFF_MULT_EFFECTS = {
-    fear: {
-        resist: 1
-    },
-    stun: {
-        speed: 0.23
-    }
-}
-
-const DEBUFF_FLAT_EFFECTS = {
-    
-}
-
-// Combine all debuffs
-const DEBUFFS = [...DEBUFF_STATUSES, ...Object.keys(DEBUFF_MULT_EFFECTS), ...Object.keys(DEBUFF_FLAT_EFFECTS)]
-
-const MULTS = {
-    // General
-    FRONT_ROW_ATK_BONUS: 1.1,
-    FRONT_ROW_DEF_NERF: 0.8,
-    EXPIRE_LEADERSKILL: 0,
-    SPEED_PENALTY: 2.5,
-    MAX_STATUSES: 3,
-    CRIT_MULTIPLIER_FAST: 2,
-    CRIT_MULTIPLIER_SLOW: 2,
-    // Ninja
-    SHARP_BLADES_BLEED_CHANCE: 0.76,
-    BLEED_DAMAGE: 10,
-    SPECTRAL_STRIKE_DAMAGE: 1.25,
-    // Enlightened
-    // Cleaver
-    CLEAVE_DAMAGE: 1.55,
-    // Tank
-    COUNTER_SPEED_MULTIPLIER: 0.5,
-    FORTIFY_COUNTER_CHANCE: 32,
-    COUNTER_DAMAGE: 1.9,
-    FORTIFY_COUNTER_DAMAGE: 1.9,
-    // Cursed
-    SPREAD_THE_FEAR_CHANCE: 0.84,
-    SPREAD_THE_FEAR_SPEED_PENALTY: 0,
-    SPREAD_THE_FEAR_CURSE_DAMAGE: 1.3,
-    CURSE_DAMAGE: 1.2,
-    CURSE_HEAL: 1,
-    CURSE_SPEED_PENALTY: 0,
-    // Healer
-    CLEANSING_AURA_REGEN: 0.2,
-    CLEANSING_AURA_NON_HEALER_REGEN: 0.1,
-    CLEANSING_AURA_HEAL: 3.4,
-    CLEANSING_AURA_HEAL_SPEED_PENALTY: 1,
-    BLESSING_HEAL: 2.7,
-    BLESSING_HEAL_SPEED_PENALTY: 1,
-    BLESSING_HEAL_CRIT_MULTIPLIER: 1.25,
-    // Mage
-    CHANNEL_THE_COVEN_STUN_CHANCE: 0.9,
-    THUNDER_STUN_CHANCE: 0.65,
-    THUNDER_DAMAGE: 1,
-    // Troll
-    CLAN_MOMENTUM_CHANCE: 0.9,
-    DEVESTATING_SMASH_X2_CHANCE: 0.65,
-    DEVESTATING_SMASH_DAMAGE: 2.5,
-    DEVESTATING_SMASH_X2_DAMAGE: 1.9,
-}
+const DEFAULT_MAX_STATUSES = 9
 
 module.exports = {
-    PASSIVES,
-    DEBUFF_STATUSES,
-    BUFF_STATUSES,
-    BUFF_MULT_EFFECTS,
-    BUFF_FLAT_EFFECTS,
-    BUFFS,
-    DEBUFF_MULT_EFFECTS,
-    DEBUFF_FLAT_EFFECTS,
-    DEBUFFS,
-    MULTS
+    AUTO_ATTACK_MULTIPLIER,
+    COUNTER_ATTACK_MULTIPLIER,
+    DEFAULT_MAX_STATUSES
 }

package/game-logic/v2.0/helpers.js

@@ -1,4 +1,5 @@
 const STATUSES = require('./statuses.json')
+const { DEFAULT_MAX_STATUSES } = require('./constants')
 
 const getTeamGotchis = (team) => {
     return [...team.formation.front, ...team.formation.back].filter(x => x)
@@ -89,14 +90,18 @@ const getNextToAct = (team1, team2, rng) => {
 
     aliveGotchis.sort((a, b) => a.actionDelay - b.actionDelay)
 
-    let toAct = aliveGotchis.filter(gotchi => gotchi.actionDelay === aliveGotchis[0].actionDelay)
+    // actionDelay is stored at 3 decimal precision; compare using scaled ints to avoid float-equality issues.
+    const minActionDelay = Math.round(aliveGotchis[0].actionDelay * 1000)
+    let toAct = aliveGotchis.filter(gotchi => Math.round(gotchi.actionDelay * 1000) === minActionDelay)
 
     // If only one gotchi can act then return it
     if (toAct.length === 1) return getFormationPosition(team1, team2, toAct[0].id)
 
     // Lowest speeds win tiebreaker
     toAct.sort((a, b) => a.speed - b.speed)
-    toAct = toAct.filter(gotchi => gotchi.speed === toAct[0].speed)
+    // speed is stored at 1 decimal precision; compare using scaled ints to avoid float-equality issues.
+    const minSpeed = Math.round(toAct[0].speed * 10)
+    toAct = toAct.filter(gotchi => Math.round(gotchi.speed * 10) === minSpeed)
 
     // If only one gotchi can act then return it
 
@@ -298,8 +303,6 @@ const getHealFromMultiplier = (healingGotchi, target, multiplier) => {
 const getModifiedStats = (gotchi) => {
     const statMods = {}
 
-    const decimalStats = ['criticalRate', 'criticalDamage']
-
     gotchi.statuses.forEach(statusCode => {
         const statusStatMods = {}
         const status = getStatusByCode(statusCode)
@@ -320,10 +323,11 @@ const getModifiedStats = (gotchi) => {
                 throw new Error(`Invalid value type for status ${statusCode}: ${statModifier.valueType}`)
             }
 
-            if (decimalStats.includes(statModifier.statName)) {
-                statChange = Math.round(statChange * 100) / 100
-            } else {
+            // Preserve our stat precision model.
+            if (statModifier.statName === 'health') {
                 statChange = Math.round(statChange)
+            } else {
+                statChange = Math.round(statChange * 10) / 10
             }
 
             if (statusStatMods[statModifier.statName]) {
@@ -352,6 +356,16 @@ const getModifiedStats = (gotchi) => {
         }
     })
 
+    // Normalize precision after all mods (avoid accumulating float noise).
+    for (const key of ['speed', 'attack', 'defense', 'criticalRate', 'criticalDamage', 'resist', 'focus']) {
+        if (typeof modifiedGotchi[key] === 'number' && Number.isFinite(modifiedGotchi[key])) {
+            modifiedGotchi[key] = Math.round(modifiedGotchi[key] * 10) / 10
+        }
+    }
+    if (typeof modifiedGotchi.health === 'number' && Number.isFinite(modifiedGotchi.health)) {
+        modifiedGotchi.health = Math.round(modifiedGotchi.health)
+    }
+
     // Enforce practical lower bounds for certain stats regardless of whether they were modified by statuses
     if (modifiedGotchi.defense < 1) {
         modifiedGotchi.defense = 1
@@ -460,7 +474,7 @@ const addStatusToGotchi = (gotchi, statusCode, count) => {
 
     const status = getStatusByCode(statusCode)
 
-    const maxStack = status.maxStack || 3
+    const maxStack = status.maxStack || DEFAULT_MAX_STATUSES
 
     // Only allow a maximum of maxStack of the same status
     const currentStacks = gotchi.statuses.filter(x => x === status.code).length
@@ -519,6 +533,8 @@ const prepareTeams = (allAliveGotchis, team1, team2) => {
 
     // Apply stat items
     applyStatItems(allAliveGotchis)
+    // Apply crystals
+    applyCrystals(allAliveGotchis)
 
     allAliveGotchis.forEach(x => {
         // Add statuses property to all gotchis
@@ -606,8 +622,21 @@ const getLogGotchis = (allAliveGotchis) => {
 const applyStatItems = (gotchis) => {
     gotchis.forEach(gotchi => {
         // Apply stat items
-        if (gotchi.item && gotchi.item.stat && gotchi.item.statValue) {
-            gotchi[gotchi.item.stat] += gotchi.item.statValue
+        // Support both shapes:
+        // - gotchi.itemExpanded: full item object (preferred)
+        // - gotchi.item: full item object (legacy)
+        const item = gotchi.itemExpanded || gotchi.item
+        if (item && item.stat && item.statValue != null) {
+            const v = Number(item.statValue)
+            if (!Number.isFinite(v)) return
+            gotchi[item.stat] += v
+
+            // Preserve stat precision model
+            if (item.stat === 'health') {
+                gotchi.health = Math.round(gotchi.health)
+            } else {
+                gotchi[item.stat] = Math.round(gotchi[item.stat] * 10) / 10
+            }
         }
     })
 }
@@ -620,8 +649,64 @@ const applyStatItems = (gotchis) => {
 const removeStatItems = (gotchis) => {
     gotchis.forEach(gotchi => {
         // Remove stat items
-        if (gotchi.item && gotchi.item.stat && gotchi.item.statValue) {
-            gotchi[gotchi.item.stat] -= gotchi.item.statValue
+        const item = gotchi.itemExpanded || gotchi.item
+        if (item && item.stat && item.statValue != null) {
+            const v = Number(item.statValue)
+            if (!Number.isFinite(v)) return
+            gotchi[item.stat] -= v
+
+            if (item.stat === 'health') {
+                gotchi.health = Math.round(gotchi.health)
+            } else {
+                gotchi[item.stat] = Math.round(gotchi[item.stat] * 10) / 10
+            }
+        }
+    })
+}
+
+/**
+ * Apply crystals to gotchis.
+ * Expects crystals to be present as crystalSlot{n}Expanded objects (preferred).
+ */
+const applyCrystals = (gotchis) => {
+    gotchis.forEach((gotchi) => {
+        for (let i = 1; i <= 6; i++) {
+            const crystal = gotchi[`crystalSlot${i}Expanded`]
+            if (!crystal || !crystal.stat || crystal.statValue == null) continue
+
+            const v = Number(crystal.statValue)
+            if (!Number.isFinite(v)) continue
+
+            gotchi[crystal.stat] += v
+
+            if (crystal.stat === 'health') {
+                gotchi.health = Math.round(gotchi.health)
+            } else {
+                gotchi[crystal.stat] = Math.round(gotchi[crystal.stat] * 10) / 10
+            }
+        }
+    })
+}
+
+/**
+ * Remove crystals from gotchis (for log replays if needed).
+ */
+const removeCrystals = (gotchis) => {
+    gotchis.forEach((gotchi) => {
+        for (let i = 1; i <= 6; i++) {
+            const crystal = gotchi[`crystalSlot${i}Expanded`]
+            if (!crystal || !crystal.stat || crystal.statValue == null) continue
+
+            const v = Number(crystal.statValue)
+            if (!Number.isFinite(v)) continue
+
+            gotchi[crystal.stat] -= v
+
+            if (crystal.stat === 'health') {
+                gotchi.health = Math.round(gotchi.health)
+            } else {
+                gotchi[crystal.stat] = Math.round(gotchi[crystal.stat] * 10) / 10
+            }
         }
     })
 }
@@ -682,9 +767,11 @@ const focusCheck = (attackingTeam, attackingGotchi, targetGotchi, rng) => {
     if (attackingTeamGotchis.find(gotchi => gotchi.id === targetGotchi.id)) {
         return true
     } else {
-        // Status apply chance is clamp(0.5 + (FOC - RES) / 400, 0.15, 0.95)
-        // This reduces how often we saturate at the clamp endpoints (0.15/0.95) when Focus/Resist grades differ.
-        const chance = Math.max(Math.min(0.5 + (modifiedAttackingGotchi.focus - modifiedTargetGotchi.resist) / 400, 0.95), 0.15)
+        // Status apply chance is clamp(0.5 + (FOC - RES) / K, 0.15, 0.95)
+        // With the new 0.1-precision stat scale, Focus/Resist are much smaller, so we use a smaller K
+        // to keep FOC/RES impactful. Design target: ±20 should saturate clamps.
+        const K = 40
+        const chance = Math.max(Math.min(0.5 + (modifiedAttackingGotchi.focus - modifiedTargetGotchi.resist) / K, 0.95), 0.15)
 
         const result = rng() < chance
 
@@ -730,6 +817,8 @@ module.exports = {
     getLogGotchis,
     applyStatItems,
     removeStatItems,
+    applyCrystals,
+    removeCrystals,
     getTeamStats,
     getStatusByCode,
     getTeamSpecialBars,

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

@@ -2,14 +2,14 @@
     {
         "code": "spd_up",
         "name": "Speed Buff",
-        "description": "+15% SPD per stack",
+        "description": "+10% SPD per stack",
         "category": "stat_modifier",
         "isBuff": true,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "speed",
-                "value": 15,
+                "value": 10,
                 "valueType": "percent"
             }
         ]
@@ -17,14 +17,14 @@
     {
         "code": "atk_up",
         "name": "Attack Buff",
-        "description": "+8% ATK per stack",
+        "description": "+10% ATK per stack",
         "category": "stat_modifier",
         "isBuff": true,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "attack",
-                "value": 8,
+                "value": 10,
                 "valueType": "percent"
             }
         ]
@@ -32,14 +32,14 @@
     {
         "code": "def_up",
         "name": "Defense Buff",
-        "description": "+8% DEF per stack",
+        "description": "+10% DEF per stack",
         "category": "stat_modifier",
         "isBuff": true,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "defense",
-                "value": 8,
+                "value": 10,
                 "valueType": "percent"
             }
         ]
@@ -47,74 +47,74 @@
     {
         "code": "crt_up",
         "name": "Critical-Rate Buff",
-        "description": "+2 CRT per stack",
+        "description": "+10% CRT per stack",
         "category": "stat_modifier",
         "isBuff": true,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "criticalRate",
-                "value": 2,
-                "valueType": "flat"
+                "value": 10,
+                "valueType": "percent"
             }
         ]
     },
     {
         "code": "crd_up",
         "name": "Critical-Damage Buff",
-        "description": "+8 CRD per stack",
+        "description": "+10% CRD per stack",
         "category": "stat_modifier",
         "isBuff": true,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "criticalDamage",
-                "value": 8,
-                "valueType": "flat"
+                "value": 10,
+                "valueType": "percent"
             }
         ]
     },
     {
         "code": "res_up",
         "name": "Resistance Buff",
-        "description": "+14 RES per stack",
+        "description": "+10% RES per stack",
         "category": "stat_modifier",
         "isBuff": true,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "resist",
-                "value": 14,
-                "valueType": "flat"
+                "value": 10,
+                "valueType": "percent"
             }
         ]
     },
     {
         "code": "foc_up",
         "name": "Focus Buff",
-        "description": "+12 FOC per stack",
+        "description": "+10% FOC per stack",
         "category": "stat_modifier",
         "isBuff": true,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "focus",
-                "value": 12,
-                "valueType": "flat"
+                "value": 10,
+                "valueType": "percent"
             }
         ]
     },
     {
         "code": "spd_down",
         "name": "Speed Debuff",
-        "description": "-15% SPD per stack",
+        "description": "-10% SPD per stack",
         "category": "stat_modifier",
         "isBuff": false,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "speed",
-                "value": -15,
+                "value": -10,
                 "valueType": "percent"
             }
         ]
@@ -122,14 +122,14 @@
     {
         "code": "atk_down",
         "name": "Attack Debuff",
-        "description": "-8% ATK per stack",
+        "description": "-10% ATK per stack",
         "category": "stat_modifier",
         "isBuff": false,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "attack",
-                "value": -8,
+                "value": -10,
                 "valueType": "percent"
             }
         ]
@@ -137,14 +137,14 @@
     {
         "code": "def_down",
         "name": "Defense Debuff",
-        "description": "-8% DEF per stack",
+        "description": "-10% DEF per stack",
         "category": "stat_modifier",
         "isBuff": false,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "defense",
-                "value": -8,
+                "value": -10,
                 "valueType": "percent"
             }
         ]
@@ -152,60 +152,60 @@
     {
         "code": "crt_down",
         "name": "Critical-Rate Debuff",
-        "description": "-2 CRT per stack",
+        "description": "-10% CRT per stack",
         "category": "stat_modifier",
         "isBuff": false,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "criticalRate",
-                "value": -2,
-                "valueType": "flat"
+                "value": -10,
+                "valueType": "percent"
             }
         ]
     },
     {
         "code": "crd_down",
         "name": "Critical-Damage Debuff",
-        "description": "-8 CRD per stack",
+        "description": "-10% CRD per stack",
         "category": "stat_modifier",
         "isBuff": false,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "criticalDamage",
-                "value": -8,
-                "valueType": "flat"
+                "value": -10,
+                "valueType": "percent"
             }
         ]
     },
     {
         "code": "res_down",
         "name": "Resistance Debuff",
-        "description": "-14 RES per stack",
+        "description": "-10% RES per stack",
         "category": "stat_modifier",
         "isBuff": false,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "resist",
-                "value": -14,
-                "valueType": "flat"
+                "value": -10,
+                "valueType": "percent"
             }
         ]
     },
     {
         "code": "foc_down",
         "name": "Focus Debuff",
-        "description": "-12 FOC per stack",
+        "description": "-10% FOC per stack",
         "category": "stat_modifier",
         "isBuff": false,
         "maxStack": null,
         "statModifiers": [
             {
                 "statName": "focus",
-                "value": -12,
-                "valueType": "flat"
+                "value": -10,
+                "valueType": "percent"
             }
         ]
     },

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "gotchi-battler-game-logic",
-    "version": "4.0.13",
+    "version": "4.0.15",
     "main": "index.js",
     "scripts": {
         "test": "mocha \"tests/**/*.test.js\"",

package/schemas/crystal.js

@@ -6,7 +6,7 @@ const CrystalSchema = z.object({
     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(),
+    statValue: z.number()
 })
 
 module.exports = { CrystalSchema }

package/schemas/gotchi.js

@@ -6,19 +6,19 @@ const { CrystalSchema } = require('./crystal')
 
 const GotchiSchema = z.object({
     id: z.number().int(),
-    onchainId: z.number().int(),
+    onchainId: z.number().int().nullable().optional(), // monsters don't have onchain ids
     name: z.string(),
     type: z.enum(['gotchi', 'spirit', 'monster']),
     visualCode: z.string(),
     level: z.number().int(),
-    speed: z.number().int(),
+    speed: z.number(),
     health: z.number().int(),
-    attack: z.number().int(),
-    defense: z.number().int(),
+    attack: z.number(),
+    defense: z.number(),
     criticalRate: z.number(),
-    criticalDamage: z.number().int(),
-    resist: z.number().int(),
-    focus: z.number().int(),
+    criticalDamage: z.number(),
+    resist: z.number(),
+    focus: z.number(),
 
     // Foreign keys
     gotchiClass: z.string(),

package/schemas/item.js

@@ -7,7 +7,7 @@ const ItemSchema = z.object({
     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()
+    statValue: z.number()
 })
 
 module.exports = { ItemSchema }