Simple Save Game Extension

this plugin is no longer under active development, and will no longer receive updates or support for future versions of unreal engine! bug fixes will be provided as needed! 1 0 setup 1 1 installation like every ue4 plugin, the ssge plugin will appear in your library ➔ vault in the epic games launcher, from where you can install it to your engine, after that you can enable it in your project 1 2 initialization no setup is required after enabling the plugin 2 0 introduction 2 1 concept simple savegame extension is built to be as easy to use as possible, the only knowledge required is how savegames work in ue, the rest will be done by the plugin the plugin gives access to an extended savegame object that can handle saving and loading of objects and actors objects are stored in separate save files and will only be loaded if needed, to decrease loading times save/load any object or actor actors placed in the level or spawned at runtime all components of an actor can be saved with the actor save/load entire levels all prior savegame features are still available 2 2 example project the example project shows all features currently available in the plugin all content can be found in the folder content /ssge/ there are two tutorials, the first explaining the functionality of the savegame, the second explaining the functionality of the worldsave the project is currently outdated and will be updated in the near future 2 3 warning please try to refrain from stop play in editor or let players exit the game while saving/loading is in progress small saves are almost never a problem, but using the worldsave and saving large amounts of data can take a couple of seconds, especially if the save is running in the background this will almost never corrupt save files, but can crash the game/editor while exiting and create file artefacts 2 4 quick start all major features are exposed to blueprints and no c++ knowledge is required to use the plugin you can obviously use the plugin from c++ as well, but the documentation will be limited to only blueprints at this time, since the workflow is the same in c++ as it is in blueprints to create a savegame, use the existing ue4 function, all you need to do is, to use a subclass of ssge savegame as the savegame class after that, the created savegame object will have functions for saving and loading objects or actors these are the basic save/load functions pins of all functions contain an explanation for what they are used for 2 5 variables when saving/loading objects or actors the variables marked as savegame are automatically handled by the plugin, supported types include all basic types and structs 2 6 interfaces the plugin includes 4 interfaces ssge interfaceobject c an/should only be added to objects, it will be used in object functions for additional options on how to handle that specific object, it also includes callbacks ssge interfaceactor c an/should only be added to actors, will be used in actor functions for additional options on how to handle that specific actor, it also includes callbacks ssge interfacecomponent c an/should only be added to components, will be used in component functions for additional options on how to handle that specific component, it also includes callbacks ssge interfaceworldsaveactor r equired for actors that the worldsave will automatically track, includes additional options required for the worldsave 2 7 components to save/load components when saving/loading an actor, the actor needs an interface called ssge interfaceactor which has two functions that need to be overridden components to save components to load both functions take in an array of components that should be saved or loaded 2 7 1 default components default components that are automatically handled by the savegame are scenecomponent (only transform), staticmeshcomponent, skeletalmeshcomponent and childactorcomponent if you want other default components to be supported, feel free to contact me 2 8 basic usage saving and loading works the same way the existing savegame works to save, first call create save game object or load an existing savegame, store all needed data inside, call the appropriate functions to save objects or actors and then call save game to slot to save all the data stored in that savegame to load, first call load game from slot, retrieve all stored variables and call the appropriate functions to load objects or actors and that's it if you want to clear objects or actors stored in the savegame, you can use the clearobject , clearactor or clearall functions you should refrain from creating and loading multiple savegame objects from the same slot at the same time, since that could create multiple instances with different changes in the savegame, this may lead to the savegame only saving part of the actual changes to the persistent storage 3 0 content 3 1 settings the plugin has a couple of settings which can be found under project settings ➔ plugins ➔ simple savegame extension settings contain things like logging or whether data should be compressed 3 2 functionality 3 2 1 compression the plugin supports the compression of data, which can greatly decrease the size of the cached data in the savegame, meaning less ram usage and of course the size of the files stored on the user's drive but keep in mind that compression will impact the performance of the game during testing, the performance of the game was decreased by about 10% (single threaded) while the size of the savegame files were decreased by about 70% these numbers will vary depending on your game compression is enabled by default and can be turned off in the settings compressed and uncompressed data are stored in separate files, and will result in different savegames when switching between them, therefore it cannot be changed at runtime 3 2 2 multithreading the plugin supports single and multithreaded saving/loading, which can greatly increase performance but keep in mind that calling non async functions in combination with async functions can potentially freeze the game while a non async function waits for the async function to release needed data you can use the existing async functions or use the ssge async functions to use m ultithreading 3 2 3 dynamic saving the plugin supports dynamic saving for objects/actors, which means it will only save data if it has changed, improving performance while saving large amounts of data 3 3 world save to save/load multiple actors in a level automatically, you can create a blueprint version of the ssge worldsave and place it in the world all actors that implement the interface ssge interfaceworldsaveactor will be saved/loaded automatically when calling save/load on the worldsave, the interface exposes some functions to customize how the worldsave handles specific actors the worldsave can spawn actors on load if needed (disabled by default) or delete those that were deleted prior to saving the worldsave can save/load in foreground (blocking the game) or in background (slower but none blocking) if a worldsave is present in the level at runtime, it can be accessed from anywhere using the node getworldsave you can check if the worldsave is currently saving/loading by calling issaving/isloading on the worldsave, this can be used to for example display the status on your ui if you want to use a custom or even generated slot (filename) for the savegame you can override the getslotid function in the worldsave to clear the data stored in the worldsave use the clear function 4 0 appendix 4 1 info if you bought the plugin, please leave a review on the marketplace https //www unrealengine com/marketplace/en us/product/e601727096024542a9322855d1112c02 if you have comments, questions, bugs, ideas or just want to show a project that uses ssge, feel free to contact me any time email 4 3 credits simple save game extension (c) 2023 by qygon special thanks daniel ravanelli https //danielravanelli com/ 5 0 versions