isaacscript-common 20.6.0 → 20.6.1

package/dist/index.d.ts

@@ -8484,10 +8484,12 @@ export declare function logSounds(): void;
 
 /**
  * Helper function for logging every key and value of a Lua table. This is a deep log; the function
- * will recursively call itself if it counters a table within a table.
+ * will recursively call itself if it encounters a table within a table.
  *
  * This function will only work on tables that have string keys (because it logs the keys in order,
  * instead of randomly). It will throw a run-time error if it encounters a non-string key.
+ *
+ * In order to prevent infinite recursion, this function will not log deeper than 10 nested tables.
  */
 export declare function logTable(luaTable: unknown, parentTables?: number): void;
 
@@ -11386,29 +11388,12 @@ declare class ModdedElementSets extends Feature {
  * mod features from this class in order to enable the `@Callback` and `@CustomCallback` decorators
  * that automatically subscribe to callbacks.
  *
- * If your feature has variables that are managed by the save data manager, put them as a `v` class
- * member and they will automatically be registered with the save data manager when the class is
- * instantiated.
- *
- * For example:
- *
- * ```ts
- * export class MyFeature extends ModFeature {
- *   v = {
- *     run: {
- *       foo: 123,
- *     }
- *   }
- *
- *   @Callback(ModCallback.POST_GAME_STARTED)
- *   postGameStarted(isContinued: boolean): void {
- *     Isaac.DebugString(`Callback fired: POST_GAME_STARTED`);
- *   }
- * }
- * ```
+ * When instantiating a mod feature class, you must pass your upgraded mod as the first argument to
+ * the constructor.
  *
- * When instantiating a feature class, you must pass your upgraded mod as the first argument to the
- * constructor.
+ * If your feature has variables that are managed by the save data manager, you need to explicitly
+ * register them with the save data manager yourself in your class constructor. (It can't be
+ * automatically done because parent classes don't have access to child class properties.)
  *
  * In almost all cases, you will want the callback functions to be immediately subscribed after
  * instantiating the class. However, if this is not the case, you can pass `false` as the optional
@@ -11627,7 +11612,7 @@ export declare function newPickingUpItem(): PickingUpItem;
 export declare function newPlayerHealth(): PlayerHealth;
 
 /**
- * Helper function to initialize an RNG object using Blade's recommended shift index.
+ * Helper function to initialize a new RNG object using Blade's recommended shift index.
  *
  * @param seed The seed to initialize it with. Default is `getRandomSeed()`.
  */

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 20.6.0
+isaacscript-common 20.6.1
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -28091,6 +28091,8 @@ function ____exports.logTable(self, luaTable, parentTables)
     end
     if parentTables == 0 then
         log(nil, "Printing out a Lua table:")
+    elseif parentTables > 10 then
+        return
     end
     local numSpaces = (parentTables + 1) * 2
     local indentation = string.rep(
@@ -49795,7 +49797,7 @@ local __TS__Class = ____lualib.__TS__Class
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local initDecoratedCallbacks, addCallback, removeCallback, initSaveDataManager, WRAPPED_CALLBACK_METHODS_KEY, WRAPPED_CUSTOM_CALLBACK_METHODS_KEY
+local initDecoratedCallbacks, addCallback, removeCallback, WRAPPED_CALLBACK_METHODS_KEY, WRAPPED_CUSTOM_CALLBACK_METHODS_KEY
 local ____array = require("src.functions.array")
 local isArray = ____array.isArray
 local ____tstlClass = require("src.functions.tstlClass")
@@ -49804,7 +49806,6 @@ local getTSTLClassName = ____tstlClass.getTSTLClassName
 local ____types = require("src.functions.types")
 local isFunction = ____types.isFunction
 local isNumber = ____types.isNumber
-local isTable = ____types.isTable
 function initDecoratedCallbacks(self, modFeature, constructor, tstlClassName, vanilla, init)
     local modFeatureConstructor = constructor
     local callbackTuplesKey = vanilla and ____exports.MOD_FEATURE_CALLBACKS_KEY or ____exports.MOD_FEATURE_CUSTOM_CALLBACKS_KEY
@@ -49916,30 +49917,6 @@ function removeCallback(self, modFeatureConstructor, mod, modCallback, vanilla)
         mod:RemoveCallbackCustom(modCallback, wrappedCallback)
     end
 end
-function initSaveDataManager(self, modFeature, tstlClassName, init)
-    local ____modFeature_0 = modFeature
-    local v = ____modFeature_0.v
-    if v == nil then
-        return
-    end
-    if not isTable(nil, v) then
-        error("Failed to initialize a mod feature class due to having a \"v\" property that is not an object. (The \"v\" property is supposed to be an object that holds the variables for the class, managed by the save data manager.)")
-    end
-    local mod = modFeature.mod
-    local saveDataManagerMethodName = init and "saveDataManager" or "saveDataManagerRemove"
-    local saveDataManagerMethod = mod[saveDataManagerMethodName]
-    if saveDataManagerMethod == nil then
-        error("Failed to initialize a mod feature class due to having a \"v\" object and not having the save data manager initialized. You must pass \"ISCFeature.SAVE_DATA_MANAGER\" to the \"upgradeMod\" function.")
-    end
-    if type(saveDataManagerMethod) ~= "function" then
-        error(("The \"" .. saveDataManagerMethodName) .. "\" property of the \"ModUpgraded\" object was not a function.")
-    end
-    if init then
-        saveDataManagerMethod(nil, tstlClassName, v)
-    else
-        saveDataManagerMethod(nil, tstlClassName)
-    end
-end
 ____exports.MOD_FEATURE_CALLBACKS_KEY = "__callbacks"
 ____exports.MOD_FEATURE_CUSTOM_CALLBACKS_KEY = "__customCallbacks"
 WRAPPED_CALLBACK_METHODS_KEY = "__wrappedCallbackMethods"
@@ -49990,7 +49967,6 @@ function ModFeature.prototype.init(self, init)
         false,
         init
     )
-    initSaveDataManager(nil, self, tstlClassName, init)
 end
 function ModFeature.prototype.uninit(self)
     self:init(false)

package/dist/src/classes/ModFeature.d.ts

@@ -8,29 +8,12 @@ export declare const MOD_FEATURE_CUSTOM_CALLBACKS_KEY = "__customCallbacks";
  * mod features from this class in order to enable the `@Callback` and `@CustomCallback` decorators
  * that automatically subscribe to callbacks.
  *
- * If your feature has variables that are managed by the save data manager, put them as a `v` class
- * member and they will automatically be registered with the save data manager when the class is
- * instantiated.
+ * When instantiating a mod feature class, you must pass your upgraded mod as the first argument to
+ * the constructor.
  *
- * For example:
- *
- * ```ts
- * export class MyFeature extends ModFeature {
- *   v = {
- *     run: {
- *       foo: 123,
- *     }
- *   }
- *
- *   @Callback(ModCallback.POST_GAME_STARTED)
- *   postGameStarted(isContinued: boolean): void {
- *     Isaac.DebugString(`Callback fired: POST_GAME_STARTED`);
- *   }
- * }
- * ```
- *
- * When instantiating a feature class, you must pass your upgraded mod as the first argument to the
- * constructor.
+ * If your feature has variables that are managed by the save data manager, you need to explicitly
+ * register them with the save data manager yourself in your class constructor. (It can't be
+ * automatically done because parent classes don't have access to child class properties.)
  *
  * In almost all cases, you will want the callback functions to be immediately subscribed after
  * instantiating the class. However, if this is not the case, you can pass `false` as the optional

package/dist/src/classes/ModFeature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModFeature.d.ts","sourceRoot":"","sources":["../../../src/classes/ModFeature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAS/D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AACvD,eAAO,MAAM,gCAAgC,sBAAsB,CAAC;AAyBpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAkB;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,yBAAyB,EAC/B,CAAC,CAAC,CAAC,SAAS,OAAO,EACjB,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,CAAC,SAAS,IAAI,GAAG,WAAW,GAAG,iBAAiB,EAC7D,GAAG,YAAY,EAAE,OAAO,EAAE,KACvB,OAAO,CAAC,GACb,IAAI,CAAQ;IAEhB;;;;;;OAMG;IACI,WAAW,UAAS;gBAEf,GAAG,EAAE,eAAe,EAAE,IAAI,UAAO;IAQ7C;;;;;OAKG;IACI,IAAI,CAAC,IAAI,UAAO,GAAG,IAAI;IAqB9B;;;;;;OAMG;IACI,MAAM,IAAI,IAAI;CAGtB"}
+{"version":3,"file":"ModFeature.d.ts","sourceRoot":"","sources":["../../../src/classes/ModFeature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAS/D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AACvD,eAAO,MAAM,gCAAgC,sBAAsB,CAAC;AAyBpE;;;;;;;;;;;;;;;GAeG;AAEH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAkB;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,yBAAyB,EAC/B,CAAC,CAAC,CAAC,SAAS,OAAO,EACjB,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,CAAC,SAAS,IAAI,GAAG,WAAW,GAAG,iBAAiB,EAC7D,GAAG,YAAY,EAAE,OAAO,EAAE,KACvB,OAAO,CAAC,GACb,IAAI,CAAQ;IAEhB;;;;;;OAMG;IACI,WAAW,UAAS;gBAEf,GAAG,EAAE,eAAe,EAAE,IAAI,UAAO;IAQ7C;;;;;OAKG;IACI,IAAI,CAAC,IAAI,UAAO,GAAG,IAAI;IAoB9B;;;;;;OAMG;IACI,MAAM,IAAI,IAAI;CAGtB"}

package/dist/src/classes/ModFeature.lua

@@ -3,7 +3,7 @@ local __TS__Class = ____lualib.__TS__Class
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local initDecoratedCallbacks, addCallback, removeCallback, initSaveDataManager, WRAPPED_CALLBACK_METHODS_KEY, WRAPPED_CUSTOM_CALLBACK_METHODS_KEY
+local initDecoratedCallbacks, addCallback, removeCallback, WRAPPED_CALLBACK_METHODS_KEY, WRAPPED_CUSTOM_CALLBACK_METHODS_KEY
 local ____array = require("src.functions.array")
 local isArray = ____array.isArray
 local ____tstlClass = require("src.functions.tstlClass")
@@ -12,7 +12,6 @@ local getTSTLClassName = ____tstlClass.getTSTLClassName
 local ____types = require("src.functions.types")
 local isFunction = ____types.isFunction
 local isNumber = ____types.isNumber
-local isTable = ____types.isTable
 function initDecoratedCallbacks(self, modFeature, constructor, tstlClassName, vanilla, init)
     local modFeatureConstructor = constructor
     local callbackTuplesKey = vanilla and ____exports.MOD_FEATURE_CALLBACKS_KEY or ____exports.MOD_FEATURE_CUSTOM_CALLBACKS_KEY
@@ -124,30 +123,6 @@ function removeCallback(self, modFeatureConstructor, mod, modCallback, vanilla)
         mod:RemoveCallbackCustom(modCallback, wrappedCallback)
     end
 end
-function initSaveDataManager(self, modFeature, tstlClassName, init)
-    local ____modFeature_0 = modFeature
-    local v = ____modFeature_0.v
-    if v == nil then
-        return
-    end
-    if not isTable(nil, v) then
-        error("Failed to initialize a mod feature class due to having a \"v\" property that is not an object. (The \"v\" property is supposed to be an object that holds the variables for the class, managed by the save data manager.)")
-    end
-    local mod = modFeature.mod
-    local saveDataManagerMethodName = init and "saveDataManager" or "saveDataManagerRemove"
-    local saveDataManagerMethod = mod[saveDataManagerMethodName]
-    if saveDataManagerMethod == nil then
-        error("Failed to initialize a mod feature class due to having a \"v\" object and not having the save data manager initialized. You must pass \"ISCFeature.SAVE_DATA_MANAGER\" to the \"upgradeMod\" function.")
-    end
-    if type(saveDataManagerMethod) ~= "function" then
-        error(("The \"" .. saveDataManagerMethodName) .. "\" property of the \"ModUpgraded\" object was not a function.")
-    end
-    if init then
-        saveDataManagerMethod(nil, tstlClassName, v)
-    else
-        saveDataManagerMethod(nil, tstlClassName)
-    end
-end
 ____exports.MOD_FEATURE_CALLBACKS_KEY = "__callbacks"
 ____exports.MOD_FEATURE_CUSTOM_CALLBACKS_KEY = "__customCallbacks"
 WRAPPED_CALLBACK_METHODS_KEY = "__wrappedCallbackMethods"
@@ -156,29 +131,12 @@ WRAPPED_CUSTOM_CALLBACK_METHODS_KEY = "__wrappedCustomCallbacksMethods"
 -- mod features from this class in order to enable the `@Callback` and `@CustomCallback` decorators
 -- that automatically subscribe to callbacks.
 -- 
--- If your feature has variables that are managed by the save data manager, put them as a `v` class
--- member and they will automatically be registered with the save data manager when the class is
--- instantiated.
--- 
--- For example:
--- 
--- ```ts
--- export class MyFeature extends ModFeature {
---   v = {
---     run: {
---       foo: 123,
---     }
---   }
--- 
--- @Callback (ModCallback.POST_GAME_STARTED)
--- postGameStarted(isContinued: boolean): void {
--- Isaac.DebugString(`Callback fired: POST_GAME_STARTED`);
--- }
--- }
--- ```
+-- When instantiating a mod feature class, you must pass your upgraded mod as the first argument to
+-- the constructor.
 -- 
--- When instantiating a feature class, you must pass your upgraded mod as the first argument to the
--- constructor.
+-- If your feature has variables that are managed by the save data manager, you need to explicitly
+-- register them with the save data manager yourself in your class constructor. (It can't be
+-- automatically done because parent classes don't have access to child class properties.)
 -- 
 -- In almost all cases, you will want the callback functions to be immediately subscribed after
 -- instantiating the class. However, if this is not the case, you can pass `false` as the optional
@@ -229,7 +187,6 @@ function ModFeature.prototype.init(self, init)
         false,
         init
     )
-    initSaveDataManager(nil, self, tstlClassName, init)
 end
 function ModFeature.prototype.uninit(self)
     self:init(false)

package/dist/src/functions/logMisc.d.ts

@@ -46,10 +46,12 @@ export declare function logSet(set: Set<AnyNotNil> | ReadonlySet<AnyNotNil>): vo
 export declare function logSounds(): void;
 /**
  * Helper function for logging every key and value of a Lua table. This is a deep log; the function
- * will recursively call itself if it counters a table within a table.
+ * will recursively call itself if it encounters a table within a table.
  *
  * This function will only work on tables that have string keys (because it logs the keys in order,
  * instead of randomly). It will throw a run-time error if it encounters a non-string key.
+ *
+ * In order to prevent infinite recursion, this function will not log deeper than 10 nested tables.
  */
 export declare function logTable(luaTable: unknown, parentTables?: number): void;
 /**

package/dist/src/functions/logMisc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logMisc.d.ts","sourceRoot":"","sources":["../../../src/functions/logMisc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logMisc.d.ts","sourceRoot":"","sources":["../../../src/functions/logMisc.ts"],"names":[],"mappings":";AAAA,OAAO,EACL,eAAe,EACf,UAAU,EACV,UAAU,EAKV,cAAc,EAGd,QAAQ,EACR,OAAO,EACR,MAAM,8BAA8B,CAAC;AAmBtC,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,IAAI,CAU3D;AAED,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,eAAe,EAAE,GAAG,IAAI,CAS7E;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAI3C;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAE7E;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAE7E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGhD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI1C;AAED,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,GAAG,UAAU,EACrD,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAC3B,WAAW,SAAK,GACf,IAAI,CAmBN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAiBxC;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAI9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAkBzC;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,IAAI,CAkBzD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CA0B3D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAoB1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC,GAC/C,IAAI,CAEN;AAED,sEAAsE;AACtE,wBAAgB,OAAO,IAAI,IAAI,CA2B9B;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAiBrC;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,GAAG,IAAI,CAezE;AAED,gFAAgF;AAChF,wBAAgB,SAAS,IAAI,IAAI,CAQhC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,SAAI,GAAG,IAAI,CA+ClE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,EACxD,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,IAAI,CA8BN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAkBpD;AAED,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAEvE;AAED,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,CAEpE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAoBnD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,IAAI,CAG7D"}

package/dist/src/functions/logMisc.lua

@@ -388,16 +388,20 @@ function ____exports.logSounds(self)
     end
 end
 --- Helper function for logging every key and value of a Lua table. This is a deep log; the function
--- will recursively call itself if it counters a table within a table.
+-- will recursively call itself if it encounters a table within a table.
 -- 
 -- This function will only work on tables that have string keys (because it logs the keys in order,
 -- instead of randomly). It will throw a run-time error if it encounters a non-string key.
+-- 
+-- In order to prevent infinite recursion, this function will not log deeper than 10 nested tables.
 function ____exports.logTable(self, luaTable, parentTables)
     if parentTables == nil then
         parentTables = 0
     end
     if parentTables == 0 then
         log(nil, "Printing out a Lua table:")
+    elseif parentTables > 10 then
+        return
     end
     local numSpaces = (parentTables + 1) * 2
     local indentation = string.rep(

package/dist/src/functions/rng.d.ts

@@ -25,7 +25,7 @@ export declare function isRNG(object: unknown): object is RNG;
  */
 export declare function isSerializedRNG(object: unknown): object is SerializedRNG;
 /**
- * Helper function to initialize an RNG object using Blade's recommended shift index.
+ * Helper function to initialize a new RNG object using Blade's recommended shift index.
  *
  * @param seed The seed to initialize it with. Default is `getRandomSeed()`.
  */

package/dist/src/functions/rng.lua

@@ -26,7 +26,7 @@ end
 function ____exports.isRNG(self, object)
     return isIsaacAPIClassOfType(nil, object, OBJECT_NAME)
 end
---- Helper function to initialize an RNG object using Blade's recommended shift index.
+--- Helper function to initialize a new RNG object using Blade's recommended shift index.
 -- 
 -- @param seed The seed to initialize it with. Default is `getRandomSeed()`.
 function ____exports.newRNG(self, seed)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "20.6.0",
+  "version": "20.6.1",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/classes/ModFeature.ts

@@ -5,7 +5,7 @@ import {
   getTSTLClassConstructor,
   getTSTLClassName,
 } from "../functions/tstlClass";
-import { isFunction, isNumber, isTable } from "../functions/types";
+import { isFunction, isNumber } from "../functions/types";
 import { TSTLClassMetatable } from "../interfaces/TSTLClassMetatable";
 import { AnyFunction } from "../types/AnyFunction";
 import { ModUpgradedBase } from "./ModUpgradedBase";
@@ -41,29 +41,12 @@ type ModFeatureConstructor = TSTLClassMetatable["constructor"] & {
  * mod features from this class in order to enable the `@Callback` and `@CustomCallback` decorators
  * that automatically subscribe to callbacks.
  *
- * If your feature has variables that are managed by the save data manager, put them as a `v` class
- * member and they will automatically be registered with the save data manager when the class is
- * instantiated.
+ * When instantiating a mod feature class, you must pass your upgraded mod as the first argument to
+ * the constructor.
  *
- * For example:
- *
- * ```ts
- * export class MyFeature extends ModFeature {
- *   v = {
- *     run: {
- *       foo: 123,
- *     }
- *   }
- *
- *   @Callback(ModCallback.POST_GAME_STARTED)
- *   postGameStarted(isContinued: boolean): void {
- *     Isaac.DebugString(`Callback fired: POST_GAME_STARTED`);
- *   }
- * }
- * ```
- *
- * When instantiating a feature class, you must pass your upgraded mod as the first argument to the
- * constructor.
+ * If your feature has variables that are managed by the save data manager, you need to explicitly
+ * register them with the save data manager yourself in your class constructor. (It can't be
+ * automatically done because parent classes don't have access to child class properties.)
  *
  * In almost all cases, you will want the callback functions to be immediately subscribed after
  * instantiating the class. However, if this is not the case, you can pass `false` as the optional
@@ -147,7 +130,6 @@ export class ModFeature {
 
     initDecoratedCallbacks(this, constructor, tstlClassName, true, init);
     initDecoratedCallbacks(this, constructor, tstlClassName, false, init);
-    initSaveDataManager(this, tstlClassName, init);
   }
 
   /**
@@ -334,46 +316,3 @@ function removeCallback(
     (mod.RemoveCallbackCustom as AnyFunction)(modCallback, wrappedCallback);
   }
 }
-
-function initSaveDataManager(
-  modFeature: ModFeature,
-  tstlClassName: string,
-  init: boolean,
-) {
-  // Do nothing if this class does not have any variables.
-  const { v } = modFeature as unknown as Record<string, unknown>;
-  if (v === undefined) {
-    return;
-  }
-
-  if (!isTable(v)) {
-    error(
-      'Failed to initialize a mod feature class due to having a "v" property that is not an object. (The "v" property is supposed to be an object that holds the variables for the class, managed by the save data manager.)',
-    );
-  }
-
-  // Do nothing if we have not enabled the save data manager.
-  // eslint-disable-next-line @typescript-eslint/dot-notation
-  const mod = modFeature["mod"] as unknown as Record<string, unknown>;
-  const saveDataManagerMethodName = init
-    ? "saveDataManager"
-    : "saveDataManagerRemove";
-  const saveDataManagerMethod = mod[saveDataManagerMethodName];
-  if (saveDataManagerMethod === undefined) {
-    error(
-      'Failed to initialize a mod feature class due to having a "v" object and not having the save data manager initialized. You must pass "ISCFeature.SAVE_DATA_MANAGER" to the "upgradeMod" function.',
-    );
-  }
-
-  if (typeof saveDataManagerMethod !== "function") {
-    error(
-      `The "${saveDataManagerMethodName}" property of the "ModUpgraded" object was not a function.`,
-    );
-  }
-
-  if (init) {
-    saveDataManagerMethod(tstlClassName, v);
-  } else {
-    saveDataManagerMethod(tstlClassName);
-  }
-}

package/src/functions/logMisc.ts

@@ -326,14 +326,18 @@ export function logSounds(): void {
 
 /**
  * Helper function for logging every key and value of a Lua table. This is a deep log; the function
- * will recursively call itself if it counters a table within a table.
+ * will recursively call itself if it encounters a table within a table.
  *
  * This function will only work on tables that have string keys (because it logs the keys in order,
  * instead of randomly). It will throw a run-time error if it encounters a non-string key.
+ *
+ * In order to prevent infinite recursion, this function will not log deeper than 10 nested tables.
  */
 export function logTable(luaTable: unknown, parentTables = 0): void {
   if (parentTables === 0) {
     log("Printing out a Lua table:");
+  } else if (parentTables > 10) {
+    return;
   }
 
   const numSpaces = (parentTables + 1) * 2; // 2, 4, 6, etc.

package/src/functions/rng.ts

@@ -83,7 +83,7 @@ export function isSerializedRNG(object: unknown): object is SerializedRNG {
 }
 
 /**
- * Helper function to initialize an RNG object using Blade's recommended shift index.
+ * Helper function to initialize a new RNG object using Blade's recommended shift index.
  *
  * @param seed The seed to initialize it with. Default is `getRandomSeed()`.
  */