Support for RGON v1.1.2d and v1.1.2e

Author: BenevolusGoat

src/docs/enums/repentogon.json

@@ -372,10 +372,6 @@
       "value": "1152",
       "comment": "(Entity, Vector Offset) - Called before the lighting of an entity is rendered. Return a Vector to modify render offset or `false` to cancel rendering."
     },
-    "MC_PRE_PLAYER_APPLY_INNATE_COLLECTIBLE_NUM": {
-      "value": "1092",
-      "comment": "(integer ModCount, EntityPlayer Player, CollectibleType Type, boolean OnlyCountTrueItems): integer - Called when getting the amount of innate items on the player. Return an integer to modify how many of a specific innate item the player has."
-    },
     "MC_PRE_MUSIC_PLAY_JINGLE": {
       "value": "1094",
       "comment": "(Music MusicID): Music | boolean, Optional Arg: Music - Called before a music jingle is played. Return `Music` to change the track or `false` to cancel the track."
@@ -910,7 +906,11 @@
     },
     "MC_PRE_PICKUP_GET_LOOT_LIST": {
       "value": "1334",
-      "comment": "(EntityPickup Pickup, boolean ShouldAdvance): LootList - Called before the pickup determines its loot content. Return `LootList` to change loot content."
+      "comment": "(EntityPickup Pickup, boolean ShouldAdvance, RNG, EntityPlayer Player): LootList - Called before the pickup determines its loot content. Accepts a `LootList` to completely replace loot content. If `ShouldAdvance` is `false`, the loot is being checked (such as for a Guppy's Eye preview) but the RNG should not be advanced. The provided RNG (the DropRNG of the entity) will be reset at the end of the callback to preserve the original seed, so you can use the provided RNG for easy consistent results between loot previews and when the loot actually spawns."
+    },
+    "MC_POST_PICKUP_GET_LOOT_LIST": {
+      "value": "1336",
+      "comment": "(EntityPickup Pickup, boolean ShouldAdvance, RNG, EntityPlayer Player): LootList - Called after the pickup determines its loot content. The provided `LootList` can be modified, so this is a good place to make small modifications such as adding to the loot. If `ShouldAdvance` is `false`, the loot is being checked (such as for a Guppy's Eye preview) but the RNG should not be advanced. The provided RNG (the DropRNG of the entity) will be reset at the end of the callback to preserve the original seed, so you can use the provided RNG for easy consistent results between loot previews and when the loot actually spawns."
     },
     "MC_PRE_PICKUP_UPDATE_GHOST_PICKUPS": {
       "value": "1335",
@@ -1170,23 +1170,23 @@
     },
     "MC_PRE_PLAYER_ADD_COSTUME": {
       "value": "1281",
-      "comment": "(ItemConfigItem itemConfig, EntityPlayer Player, boolean ItemStateOnly): ItemConfigItem | boolean - Called before the costume is added to the player. Return `ItemConfigItem` to replace the costume or `true` to cancel adding it entirely."
+      "comment": "(ItemConfigItem itemConfig, EntityPlayer Player, boolean ItemStateOnly): ItemConfigItem | boolean, Optional Arg: ItemConfigItem - Called before the costume is added to the player. Return `ItemConfigItem` to replace the costume or `true` to cancel adding it entirely."
     },
     "MC_PRE_PLAYER_REMOVE_COSTUME": {
       "value": "1282",
-      "comment": "(ItemConfigItem itemConfig, EntityPlayer Player): boolean - Called before the costume is removed from the player. Return `true` to cancel the removal."
+      "comment": "(ItemConfigItem itemConfig, EntityPlayer Player): boolean, Optional Arg: ItemConfigItem - Called before the costume is removed from the player. Return `true` to cancel the removal."
     },
     "MC_POST_PLAYER_ADD_COSTUME": {
       "value": "1283",
-      "comment": "(ItemConfigItem itemConfig, EntityPlayer Player, boolean ItemStateOnly) - Called after the costume is added to the player successfully."
+      "comment": "(ItemConfigItem itemConfig, EntityPlayer Player, boolean ItemStateOnly), Optional Arg: ItemConfigItem - Called after the costume is added to the player successfully."
     },
     "MC_POST_PLAYER_REMOVE_COSTUME": {
       "value": "1284",
-      "comment": "(ItemConfigItem itemConfig, EntityPlayer Player): boolean - Called after the costume is removed from the player successfully."
+      "comment": "(ItemConfigItem itemConfig, EntityPlayer Player): boolean, Optional Arg: ItemConfigItem - Called after the costume is removed from the player successfully."
     },
-    "MC_POST_FORCE_PILL_EFFECT": {
+    "MC_POST_FORCE_ADD_PILL_EFFECT": {
       "value": "1129",
-      "comment": "(PillEffect PillEffectID, PillColor PillColorID) - TODO: Document me!"
+      "comment": "(PillEffect PillEffectID, PillColor PillColorID) - Called after `ItemPool:ForceAddPillEffect` is used to forcibly add a pill effect to the current pill pool.`"
     },
     "MC_EVALUATE_CUSTOM_CACHE" : {
       "value": "1224",
@@ -1399,6 +1399,14 @@
 	"MC_POST_GRID_HURT ": {
 		"value": "1018",
 		"comment": "(Entity Source, Vector Diration, number DamageScale), Optional Arg: GridEntityType - Called after a GridEntityPoop or GridEntityTNT successfully takes damage."
+	},
+	"MC_PRE_SHUFFLE_COSTUMES ": {
+		"value": "1494",
+		"comment": "(EntityPlayer Player, integer seed): boolean, Optional Arg: PlayerType - Called when shuffling costumes with `EntityPlayer:ShuffleCostumes`. Return `false` to cancel the shuffle."
+	},
+	"MC_POST_SHUFFLE_COSTUMES ": {
+		"value": "1495",
+		"comment": "(EntityPlayer Player, integer seed), Optional Arg: PlayerType - Called when shuffling costumes with `EntityPlayer:ShuffleCostumes`."
 	}
   },
   "Renderer": {
@@ -5521,5 +5529,9 @@
     "FUNC_REVERSE_SUBTRACT": "2",
     "MIN": "3",
     "MAX": "4"
+  },
+  "RoomGroup": {
+    "GROUP_NONE": "-1",
+	"GROUP_ULTRA_SECRET": "99"
   }
 }

src/docs/no_repentogon_only/entity/EntityPlayer.lua

@@ -36,15 +36,15 @@ function EntityPlayer:GetMultiShotPositionVelocity(LoopIndex, Weapon, ShotDirect
 end
 
 ---@param Type CollectibleType
----@param IgnoreModifiers? boolean @default: `false`
+---@param IgnoreModifiers? boolean @default: `false`. If set to `true`, only counts collectibles the player actually owns and ignores effects granted by other items and if its blocked by effects such as the curse mist.
 ---@return boolean
 function EntityPlayer:HasCollectible(Type, IgnoreModifiers)
 end
 
 ---@param Type CollectibleType
----@param OnlyCountTrueItems? boolean @default: `false`
+---@param IgnoreModifiers? boolean @default: `false`. If set to `true`, only counts collectibles the player actually owns and ignores effects granted by other items and if its blocked by effects such as the curse mist.
 ---@return integer
-function EntityPlayer:GetCollectibleNum(Type, OnlyCountTrueItems)
+function EntityPlayer:GetCollectibleNum(Type, IgnoreModifiers)
 end
 
 ---@param Item CollectibleType

src/docs/repentogon_changes/Isaac.lua

@@ -435,4 +435,10 @@ end
 ---More information can be obtained on [repentogon.com](https://repentogon.com/Isaac.html#rendertoworld)
 ---@param pos Vector
 function Isaac.RenderToWorld(pos)
+end
+
+---Similar to `Isaac.LoadModData`, but lets you read the saveX.dat file from any existing mod data folder, even if that mod is not currently enabled.
+---@param name string
+---@return string
+function Isaac.LoadModDataFromFolder(name)
 end

src/docs/repentogon_changes/MusicManager.lua

@@ -14,3 +14,8 @@ end
 ---Stops the currently playing jingle.
 function MusicManager:StopJingle()
 end
+
+---Returns the id of the currently playing jingle, or `0` if no jingle is playing/current jingle is fading out.
+---@return Music
+function MusicManager:GetCurrentJingleID()
+end

src/docs/repentogon_changes/RoomDescriptor.lua

@@ -51,4 +51,34 @@ end
 ---The trinket to be copied by the Error trinket.
 ---@return TrinketType
 function RoomDescriptor_RGON:GetErrorTrinketEffect()
+end
+
+---Group is only used by effects that need to randomly select a room to warp to (e.g. Teleport, Gold Pill Teleport, etc.). A room can only be selected if its group is either `RoomGroup.GROUP_NONE` or matches the current room's group.
+---
+---By default, all rooms use `RoomGroup.GROUP_NONE`. The only exception is Ultra Secret Rooms, which are assigned a different group by the game during level generation.
+---@return RoomGroup | integer
+function RoomDescriptor_RGON:GetGroup()
+end
+
+---**It is suggested to use CreateGroup instead of setting an arbitrary group.**
+---
+---Group is only used by effects that need to randomly select a room to warp to (e.g. Teleport, Gold Pill Teleport, etc.). A room can only be selected if its group is either `RoomGroup.GROUP_NONE` or matches the current room's group.
+---
+---By default, all rooms use `RoomGroup.GROUP_NONE`. The only exception is Ultra Secret Rooms, which are assigned a different group by the game during level generation.
+---@param group RoomGroup | integer
+function RoomDescriptor_RGON:SetGroup(group)
+end
+
+---Creates a new unique group id for `SetGroup`.
+---
+---**The function will error if a group with the specified name already exists.**
+---@param groupName string
+---@return integer
+function _G.RoomDescriptor.CreateGroup(groupName)
+end
+
+---Returns the group id tied to the specified name.
+---@param groupName string
+---@return integer? @Returns `nil` if the name has not been registered.
+function _G.RoomDescriptor.GetGroupByName(groupName)
 end

src/docs/repentogon_changes/entity/EntityPlayer.lua

@@ -1192,17 +1192,17 @@ function EntityPlayer:SetInnateTrinketGroup(groupKey, newCounts, addCostume)
 end
 
 ---@param Type CollectibleType
----@param IgnoreModifiers? boolean @default: `false`
----@param IgnoreSpoof? boolean @default: `false`. Ignores innate items when set to true.
+---@param IgnoreModifiers? boolean @default: `false`. If set to `true`, only counts collectibles the player actually owns and ignores effects granted by other items and if its blocked by effects such as the curse mist.
+---@param IgnoreSpoof? boolean @default: `false`. Ignores innate items when set to `true`.
 ---@return boolean
 function EntityPlayer:HasCollectible(Type, IgnoreModifiers, IgnoreSpoof)
 end
 
 ---@param Type CollectibleType
----@param OnlyCountTrueItems? boolean @default: `false`
----@param IgnoreSpoof? boolean @default: `false`. Ignores innate items when set to true.
+---@param IgnoreModifiers? boolean @default: `false`. If set to `true`, only counts collectibles the player actually owns and ignores effects granted by other items and if its blocked by effects such as the curse mist.
+---@param IgnoreSpoof? boolean @default: `false`. Ignores innate items when set to `true`.
 ---@return integer
-function EntityPlayer:GetCollectibleNum(Type, OnlyCountTrueItems, IgnoreSpoof)
+function EntityPlayer:GetCollectibleNum(Type, IgnoreModifiers, IgnoreSpoof)
 end
 
 ---Returns `true` if you have a golden variant of the provided `TrinketType`.
@@ -1253,6 +1253,15 @@ end
 function EntityPlayer:GetTearDisplacement()
 end
 
+---Sets the player's TearDisplacement value, which represents which eye the player is shooting from.
+---
+---Note that the game will typically alternate this value BEFORE shooting a tear.
+---@param value integer
+---|-1 # Left eye
+---|1 # Right eye
+function EntityPlayer:SetTearDisplacement(value)
+end
+
 ---Add CustomCacheTag(s) to be evaluated next time EvaluateItems runs (which is right now, if the optional boolean is passed).
 ---@param tag string | string[]
 ---@param EvaluateItems? boolean @default: `false`.

src/docs/repentogon_new/PlayerManager.lua

@@ -3,14 +3,16 @@ _G.PlayerManager = {}
 
 ---Returns true if any player has the provided collectible.
 ---@param collectible CollectibleType
+---@param ignoreModifiers? boolean @default: `false`. If set to `true`, only counts collectibles the player actually owns and ignores effects granted by other items and if its blocked by effects such as the curse mist.
 ---@return boolean
-function PlayerManager.AnyoneHasCollectible(collectible)
+function PlayerManager.AnyoneHasCollectible(collectible, ignoreModifiers)
 end
 
 ---Returns true if any player has the provided trinket.
 ---@param trinket TrinketType
+---@param ignoreModifiers? boolean @default: `false`. If set to `true`, only counts trinkets the player actually owns and ignores effects granted by other items and if its blocked by effects such as the curse mist.
 ---@return boolean
-function PlayerManager.AnyoneHasTrinket(trinket)
+function PlayerManager.AnyoneHasTrinket(trinket, ignoreModifiers)
 end
 
 ---Returns true if any player matches the provided PlayerType.
@@ -60,8 +62,9 @@ end
 
 ---Returns the total number of the specified collectible held by all players.
 ---@param collectible CollectibleType
+---@param ignoreModifiers? boolean @default: `false`. If set to `true`, only counts collectibles the player actually owns and ignores effects granted by other items and if its blocked by effects such as the curse mist.
 ---@return integer
-function PlayerManager.GetNumCollectibles(collectible)
+function PlayerManager.GetNumCollectibles(collectible, ignoreModifiers)
 end
 
 ---Returns a table containing all players.
@@ -92,13 +95,13 @@ end
 
 ---@param playerType PlayerType
 ---@param trinketType TrinketType
----@param ignoreModifiers? boolean @default: `false`
+---@param ignoreModifiers? boolean @default: `false`. If set to `true`, only counts trinkets the player actually owns and ignores effects granted by other items and if its blocked by effects such as the curse mist.
 function PlayerManager.AnyPlayerTypeHasTrinket(playerType, trinketType, ignoreModifiers)
 end
 
 ---@param playerType PlayerType
 ---@param itemID TrinketType
----@param ignoreModifiers? boolean @default: `false`
+---@param ignoreModifiers? boolean @default: `false`. If set to `true`, only counts collectibles the player actually owns and ignores effects granted by other items and if its blocked by effects such as the curse mist.
 function PlayerManager.AnyPlayerTypeHasCollectible(playerType, itemID, ignoreModifiers)
 end
 

src/docs/vanilla/entity/EntityPickup.lua

@@ -29,8 +29,8 @@ end
 ---@param Variant integer
 ---@param SubType integer
 ---@param KeepPrice? boolean @default: `false`
----@param KeepSeed? boolean @default: `false`
----@param IgnoreModifiers? boolean @default: `false`
+---@param KeepSeed? boolean @default: `false. If set to `true`, keeps the initial RNG seed of the pickup instead of rerolling it
+---@param IgnoreModifiers? boolean @default: `false`. If set to `, ignores item effects that might turn this pickup into something other than the specificed variant and sub-type. Specifically, this can be used to prevent a collectible from being affected by Tainted Isaac's rotation mechanic. (For example, if you manually spawn a quest collectible such as a Polaroid, it will be affected by Tainted Isaac's rotation mechanic, which is normally undesired. To fix this, you can immediately morph it into the same entity type / variant /sub-type after spawning with this argument set to true.)
 function EntityPickup_Local:Morph(Type, Variant, SubType, KeepPrice, KeepSeed, IgnoreModifiers)
 end
 

src/docs/vanilla/entity/EntityPlayer.lua

@@ -815,7 +815,7 @@ function EntityPlayer:HasTimedItem()
 end
 
 ---@param Type TrinketType
----@param IgnoreModifiers? boolean @default: `false`
+---@param IgnoreModifiers? boolean @default: `false`. If set to `true`, only counts trinkets the player actually owns and ignores effects granted by other items and if its blocked by effects such as the curse mist.
 ---@return boolean
 function EntityPlayer:HasTrinket(Type, IgnoreModifiers)
 end
@@ -907,7 +907,7 @@ function EntityPlayer:RemoveBlueSpider()
 end
 
 ---@param Type CollectibleType
----@param IgnoreModifiers? boolean @default: `false`
+---@param IgnoreModifiers? boolean @default: `false`. Ignores collectible effects granted by other items (i.e. Void).
 ---@param ActiveSlot? ActiveSlot @default: `ActiveSlot.SLOT_PRIMARY`
 ---@param RemoveFromPlayerForm? boolean @default: `true`
 function EntityPlayer:RemoveCollectible(Type, IgnoreModifiers, ActiveSlot, RemoveFromPlayerForm)