isaacscript-common 1.0.483 → 1.0.484

package/dist/functions/player.d.ts

@@ -198,6 +198,22 @@ export declare function removeCollectibleCostume(player: EntityPlayer, collectib
  */
 export declare function removeDeadEyeMultiplier(player: EntityPlayer): void;
 export declare function removeTrinketCostume(player: EntityPlayer, trinketType: TrinketType | int): void;
+/**
+ * Helper function to set an active collectible to a particular slot. This has different behavior
+ * than calling `player.AddCollectible()` with the `activeSlot` argument, because this function will
+ * not shift existing items into the Schoolbag and it handles `ActiveSlot.SLOT_POCKET2`.
+ *
+ * Note that if an item is set to `ActiveSlot.SLOT_POCKET2`, it will disappear after being used and
+ * will be automatically removed upon entering a new room.
+ *
+ * @param player The player to give the item to.
+ * @param collectibleType The collectible type of the item to give.
+ * @param activeSlot The slot to set.
+ * @param charge Optional. The argument of charges to set. If not specified, the item will be set
+ * with maximum charges.
+ * @param keepInPools Optional. Whether or not to remove the item from pools. False by default.
+ */
+export declare function setActiveItem(player: EntityPlayer, collectibleType: CollectibleType, activeSlot: ActiveSlot, charge?: int, keepInPools?: boolean): void;
 /**
  * If you want to stop the player from shooting without the blindfold costume, then simply call
  * `player.TryRemoveNullCostume(NullItemID.ID_BLINDFOLD)` after invoking this function.

package/dist/functions/player.lua

@@ -11,8 +11,12 @@ local PocketItemType = ____PocketItemType.PocketItemType
 local ____bitwise = require("functions.bitwise")
 local getKBitOfN = ____bitwise.getKBitOfN
 local getNumBitsOfN = ____bitwise.getNumBitsOfN
+local ____collectibles = require("functions.collectibles")
+local getCollectibleMaxCharges = ____collectibles.getCollectibleMaxCharges
 local ____collectibleSet = require("functions.collectibleSet")
 local getCollectibleSet = ____collectibleSet.getCollectibleSet
+local ____util = require("functions.util")
+local ensureAllCases = ____util.ensureAllCases
 function ____exports.getPlayers(self, performExclusions)
     if performExclusions == nil then
         performExclusions = false
@@ -436,6 +440,71 @@ function ____exports.removeTrinketCostume(self, player, trinketType)
     end
     player:RemoveCostume(itemConfigTrinket)
 end
+function ____exports.setActiveItem(self, player, collectibleType, activeSlot, charge, keepInPools)
+    if keepInPools == nil then
+        keepInPools = false
+    end
+    local game = Game()
+    local itemPool = game:GetItemPool()
+    local primaryCollectibleType = player:GetActiveItem(ActiveSlot.SLOT_PRIMARY)
+    local primaryCharge = player:GetActiveCharge(ActiveSlot.SLOT_PRIMARY)
+    local secondaryCollectibleType = player:GetActiveItem(ActiveSlot.SLOT_SECONDARY)
+    if charge == nil then
+        charge = getCollectibleMaxCharges(nil, collectibleType)
+    end
+    if not keepInPools then
+        itemPool:RemoveCollectible(collectibleType)
+    end
+    repeat
+        local ____switch106 = activeSlot
+        local ____cond106 = ____switch106 == ActiveSlot.SLOT_PRIMARY
+        if ____cond106 then
+            do
+                if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
+                    player:RemoveCollectible(primaryCollectibleType)
+                end
+                player:AddCollectible(collectibleType, charge, false)
+                break
+            end
+        end
+        ____cond106 = ____cond106 or (____switch106 == ActiveSlot.SLOT_SECONDARY)
+        if ____cond106 then
+            do
+                if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
+                    player:RemoveCollectible(primaryCollectibleType)
+                end
+                if secondaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
+                    player:RemoveCollectible(secondaryCollectibleType)
+                end
+                player:AddCollectible(secondaryCollectibleType, charge, false)
+                if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
+                    player:AddCollectible(primaryCollectibleType, primaryCharge, false)
+                end
+                break
+            end
+        end
+        ____cond106 = ____cond106 or (____switch106 == ActiveSlot.SLOT_POCKET)
+        if ____cond106 then
+            do
+                player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
+                player:SetActiveCharge(charge, activeSlot)
+                break
+            end
+        end
+        ____cond106 = ____cond106 or (____switch106 == ActiveSlot.SLOT_POCKET2)
+        if ____cond106 then
+            do
+                player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
+                break
+            end
+        end
+        do
+            do
+                ensureAllCases(nil, activeSlot)
+            end
+        end
+    until true
+end
 function ____exports.setBlindfold(self, player, enabled)
     local game = Game()
     local character = player:GetPlayerType()

package/package.json

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