diff --git a/CHANGELOG.md b/CHANGELOG.md
index aef17765..fe3f74df 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+### 0.2.9.0
+- Added Bonk Drop Shuffle
+- Fixed disappearing mirror portal issue in Inverted+Crossed OWR
+- Fixed 4-digit collection rate in credits
+- Fixed Ganon vulnerability to reference Aga2 boss flag rather than pyramid hole
+- Fixed issue with pre-opened pyramid when not expected
+
 ### 0.2.8.0
 - ~Merged DR v1.0.1.0 - Pottery options, BPS support, MSU Resume, Collection Rate Counter~
 - Various improvements to increase generation success rate and reduce generation time
diff --git a/OverworldShuffle.py b/OverworldShuffle.py
index 5a940200..f5812ffc 100644
--- a/OverworldShuffle.py
+++ b/OverworldShuffle.py
@@ -6,7 +6,7 @@ from Regions import mark_dark_world_regions, mark_light_world_regions
 from OWEdges import OWTileRegions, OWEdgeGroups, OWExitTypes, OpenStd, parallel_links, IsParallel
 from Utils import bidict
 
-version_number = '0.2.8.0'
+version_number = '0.2.9.0'
 version_branch = '-u'
 __version__ = '%s%s' % (version_number, version_branch)
 
diff --git a/README.md b/README.md
index 9dbb35fe..c6e5187c 100644
--- a/README.md
+++ b/README.md
@@ -48,7 +48,7 @@ Alternatively, run ```Gui.py``` for a simple graphical user interface.
 
 # Settings
 
-Only extra settings are found here. All door and entrance randomizer settings are supported. See their [readme](https://github.com/Aerinon/ALttPDoorRandomizer/blob/master/README.md)
+Only extra settings added by this Overworld Shuffle fork are found here. All door and entrance randomizer settings are supported. See their [readme](https://github.com/Aerinon/ALttPDoorRandomizer/blob/master/README.md)
 
 ## Overworld Layout Shuffle (--ow_shuffle)
 
@@ -136,6 +136,37 @@ New flute spots are chosen at random, with restrictions that limit the promixity
 
 New flute spots are chosen at random with minimum bias.
 
+## Bonk Drop Shuffle (--bonk_drops)
+
+This adds 41 new item locations to the game. These bonk locations are limited to the ones that drop a static item in the vanilla game.
+
+- Bonk Locations consist of some trees, rocks, and statues
+  - 33 Trees
+    - 8 of the tree locations require Agahnim to be defeated to access the item
+  - 6 Rocks
+    - 1 of the rocks drops 2 items
+  - 1 Statue
+- Bonk locations can be collected by bonking into them with the Pegasus Boots or using the Quake Medallion
+- One of the bonk locations are guaranteed to have a full magic decanter
+- Some of the drops can be farmed repeatedly, but only increments the collection rate once
+- All of the bonk trees have been given an alternate color (and all non-bonk trees are reverted to normal tree color)
+  - Some screens are coded to change the "alternate tree color", some of them are strange (just how the vanilla game does it)
+  - Rocks and statues are unable to be made to have a different color
+- Since Fairies and Apples are new items that can appear in plain sight, they don't have a proper graphic for them yet. For now, they show up as Power Stars
+
+Future Note: This does NOT include the Good Bee (Cold Bee) Cave Statue...yet. In the future, this could be an additional item location.
+
+#### Items Added To Pool:
+- 15 Fairies
+- 8 Apples
+- 6 Bee Traps
+- 3 Red Rupees
+- 3 Blue Rupees
+- 2 Single Bomb
+- 2 Small Hearts
+- 1 Large Magic Decanter
+- 1 8x Bomb Pack
+
 ## New Goal Options (--goal)
 
 ### Trinity
@@ -216,3 +247,9 @@ This gives each OW tile a random chance to be swapped to the opposite world
 ```
 
 For randomizing the flute spots around the overworld
+
+```
+--bonk_drops
+```
+
+This extends the item pool to bonk locations and makes them additional item locations