gen 4 (final-final-final-final) update notes

Backing up the gen 4 - 6 Jan patch notes before I update again: currently in the testing and post-making phase

Gen 4 fixes:

• 27 Dec - creates the riv_rel_autojson.cfg file if it's needed (it stores options for automatic relation backups) instead of relying on this file existing
• 27 Dec - better recognition of what the current save ID is if you started the save off in CAS / build mode instead of going directly into live mode
• 4 Jan - fixed issue that would happen sometimes when setting up riv_auto, causing an error because the .json files didn't exist yet (this can be hotfixed by making two empty text files, but if you have encountered this issue then please update!) well, I fixed making the file storing sims, and in the process broke making the file storing relations...
• 4 Jan - added compatibility with MCCC autosave: my mod finds which slots are MCCC autosave slots from the mc_settings.cfg file (it searches the entire Mods folder - on my PC this added at most 0.14s to the initial loading time, so it should be virtually unnoticeable on any system - and if it can't find this file then it assumes there are no autosave slots), and if the current save slot changes to one of these then it continues to use
• 6 Jan - fixed issue that would happen sometimes when setting up riv_auto, causing an error because the .json files didn't exist yet

_____________________________________________________

GEN 4 NEW FEATURES:

• riv_auto: this command will set up automatic .json updates for the current save ID with whatever keyword you like. Then your .json files will be automatically updated on loading into live mode (when all households and sim infos have loaded), addition of a new sim (birth or generated NPCs), and saving the game.
  • set this up by running "riv_auto xyz" after loading into a lot if you want this save to use the files riv_rel_xyz.json and riv_relparents_xyz.json
  • this will create or update a file riv_rel_autojson.cfg, which can be edited in Notepad++ if you want to change or remove the settings
  • your keyword (xyz) will be attached to a save ID (can be seen by hovering over the folder icon in the 'load game' menu), not a save file, so if you save your file under a different ID then you'll have to run riv_auto again.
  • you'll see a notification pop up when you next load into live mode in this save!
• riv_rel_addon_computer.package: this add-on adds an extra pie menu to the computer giving a mod overview, descriptions of commands, explanations of features, and definitions for different relations. This is in a separate package, and requires XML injector, found at https://scumbumbomods.com/xml-injector (the main mod does not require this)
• riv_gen_diff: I made this command for myself but figured I might as well throw it in - it gives the generational difference between two sims as the average of all of their biological relationships with that sim.

BUG FIXES / IMPROVEMENTS:

• loading/saving rels is now done to/from temporary files (riv_tmp_xyz.json and riv_tmpparents_xyz.json)
  • these files will replace riv_rel_xyz.json and riv_relparents_xyz.json when you save
  • this just ensures that if your game crashes or you quit without saving, then you'll have the right lists for the current state of your game
• if you're using .json files, the game will also use relbits when checking for indirect relations
  • siblings with no parents will now show up as siblings
  • (same for most pibling/nibling pairs and first cousins - I still haven't found where the occasional error is, and in the released version i'd rather have it just not recognise the relation than throw an exception)
• riv_clean is now more effective (make sure you run this command while in the current version of your save - running riv_auto will also call riv_clean)
  • sims flagged as culled in the .json file will be 'unculled' from the file if they exist in the save
  • exact duplicates of the same tuple will now be removed (I originally overlooked this possibility and was only removing previous instances of an existing sim info)
  • if you somehow managed to get two copies of the same sim at the exact same time but with different details, you'll have to manually delete one, since I have no way to prioritise which one should be kept in the file
• clears the list of sim mini-infos if you switch save slots without quitting the game
• creates the riv_rel_autojson.cfg file if it's needed (it stores options for automatic relation backups) instead of relying on this file existing
• riv_auto is compatible with MCCC autosave
• fixed problems with riv_auto trying to access .json files before they were created