Last hope: blueprint library recovery from save file. (v1.1.9+)

[boskid]

Introduction

Recently v453000 asked me about options to recover blueprints of a player that lost his blueprint library (viewtopic.php?p=530872#p530872). I looked at possible options and there were not many, however thinking a little more lead me to the simple conclusion: when blueprints from library are used in game, they are transferred so all the players have a copy of imported blueprint so it has to be part of a game state and be included inside of the save file. They are there and should be possible to be extracted. Only reason why they were not possible to be extracted was that when a player joins with an empty blueprint library, there is a blueprint library synchronization happening which removes all the blueprints that player does not have. From this a simple idea started to grow: if the synchronization would be bypassed (would not happen), it would be possible to get hands on the blueprints inside of a save file and take them out.

Limitations

This approach has some limitations. When player joins the game, synchronization is able to delete blueprints but it does not transfer new ones: it only creates a preview of a blueprint because blueprints contain entity data which can take a lot of space. Blueprints that are in the preview state are not part of the game state yet so they cannot be recovered using this approach.

The way

In the main menu, click "Settings" while holding both Ctrl and Alt. Modifiers are required to expose "The rest" part with all the hidden switches.

bprec-main-menu.png (32.13 KiB) Viewed 20707 times

In settings go to "The rest"

bprec-settings.png (81.6 KiB) Viewed 20707 times

Inside of the "Other settings" enable the "bypass-library-sync" option

bprec-bypass-on.png (2.88 KiB) Viewed 20707 times

Go back to the main menu and open a save file from which you want to extract blueprints.

bprec-load.png (6.26 KiB) Viewed 20707 times

While in game, open the blueprint library. There will be a warning "Blueprint library is not synchronized" to inform that the blueprint library here is not synchronized with player's own blueprint storage so none of the blueprints from player's blueprint storage are shown here. This also works in opposite direction: changes here will not get saved to the player's own blueprint storage.

bprec-library.png (90.39 KiB) Viewed 20707 times

From this point you can take a look at the blueprints and transfer them out. Simplest way is to empty the inventory, Control+Left click on empty slot in the library to transfer all blueprints to the inventory, create an empty blueprint book inside of the Game Blueprints, open that book, transfer all the blueprints from inventory to the book (Control+Left click on empty inventory slot) and then export that book to the string.

Alternative approach is to transfer blueprints to the inventory or to the Game Blueprints and save the game at that state. After disabling "bypass-library-sync" hidden option you can then load that save file and transfer those blueprints back to the "My Blueprints" which at this point will be synchronized (there should be no "Blueprint library is not synchronized" warning)

Cleanup: do not forget to disable "bypass-library-sync" option (first 3 steps).

Final notes

This way is intended to be only a last resort because it does not help with recovery of blueprints that were not transferred to the game state. Keep in mind that blueprint library uses binary format that is evolving with the game itself so older game versions are unable to read blueprint library made by newer versions. Every time you want to downgrade the game, the blueprint library will be lost (however there should be a backup made which may require manual file renaming to make backup to be the active one). When there are preview-only blueprints in the library, there may be some unintended behaviors happening when those blueprints are requested to be transferred: starting from importing a blueprint from the player's own blueprint library ending on the crashes because blueprint with the given ID does not exist in the player's own blueprint library.

[Diablo]

I just wanted to say here again, thank you so much for helping me out with this.
It means more then I can express here.

THANK YOU!

[ssilk]

Would/should have been a nearly perfect FFF.

[NotRexButCaesar]

Would/should have been a nearly perfect FFF.

No gif means no FFF. (Devs are never sarcastic and always tell the 100% truth with no jokes)

talk on discord

Screenshot 2021-01-16 004520.jpg (84.95 KiB) Viewed 20448 times

[quinor]

That's the most factorio devs' thing I've seen in a long time. Come on, can you set the standarts any higher...?! Absolutely love the attention.

[Marco3104]

This Post literally saved me many hours of work. Thank you very much!

[mrfox113]

Hello,

i tryd this, but after 5 bps into my inventory, the game crash.

[ssilk]

You can make a bug report, please.

[boskid]

Hello,

i tryd this, but after 5 bps into my inventory, the game crash.

You are most likely trying to transfer a preview-only blueprint for which this method does not work. This was mentioned in the "limitations" part and in the "final notes" part. This is highly experimental "feature" and in case of a crash happening because of a misuse of it and following bug reports, i would rather remove this feature entirely rather than fixing it.

[MiniHerc]

Only reason why they were not possible to be extracted was that when a player joins with an empty blueprint library, there is a blueprint library synchronization happening which removes all the blueprints that player does not have.

But why remove them?

[boskid]

Only reason why they were not possible to be extracted was that when a player joins with an empty blueprint library, there is a blueprint library synchronization happening which removes all the blueprints that player does not have.

But why remove them?

Because player does not have them in local storage so they must have been removed intentionally.

[MiniHerc]

Only reason why they were not possible to be extracted was that when a player joins with an empty blueprint library, there is a blueprint library synchronization happening which removes all the blueprints that player does not have.

But why remove them?

Because player does not have them in local storage so they must have been removed intentionally.

Or the save was shared with another who would naturally not have those blueprints in local storage.

[Rescovedo]

Recently bought a brand new Macbook Air and I honestly have no words to express so much gratitude towards this tutorial. REALLY REALLY Thanks, I was able to restore all my library back to what it was!

[buddiedelorenzo]

I don't understand why this method should be used only as a last resort? You said that it's a good method for restoring blueprints.

[aka13]

I had the issue, where I accidentally put a bp book from hotbar into inventory, which removed it from the cloud bp storage.
Saved me a lot of trouble!

[cheezecake]

Just want to say thank you! This saved so much trouble and headache. Just used the export the book to string and it worked perfect.
I am putting a sticky note next to my PC that says "Do NOT downgrade Factorio unless absolutely necessary and back up all blueprints"

[Whalesaregreat]

I created an account specifically to reply to this post to thank you. I spent nearly 4 hours today creating some rail and station blueprints, and I thought I had lost them after I accidentally removed them from my blueprint library and accidentally cleared them from my hot bar. Thank you so much.

[Dmytrozern]

Still relevant. Downgraded my game to continue playing a save with active recording and lost my saves. Renaming the backup did not help, but this thread did. Thank you.

[GriffiPlayz]

Thanks! My blueprint library disappered after enabling steam cloud sync for blueprints (just like expected, that feature is a bit broken), and my blueprint backup i made a few days ago didn't want to work for some reason. (I tried copying the blueprint library file)
You saved my blueprints

[flintycrayon]

You, sir, are my hero.
Thank you <3