Make Mini Heart Doors stay open for the duration of the session (when not used with unlock cutscene triggers)

... which makes them more consistent with vanilla heart doors, and with how they behaved before 1.3.7 came out. Those can now be used as vanilla heart door replacement if someone needs them to be approachable from the right, or resizable vertically.

Author: maddie480

DOCUMENTATION.md

@@ -171,6 +171,8 @@ The cutscene will trigger as soon as the player enters it if the conditions are
 
 If you have multiple heart doors in your lobby, and don't want them to open all at the same time (for example because they are referring to different level sets), give your doors different _IDs_ (with the "Door Id" field). You should then use the same ID in the unlock cutscene trigger lo link the door to its trigger.
 
+**Tip:** If you use these doors without an unlock cutscene trigger, they behave like vanilla mini heart doors, but approachable from both sides, with resizable height, and all using their own flags (so opening one won't open all heart gates with the same amount of hearts). You shouldn't use a mix of vanilla heart doors and mini heart doors in the same map though.
+
 ### Rainbow Berries
 
 This is a special berry that will appear as a hologram until the player got all silver berries in the level set they're associated to. **Only silver berries count**, golden berries are excluded from this counter.

Entities/MiniHeartDoor.cs

@@ -109,6 +109,20 @@ private static void modDoorRoutine(ILContext il) {
                     return orig;
                 });
             }
+
+            // add a patch at the place where the vanilla opened_heartgem_door_[heartcount] gets set.
+            if (refToThis != null && cursor.TryGotoNext(MoveType.After, instr => instr.MatchLdstr("opened_heartgem_door_"))) {
+                Logger.Log("CollabUtils2/MiniHeartDoor", $"Making mini heart door save its session flag at {cursor.Index} in IL for HeartGemDoor.Routine");
+
+                cursor.Emit(OpCodes.Ldarg_0);
+                cursor.Emit(OpCodes.Ldfld, refToThis);
+                cursor.EmitDelegate<Action<HeartGemDoor>>(self => {
+                    if (self is MiniHeartDoor door) {
+                        // mini heart doors use their own flags, that allow better differenciation between themselves by using entity ID.
+                        (door.Scene as Level).Session.SetFlag("opened_mini_heart_door_" + door.entityID, true);
+                    }
+                });
+            }
         }
 
         private static void modDoorColor(ILContext il) {
@@ -134,12 +148,13 @@ private static void modDoorColor(ILContext il) {
 
         private float height;
 
+        private EntityID entityID;
         public string DoorID;
         public string GetDoorSaveDataID(Scene scene) {
             return (scene as Level).Session.Area.GetSID() + (string.IsNullOrEmpty(DoorID) ? "" : ":" + DoorID);
         }
 
-        public MiniHeartDoor(EntityData data, Vector2 offset) : base(data, offset) {
+        public MiniHeartDoor(EntityData data, Vector2 offset, EntityID entityID) : base(data, offset) {
             height = data.Height;
             levelSet = data.Attr("levelSet");
 
@@ -148,12 +163,14 @@ public MiniHeartDoor(EntityData data, Vector2 offset) : base(data, offset) {
                 color = colors[color];
             }
 
+            this.entityID = entityID;
             DoorID = data.Attr("doorID");
         }
 
         public override void Added(Scene scene) {
-            // if the gate was already opened on that save, open the door right away by setting the flag.
-            (scene as Level).Session.SetFlag("opened_heartgem_door_" + Requires, CollabModule.Instance.SaveData.OpenedMiniHeartDoors.Contains(GetDoorSaveDataID(scene)));
+            // if the gate was already opened on that save or in that session, open the door right away by setting the flag.
+            (scene as Level).Session.SetFlag("opened_heartgem_door_" + Requires,
+                (scene as Level).Session.GetFlag("opened_mini_heart_door_" + entityID) || CollabModule.Instance.SaveData.OpenedMiniHeartDoors.Contains(GetDoorSaveDataID(scene)));
 
             base.Added(scene);
 

everest.yaml

@@ -1,5 +1,5 @@
 - Name: CollabUtils2
-  Version: 1.3.7
+  Version: 1.3.8
   DLL: bin/Debug/net452/CollabUtils2.dll
   Dependencies:
     - Name: Everest