isaacscript-common 7.17.5 → 7.18.0

package/dist/functions/players.lua

@@ -304,7 +304,7 @@ function ____exports.getAzazelBrimstoneDistance(self, playerOrTearHeight)
     return 32 - 2.5 * tearHeight
 end
 function ____exports.getClosestPlayer(self, position)
-    local closestPlayer = nil
+    local closestPlayer
     local closestDistance = math.huge
     for ____, player in ipairs(getPlayers(nil)) do
         local distance = position:Distance(player.Position)

package/dist/functions/run.d.ts

@@ -1,4 +1,9 @@
 import { PlayerType } from "isaac-typescript-definitions";
+/**
+ * Helper function to see if the current run can unlock achievements. For example, if playing on a
+ * set seed or in a victory lap, achievements are disabled.
+ */
+export declare function canRunUnlockAchievements(): boolean;
 /**
  * Whether or not the player is playing on a set seed (i.e. that they entered in a specific seed by
  * pressing tab on the character selection screen). When the player resets the game on a set seed,

package/dist/functions/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAMrE;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAiBpD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAInE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EAEX,MAAM,8BAA8B,CAAC;AAQtC;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAUlD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAiBpD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAInE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}

package/dist/functions/run.lua

@@ -2,14 +2,27 @@ local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local SlotVariant = ____isaac_2Dtypescript_2Ddefinitions.SlotVariant
 local ____cachedClasses = require("core.cachedClasses")
 local game = ____cachedClasses.game
+local ____constants = require("core.constants")
+local VectorZero = ____constants.VectorZero
 local ____constantsFirstLast = require("core.constantsFirstLast")
 local FIRST_CHARACTER = ____constantsFirstLast.FIRST_CHARACTER
 local ____runInNFrames = require("features.runInNFrames")
 local runNextRenderFrame = ____runInNFrames.runNextRenderFrame
+local ____entitiesSpecific = require("functions.entitiesSpecific")
+local spawnSlot = ____entitiesSpecific.spawnSlot
 local ____log = require("functions.log")
 local log = ____log.log
+--- Helper function to see if the current run can unlock achievements. For example, if playing on a
+-- set seed or in a victory lap, achievements are disabled.
+function ____exports.canRunUnlockAchievements(self)
+    local greedDonationMachine = spawnSlot(nil, SlotVariant.GREED_DONATION_MACHINE, 0, VectorZero)
+    local canUnlockAchievements = greedDonationMachine:Exists()
+    greedDonationMachine:Remove()
+    return canUnlockAchievements
+end
 --- Whether or not the player is playing on a set seed (i.e. that they entered in a specific seed by
 -- pressing tab on the character selection screen). When the player resets the game on a set seed,
 -- the game will not switch to a different seed.

package/dist/index.d.ts

@@ -613,6 +613,12 @@ export declare function calculateStageTypeRepentance(stage: LevelStage): StageTy
  */
 export declare function canPlayerCrushRocks(player: EntityPlayer): boolean;
 
+/**
+ * Helper function to see if the current run can unlock achievements. For example, if playing on a
+ * set seed or in a victory lap, achievements are disabled.
+ */
+export declare function canRunUnlockAchievements(): boolean;
+
 export declare function capitalizeFirstLetter(string: string): string;
 
 /** Maps card names to card sub-types. */

package/package.json

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

package/src/functions/players.ts

@@ -249,7 +249,7 @@ export function getCharacters(): PlayerType[] {
 }
 
 export function getClosestPlayer(position: Vector): EntityPlayer {
-  let closestPlayer: EntityPlayer | null = null;
+  let closestPlayer: EntityPlayer | undefined;
   let closestDistance = math.huge;
   for (const player of getPlayers()) {
     const distance = position.Distance(player.Position);
@@ -260,7 +260,7 @@ export function getClosestPlayer(position: Vector): EntityPlayer {
     }
   }
 
-  if (closestPlayer === null) {
+  if (closestPlayer === undefined) {
     error("Failed to find the closest player.");
   }
 

package/src/functions/run.ts

@@ -1,9 +1,31 @@
-import { Challenge, PlayerType } from "isaac-typescript-definitions";
+import {
+  Challenge,
+  PlayerType,
+  SlotVariant,
+} from "isaac-typescript-definitions";
 import { game } from "../core/cachedClasses";
+import { VectorZero } from "../core/constants";
 import { FIRST_CHARACTER } from "../core/constantsFirstLast";
 import { runNextRenderFrame } from "../features/runInNFrames";
+import { spawnSlot } from "./entitiesSpecific";
 import { log } from "./log";
 
+/**
+ * Helper function to see if the current run can unlock achievements. For example, if playing on a
+ * set seed or in a victory lap, achievements are disabled.
+ */
+export function canRunUnlockAchievements(): boolean {
+  const greedDonationMachine = spawnSlot(
+    SlotVariant.GREED_DONATION_MACHINE,
+    0,
+    VectorZero,
+  );
+  const canUnlockAchievements = greedDonationMachine.Exists();
+  greedDonationMachine.Remove();
+
+  return canUnlockAchievements;
+}
+
 /**
  * Whether or not the player is playing on a set seed (i.e. that they entered in a specific seed by
  * pressing tab on the character selection screen). When the player resets the game on a set seed,