isaacscript-common 1.2.190 → 1.2.191

package/dist/features/characterStats.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * Helper function to manage the stats for a vanilla or custom character. Call this function once at
+ * the beginning of your mod to declare the starting stats.
+ *
+ * You must provide this function with a map of CacheFlag to the default stat amount. For example,
+ * the default amount of damage is 3.5. To make a custom character start with 4.5 damage:
+ *
+ * ```ts
+ * const fooDefaultStats = new Map<CacheFlag, number>([
+ *   [CacheFlag.CACHE_DAMAGE, 4.5],
+ * ])
+ * registerCharacterStats(PlayerTypeCustom.FOO, fooDefaultStats);
+ * ```
+ *
+ * Note that the format for the `CacheFlag.CACHE_FIREDELAY` value should be in the tears stat
+ * format, not the `MaxFireDelay` format.
+ */
+export declare function registerCharacterStats(playerType: PlayerType | int, statMap: Map<CacheFlag, number>): void;

package/dist/features/characterStats.lua

@@ -0,0 +1,77 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local evaluateCache, charactersStatMap
+local ____featuresInitialized = require("featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____cacheFlag = require("functions.cacheFlag")
+local getDefaultPlayerStat = ____cacheFlag.getDefaultPlayerStat
+local ____tears = require("functions.tears")
+local addTearsStat = ____tears.addTearsStat
+function evaluateCache(self, player, cacheFlag)
+    local character = player:GetPlayerType()
+    local statMap = charactersStatMap:get(character)
+    if statMap == nil then
+        return
+    end
+    local stat = statMap:get(cacheFlag)
+    local defaultStat = getDefaultPlayerStat(nil, cacheFlag)
+    if stat == nil or defaultStat == nil then
+        return
+    end
+    local delta = stat - defaultStat
+    repeat
+        local ____switch6 = cacheFlag
+        local ____cond6 = ____switch6 == CacheFlag.CACHE_DAMAGE
+        if ____cond6 then
+            do
+                player.Damage = player.Damage + delta
+                return
+            end
+        end
+        ____cond6 = ____cond6 or ____switch6 == CacheFlag.CACHE_FIREDELAY
+        if ____cond6 then
+            do
+                addTearsStat(nil, player, delta)
+                return
+            end
+        end
+        ____cond6 = ____cond6 or ____switch6 == CacheFlag.CACHE_SHOTSPEED
+        if ____cond6 then
+            do
+                player.ShotSpeed = player.ShotSpeed + delta
+                break
+            end
+        end
+        ____cond6 = ____cond6 or ____switch6 == CacheFlag.CACHE_RANGE
+        if ____cond6 then
+            do
+                player.TearHeight = player.TearHeight + delta
+                break
+            end
+        end
+        ____cond6 = ____cond6 or ____switch6 == CacheFlag.CACHE_SPEED
+        if ____cond6 then
+            do
+                player.MoveSpeed = player.MoveSpeed + delta
+                break
+            end
+        end
+        do
+            do
+                break
+            end
+        end
+    until true
+end
+local FEATURE_NAME = "character stat manager"
+charactersStatMap = __TS__New(Map)
+function ____exports.characterStatsInit(self, mod)
+    mod:AddCallback(ModCallbacks.MC_EVALUATE_CACHE, evaluateCache)
+end
+function ____exports.registerCharacterStats(self, playerType, statMap)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    charactersStatMap:set(playerType, statMap)
+end
+return ____exports

package/dist/functions/cacheFlag.d.ts

@@ -1,7 +1,8 @@
 /// <reference types="isaac-typescript-definitions" />
 /**
- * Returns the starting stat that Isaac (the default character) starts with.
+ * Returns the starting stat that Isaac (the default character) starts with. For example, if you
+ * pass this function `CacheFlag.CACHE_DAMAGE`, it will return 3.5.
  *
- * For example, if you pass this function `CacheFlag.CACHE_DAMAGE`, it will return 3.5.
+ * Note that the default fire delay is represented in the tear stat, not the `MaxFireDelay` value.
  */
 export declare function getDefaultPlayerStat(cacheFlag: CacheFlag): number | undefined;

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export * from "./enums/PillEffectClass";
 export * from "./enums/PillEffectType";
 export * from "./enums/PocketItemType";
 export * from "./enums/SerializationType";
+export * from "./features/characterStats";
 export { deployJSONRoom, deployRandomJSONRoom, emptyRoom, } from "./features/deployJSONRoom";
 export { disableAllInputs, disableAllInputsExceptFor, disableMovementInputs, disableShootingInputs, enableAllInputs, enableAllInputsExceptFor, } from "./features/disableInputs";
 export { disableAllSound, enableAllSound } from "./features/disableSound";

package/dist/index.lua

@@ -110,6 +110,14 @@ do
         end
     end
 end
+do
+    local ____export = require("features.characterStats")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____deployJSONRoom = require("features.deployJSONRoom")
     local deployJSONRoom = ____deployJSONRoom.deployJSONRoom

package/dist/maps/defaultPlayerStatMap.d.ts

@@ -1,2 +1,3 @@
 /// <reference types="isaac-typescript-definitions" />
+/** The default fire delay is represented in the tear stat, not the `MaxFireDelay` value. */
 export declare const DEFAULT_PLAYER_STAT_MAP: ReadonlyMap<CacheFlag, number>;

package/dist/maps/defaultPlayerStatMap.lua

@@ -2,12 +2,21 @@ local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-____exports.DEFAULT_PLAYER_STAT_MAP = __TS__New(Map, {
-    {CacheFlag.CACHE_DAMAGE, 3.5},
-    {CacheFlag.CACHE_FIREDELAY, 10},
-    {CacheFlag.CACHE_SHOTSPEED, 1},
-    {CacheFlag.CACHE_RANGE, 6.5},
-    {CacheFlag.CACHE_SPEED, 1},
-    {CacheFlag.CACHE_LUCK, 0}
-})
+local ____tears = require("functions.tears")
+local getTearsStat = ____tears.getTearsStat
+local DEFAULT_MAX_FIRE_DELAY = 10
+____exports.DEFAULT_PLAYER_STAT_MAP = __TS__New(
+    Map,
+    {
+        {CacheFlag.CACHE_DAMAGE, 3.5},
+        {
+            CacheFlag.CACHE_FIREDELAY,
+            getTearsStat(nil, DEFAULT_MAX_FIRE_DELAY)
+        },
+        {CacheFlag.CACHE_SHOTSPEED, 1},
+        {CacheFlag.CACHE_RANGE, 6.5},
+        {CacheFlag.CACHE_SPEED, 1},
+        {CacheFlag.CACHE_LUCK, 0}
+    }
+)
 return ____exports

package/dist/upgradeMod.lua

@@ -78,6 +78,8 @@ local ____roomClearChange = require("callbacks.roomClearChange")
 local roomClearChangeCallbackInit = ____roomClearChange.roomClearChangeCallbackInit
 local ____ModUpgraded = require("classes.ModUpgraded")
 local ModUpgraded = ____ModUpgraded.ModUpgraded
+local ____characterStats = require("features.characterStats")
+local characterStatsInit = ____characterStats.characterStatsInit
 local ____deployJSONRoom = require("features.deployJSONRoom")
 local deployJSONRoomInit = ____deployJSONRoom.deployJSONRoomInit
 local ____disableInputs = require("features.disableInputs")
@@ -163,6 +165,7 @@ function initFeatures(self, mod)
     taintedLazarusPlayersInit(nil, mod)
     fastResetInit(nil, mod)
     fadeInRemoverInit(nil, mod)
+    characterStatsInit(nil, mod)
 end
 function ____exports.upgradeMod(self, modVanilla, verbose)
     if verbose == nil then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.190",
+  "version": "1.2.191",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",