Initial Follower Shuffle Implementation

README.md

@@ -234,6 +234,27 @@ New flute spots are chosen at random, with restrictions that limit the promixity
 
 New flute spots are chosen at random with minimum bias.
 
+## Follower Shuffle (--shuffle_followers)
+
+This shuffles the follower companions throughout the world. Here is a full list of followers in the game:
+
+- Princess Zelda
+- Old Man
+- Blind Maiden
+- Frog/Blacksmith
+- Locksmith (Guy who unlocks Purple Chest)
+- Kiki the Monkey
+- Purple Chest
+- Super Bomb
+
+When followers are shuffled, you must still fulfill the original requirements of the follower location. For example, if the Super Bomb Shop now contains the Frog, you must have crystals 5 and 6 and 100 rupees to unlock the Frog. It is also important to note that Purple Chest still needs to be delivered to the usual spot. Also, since it isn't useful normally, many people might not know that the Locksmith (the Purple Chest unlocking guy) can follow you, you must remove his sign to get him to follow.
+
+Most of the limitations of followers in the vanilla game have been lifted for this shuffle to work. For instance, you are able to mirror, flute, die, collect a crystal, and save/quit in most situations and still retain the follower. You are also able to enter caves/dungeons and complete dig game while you have a follower.
+
+In the scenario where you are forced down a narrow path and a follower is in your way and you already have a different follower. Running into that follower will switch the followers rather than overwriting, this gives you the opportunity to proceed with either one of the followers. Note that if you leave the screen, you lose this option to switch and you will need to go back to the original place you found the first follower.
+
+Optionally, thru the customizer, you can add a follower to your starting inventory, and you will be given that follower and it will stay with you until you complete their quest.
+
 ## Bonk Drop Shuffle (--bonk_drops)
 
 This adds 42 new item locations to the game. These bonk locations are limited to the ones that drop a static item in the vanilla game.
@@ -403,6 +424,12 @@ This gives each OW tile a random chance to be flipped to the opposite world
 
 For randomizing the flute spots around the overworld
 
+```
+--shuffle_followers
+```
+
+This shuffles the follower companion locations, ie. Purple Chest, Old Man, etc.
+
 ```
 --bonk_drops
 ```