The Binding of Isaac: Rebirth

The Binding of Isaac: Rebirth

[AB+] Eden Modded Start
 This topic has been pinned, so it's probably important
budjmt  [developer] 26 May, 2020 @ 9:15pm
FAQ
- Why can I sometimes see the original build for 1 frame?
- Due to API limitations, the safest time to apply these build changes is after the player is first rendered. Often there is no visible interruption, but sometimes there is a noticeable blip. This should not interfere with any functionality

- Why do I have a vanilla item with OnlyModdedItems on?
- See the sections below for more information

- I'm seeing some weird effect after starting as Eden!?
- All logs for this mod appear in `Documents/My Games/The Binding of Isaac Afterbirth+/log.txt` with the prefix `[EdenModdedStart]`. Check if any of the items removed in those logs match any mentioned in the sections below; if the effects you're seeing match up, then that's expected. If it's an item not mentioned, or you're seeing another effect, please provide a bug report with the relevant log information

## Items with Special Removal Conditions

As a general rule, if an item can be removed from the player mostly without consequence, the mod does so to increase the possibility for a modded item to appear. Most can be removed seamlessly using previously mentioned techniques. Some items are fairly simple to special-case; others require larger workarounds

1. Halo of Flies - adds two copies of itself when given (this is also likely responsible for its strange behavior with D4!)

2. Camo Undies - adds both an item and collectible effect, the latter of which must be manually removed if the player does not fire

3. Trinity Shield, Marked, Spear of Destiny - These items do not use the standard familiar system to ensure their objects are removed when the source item is. As a result, they leave behind effect entities that must be manually removed, and in Marked's case it's unclear which player the target belongs to so it just checks for frame count

4. Rosary - The item adds copies to the Bible to all pools. Due to API limitations, the mod just removes the Bible from all pools if removing Rosary

5. All mapping related items - Mapping/Curse removal effects are impossible to reverse correctly on the current floor. If a player is added in the starting room, the mod resets the current floor entirely, (without changing the map seed) which may lead to unusual side effects in True Coop or for any mods/items that are tied to the new level/room callbacks. The items specifically targeted are Compass, Treasure Map, Blue Map, The Mind, Black Candle, X-Ray Vision, and Spelunker's Hat

## Items that are Blacklisted from Removal

The following items are deliberately not removed from Eden due to API limitations which would lead balance or player information issues. As a result they may be encountered even when the OnlyModdedItems setting is on

1. PHD - the API does not allow pills to be unidentified. Having all identified pills is confusing and a bit of an unfair advantage

2. Eden's Blessing - the effect cannot be reversed, so to make it clear why you have an extra item on your next run this is not removed

3. Guppy Items - the Guppy transformation is very strong and it's important to understand how close the player is to getting it; the API also does not expose a mechanism to reset transformation progress

## Other Items of Note

1. Skinny/Fat Odd Mushroom - the API does not expose a way to reverse a change in Head size, so the mod adds and removes the other odd mushroom to counter the size change. As a result, getting either of these items puts the player 2/3 of the way to the Fun Guy transformation

2. Experimental Treatment - the stat changes from this item do not go away once the item is removed, however the mod automatically reverses the health change. Since the stat changes are random, consider it a further enhancement to Eden's randomness

3. Special Items - it's hard to measure, but it's possible removing/adding a special item from/to Eden will affect the special item reroll rate. Since one special item's effect on this is negligible, it seems reasonable to ignore

4. Any and all transformation items - the API exposes no way to reset transformation progress, so all transformations may be affected by this mod's implementation. Expect unusual timing for these since transformation counters are shared by all players. Since Guppy is disproportionately powerful, it's the only transformation with blacklisted items

5. Polaroid? - during testing, on some rare occasions the game detected the player as having the Polaroid despite not actually having it. As a result, in cases where Eden's passive has a greater id than the Polaroid, (usually meaning the item was added to the game later in its lifecycle) the player ends up with 2 passives instead of 1 since the real one is not removed. Consider it an occasional bonus! You can verify if that's what's happening using `log.txt`