game_save_buffer

This is a variant of the game_save function, so please read its page first as it contains important information related to its use and to this function's as well.

With this function you can save the current state of the game to a previously created "grow" buffer (see Buffers) which can then be loaded again at any time using the game_load_buffer function. This function is designed for use in a single room at a time (i.e.: it's not advised to do a buffer save in one room, then try and load the buffer from another one) and should ideally be used only for checkpoints or level restarts.

NOTE This function is very limited and it is designed for the beginner to get a checkpoint system up and running quickly, but more advanced users may prefer to code their own system using the File functions, due to the fact that the game will not save any of the dynamic resources like data structures, surfaces, added sprites etc.

Syntax:

game_save_buffer(buffer);

Returns:

N/A

Example:

if (keyboard_check_pressed(ord("S")))
{
    global.Checkpoint = true;
    game_save_buffer(save_buff);
}

The above code will set a global variable to true and then save the current game state to the buffer stored in the variable "save_buff" when the key "S" is pressed.