https://sourceforge.net/p/eremus/wiki/Savegame%2520File%2520Format/Recent changes to Savegame File FormatenWed, 19 Oct 2011 13:15:28 -0000https://sourceforge.net/p/eremus/wiki/Savegame%2520File%2520Format/<pre>--- v13 +++ v14 @@ -35,9 +35,14 @@ * OBJECT -Not sure what this will be yet, since you can't pickle GameObjects. - +See: [GameObject] + OBJECT's are saved when they have a property 'save'=True and are marked 'dirty'=True. + +* OBJECT_INSTANCE + +OBJECT_INSTANCE's are equivalent to OBJECT's except they are created after the +scene has been initialized by the AddObject actuator. Example ======= </pre>Zachary R.Wed, 19 Oct 2011 13:15:28 -0000https://sourceforge.net32e663e324a0536514b3ebf8bd57e6cc44bc38c4https://sourceforge.net/p/eremus/wiki/Savegame%2520File%2520Format/<pre>--- v12 +++ v13 @@ -35,25 +35,24 @@ * OBJECT -This will be a dump of an blender game object created -by the [pickle](http://docs.python.org/py3k/library/pickle.html) module. - +Not sure what this will be yet, since you can't pickle GameObjects. + OBJECT's are saved when they have a property 'save'=True and are marked 'dirty'=True. Example ======= An example of the layout of a basic save game. Header/Data |Data Size/Value ---------------|---------- SAVE_FILE_START| 0 *0 bytes of data*| No value SAVE_FILE_VERSION | 4 *4 bytes of data* | 1 BLEND_FILE | 12 *12 bytes of data*|"test1.blend" + 0x0 START_SCENE | 6 *6 bytes of data* |"Scene" + 0x0 OBJECT |100 -*100 bytes of data*|*An KX_GameObject pickled by [pickle](http://docs.python.org/py3k/library/pickle.html)* +*100 bytes of data*|*An GameObject* SAVE_FILE_END |0 </pre>Zachary R.Wed, 19 Oct 2011 00:00:40 -0000https://sourceforge.net575337f0111bdedec971b84f374f745188f6b59ahttps://sourceforge.net/p/eremus/wiki/Savegame%2520File%2520Format/<pre>--- v11 +++ v12 @@ -29,26 +29,30 @@ A scene to load from a blend file. +* START_SCENE + +The scene to start in. + * OBJECT This will be a dump of an blender game object created by the [pickle](http://docs.python.org/py3k/library/pickle.html) module. OBJECT's are saved when they have a property 'save'=True and are marked 'dirty'=True. Example ======= An example of the layout of a basic save game. Header/Data |Data Size/Value ---------------|---------- SAVE_FILE_START| 0 *0 bytes of data*| No value SAVE_FILE_VERSION | 4 *4 bytes of data* | 1 BLEND_FILE | 12 *12 bytes of data*|"test1.blend" + 0x0 -SCENE | 6 +START_SCENE | 6 *6 bytes of data* |"Scene" + 0x0 OBJECT |100 *100 bytes of data*|*An KX_GameObject pickled by [pickle](http://docs.python.org/py3k/library/pickle.html)* </pre>Zachary R.Tue, 18 Oct 2011 20:33:14 -0000https://sourceforge.netd41f15119b1886cc7530d771909693785fc41a41https://sourceforge.net/p/eremus/wiki/Savegame%2520File%2520Format/<pre>--- v10 +++ v11 @@ -23,16 +23,18 @@ * BLEND_FILE -The path to the blend file needed for this save - +The path to a blend file to load. + * SCENE -The scene to load from BLEND_FILE +A scene to load from a blend file. * OBJECT This will be a dump of an blender game object created by the [pickle](http://docs.python.org/py3k/library/pickle.html) module. + +OBJECT's are saved when they have a property 'save'=True and are marked 'dirty'=True. Example ======= </pre>Zachary R.Tue, 18 Oct 2011 14:56:35 -0000https://sourceforge.net90050c43c4b44da89e8b9c854b1d61555a442efbhttps://sourceforge.net/p/eremus/wiki/Savegame%2520File%2520Format/<pre>--- v9 +++ v10 @@ -33,3 +33,21 @@ This will be a dump of an blender game object created by the [pickle](http://docs.python.org/py3k/library/pickle.html) module. + +Example +======= +An example of the layout of a basic save game. + +Header/Data |Data Size/Value +---------------|---------- +SAVE_FILE_START| 0 +*0 bytes of data*| No value +SAVE_FILE_VERSION | 4 +*4 bytes of data* | 1 +BLEND_FILE | 12 +*12 bytes of data*|"test1.blend" + 0x0 +SCENE | 6 +*6 bytes of data* |"Scene" + 0x0 +OBJECT |100 +*100 bytes of data*|*An KX_GameObject pickled by [pickle](http://docs.python.org/py3k/library/pickle.html)* +SAVE_FILE_END |0 </pre>Zachary R.Tue, 18 Oct 2011 12:57:35 -0000https://sourceforge.net5c6965b787e075634ab7393c6da98df3516f3dabhttps://sourceforge.net/p/eremus/wiki/Savegame%2520File%2520Format/<pre>--- v8 +++ v9 @@ -1,6 +1,35 @@ - - - - - - +Header Format +============== +Each chunk of variable-sized data in the file is preceded by a header. + +Name |Size +--------- |-------- +Header Type| 4 bytes +Data Size | 4 bytes + +The possible header types are: + +* SAVE_FILE_START + +This is the first header in the file + +* SAVE_FILE_VERSION + +The version of the file + +* SAVE_FILE_END + +This is the final header in the file + +* BLEND_FILE + +The path to the blend file needed for this save + +* SCENE + +The scene to load from BLEND_FILE + +* OBJECT + +This will be a dump of an blender game object created +by the [pickle](http://docs.python.org/py3k/library/pickle.html) module. </pre>Zachary R.Tue, 18 Oct 2011 03:52:54 -0000https://sourceforge.net2498da7e8cf11860ef6d13fa23691007bdf95e49https://sourceforge.net/p/eremus/wiki/Savegame%2520File%2520Format/<pre>--- v7 +++ v8 @@ -1,7 +1,6 @@ -Saved games are stored in a simple XML-based format, this format might be slightly slower but has numerous advantages including: - -* Human readable and editable -* Unlike a binary file format it's harder to corrupt -* Easier to manipulate + + + + </pre>Zachary R.Tue, 18 Oct 2011 03:15:32 -0000https://sourceforge.netb11ddd0269ad37f751d3d2273504560bd4c47289https://sourceforge.net/p/eremus/wiki/Savegame%2520File%2520Format/<pre>--- v6 +++ v7 @@ -1,4 +1,4 @@ -Saved games are stored in a simple plain-text file format, this format might be slightly slower but has numerous advantages including: +Saved games are stored in a simple XML-based format, this format might be slightly slower but has numerous advantages including: * Human readable and editable * Unlike a binary file format it's harder to corrupt </pre>Zachary R.Tue, 18 Oct 2011 02:56:31 -0000https://sourceforge.neta6c95d9aef1fd706a489b79d4590ad51176be7a0https://sourceforge.net/p/eremus/wiki/Savegame%2520File%2520Format/<pre>--- v5 +++ v6 @@ -4,29 +4,4 @@ * Unlike a binary file format it's harder to corrupt * Easier to manipulate -Every line of the save game file is of the format '*save_format_opt* *args*' for example -the line 'NAME "Save Game With A Descriptive Name"' could be read as the name of the save. - -**Should probably have a table of save game options and args here at some point** - -Here's an example of a save game file: - - NAME "The Saved Game" - BLEND "blend/level/here_come_the_clowns.blend" - SCENE "Couldn't be real, must be fake" - OBJECT "Player" - LOCATION (0, 0, 0) - PROPERTY "save" True - PROPERTY "a_clown" True - PROPERTY "alive" True - PROPERTY "health" 100 - PROPERTY "init" "initPlayer" - OBJECT_END - ;; More objects here(this is a comment) - ;; Comments must be on their own line. - -Future Changes -============== -Perhaps add a GLOBAL keyword(same format as PROPERTY) that adds to the [globalDict](http://www.blender.org/documentation/blender_python_api_2_59_4/bge.logic.html#bge.logic.globalDict) - </pre>Zachary R.Tue, 18 Oct 2011 02:55:47 -0000https://sourceforge.net07abb86966bd3445139ae0dd15ac73ea1bc3be7ehttps://sourceforge.net/p/eremus/wiki/Savegame%2520File%2520Format/<pre>--- v4 +++ v5 @@ -25,4 +25,8 @@ ;; More objects here(this is a comment) ;; Comments must be on their own line. +Future Changes +============== +Perhaps add a GLOBAL keyword(same format as PROPERTY) that adds to the [globalDict](http://www.blender.org/documentation/blender_python_api_2_59_4/bge.logic.html#bge.logic.globalDict) + </pre>Zachary R.Mon, 17 Oct 2011 23:41:32 -0000https://sourceforge.netc6296cdbd2ffafa58444dfe51446e5d79ff9ee64