Feature/custom epochs and eras

[quipsol]

Adds CustomEpochModel, CustomStoryModel and CustomEpochEra models.

• Custom epochs can be inserted into the timeline.
• Support for Character specific epochs that match how the base game epochs unlock.
• Custom Eras can be inserted to the Timeline.

Custom Epoch

With these it is possible to add custom Epochs to the Timeline. Important for that are the patches that change the position value for epochs that have duplicate values with other epochs in the same Era. As well as fixing the Timeline Screen when epoch count in an era grows over 5, as they would appear out of bound.

Custom Story

Stories cross reference themselves with their respective Epochs. Some information of them is shown in the Timeline.

Character Specific Epochs

Character specific epochs are nullable EpochModel properties. Default to null and leaving them empty will keep the CustomCharacterModel to behave as previously. Any number of them can be overwritten with a CustomEpoch and BaseLib will take care of the unlock logic for it.

A special mention goes to the first epoch which unlocks the character. If the value is not null the character will be locked by default. When the character unlocks depends on the UnlocksAfterRunAs property.
null or Ironclad will result in the character to unlock after obtaining the NeowEpoch. This is how Silents unlock works as well (Silent does say "play a game as Ironclad" but it technically unlocks after doing a run with any character).
Choosing other characters will unlock after a run with them has been finished.
Since mods are usually added later, during main menu load a check is run to see if any required epoch is already unlocked. If it is, set the character unlock epoch state to obtained.

Custom Eras

The game uses the EpochEra enum value for ordering in the Timeline (and a few other minor things). This does not work for us. While a [CustomEnum] EpochEra is still required, it is only used for insertion in a Dictionary and set in the EpochModel.
During Timeline initialization, all epochs that belong to custom eras are removed from the list. At a later point in the initialization a transpiler will call a method that will handle re inserting these Epochs and creates the Eras along the way.

Eras are inserted as follows:
A reference base game Era used as an insertion reference point.
A direction in which to insert the Era.
A number to declare the order in which they are displayed. (larger -> further away from reference)

Since eras only exist if at least one epoch from it will be shown, there is some logic that will find an alternative entry point which keeps the expected display position the same.

Custom Eras have these extra features:

• Disable forced resizing -> displays the icon with its original resolution
• Disable tinting -> Removes the games self modulate which turns the icon textures from white to their gold yellow

---

issues/notes

If a custom era had to find an alternative entry point, and the game inserts new eras during unlocking, the custom era might not be in the correct spot. -> Fixes itself when exiting and entering the Timeline.

If multiple characters are unlocked at once, only one character will get the unlock animation when entering the choose a character menu. (they are still all unlocked)

As before, many patches skip the original epoch unlock methods. If someone wants to forgo this system and implement their own, they still need to patch around that. (its not difficult to do but should still be mentioned)

Since EpochModel and StoryModel are not in ModelDb, the default PrefixId patch does not work. I have tried to find good places to implement prefixing but couldn't find any. So currently the mod prefix must be added manually to them.

While they haven't touched the Timeline/Epoch system in a while, there are minor changes in the newest beta branch update. Possible that this currently only works for beta branch.

One of the commits is just a squashed commit of all the master branch changes. I needed those due to the game updating.

---

CustomEras are a bit more complicated to set up. If this gets merged I will write an Entry on the Wiki for all of this.

Custom Era code:

public class MyCustomEras
{
    public static CustomEpochEra TestEra => new CustomTestEra();
    
    private class CustomTestEra : CustomEpochEra
    {
        [CustomEnum] public static EpochEra TestEpochEra;
        public override EpochEra CustomEra => TestEpochEra;
        public override EpochEra ReferenceEra => EpochEra.FarFuture0;
        public override RelativeEraDirection Direction => RelativeEraDirection.After;
        public override int DirectionDepth => 42;
        public override string EraIconPath => $"{MainFile.ResPath}/images/eras/{StringHelper.Slugify(GetType().Name).ToLowerInvariant()}.png";
        public override bool UseOriginalImageSize => true;
        public override bool DisableTinting => true;
    }

for use in a CustomEpochModel:

public override EpochEra Era =>  CustomEra.CustomEra;
public override CustomEpochEra CustomEra => MyCustomEras.TestEra;