Readme plus other fixes.

- Readme update (version 1 release)
- Fixed fake Dark World
- Fixed Titan's Mitt downgrading
- some fixes with item placement
- Hammer can now be found in the Light World again! yay!
- Red Mail and Mirror Shield can no longer be found in the Light World.

Author: Dessyreqt

AlttpRandomizer/Net/RandomizerVersion.cs

@@ -10,7 +10,7 @@ namespace AlttpRandomizer.Net
 {
     public class RandomizerVersion
     {
-        public static string Current = "1P5";
+        public static string Current = "1";
         public static bool Debug = false;
 
         public static string CurrentDisplay
@@ -28,7 +28,7 @@ public static string CurrentDisplay
             }
         }
 
-        private const int checkVersion = 0;
+        private const int checkVersion = 1;
         private static readonly string updateAddress = "http://dessyreqt.github.io/alttprandomizer/?" + DateTime.Now.Ticks;
 
         public static void CheckUpdate()

AlttpRandomizer/Random/Randomizer.cs

@@ -2,19 +2,14 @@
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
-using System.Runtime.CompilerServices;
-using System.Runtime.InteropServices;
-using System.Security.Cryptography.X509Certificates;
-using System.Text;
-using System.Threading.Tasks;
 using AlttpRandomizer.IO;
 using AlttpRandomizer.Net;
 using AlttpRandomizer.Properties;
 using AlttpRandomizer.Rom;
 
 namespace AlttpRandomizer.Random
 {
-	public enum RandomizerDifficulty
+    public enum RandomizerDifficulty
 	{
 		Casual = 0,
 	}

AlttpRandomizer/Resources/alttp.sfc

@@ -924,7 +924,7 @@ public void ResetLocations()
                         have.Contains(ItemType.OcarinaActive)
                         && CanBeInDarkWorld(have)
                         && have.Contains(ItemType.TitansMitt),
-                },
+               },
                 new Location
                 {
                     LateGameItem = true,
@@ -1007,7 +1007,9 @@ public void ResetLocations()
                         have =>
                         CanClimbDeathMountain(have)
                         && CanBeInDarkWorld(have)
-                        && have.Contains(ItemType.Hammer),
+                        && have.Contains(ItemType.Hammer)
+                        // not actually required here, but stops some deadlocks
+                        && have.Contains(ItemType.Quake),
                 },
                 new Location
                 {
@@ -2010,20 +2012,6 @@ public void ResetLocations()
                             }
                         }
                 },
-                // To prevent double-item deadlocks
-                new Location
-                {
-                    LateGameItem = true,
-                    Region = Region.Progression,
-                    Name = "Turtle Rock",
-                    Item = new Item(ItemType.Progression),
-                    CanAccess =
-                        have =>
-                        CanAccessEastDarkWorldDeathMountain(have)
-                        && have.Contains(ItemType.Hammer)
-                        && have.Contains(ItemType.Quake),
-                },
-
             };
         }
 
@@ -2243,35 +2231,46 @@ public List<Location> GetUnavailableLocations(List<ItemType> haveItems)
         public void TryInsertCandidateItem(List<Location> currentLocations, List<ItemType> candidateItemList, ItemType candidateItem)
         {
             var uniqueItems = GetUniqueItems();
-            var badLateGameItem = (candidateItem == ItemType.TitansMitt || candidateItem == ItemType.Hammer) && !currentLocations.Any(x => x.LateGameItem);
+            var badLateGameItem = IsLateGameItem(candidateItem) && !currentLocations.Any(x => x.LateGameItem);
             var needUniqueItem = !uniqueItems.Contains(candidateItem) && currentLocations.All(x => x.UniqueItemOnly);
-            var badFirstItem = (candidateItem == ItemType.PowerGlove || candidateItem == ItemType.MirrorShield) && currentLocations.Any(x => x.Name == "[cave-040] Link's House");
+            var badFirstItem = IsBadFirstItem(candidateItem) && currentLocations.Any(x => x.Name == "[cave-040] Link's House");
 
             if (!badLateGameItem && !needUniqueItem && !badFirstItem)
             {
                 candidateItemList.Add(candidateItem);
             }
         }
 
+        private static bool IsBadFirstItem(ItemType item)
+        {
+            return (item == ItemType.PowerGlove || item == ItemType.TitansMitt || item == ItemType.RedShield || item == ItemType.MirrorShield);
+        }
+
         public int GetInsertedLocation(List<Location> currentLocations, ItemType insertedItem, SeedRandom random)
         {
             int retVal;
             var uniqueItems = GetUniqueItems();
             bool badLateGameItemSpot;
             bool badUniqueItemSpot;
+            bool unusedUniqueItemSpot;
 
             do
             {
                 retVal = random.Next(currentLocations.Count);
 
-                badLateGameItemSpot = (insertedItem == ItemType.TitansMitt || insertedItem == ItemType.Hammer) && !currentLocations[retVal].LateGameItem;
-                badUniqueItemSpot = uniqueItems.Contains(insertedItem) && !currentLocations[retVal].UniqueItemOnly && currentLocations.Any(x => x.UniqueItemOnly);
-            } while (badLateGameItemSpot || badUniqueItemSpot);
-
+                badLateGameItemSpot = IsLateGameItem(insertedItem) && !currentLocations[retVal].LateGameItem;
+                badUniqueItemSpot = !uniqueItems.Contains(insertedItem) && currentLocations[retVal].UniqueItemOnly;
+                unusedUniqueItemSpot = uniqueItems.Contains(insertedItem) && !currentLocations[retVal].UniqueItemOnly && currentLocations.Any(x => x.UniqueItemOnly);
+            } while (badLateGameItemSpot || badUniqueItemSpot || unusedUniqueItemSpot);
 
             return retVal;
         }
 
+        private static bool IsLateGameItem(ItemType item)
+        {
+            return item == ItemType.TitansMitt || item == ItemType.RedMail || item == ItemType.MirrorShield;
+        }
+
         public ItemType GetInsertedItem(List<Location> currentLocations, List<ItemType> itemPool, SeedRandom random)
         {
             ItemType retVal;
@@ -2283,7 +2282,7 @@ public ItemType GetInsertedItem(List<Location> currentLocations, List<ItemType>
             {
                 retVal = itemPool[random.Next(itemPool.Count)];
 
-                badLateGameItem = (retVal == ItemType.TitansMitt || retVal == ItemType.Hammer) && !currentLocations.Any(x => x.LateGameItem);
+                badLateGameItem = IsLateGameItem(retVal) && !currentLocations.Any(x => x.LateGameItem);
                 needUniqueItem = !uniqueItems.Contains(retVal) && currentLocations.All(x => x.UniqueItemOnly);
             } while (badLateGameItem || needUniqueItem);
 

AlttpRandomizer/Rom/RomLocationsCasual.cs

@@ -1,4 +1,4 @@
-# Current Version: 0
+# Current Version: 1
 
 # About the Legend of Zelda: A Link to the Past Randomizer (or ALttPRandomizer)
 This is a simple program that moves around items in the Legend of Zelda: A Link to the Past (ALttP). It is used for racing the game.
@@ -10,11 +10,22 @@ Select a location to save your randomized rom, then select `Create`.
 
 Right now there is only one difficulty, "Casual". There may be other difficulties in the future.
 
+# Differences from the normal game
+There are a number of differences from a randomized game to the normal game. Here's a short list:
+- The game text is in Japanese _(this obviously isn't different if you are used to playing in Japanese. See below for why.)_
+- Chest items and items given to you by the bottle vendor, Sahasrahla, the flute boy, the sick kid, the purple chest, the hobo under the bridge, the catfish, King Zora, and the old mountain man are randomized. Note that this doesn't include chests in the various chest games throughout Hyrule.
+
+Some bugs that wouldn't crop up in normal play have been fixed:
+- If you die in a Dark World dungeon and haven't defeated Agahnim, you will end up in what's known as "fake Dark World." This will sometimes cause the Crystal at the end of the dungeon to not spawn, causing a softlock. You cannot spawn in "fake Dark World" in randomizer.
+- If you collect Power Gloves after collecting Titan's Mitt, your gloves will downgrade and you will be stuck without a way to lift dark rocks. This will not happen in randomizer.
+- If you collect the key in the big chest room in the Swamp Palace _(due to having hookshot earlier than normal)_, then use that key on the top left door of that room, you can cause a soft lock due to being unable to access that key. In randomizer, moving one screen on the overworld away from the entrance to Swamp Palace will reset the water both around Swamp Palace, and the water that would cover those keys.
+- If you defeat Agahnim and never found the Magic Mirror, you will be stuck in the Dark World with no way to return to the light world. In randomizer, saving and quitting will cause you to load up in the Light World.
+- Occasionally Agahnim will attack you with particles that can't be reflected back at him. In randomizer, this doesn't happen.
+
 # Why is the game in Japanese?
 This randomizer uses the 1.0 JP version of the base rom because it is what is primarily used in speedrunning ALttP. Here are some of the features of this version compared to the English version:
 - Faster text speed. This is very noticeable during the introduction.
 - After getting the Pegasus Boots, pressing `Y` + `A` will allow you to use an item and dash at the same time. For a clear example of this working, try hammer dashing at the bridge leading from Dark Palace to Swamp Palace.
 - You can jump down from a wall of which you are partially inside. This is most useful above the section of Turtle Rock that leads to the Mirror Shield.
 - In an area where you can't use the Magic Mirror, you can make pushed blocks disappear by trying to use it while pushing the blocks.
 - You can enter the Exploration Glitch in Tower of Hera by falling down the rightmost hole on the 3F, then jumping right from the wall.
-- If you light Ganon's left torch before the right torch extinguishes, the right torch will never extinguish.