isaacscript-common 11.0.1 → 11.2.0

package/dist/src/functions/tears.lua

@@ -33,6 +33,9 @@ end
 -- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
+-- 
+-- Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+-- this case, it will always appear as if the tear is coming from a player.
 function ____exports.isTearFromFamiliar(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromFamiliar\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
@@ -52,6 +55,9 @@ end
 -- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
+-- 
+-- Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+-- this case, it will always appear as if the tear is coming from a player.
 function ____exports.isTearFromPlayer(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromPlayer\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")

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

@@ -24,6 +24,8 @@ export declare function getOpenTrinketSlot(player: EntityPlayer): int | undefine
 /**
  * Helper function to get the in-game description for a trinket. Returns "Unknown" if the provided
  * trinket type was not valid.
+ *
+ * This function works for both vanilla and modded trinkets.
  */
 export declare function getTrinketDescription(trinketType: TrinketType): string;
 /**
@@ -40,6 +42,8 @@ export declare function getTrinketGfxFilename(trinketType: TrinketType): string;
  * not valid.
  *
  * For example, `getTrinketName(TrinketType.SWALLOWED_PENNY)` would return "Swallowed Penny".
+ *
+ * This function works for both vanilla and modded trinkets.
  */
 export declare function getTrinketName(trinketType: TrinketType): string;
 /** Helper function to get an array that represents every vanilla trinket type. */

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

@@ -1 +1 @@
-{"version":3,"file":"trinkets.d.ts","sourceRoot":"","sources":["../../../src/functions/trinkets.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAkCtC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAE1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,GAAG,SAAS,CAkBxE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CActE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAOtE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAc/D;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,IAAI,WAAW,EAAE,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAOhE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CASjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAeN"}
+{"version":3,"file":"trinkets.d.ts","sourceRoot":"","sources":["../../../src/functions/trinkets.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAkCtC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAE1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,GAAG,SAAS,CAkBxE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CActE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAOtE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAc/D;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,IAAI,WAAW,EAAE,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAOhE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CASjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAeN"}

package/dist/src/functions/trinkets.lua

@@ -75,6 +75,8 @@ function ____exports.getOpenTrinketSlot(self, player)
 end
 --- Helper function to get the in-game description for a trinket. Returns "Unknown" if the provided
 -- trinket type was not valid.
+-- 
+-- This function works for both vanilla and modded trinkets.
 function ____exports.getTrinketDescription(self, trinketType)
     local trinketDescription = TRINKET_DESCRIPTION_MAP:get(trinketType)
     if trinketDescription ~= nil then
@@ -103,6 +105,8 @@ end
 -- not valid.
 -- 
 -- For example, `getTrinketName(TrinketType.SWALLOWED_PENNY)` would return "Swallowed Penny".
+-- 
+-- This function works for both vanilla and modded trinkets.
 function ____exports.getTrinketName(self, trinketType)
     local trinketName = TRINKET_TYPE_TO_NAME_MAP:get(trinketType)
     if trinketName ~= nil then

package/dist/src/maps/transformationNameToPlayerForm.d.ts

@@ -0,0 +1,4 @@
+import { PlayerForm } from "isaac-typescript-definitions";
+/** Maps transformation names to the values of the `PlayerForm` enum. */
+export declare const TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP: ReadonlyMap<string, PlayerForm>;
+//# sourceMappingURL=transformationNameToPlayerForm.d.ts.map

package/dist/src/maps/transformationNameToPlayerForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformationNameToPlayerForm.d.ts","sourceRoot":"","sources":["../../../src/maps/transformationNameToPlayerForm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,wEAAwE;AACxE,eAAO,MAAM,sCAAsC,EAAE,WAAW,CAC9D,MAAM,EACN,UAAU,CA6BV,CAAC"}

package/dist/src/maps/transformationNameToPlayerForm.lua

@@ -0,0 +1,37 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
+--- Maps transformation names to the values of the `PlayerForm` enum.
+____exports.TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP = __TS__New(Map, {
+    {"guppy", PlayerForm.GUPPY},
+    {"cat", PlayerForm.GUPPY},
+    {"beelzebub", PlayerForm.BEELZEBUB},
+    {"fly", PlayerForm.BEELZEBUB},
+    {"funGuy", PlayerForm.FUN_GUY},
+    {"mushroom", PlayerForm.FUN_GUY},
+    {"seraphim", PlayerForm.SERAPHIM},
+    {"angel", PlayerForm.SERAPHIM},
+    {"bob", PlayerForm.BOB},
+    {"poison", PlayerForm.BOB},
+    {"spun", PlayerForm.SPUN},
+    {"drugs", PlayerForm.SPUN},
+    {"needles", PlayerForm.SPUN},
+    {"yesMother", PlayerForm.YES_MOTHER},
+    {"mother", PlayerForm.YES_MOTHER},
+    {"mom", PlayerForm.YES_MOTHER},
+    {"conjoined", PlayerForm.CONJOINED},
+    {"triple", PlayerForm.CONJOINED},
+    {"leviathan", PlayerForm.LEVIATHAN},
+    {"devil", PlayerForm.LEVIATHAN},
+    {"ohCrap", PlayerForm.OH_CRAP},
+    {"crap", PlayerForm.OH_CRAP},
+    {"poop", PlayerForm.OH_CRAP},
+    {"bookWorm", PlayerForm.BOOKWORM},
+    {"adult", PlayerForm.ADULT},
+    {"spiderBaby", PlayerForm.SPIDER_BABY},
+    {"stompy", PlayerForm.STOMPY}
+})
+return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "11.0.1",
+  "version": "11.2.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -22,6 +22,6 @@
   "main": "dist/src/index",
   "types": "dist/src/index.d.ts",
   "dependencies": {
-    "isaac-typescript-definitions": "^7.2.1"
+    "isaac-typescript-definitions": "^7.2.3"
   }
 }

package/src/features/extraConsoleCommands/init.ts

@@ -5,10 +5,8 @@ import {
   EntityType,
   LevelCurse,
   ModCallback,
-  TearVariant,
 } from "isaac-typescript-definitions";
 import { ModUpgraded } from "../../classes/ModUpgraded";
-import { MAX_SPEED_STAT } from "../../core/constants";
 import { addFlag, bitFlags } from "../../functions/flag";
 import { getMapPartialMatch } from "../../functions/map";
 import { printConsole } from "../../functions/utils";
@@ -37,6 +35,11 @@ function initCommandMap() {
 
 function initCallbacks(mod: ModUpgraded) {
   mod.AddCallback(ModCallback.POST_UPDATE, postUpdate); // 1
+  mod.AddCallback(
+    ModCallback.EVALUATE_CACHE,
+    evaluateCacheDamage,
+    CacheFlag.DAMAGE, // 1 << 0
+  ); // 8
   mod.AddCallback(
     ModCallback.EVALUATE_CACHE,
     evaluateCacheFireDelay,
@@ -59,37 +62,44 @@ function initCallbacks(mod: ModUpgraded) {
   ); // 11
   mod.AddCallback(ModCallback.POST_CURSE_EVAL, postCurseEval); // 12
   mod.AddCallback(ModCallback.EXECUTE_CMD, executeCmd); // 22
-  mod.AddCallback(ModCallback.POST_FIRE_TEAR, postFireTear); // 61
 }
 
 // ModCallback.POST_UPDATE (1)
 function postUpdate() {
-  if (v.run.spamBloodRights) {
+  if (v.persistent.spamBloodRights) {
     const player = Isaac.GetPlayer();
     player.UseActiveItem(CollectibleType.BLOOD_RIGHTS);
   }
 }
 
+// ModCallback.EVALUATE_CACHE (8)
+// CacheFlag.DAMAGE (1 << 0)
+function evaluateCacheDamage(player: EntityPlayer) {
+  if (v.persistent.damage) {
+    player.Damage = v.persistent.damageAmount;
+  }
+}
+
 // ModCallback.EVALUATE_CACHE (8)
 // CacheFlag.FIRE_DELAY (1 << 1)
 function evaluateCacheFireDelay(player: EntityPlayer) {
-  if (v.run.maxTears) {
-    player.FireDelay = 1; // Equivalent to Soy Milk
+  if (v.persistent.tears) {
+    player.FireDelay = v.persistent.tearsAmount; // Equivalent to Soy Milk
   }
 }
 
 // ModCallback.EVALUATE_CACHE (8)
 // CacheFlag.SPEED (1 << 4)
 function evaluateCacheSpeed(player: EntityPlayer) {
-  if (v.run.maxSpeed) {
-    player.MoveSpeed = MAX_SPEED_STAT;
+  if (v.persistent.speed) {
+    player.MoveSpeed = v.persistent.speedAmount;
   }
 }
 
 // ModCallback.EVALUATE_CACHE (8)
 // CacheFlag.FLYING (1 << 7)
 function evaluateCacheFlying(player: EntityPlayer) {
-  if (v.run.flight) {
+  if (v.persistent.flight) {
     player.CanFly = true;
   }
 }
@@ -103,7 +113,7 @@ function entityTakeDmgPlayer(
   _damageSource: EntityRef,
   _damageCountdownFrames: int,
 ) {
-  if (v.run.spamBloodRights) {
+  if (v.persistent.spamBloodRights) {
     return false;
   }
 
@@ -178,19 +188,3 @@ function executeCmd(command: string, params: string) {
   printConsole(`Command: ${commandName}`);
   commandFunction(params);
 }
-
-// ModCallback.POST_FIRE_TEAR (61)
-function postFireTear(tear: EntityTear) {
-  if (v.run.chaosCardTears) {
-    tear.ChangeVariant(TearVariant.CHAOS_CARD);
-  }
-
-  if (v.run.maxDamage) {
-    // If we increase the damage stat too high, then the tears will become bigger than the screen.
-    // Instead, increase the collision damage of the tear.
-    tear.CollisionDamage *= 1000;
-
-    // Change the visual of the tear so that it is more clear that we have debug-damage turned on.
-    tear.ChangeVariant(TearVariant.TOOTH);
-  }
-}

package/src/features/extraConsoleCommands/listCommands.ts

@@ -45,6 +45,7 @@ import {
   LevelStage,
   PillColor,
   PillEffect,
+  PlayerForm,
   PlayerType,
   RoomType,
   SoundEffect,
@@ -70,7 +71,7 @@ import { addCharge } from "../../functions/charge";
 import { isValidCollectibleType } from "../../functions/collectibles";
 import { runDeepCopyTests } from "../../functions/deepCopyTests";
 import { getNPCs } from "../../functions/entitiesSpecific";
-import { getEnumValues } from "../../functions/enums";
+import { getEnumValues, getLastEnumValue } from "../../functions/enums";
 import { addFlag } from "../../functions/flag";
 import { spawnGridEntity } from "../../functions/gridEntities";
 import { getRoomGridIndexesForType } from "../../functions/levelGrid";
@@ -99,8 +100,13 @@ import { gridCoordinatesToWorldPosition } from "../../functions/roomGrid";
 import { changeRoom } from "../../functions/rooms";
 import { reloadRoom as reloadRoomFunction } from "../../functions/roomTransition";
 import { onSetSeed, restart, setUnseeded } from "../../functions/run";
+import { getSortedSetValues } from "../../functions/set";
 import { spawnCollectible as spawnCollectibleFunction } from "../../functions/spawnCollectible";
 import { setStage } from "../../functions/stage";
+import {
+  getCollectibleTypesForTransformation,
+  getTransformationName,
+} from "../../functions/transformations";
 import { getGoldenTrinketType } from "../../functions/trinkets";
 import {
   asCardType,
@@ -113,6 +119,7 @@ import { CHARACTER_NAME_TO_TYPE_MAP } from "../../maps/characterNameToTypeMap";
 import { COLLECTIBLE_NAME_TO_TYPE_MAP } from "../../maps/collectibleNameToTypeMap";
 import { PILL_NAME_TO_EFFECT_MAP } from "../../maps/pillNameToEffectMap";
 import { ROOM_NAME_TO_TYPE_MAP } from "../../maps/roomNameToTypeMap";
+import { TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP } from "../../maps/transformationNameToPlayerForm";
 import { TRINKET_NAME_TO_TYPE_MAP } from "../../maps/trinketNameToTypeMap";
 import { getLastCardType, getLastPillEffect } from "../firstLast";
 import {
@@ -400,8 +407,8 @@ export function cc(): void {
  * "debug 10".
  */
 export function chaosCardTears(): void {
-  v.run.chaosCardTears = !v.run.chaosCardTears;
-  printEnabled(v.run.chaosCardTears, "Chaos Card tears");
+  v.persistent.chaosCardTears = !v.persistent.chaosCardTears;
+  printEnabled(v.persistent.chaosCardTears, "Chaos Card tears");
 }
 
 /**
@@ -522,10 +529,23 @@ export function dadsNote(): void {
   bossRoom();
 }
 
-/** Toggles extremely high-damage tears for the player. */
-export function damage(): void {
-  v.run.maxDamage = !v.run.maxDamage;
-  printEnabled(v.run.maxDamage, "debug damage");
+/**
+ * Toggles a set damage stat for the player. You can provide an optional argument to this command in
+ * order to set the damage to a specific amount. Default is 500.
+ */
+export function damage(params: string): void {
+  if (params !== "") {
+    const num = tonumber(params);
+    if (num === undefined) {
+      printConsole(`The provided damage amount is invalid: ${params}`);
+      return;
+    }
+
+    v.persistent.damageAmount = num;
+  }
+
+  v.persistent.damage = !v.persistent.damage;
+  printEnabled(v.persistent.damage, "debug damage");
 }
 
 /** Toggles permanent Curse of Darkness. */
@@ -592,26 +612,26 @@ export function eternalHearts(params: string): void {
 export function flight(params: string): void {
   const player = Isaac.GetPlayer();
 
-  v.run.flight = !v.run.flight;
+  v.persistent.flight = !v.persistent.flight;
 
   // Optionally, allow the toggle to be overridden by a parameter.
   if (params === "true") {
-    v.run.flight = true;
+    v.persistent.flight = true;
   } else if (params === "false") {
-    v.run.flight = false;
+    v.persistent.flight = false;
   }
 
   player.AddCacheFlags(CacheFlag.FLYING);
   player.EvaluateItems();
 
   const collectibleUsedToShowFlight = CollectibleType.FATE;
-  if (v.run.flight) {
+  if (v.persistent.flight) {
     addCollectibleCostume(player, collectibleUsedToShowFlight);
   } else {
     removeCollectibleCostume(player, collectibleUsedToShowFlight);
   }
 
-  printEnabled(v.run.maxSpeed, "max speed");
+  printEnabled(v.persistent.speed, "max speed");
 }
 
 /** Alias for the "startingRoom" command. */
@@ -1000,6 +1020,11 @@ export function playSound(params: string): void {
   sound(params);
 }
 
+/** Alias for the "transformation" command. */
+export function playerForm(params: string): void {
+  transformation(params);
+}
+
 /** Sets the player's pocket item to the specified collectible type. */
 export function pocket(params: string): void {
   if (params === "") {
@@ -1318,8 +1343,8 @@ export function sounds(): void {
  * "debug 10".
  */
 export function spam(): void {
-  v.run.spamBloodRights = !v.run.spamBloodRights;
-  printEnabled(v.run.spamBloodRights, "spamming Blood Rights");
+  v.persistent.spamBloodRights = !v.persistent.spamBloodRights;
+  printEnabled(v.persistent.spamBloodRights, "spamming Blood Rights");
 }
 
 export function spawnCollectible(params: string): void {
@@ -1405,19 +1430,33 @@ export function spawnTrinket(params: string): void {
   spawnTrinketFunction(trinketType, centerPos);
 }
 
-/** Toggles maximum movement speed and flight for the player. */
-export function speed(): void {
+/**
+ * Toggles a set movement speed and flight for the player. You can provide an optional argument to
+ * this command in order to set the speed to a specific amount. Default is 2.0 (which is the maximum
+ * that the stat can be set to).
+ */
+export function speed(params: string): void {
   const player = Isaac.GetPlayer();
 
-  v.run.maxSpeed = !v.run.maxSpeed;
+  if (params !== "") {
+    const num = tonumber(params);
+    if (num === undefined) {
+      printConsole(`The provided speed amount is invalid: ${params}`);
+      return;
+    }
+
+    v.persistent.damageAmount = num;
+  }
+
+  v.persistent.speed = !v.persistent.speed;
 
   player.AddCacheFlags(CacheFlag.SPEED);
   player.EvaluateItems();
 
-  const value = tostring(v.run.maxSpeed);
+  const value = tostring(v.persistent.speed);
   flight(value);
 
-  printEnabled(v.run.maxSpeed, "max speed and flight");
+  printEnabled(v.persistent.speed, "max speed and flight");
 }
 
 /** Alias for the "startingRoom" command. */
@@ -1438,17 +1477,28 @@ export function superSecretRoom(): void {
 }
 
 /**
- * Toggles an extremely high tears stat (e.g. fire rate) for the player, equivalent of that to soy
- * milk.
+ * Toggles a set tear delay (e.g. fire rate) for the player. You can provide an optional argument to
+ * this command in order to set the tear delay to a specific amount. Default is 1 (which is
+ * equivalent to the Soy Milk tear rate).
  */
-export function tears(): void {
-  v.run.maxTears = !v.run.maxTears;
+export function tears(params: string): void {
+  if (params !== "") {
+    const num = tonumber(params);
+    if (num === undefined) {
+      printConsole(`The provided tear delay amount is invalid: ${params}`);
+      return;
+    }
+
+    v.persistent.tearsAmount = num;
+  }
+
+  v.persistent.tears = !v.persistent.tears;
 
   const player = Isaac.GetPlayer();
   player.AddCacheFlags(CacheFlag.FIRE_DELAY);
   player.EvaluateItems();
 
-  printEnabled(v.run.maxDamage, "debug tear-rate");
+  printEnabled(v.persistent.damage, "debug tear-rate");
 }
 
 /** Alias for the "runTests" command. */
@@ -1456,6 +1506,60 @@ export function tests(): void {
   runTests();
 }
 
+/**
+ * Gives the specified transformation. Accepts either the transformation number or the partial name
+ * of the transformation.
+ *
+ * For example:
+ * - transformation 1 - Gives the Beelzebub transformation.
+ * - transformation gup - Gives the Guppy transformation.
+ */
+export function transformation(params: string): void {
+  if (params === "") {
+    printConsole("You must specify a transformation name or number.");
+    return;
+  }
+
+  let targetPlayerForm: PlayerForm;
+  const num = tonumber(params) as PlayerForm | undefined;
+  if (num === undefined) {
+    const match = getMapPartialMatch(
+      params,
+      TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP,
+    );
+    if (match === undefined) {
+      printConsole(`Unknown transformation: ${params}`);
+      return;
+    }
+
+    targetPlayerForm = match[1];
+  } else {
+    const lastPlayerForm = getLastEnumValue(PlayerForm);
+    if (num < PlayerForm.GUPPY || num > lastPlayerForm) {
+      printConsole(`Invalid transformation number: ${num}`);
+      return;
+    }
+
+    targetPlayerForm = num;
+  }
+
+  const transformationName = getTransformationName(targetPlayerForm);
+  const player = Isaac.GetPlayer();
+  const collectibleTypesSet =
+    getCollectibleTypesForTransformation(targetPlayerForm);
+  const collectiblesTypes = getSortedSetValues(collectibleTypesSet);
+  for (let i = 0; i < 3; i++) {
+    const collectibleType = collectiblesTypes[i];
+    if (collectibleType !== undefined) {
+      player.AddCollectible(collectibleType);
+    }
+  }
+
+  printConsole(
+    `Gave transformation: ${transformationName} (${targetPlayerForm})`,
+  );
+}
+
 /** Creates a trapdoor next to the player. */
 export function trapdoor(): void {
   spawnTrapdoorOrCrawlSpace(true);

package/src/features/extraConsoleCommands/v.ts

@@ -1,5 +1,6 @@
 const v = {
   persistent: {
+    // Curses
     darkness: false, // 1
     labyrinth: false, // 2
     lost: false, // 3
@@ -8,17 +9,20 @@ const v = {
     maze: false, // 6
     blind: false, // 7
     giant: false, // 8
-
     disableCurses: false,
-  },
 
-  run: {
+    // Stats
+    damage: false,
+    damageAmount: 500,
+    speed: false,
+    speedAmount: 2.0,
+    tears: false,
+    tearsAmount: 1, // In tear delay, not tears stat
+    flight: false,
+
+    // Other
     chaosCardTears: false,
     spamBloodRights: false,
-    maxDamage: false,
-    maxSpeed: false,
-    maxTears: false,
-    flight: false,
   },
 };
 export default v;

package/src/features/saveDataManager/main.ts

@@ -1,4 +1,4 @@
-import { ModCallback } from "isaac-typescript-definitions";
+import { CollectibleType, ModCallback } from "isaac-typescript-definitions";
 import { ModUpgraded } from "../../classes/ModUpgraded";
 import { game } from "../../core/cachedClasses";
 import { ModCallbackCustom } from "../../enums/ModCallbackCustom";
@@ -33,6 +33,11 @@ let loadedDataOnThisRun = false;
 export function saveDataManagerInit(incomingMod: ModUpgraded): void {
   mod = incomingMod;
 
+  mod.AddCallback(
+    ModCallback.POST_USE_ITEM,
+    postUseItemGlowingHourGlass,
+    CollectibleType.GLOWING_HOUR_GLASS,
+  ); // 3
   mod.AddCallback(ModCallback.POST_PLAYER_INIT, postPlayerInit); // 9
   mod.AddCallback(ModCallback.PRE_GAME_EXIT, preGameExit); // 17
   mod.AddCallback(ModCallback.POST_NEW_LEVEL, postNewLevel); // 18
@@ -42,6 +47,12 @@ export function saveDataManagerInit(incomingMod: ModUpgraded): void {
   ); // 19
 }
 
+// ModCallback.POST_USE_ITEM (3)
+// CollectibleType.GLOWING_HOUR_GLASS (422)
+function postUseItemGlowingHourGlass() {
+  return undefined;
+}
+
 // ModCallback.POST_PLAYER_INIT (9)
 function postPlayerInit() {
   if (mod === null) {

package/src/functions/collectibles.ts

@@ -100,6 +100,8 @@ export function getCollectibleChargeType(
 /**
  * Helper function to get the in-game description for a collectible. Returns "Unknown" if the
  * provided collectible type was not valid.
+ *
+ * This function works for both vanilla and modded collectibles.
  */
 export function getCollectibleDescription(
   collectibleType: CollectibleType,
@@ -319,6 +321,8 @@ export function getCollectibleMaxCharges(
  * type is not valid.
  *
  * For example, `getCollectibleName(CollectibleType.SAD_ONION)` would return "Sad Onion".
+ *
+ * This function works for both vanilla and modded collectibles.
  */
 export function getCollectibleName(collectibleType: CollectibleType): string {
   // "ItemConfigItem.Name" is bugged with vanilla items on patch v1.7.6, so we use a hard-coded map

package/src/functions/map.ts

@@ -24,7 +24,7 @@ export function copyMap<K, V>(oldMap: Map<K, V>): Map<K, V> {
  *   ["bar", 456],
  * ]);
  * const searchText = "f";
- * const match = getMapPartialMatch(map, searchText); // match is now equal to 123
+ * const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
  *
  * @returns If a match was found, returns a tuple of the map key and value. If a match was not
  * found, returns undefined.

package/src/functions/tears.ts

@@ -42,6 +42,9 @@ export function getTearsStat(fireDelay: float): float {
  * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
+ *
+ * Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+ * this case, it will always appear as if the tear is coming from a player.
  */
 export function isTearFromFamiliar(tear: EntityTear): boolean {
   if (tear.FrameCount === 0) {
@@ -71,6 +74,9 @@ export function isTearFromFamiliar(tear: EntityTear): boolean {
  * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
+ *
+ * Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+ * this case, it will always appear as if the tear is coming from a player.
  */
 export function isTearFromPlayer(tear: EntityTear): boolean {
   if (tear.FrameCount === 0) {

package/src/functions/trinkets.ts

@@ -83,6 +83,8 @@ export function getOpenTrinketSlot(player: EntityPlayer): int | undefined {
 /**
  * Helper function to get the in-game description for a trinket. Returns "Unknown" if the provided
  * trinket type was not valid.
+ *
+ * This function works for both vanilla and modded trinkets.
  */
 export function getTrinketDescription(trinketType: TrinketType): string {
   // "ItemConfigItem.Description" is bugged with vanilla items on patch v1.7.6, so we use a
@@ -122,6 +124,8 @@ export function getTrinketGfxFilename(trinketType: TrinketType): string {
  * not valid.
  *
  * For example, `getTrinketName(TrinketType.SWALLOWED_PENNY)` would return "Swallowed Penny".
+ *
+ * This function works for both vanilla and modded trinkets.
  */
 export function getTrinketName(trinketType: TrinketType): string {
   // "ItemConfigItem.Name" is bugged with vanilla items on patch v1.7.6, so we use a hard-coded map

package/src/maps/transformationNameToPlayerForm.ts

@@ -0,0 +1,35 @@
+import { PlayerForm } from "isaac-typescript-definitions";
+
+/** Maps transformation names to the values of the `PlayerForm` enum. */
+export const TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP: ReadonlyMap<
+  string,
+  PlayerForm
+> = new Map([
+  ["guppy", PlayerForm.GUPPY], // 0
+  ["cat", PlayerForm.GUPPY], // 0
+  ["beelzebub", PlayerForm.BEELZEBUB], // 1
+  ["fly", PlayerForm.BEELZEBUB], // 1
+  ["funGuy", PlayerForm.FUN_GUY], // 2
+  ["mushroom", PlayerForm.FUN_GUY], // 2
+  ["seraphim", PlayerForm.SERAPHIM], // 3
+  ["angel", PlayerForm.SERAPHIM], // 3
+  ["bob", PlayerForm.BOB], // 4
+  ["poison", PlayerForm.BOB], // 4
+  ["spun", PlayerForm.SPUN], // 5
+  ["drugs", PlayerForm.SPUN], // 5
+  ["needles", PlayerForm.SPUN], // 5
+  ["yesMother", PlayerForm.YES_MOTHER], // 6
+  ["mother", PlayerForm.YES_MOTHER], // 6
+  ["mom", PlayerForm.YES_MOTHER], // 6
+  ["conjoined", PlayerForm.CONJOINED], // 7
+  ["triple", PlayerForm.CONJOINED], // 7
+  ["leviathan", PlayerForm.LEVIATHAN], // 8
+  ["devil", PlayerForm.LEVIATHAN], // 8
+  ["ohCrap", PlayerForm.OH_CRAP], // 9
+  ["crap", PlayerForm.OH_CRAP], // 9
+  ["poop", PlayerForm.OH_CRAP], // 9
+  ["bookWorm", PlayerForm.BOOKWORM], // 10
+  ["adult", PlayerForm.ADULT], // 11
+  ["spiderBaby", PlayerForm.SPIDER_BABY], // 12
+  ["stompy", PlayerForm.STOMPY], // 13
+]);