Skip to content

Class "TemporaryEffects"⚓︎

Info

You can get this class by using the following function:

Example Code 
1
2
local player = Isaac.GetPlayer()
local tempEffects = player:GetEffects()

Functions⚓︎

Add·Collectible·Effect ()⚓︎

void AddCollectibleEffect ( CollectibleType CollectibleType, boolean AddCostume = true, int Count = 1 )⚓︎

Adds the CollectibleEffect associated with a given item. If the passed item's CollectibleEffect is marked to have a cooldown or be persistent in items.xml, this will be respected.

Misinformation

TemporaryEffects, despite their names, are not and were never intended to be fake or temporary copies of items. Notably every single active item automatically grants its CollectibleEffect on use, and this is often closely tied to its effect; CollectibleEffects can therefore be visuallised more as an item's state. For example in passive items:

  • Holy Mantle utilises its CollectibleEffect to track how many shield charges the player currently has.
  • Most familiar items can have their familiar granted via their CollectibleEffect.
  • Whore of Babylon and Crown of Light grant their CollectibleEffects while activated.

Some items can have their effects granted invisibly through the use of their CollectibleEffect, oftentimes this is because another item pre-repentance wished to invoke its effect (such as Monster Manual). Many post-repentance items use real fake copies of items for this purpose, but adding these is not supported by the API and some such as Hemoptysis and Berserk! still use CollectibleEffects for their cooldowns. You should not assume that any given item will work as a TemporaryEffect the same as it does when actually obtained.

Supported Items

Passive items with notable CollectibleEffects (excluding quest items).

  • Sad Onion
  • Inner Eye
  • Spoon Bender
  • My Reflection
  • Number One
  • Brother Bobby
  • Magic Mushroom
  • The Virus
  • Roid Rage
  • Transcendence
  • Mom's Underwear
  • Mom's Heels
  • Mom's Lipstick
  • Mom's Eye
  • Distant Admiration
  • Sister Maggy
  • Growth Hormones
  • Mini Mush
  • Cube of Meat (all levels)
  • Little Chubby
  • Sack of Pennies
  • Robo-Baby
  • Little Chad
  • The Relic
  • Little Gish
  • Little Steven
  • The Wafer
  • Mom's Contacts
  • Guardian Angel
  • Demon Baby
  • Mom's Knife
  • Ouija Board
  • Dead Bird (spawns the bird without having to get hit)
  • Brimstone
  • Odd Mushroom (Thin)
  • Odd Mushroom (Large)
  • Whore of Babylon (grants the effect without having to be at half a heart or less)
  • Forever Alone
  • Bomb Bag
  • Speed Ball
  • Bum Friend
  • Tough Love
  • Peeper (only gives the familiar)
  • Ghost Baby
  • Harlequin Baby
  • Daddy Longlegs
  • Sacrificial Dagger
  • Rainbow Baby
  • Holy Water
  • Guppy's Hairball
  • Abel
  • Mom's Key
  • Mom's Eyeshadow
  • Iron Bar
  • The Guillotine
  • Ball of Bandages (all levels)
  • Anemic (grants the creep trail without having to get hit)
  • Mom's Wig
  • Mom's Perfume
  • Death's Touch
  • Experimental Treatment (stat changes are seeded per room)
  • 20/20 (no damage down)
  • Hive Mind
  • Fire Mind
  • Dark Matter
  • Proptosis
  • Smart Fly
  • Dry Baby
  • Juciy Sack
  • Robo-Baby 2.0
  • Rotten Baby
  • Headless Baby
  • Leech
  • Mystery Sack
  • BBF
  • Bob's Brain
  • Best Bud (grants the familiar witout having to get hit)
  • Lil Brimstone
  • Lil Haunt
  • Dark Bum
  • Big Fan
  • Sissy Longlegs
  • Punching Bag
  • Leo
  • Holy Mantle
  • Mysterious Liquid
  • Gemini
  • Cain's Other Eye
  • ???'s Only Friend
  • Samson's Chains
  • Mongo Baby
  • Blue Cap
  • Synthoil
  • Mom's Pearls
  • The Wiz
  • Incubus
  • Fate's Reward
  • Lil Chest
  • Sworn Protector
  • Friend Zone
  • Lost Fly
  • Charged Baby
  • Holy Light
  • Lil Gurdy
  • Bumbo
  • Censer
  • Key Bum
  • Rune Bag
  • Seraphim
  • Tractor Beam (only grants a tears up)
  • God's Flesh
  • Spider Mod
  • Farting Baby
  • Empty Vessel (grants flight even with red hearts; shield doesn't trigger)
  • Lusty Blood (each count of the effect increases damage; doesn't increase with kills)
  • Crown of Light (only gives range up and shot speed down, doesn't go away when hit)
  • Succubus
  • Fruit Cake
  • Obsessed Fan
  • Head of the Keeper
  • Papa Fly
  • Multidimensional Baby
  • Lil Loki
  • Milk! (grants a tears up instead of the familiar)
  • Dark Prince's Crown (grants its effect as if it was active no matter your health)
  • Finger!
  • Shade
  • Depression
  • Hushy
  • Lil Monstro
  • King Baby
  • Big Chubby
  • Acid Baby
  • Yo Listen!
  • Adrenaline
  • Euthanasia
  • Camo Undies
  • Sack of Sacks
  • Mom's Razor
  • Bloodshot Eye
  • Angry Fly
  • Buddy in a Box
  • Lil Delirium
  • 7 Seals
  • Angelic Prism
  • Lil Spewer
  • Mystery Egg
  • Slipped Rib
  • Hallowed Ground
  • Pointy Rib
  • Jaw Bone
  • Blood Puppy
  • Paschal Candle (each count of the effect increases tears; doesn't give the familiar)
  • Eye of the Occult (doesn't change any stats)
  • Intruder (doesn't release the spider on hit)
  • Psy Fly
  • Mars (immediately causes the dash effect)
  • Uranus
  • Boiled Baby
  • Freezer Baby
  • Bird Cage (spawns the bird without having to get hit)
  • Lil Dumpy
  • Bot Fly
  • Tinytoma
  • Fruity Plum
  • Cube Baby
  • Astral Projection (turns you into the ghost that gets a free hit + flight)
  • Lil Abaddon
  • Lil Portal
  • Worm Friend
  • Innner Child (permanently grants speed and size down as if you just revived)
  • Twisted Pair
  • Mom's Ring
Example Code

This code applies the effect and costume of the item "Sad Onion" to the player.

1
2
local player = Isaac.GetPlayer()
player:GetEffects():AddCollectibleEffect(CollectibleType.COLLECTIBLE_SAD_ONION, true)

Add·Null·Effect ()⚓︎

void AddNullEffect ( ItemConfigNullItemID NullId, boolean AddCostume = true, int Count = 1 )⚓︎

Add·Trinket·Effect ()⚓︎

void AddTrinketEffect ( TrinketType TrinketType, boolean AddCostume = true, int Count = 1 )⚓︎

Clear·Effects ()⚓︎

void ClearEffects ( )⚓︎

Get·Collectible·Effect ()⚓︎

const TemporaryEffect GetCollectibleEffect ( CollectibleType CollectibleType )⚓︎

Get·Collectible·Effect·Num ()⚓︎

int GetCollectibleEffectNum ( CollectibleType CollectibleType )⚓︎

Get·Effects·List ()⚓︎

const EffectList GetEffectsList ( )⚓︎

Get·Null·Effect ()⚓︎

const TemporaryEffect GetNullEffect ( ItemConfigNullItemID NullId )⚓︎

Get·Null·Effect·Num ()⚓︎

int GetNullEffectNum ( ItemConfigNullItemID NullId )⚓︎

Get·Trinket·Effect ()⚓︎

const TemporaryEffect GetTrinketEffect ( TrinketType TrinketType )⚓︎

Get·Trinket·Effect·Num ()⚓︎

int GetTrinketEffectNum ( TrinketType TrinketType )⚓︎

Has·Collectible·Effect ()⚓︎

boolean HasCollectibleEffect ( CollectibleType CollectibleType )⚓︎

Has·Null·Effect ()⚓︎

boolean HasNullEffect ( ItemConfigNullItemID NullId )⚓︎

Has·Trinket·Effect ()⚓︎

boolean HasTrinketEffect ( TrinketType TrinketType )⚓︎

Remove·Collectible·Effect ()⚓︎

void RemoveCollectibleEffect ( CollectibleType CollectibleType, int Count = 1 )⚓︎

Count = -1 removes all instances of the effect

Remove·Null·Effect ()⚓︎

void RemoveNullEffect ( ItemConfigNullItemID NullId, int Count = 1 )⚓︎

Count = -1 removes all instances of the effect

Remove·Trinket·Effect ()⚓︎

void RemoveTrinketEffect ( TrinketType TrinketType, int Count = 1 )⚓︎

Count = -1 removes all instances of the effect

Last update: January 30, 2023