CrossBrowdy - Examples

Advanced

Sokoban game

This is an example of a simple Sokoban game (using the Game engine module from the previous example).

This game is for one player. You can use a gamepad, the keyboard, the mouse or a touch screen (either touching the screen controls or swiping to the desired direction) to control the game.

The purpose of this example is to show different ways to use CrossBrowdy and some of its multiple features.

index.html:

<!DOCTYPE html>
<html>
	<head>
		<!-- This file belongs to a CrossBrowdy.com example, made by Joan Alba Maldonado. Creative Commons Attribution 4.0 International License. -->
		<meta http-equiv="content-type" content="text/html; charset=utf-8" />
		<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" />
		<link rel="canonical" href="https://crossbrowdy.com/examples/advanced/sokoban_game/try" />
		<title>Advanced: Sokoban game - Example</title>
		<!-- Loads the needed CSS files: -->
		<link rel="stylesheet" type="text/css" href="main.css" />
		<!-- Loads FlashCanvas (Flash emulation) before CrossBrowdy. Needed also to use ExplorerCanvas (VML emulation) without problems: -->
		<!-- Note: it is recommended to download CrossBrowdy instead of hotlinking the online version. This is just for the example! -->
		<script src="https://crossbrowdy.com/CrossBrowdy/CrossBase/audiovisual/image/canvas/FlashCanvas/pro/bin/flashcanvas.js" type="text/javascript" language="javascript"></script><!-- FlashCanvas/ExplorerCanvas do not support lazy load. -->
		<!-- Loads CrossBrowdy.js (main file): -->
		<!-- Note: it is recommended to download CrossBrowdy instead of hotlinking the online version. This is just for the example! -->
		<script src="https://crossbrowdy.com/CrossBrowdy/CrossBrowdy.js" type="text/javascript" language="javascript"></script><!-- "type" and "language" parameters for legacy clients. -->
		<!-- Loads the other needed script files: -->
		<script src="levels.js" type="text/javascript" language="javascript"></script><!-- File with the available levels. -->
		<script src="main.js" type="text/javascript" language="javascript"></script><!-- File with the main logic. -->
	</head>
	<body>
		<!-- Music loader/checker: -->
		<div id="music_loader_checker">
			<span id="music_progress"></span>
			<span>
				<p>
					Music downloaded from <a href="https://icons8.com/music/tag/atmospheric" target="_blank">here</a>
					(modified to be exported to different audio formats and compressed using
					<a href="https://www.audacityteam.org/download/" target="_blank">Audacity</a>):
				</p>
				<p>
					&quot;First contact&quot; by Black Lark,
					&quot;Invisible hand&quot; by Weary Eyes and
					&quot;Sorry for lying&quot; by Smokefishe.
				</p>
				<p>
					This example belongs to <a href="https://crossbrowdy.com" target="_blank">CrossBrowdy.com</a>, made by <a href="https://joanalbamaldonado.com/" target="_blank">Joan Alba Maldonado</a>. <a href="http://creativecommons.org/licenses/by/4.0/" target="_blank">Creative Commons Attribution 4.0 International License</a>.
				</p>
			</span>
			<button id="button_load_check_music">
				Step 1:<br />
				Load music
			</button>
			<div id="skip_music_loader" onClick="skipLoadingMusic();">[ Press here to skip music ]</div>
		</div>
		<!-- Toolbar and its icons: -->
		<div id="toolbar">
			<img src="img/button_undo.gif" id="button_undo" class="toolbar_icon" title="Undo step (movement)" />
			<img src="img/button_redo.gif" id="button_redo" class="toolbar_icon" title="Redo step (movement)" />
			<select id="level_selector" class="toolbar_icon"></select>
			<img src="img/button_restart.gif" id="button_restart" class="toolbar_icon" title="Restart level" />
			<img src="img/button_fullscreen.gif" id="button_fullscreen" class="toolbar_icon" title="Toggle fullscreen mode" />
		</div>
		<!-- Screen controls: -->
		<div id="controls_toggler" onClick="screenControlsToggle();">C</div>
		<div id="controls">
			<center>
				<span id="screen_button_up" class="screen_button">&uarr;</span>
				<br />
				<span id="screen_button_left" class="screen_button">&larr;</span>
				<span id="screen_button_right" class="screen_button">&rarr;</span>
				<br />
				<span id="screen_button_down" class="screen_button">&darr;</span>
			</center>
		</div>
		<div id="loading">Loading...</div>
		<div id="debug_switch"><label for="debug_checkbox"><input type="checkbox" id="debug_checkbox" name="debug_checkbox" />Debug</label></div>
		<canvas id="my_canvas">if you read this, canvas is not working</canvas><!-- Some emulation methods will require the canvas element created in HTML (not dynamically by JavaScript). -->
		<canvas id="my_canvas_buffer">if you read this, canvas is not working</canvas><!-- Some emulation methods will require the canvas element created in HTML (not dynamically by JavaScript). -->
		<button id="start_button" onClick="gameStart();">
			<span style="display:block; margin-bottom:10px; color:#cc0088;">This example belongs to CrossBrowdy.com, made by Joan Alba Maldonado. Creative Commons Attribution 4.0 International License.</span>
			<span style="display:block; margin-bottom:10px; color:#ff0000;">
				This game is for one player. You can use a gamepad, the keyboard, the mouse or a touch screen (either touching the screen controls or swiping to the desired direction) to control the game.
			</span>
			<span style="display:block; margin-top:10px;">Start game!</span>
		</button>
		<br />
		<!-- The "CB_console" element will be used automatically in the case that the client does not support console: -->
		<div id="CB_console" style="display:none; visibility:hidden; overflow:scroll;">
			<span style="font-weight:bold;">Console:</span><br />
		</div>
		<div id="crossbrowdy_info"><a href="https://crossbrowdy.com/examples/advanced/sokoban_game" target="_blank">CrossBrowdy.com example</a></div>
	</body>
</html>

main.css:

/* This file belongs to a CrossBrowdy.com example, made by Joan Alba Maldonado. Creative Commons Attribution 4.0 International License. */

body { background-color:#ffffff; word-wrap:break-word; }
#crossbrowdy_info { position:fixed; bottom:2px; right:2px; z-index:5; }
#crossbrowdy_info a { color:#00aadd; }
#crossbrowdy_info a:hover { color:#0033aa; }
#CB_console { width:460px; height:100px; background-color:#aaaaaa; color:#ddddff; }
button { cursor:pointer; cursor:hand; }
span { color:#aa0000; }
#debug_switch { position:absolute; top:0px; right:6px; z-index:2; color:#ffaa00; }
#debug_switch, label, #debug_checkbox  { cursor:hand; cursor:pointer; }
#skip_music_loader { position:absolute; bottom:10px; left:10px; cursor:hand; cursor:pointer; }
#skip_music_loader:hover { cursor:hand; cursor:pointer; color:#0000aa; }
#loading, #music_loader_checker
{
	position:absolute;
	left:0px;
	top:0px;
	width:100%;
	height:100%;
	color:#ff0000;
	background-color:#ffffff;
	z-index:5;
}
#music_loader_checker
{
	display:none;
	visibility:hidden;
	z-index:4;
	font-size:12px;
	font-size:0.6em;
	font-size:60%;
	font-size:3vmin;
}
#button_load_check_music
{
	position:absolute;
	left:25%;
	top:25%;
	width:50%;
	height:50%;
	color:#ff0000;
	font-weight:bold;
	z-index:4;
}
#music_progress
{
	display:table-cell;
	vertical-align:middle;
	color:#ff0000;
	font-weight:bold;
	z-index:4;
	animation:blinking 0.5s ease-in-out infinite;
}
#my_canvas { position:absolute; left:0px; top:0px; z-index:1; }
#my_canvas_buffer { position:absolute; left:0px; top:0px; visibility:hidden; display:none; z-index:1; }
#start_button
{
	z-index:3;
	visibility: hidden;
	display: none;
	position:absolute;
	left:10%;
	top:10%;
	width:80%;
	height:80%;
	color:#ff0000;
	font-size:12px !important;
	font-size:0.58em !important;
	font-size:58% !important;
	font-size:2.8vmin !important;
	font-weight:bold;
	filter:alpha(opacity=90);
	opacity:0.9;
	-moz-opacity:0.9;
	-khtml-opacity:0.9;
	-ms-filter:"progid:DXImageTransform.Microsoft.Alpha(Opacity=90)";
}
#start_button:hover
{
	color:#ffaa00;
	filter:alpha(opacity=100);
	opacity:1;
	-moz-opacity:1;
	-khtml-opacity:1;
	-ms-filter:"progid:DXImageTransform.Microsoft.Alpha(Opacity=100)";
}
#toolbar { z-index:2; position:absolute; right:50px; top:50px; }
.toolbar_icon { cursor:pointer; cursor:hand; }
#level_selector { color:#3300bb; vertical-align:bottom; text-align:center; }
#controls_toggler
{
	z-index:2;
	position:absolute;
	bottom:50px;
	right:0px;

	text-align:center;
	font-weight:bold;
	line-height:50px;
	color:#ffffff;
	border:1px dashed #ffffff;
	background-color:#5555aa;
	cursor:pointer;
	cursor:hand;
	width:50px;
	height:50px;
	margin:2px;
	
	border-radius:12px;
	-moz-border-radius:12px;
	-webkit-border-radius:12px;
	-khtml-border-radius:12px;

	filter:alpha(opacity=50);
	opacity:0.5;
	-moz-opacity:0.5;
	-khtml-opacity:0.5;
	-ms-filter:"progid:DXImageTransform.Microsoft.Alpha(Opacity=50)";
}
#controls_toggler.controls_hidden
{
	background-color:#0000ff;
}
#controls
{
	z-index:2;
	position:absolute;
	bottom:50px;
	right:50px;
	filter:alpha(opacity=50);
	opacity:0.5;
	-moz-opacity:0.5;
	-khtml-opacity:0.5;
	-ms-filter:"progid:DXImageTransform.Microsoft.Alpha(Opacity=50)";
}
.screen_button
{
	display:inline-block;
	text-align:center;
	font-weight:bold;
	line-height:100px;
	color:#ffffff;
	border:1px dotted #ffffff;
	background-color:#0000aa;
	cursor:pointer;
	cursor:hand;
	width:100px;
	height:100px;
	margin:2px;
	border-radius:12px;
	-moz-border-radius:12px;
	-webkit-border-radius:12px;
	-khtml-border-radius:12px;
}
@keyframes blinking
{
  0%
  {
	filter:alpha(opacity=70);
	opacity:0.7;
	-moz-opacity:0.7;
	-khtml-opacity:0.7;
	-ms-filter:"progid:DXImageTransform.Microsoft.Alpha(Opacity=70)";
  }

  50%
  {
	filter:alpha(opacity=0);
	opacity:0;
	-moz-opacity:0;
	-khtml-opacity:0;
	-ms-filter:"progid:DXImageTransform.Microsoft.Alpha(Opacity=0)";
  }

  100%
  {
	filter:alpha(opacity=70);
	opacity:0.7;
	-moz-opacity:0.7;
	-khtml-opacity:0.7;
	-ms-filter:"progid:DXImageTransform.Microsoft.Alpha(Opacity=70)";
  }
}

levels.js:

/* This file belongs to a CrossBrowdy.com example, made by Joan Alba Maldonado. Creative Commons Attribution 4.0 International License. */

/*
	Symbols meaning:
		" " (space)	=> Blank space.
		"@"			=> Main character (player).
		"#"			=> Walls.
		"$"			=> Pieces to move.
		"-"			=> Empty holes to put pieces in.
		"+"			=> Holes with a piece inside.
		"*"			=> Main character (player) above a hole.
*/


//Levels array:
var LEVELS =
[
	//Level 0:
	[
		"    #####          ".split(""),
		"    #   #          ".split(""),
		"    #$  #          ".split(""),
		"  ###  $##         ".split(""),
		"  #  $ $ #         ".split(""),
		"### # ## #   ######".split(""),
		"#   # ## #####  --#".split(""),
		"# $  $          --#".split(""),
		"##### ### #@##  --#".split(""),
		"    #     #########".split(""),
		"    #######        ".split("")
	],

	//Level 1:
	[
		"##########".split(""),
		"####   # #".split(""),
		"#- $ $-# #".split(""),
		"#- *$ ## #".split(""),
		"#$ $  $--#".split(""),
		"#  #######".split("")
	],
	
	//Level 2:
	[
		"############  ".split(""),
		"#--  #     ###".split(""),
		"#--  # $  $  #".split(""),
		"#--  #$####  #".split(""),
		"#--    @ ##  #".split(""),
		"#--  # #  $ ##".split(""),
		"###### ##$ $ #".split(""),
		"  # $  $ $ $ #".split(""),
		"  #    #     #".split(""),
		"  ############".split("")
	],
	
	//Level 3:
	[
		"##   #   #  ##".split(""),
		"#            #".split(""),
		"##### $@$ ####".split(""),
		"-   ##$$$##  -".split(""),
		"#        #   #".split(""),
		"--   #      --".split(""),
		"--  ##$$$ # --".split(""),
		"##### $ $ ####".split(""),
		"##            ".split(""),
		"###   #  #  ##".split("")
	],
	
	//Level 4:
	[
		"        ######## ".split(""),
		"        #     @# ".split(""),
		"        # $#$ ## ".split(""),
		"        # $  $#  ".split(""),
		"        ##$ $ #  ".split(""),
		"######### $ # ###".split(""),
		"#----  ## $  $  #".split(""),
		"##---    $  $   #".split(""),
		"#----  ##########".split(""),
		"########         ".split("")
	],
	
	//Level 5:
	[
		"# # # #     # # #".split(""),
		"   $      #      ".split(""),
		"#        $  -   #".split(""),
		" $ $ $ $  #$ # $ ".split(""),
		" # # # # #-      ".split(""),
		"  -   -   $# #-#-".split(""),
		"# $ $  #$#- $ $ $".split(""),
		" - -  -       -  ".split(""),
		"   #$#$#  $      ".split(""),
		"#- - -  #-#-#-#*#".split("")
	],
	
	//Level 6:
	[
		"           ########".split(""),
		"           #  ----#".split(""),
		"############  ----#".split(""),
		"#    #  $ $   ----#".split(""),
		"# $$$#$  $ #  ----#".split(""),
		"#  $     $ #  ----#".split(""),
		"# $$ #$ $ $########".split(""),
		"#  $ #     #       ".split(""),
		"## #########       ".split(""),
		"#    #    ##       ".split(""),
		"#     $   ##       ".split(""),
		"#  $$#$$  @#       ".split(""),
		"#    #    ##       ".split(""),
		"###########        ".split("")
	],
	
	//Level 7:
	[
		"#  ####  #### #### ".split(""),
		"####--####--###--##".split(""),
		"*                  ".split(""),
		"#  #  #  #  # #  ##".split(""),
		"#  #  #  #  # #   #".split(""),
		"#     #          ##".split(""),
		"#  #   #  #  #$$$ #".split(""),
		"#     $     #  #  #".split(""),
		"##### $   ###  #  #".split(""),
		"#    $$$ $  #  $$$#".split(""),
		"##  # #  #  #  #  #".split(""),
		"      #  #     #   ".split(""),
		" ####-####--####--#".split(""),
		"##  ###  ####  ####".split("")
	],
	
	//Level 8:
	[
		"        #####    ".split(""),
		"        #   #####".split(""),
		"        # #$##  #".split(""),
		"        #     $ #".split(""),
		"######### ###   #".split(""),
		"#----  ## $  $###".split(""),
		"#----    $ $$ ## ".split(""),
		"#----  ##$  $ @# ".split(""),
		"#########  $  ## ".split(""),
		"        # $ $  # ".split(""),
		"        ### ## # ".split(""),
		"          #    # ".split(""),
		"          ###### ".split("")
	],
	
	//Level 9:
	[
		"################ ".split(""),
		" * #-            ".split(""),
		"  ##$#########   ".split(""),
		"#             # #".split(""),
		"#  # #######  # #".split(""),
		"# $       - $ #$#".split(""),
		"# #  ###### # # #".split(""),
		"# # #  $ -  #   #".split(""),
		"###  # ####$  # #".split(""),
		"# #           # #".split(""),
		"#  ##########-#  ".split(""),
		"#--         $-$  ".split(""),
		" ############### ".split("")
	],
		
	//Level 10:
	[
		"######  ### ".split(""),
		"#--  # ##@##".split(""),
		"#--  ###   #".split(""),
		"#--     $$ #".split(""),
		"#--  # # $ #".split(""),
		"#--### # $ #".split(""),
		"#### $ #$  #".split(""),
		"   #  $# $ #".split(""),
		"   # $  $  #".split(""),
		"   #  ##   #".split(""),
		"   #########".split("")
	],
		
	//Level 11:
	[
		"    #     ##".split(""),
		" -- #$#$ #  ".split(""),
		" #    #@ #- ".split(""),
		" # - $$$ # #".split(""),
		"  #    -#-$ ".split(""),
		"  $  #  #-$ ".split(""),
		"   ## - ##$ ".split(""),
		"  # $  $ #  ".split(""),
		"  #-    -# $".split(""),
		"  #######   ".split(""),
		"--       $ -".split("")
	],
		
	//Level 12:
	[
		"       ##### ".split(""),
		" #######   ##".split(""),
		"## # @## $$ #".split(""),
		"#    $      #".split(""),
		"#  $  ###   #".split(""),
		"### #####$###".split(""),
		"# $  ### --# ".split(""),
		"# $ $ $ ---# ".split(""),
		"#    ###---# ".split(""),
		"# $$ # #---# ".split(""),
		"#  ### ##### ".split(""),
		"####         ".split("")
	],
		
	//Level 13:
	[
		"#   #   # ###".split(""),
		" # # # # #   ".split(""),
		"- #  -#- -#  ".split(""),
		"$ # $ # $ #  ".split(""),
		" #  -$   #-- ".split(""),
		" $-  $* $ $++".split(""),
		"   $- #$     ".split(""),
		" # #   $ # $ ".split(""),
		"  #-$$# $ #--".split(""),
		"  #   #  -#$ ".split(""),
		" # #-# #-##  ".split(""),
		"#   #   #  ##".split("")
	],
		
	//Level 14:
	[
		"  ####          ".split(""),
		"  #  ###########".split(""),
		"  #    $   $ $ #".split(""),
		"  # $# $ #  $  #".split(""),
		"  #  $ $  #    #".split(""),
		"### $# #  #### #".split(""),
		"#@#$ $ $  ##   #".split(""),
		"#    $ #$#   # #".split(""),
		"#   $    $ $ $ #".split(""),
		"#####  #########".split(""),
		"  #      #      ".split(""),
		"  #      #      ".split(""),
		"  #------#      ".split(""),
		"  #------#      ".split(""),
		"  #------#      ".split(""),
		"  ########      ".split("")
	]
];

main.js:

/* This file belongs to a CrossBrowdy.com example, made by Joan Alba Maldonado. Creative Commons Attribution 4.0 International License. */

//Path to the graphic rendering engine module:
var CB_GEM_PATH = CB_GEM_PATH || "../simple_game_engine_files/";

//Defines whether to shows debug messages or not:
var CB_GEM_DEBUG_MESSAGES = false;

//Adds the game engine module to CrossBrowdy:
var CB_GEM_MODULE_NEEDED_MODULES = {};
CB_GEM_MODULE_NEEDED_MODULES[CB_GEM_PATH + "game_engine_module.js"] = { load: true, mandatory: true, absolutePath: true };
CB_Modules.addNeededModule(CB_NAME, "GAME_ENGINE_MODULE", CB_GEM_MODULE_NEEDED_MODULES);


CB_init(main); //It will call the "main" function when ready.


//This function will be called when CrossBrowdy is ready:
function main()
{
	CB_console("CrossBrowdy and all needed modules loaded. Starting game...");
	
	//Defines needed data:
	//NOTE: most of the data will be calculated automatically and dynamically.
	CB_GEM.data = //Data stored in the game engine module (can be exported to save the game status):
	{
		//General data:
		soundEnabled: true, //Set to false to disable sound.
		musicEnabled: true, //Set to false to disable music.
		vibrationEnabled: true, //Set to false to disable vibration.
		musicLoaded: false,
		musicChecked: false,
		gameStarted: false,
		level: 0,
		//Player data:
		player:
		{
			movementsLevel: 0,
			movementsTotal: 0,
			x: 0,
			y: 0,
			xPrevious: 0,
			yPrevious: 0
		},
		//Steps (movements) performed (to undo/redo them):
		steps:
		{
			pointer: 0, //Pointer to the current step (movement).
			data: [] //Array with the steps (movements) performed.
		}
	};
	
	//Defines the callback function to call before drawing an element to rotate it (it will be used in the "beforeDrawing" of some elements):
	var beforeDrawingRotate = function(element, canvasContext, canvasBufferContext, useBuffer, CB_GraphicSpritesSceneObject, drawingMap, x, y, mapElement) //Called before drawing the element.
	{
		//If it has been called for a 'CB_GraphicSprites' object:
		if (element.isSprites)
		{
			var rotations = [ 0, 90, 180, 270 ];
			this.getCurrent().data.rotation = rotations[(x + y) % rotations.length];
		}
		return this; //Same as 'element'. Must return the element to draw.
	};

	//Sets the desired sprites scene data (can be modified dynamically):
	CB_GEM.spritesGroupsData =
	{
		//'my_sprites_groups_1' ('CB_GraphicSpritesScene.SPRITES_GROUPS_OBJECT' object). Some missing or non-valid properties will get a default value:
		id: "my_sprites_groups_1",
		srcWidth: 40,
		srcHeight: 40,
		data: { loop: true, onlyUseInMap: false },
		//Numeric array containing 'CB_GraphicSprites.SPRITES_OBJECT' objects with all the sprites groups that will be used (their "parent" property will be set to point the current 'CB_GraphicSpritesScene' object which contains them):
		spritesGroups:
		[
			{
				id: "info",
				srcType: CB_GraphicSprites.SRC_TYPES.TEXT,
				top: 15,
				zIndex: 3,
				data:
				{
					fontSize: "16px",
					fontFamily: "courier",
					style: "#8800ff",
					fontWeight: "bold"
				},
				sprites: [ { id: "info_sprite" } ]
			},
			//'bottle_sprites' ('CB_GraphicSprites.SPRITES_OBJECT' object). Some missing or non-valid properties will will be inherited from the parent ('CB_GraphicSpritesScene.SPRITES_GROUPS_OBJECT' object):
			{
				id: "bottle_sprites",
				data:
				{
					rotationUseDegrees: true,
					onlyUseInMap: true,
					//Rotates the bottles before drawing them:
					beforeDrawing: beforeDrawingRotate
				},
				//Numeric array containing 'CB_GraphicSprites.SPRITE_OBJECT' objects with all the sprites that will be used:
				sprites:
				[
					//'bottle_sprite' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "bottle_sprite",
						src: "img/bottle.gif"
					}
				]
			},
			//'cup_sprites' ('CB_GraphicSprites.SPRITES_OBJECT' object). Some missing or non-valid properties will will be inherited from the parent ('CB_GraphicSpritesScene.SPRITES_GROUPS_OBJECT' object):
			{
				id: "cup_sprites",
				data: { onlyUseInMap: true },
				//Numeric array containing 'CB_GraphicSprites.SPRITE_OBJECT' objects with all the sprites that will be used:
				sprites:
				[
					//'cup_empty_sprite' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "cup_empty_sprite",
						src: "img/cup_empty.gif"
					},
					//'cup_filled_sprite' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "cup_filled_sprite",
						src: "img/cup_filled.gif"
					}
				]
			},
			//'stone_sprites' ('CB_GraphicSprites.SPRITES_OBJECT' object). Some missing or non-valid properties will will be inherited from the parent ('CB_GraphicSpritesScene.SPRITES_GROUPS_OBJECT' object):
			{
				id: "stone_sprites",
				src: "img/stone.gif",
				data:
				{
					rotationUseDegrees: true,
					onlyUseInMap: true,
					//Rotates the stone walls before drawing them:
					beforeDrawing: beforeDrawingRotate
				},
				//Numeric array containing 'CB_GraphicSprites.SPRITE_OBJECT' objects with all the sprites that will be used:
				sprites:
				[
					//'stone_sprite' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "stone_sprite"
					}
				]
			},
			//'player_sprites' ('CB_GraphicSprites.SPRITES_OBJECT' object). Some missing or non-valid properties will will be inherited from the parent ('CB_GraphicSpritesScene.SPRITES_GROUPS_OBJECT' object):
			{
				id: "player_sprites", //Identifier of the sprites group (also used for the 'CB_GraphicSprites' object). Optional but recommended. It should be unique. If not provided, it will be calculated automatically.
				//Object with any additional data desired which can be any kind:
				//NOTE: it will always have a "that" property pointing to the 'CB_GraphicSprites.SPRITES_OBJECT' object where it belongs to and a function in its "getThis" property returning the same value (added automatically).
				data: //Object with any additional data desired which can be any kind. Default: CB_combineJSON(this.parent.data, this.data) || this.parent.data || { 'that' : CB_GraphicSprites.SPRITES_OBJECT, 'getThis' = function() { return this.that; } }.
				{
					onlyUseInMap: true,
					skipAfter: 500,
					//Creates a loop to repeat sprites (grouped by pairs):
					pointerNext:
						function (sprite, canvasContext, CB_GraphicSpritesObject, drawingMap)
						{
							//If the index of the sprite is even, the next sprite will be the one in the next index:
							if (sprite.position % 2 === 0) { return sprite.position + 1; }
							//...otherwise, the next sprite will be the previous one:
							else { return sprite.position - 1; }
						}
				},
				//Numeric array containing 'CB_GraphicSprites.SPRITE_OBJECT' objects with all the sprites that will be used:
				sprites:
				[
					//'player_down_1_sprite' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "player_down_1_sprite",
						src: "img/player_down_1.gif"
					},
					//'player_down_2_sprite' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "player_down_2_sprite",
						src: "img/player_down_2.gif"
					},
					//'player_up_1_sprite' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "player_up_1_sprite",
						src: "img/player_up_1.gif"
					},
					//'player_up_2_sprite' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "player_up_2_sprite",
						src: "img/player_up_2.gif"
					},
					//'player_left_1_sprite' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "player_left_1_sprite",
						src: "img/player_left_1.gif"
					},
					//'player_left_2_sprite' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "player_left_2_sprite",
						src: "img/player_left_2.gif"
					},
					//'player_right_1_sprite' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "player_right_1_sprite",
						src: "img/player_right_1.gif"
					},
					//'player_right_2_sprite' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "player_right_2_sprite",
						src: "img/player_right_2.gif"
					}
				]
			},
			//'map_group' ('CB_GraphicSprites.SPRITES_OBJECT' object). Some missing or non-valid properties will will be inherited from the parent ('CB_GraphicSpritesScene.SPRITES_GROUPS_OBJECT' object):
			{
				id: "map_group",
				srcType: CB_GraphicSprites.SRC_TYPES.MAP,
				data:
				{
					//References sprites or sub-sprites by their index or identifier. Define a "parentId" (parent identifier of the 'CB_GraphicSprites' object or of the 'CB_GraphicSprites.SPRITE_OBJECT' object) to improve performance.
					elementsData:
					{
						//Each property name is an alias which can be used in the map (in the "src" property).
						"@": //Main character (player):
						{
							id: "player_sprites"
						},
						"#": //Walls:
						{
							id: "stone_sprites"
						},
						"$": //Pieces to move:
						{
							id: "bottle_sprites"
						},
						"-": //Empty holes to put pieces in:
						{
							id: "cup_empty_sprite",
							parentId: "cup_sprites"
						},
						"+": //Holes with a piece inside:
						{
							id: "cup_filled_sprite",
							parentId: "cup_sprites"
						},
						"*": //Main character (player) above a hole:
						{
							id: "player_sprites"
						}
					},
					elementsWidth:
						function(alias, element, elementData, elementMapParent, elementLoopHeightDefault, x, y)
						{
							return _ELEMENTS_WIDTH;
						},
					elementsHeight:
						function(alias, element, elementData, elementMapParent, elementLoopHeightDefault, x, y)
						{
							return _ELEMENTS_HEIGHT;
						}
				},
				sprites:
				[
					//Maps with string aliases:
					//'map_current' ('CB_GraphicSprites.SPRITE_OBJECT' object). Some missing or non-valid properties will be inherited from the sprites group:
					{
						id: "map_current", //Current map which will be displayed (it will be modified according to the position of the player and the other elements).
						src: CB_Arrays.copy(LEVELS[0]) //Using a copy of the array as this one will be modified by the game when elements move.
					}
				]
			}
		]
	};
	
	//Defines the callbacks for the game loop:
	CB_GEM.onLoopStart = function(graphicSpritesSceneObject, CB_REM_dataObject, expectedCallingTime) //When the game loop starts, before rendering the graphics (if it returns false, it will skip rendering in this loop):
	{
		//Manages input:
		manageInput();
	};
	
	CB_GEM.onLoopEnd = function(graphicSpritesSceneObject, CB_REM_dataObject, expectedCallingTime) //When the game loop ends, after rendering the graphics (not executed if the 'CB_GEM.onLoopStart' function returned false):
	{
		if (!CB_GEM.data.gameStarted) { return; }
		
		//If the player has been moved:
		if (CB_GEM.data.player.xPrevious !== CB_GEM.data.player.x || CB_GEM.data.player.yPrevious !== CB_GEM.data.player.y)
		{
			CB_GEM.data.player.xPrevious = CB_GEM.data.player.x;
			CB_GEM.data.player.yPrevious = CB_GEM.data.player.y;

			//Updates the information shown:
			updateInfo(graphicSpritesSceneObject);
			
			//If the current map has all cups filled, jumps to the next level:
			var mapCurrent = graphicSpritesSceneObject.getById("map_group").getById("map_current").src;
			var allHolesFilled = true;
			for (var y = mapCurrent.length - 1; y >= 0; y--)
			{
				for (var x = mapCurrent[y].length - 1; x >= 0; x--)
				{
					if (mapCurrent[y][x] === "-" || mapCurrent[y][x] === "*") { allHolesFilled = false; break; } //An unfilled hole has been found (note that some variants could consider the level done when all bottles has been put in place).
				}
				if (!allHolesFilled) { break; }
			}

			if (allHolesFilled)
			{
				
				//Loads the next level (loops when final level is reached):
				loadLevel(CB_GEM.data.level + 1);
			}
		}
	};
	
	//Modifies the default refresh rate for the game loop (it will affect the FPS):
	CB_GEM.options.LOOP_REFRESH_RATE = 33; //A refresh rate of 33 is about 30 FPS (Frames Per Second) when the cycles per loop is set to 1, which is good enough for this game.
	
	//Starts the game engine module:
	CB_GEM.begin
	(
		//onStart:
		function(graphicSpritesSceneObject, CB_CanvasObject, CB_CanvasObjectBuffer, FPSSprites) //'FPSSprites' contains the 'CB_GraphicSprites.SPRITES_OBJECT' object used to display the FPS counter.
		{
			//Sets the events to the toolbar and its icons:
			var toolbarIconEvent = function()
			{
				if (this.id === "button_restart") { restartLevel(); }
				else if (this.id === "button_undo") { stepUndo(); }
				else if (this.id === "button_redo") { stepRedo(); }
				else if (this.id === "button_fullscreen") { fullScreenToggle(); }
			};
			var toolbarIconsIDs = [ "button_undo", "button_redo", "button_restart", "button_fullscreen" ]; //Identifiers of the toolbar icons.
			var toolbarIconElement = null;
			for (var x = toolbarIconsIDs.length - 1; x >= 0; x--)
			{
				toolbarIconElement = CB_Elements.id(toolbarIconsIDs[x]);
				if (toolbarIconElement !== null)
				{
					makeElementSolid(toolbarIconElement);
					CB_Events.on(toolbarIconElement, "mousedown", toolbarIconEvent);
				}
			}
			
			//Fills the level selector and set its events:
			var levelSelector = CB_Elements.id("level_selector");
			var levelOptionLoop = null;
			if (levelSelector !== null)
			{
				CB_Events.on(levelSelector, "change", function() { loadLevel(levelSelector.value || levelSelector.selectedIndex); });
				
				for (var x = 0; x < LEVELS.length; x++)
				{
					levelOptionLoop = document.createElement("option");
					levelOptionLoop.id = levelOptionLoop.name = levelOptionLoop.value = levelOptionLoop.text = levelOptionLoop.textContent = levelOptionLoop.innerText = x;
					levelSelector.appendChild(levelOptionLoop);
				}
				
				levelSelector.disabled = true; //At first, it will be disabled (since the game has not started yet).
			}

			//Sets the events to the screen controls:
			var screenControlsToggler = CB_Elements.id("controls_toggler");
			if (screenControlsToggler !== null)
			{
				makeElementSolid(screenControlsToggler);
			}
			var screenControls = CB_Elements.id("controls");
			if (screenControls !== null)
			{
				makeElementSolid(screenControls);
			}
			var movePlayerButtonEvent = function() { if (this.id) { manageInput(this.id.replace("screen_button_", "").toUpperCase()); } };
			var screenButtonsIDs = [ "screen_button_up", "screen_button_down", "screen_button_left", "screen_button_right" ]; //Identifiers of the screen buttons.
			var buttonElement = null;
			for (var x = screenButtonsIDs.length - 1; x >= 0; x--)
			{
				buttonElement = CB_Elements.id(screenButtonsIDs[x]);
				if (buttonElement !== null)
				{
					makeElementSolid(buttonElement);
					CB_Events.on(buttonElement, "mousedown", movePlayerButtonEvent);
				}
			}
			
			FPSSprites.setDisabled(false); //Set to true to hide FPS counter.
	
			resizeElements(graphicSpritesSceneObject); //Updates all visual elements according to the screen size.

			updateInfo(graphicSpritesSceneObject); //Shows the information for the first time.
	
			//Updates all when the screen is resized or changes its orientation:
			CB_GEM.onResize = function(graphicSpritesSceneObject, CB_REM_dataObject, CB_CanvasObject, CB_CanvasObjectBuffer)
			{
				resizeElements(graphicSpritesSceneObject);
				updateInfo(graphicSpritesSceneObject);
			};
			
			//If possible, sets the touch events (when swiping):
			var HammerJS = CB_Touch.getHammerJSObject();
			if (HammerJS !== null)
			{
				HammerJS = new HammerJS(document);
				HammerJS.on("swipeup", function(e) { CB_console("Swipe UP! Scale: " + e.scale); manageInput("UP"); });
				HammerJS.on("swipedown", function(e) { CB_console("Swipe DOWN! Scale: " + e.scale); manageInput("DOWN"); });
				HammerJS.on("swipeleft", function(e) { CB_console("Swipe LEFT! Scale: " + e.scale); manageInput("LEFT"); });
				HammerJS.on("swiperight", function(e) { CB_console("Swipe RIGHT! Scale: " + e.scale); manageInput("RIGHT"); });
				HammerJS.get("swipe").set({ direction: Hammer.DIRECTION_ALL });
			}

			CB_Elements.hideById("loading"); //Hides the loading message.
			
			//If music is enabled, shows the music loader:
			if (CB_GEM.data.musicEnabled)
			{
				CB_Events.removeByName(CB_Elements.id("button_load_check_music"), "click"); //Removes the previous event handler from the button (if any).
				CB_Events.on(CB_Elements.id("button_load_check_music"), "click", prepareMusic); //Attaches the event to the button to load the music.
				CB_Elements.showById("music_loader_checker"); //Shows the music loader.
			}
			//...otherwise, if music is disabled, shows the start button directly:
			else
			{
				CB_Elements.showById("start_button"); //Shows the start button.
			}
			
			//Sets the event for the debug checkbox:
			var debugCheckbox = CB_Elements.id("debug_checkbox");
			if (debugCheckbox !== null)
			{
				debugCheckbox.checked = !!CB_GEM_DEBUG_MESSAGES;
				CB_Events.on(debugCheckbox, "change", function() { CB_GEM_DEBUG_MESSAGES = !!debugCheckbox.checked; updateInfo(graphicSpritesSceneObject); });
			}
		},
		
		//onError:
		function(error) { CB_console("Error: " + error); }
	);
}


//Starts the game:
function gameStart(graphicSpritesSceneObject)
{
	if (CB_GEM.data.gameStarted) { return; }

	graphicSpritesSceneObject = graphicSpritesSceneObject || CB_GEM.graphicSpritesSceneObject;
	if (!graphicSpritesSceneObject) { return; }
	
	//Hides the start button:
	CB_Elements.hideById("start_button");
	
	//Loads the first level and resets any data:
	loadLevel(0, true);
	
	//Prepares the sound effects and plays one of them (recommended to do this through a user-driven event):
	try
	{
		prepareSoundFx(); //Prepares sound effects to be used later.
		playSoundFx("start");
	}
	catch(E)
	{
		CB_console("Error preparing sounds or playing sound with 'start' ID: " + E);
		CB_GEM.data.soundEnabled = false; //If it fails, disables the sound.
	}

	if (CB_GEM.data.vibrationEnabled) { CB_Device.Vibration.start(100); } //Makes the device vibrate.

	//Enables the level selector:
	var levelSelector = CB_Elements.id("level_selector");
	if (levelSelector !== null)
	{
		levelSelector.disabled = false;
	}

	//Sets the game as started:
	CB_GEM.data.gameStarted = true; //When set to true, starts the game automatically as the game loops detect it.
}


//Ends the game:
function gameEnd(message)
{
	if (!CB_GEM.data.gameStarted) { return; }

	//Disables the level selector:
	var levelSelector = CB_Elements.id("level_selector");
	if (levelSelector !== null)
	{
		levelSelector.disabled = true;
	}
		
	message = CB_trim(message);
	CB_GEM.data.gameStarted = false;
	CB_Elements.insertContentById("start_button", (message !== "" ? message + "<br />" : "") + "Start game!")
	CB_Elements.showById("start_button"); //Shows the start button again.
}


//Loads the desired level:
function loadLevel(level, resetAllMovements)
{
	//Sanitizes the level number:
	level = level || 0;
	if (level < 0) { level = 0; }
	level %= LEVELS.length; //When the number given is bigger than the levels, it will start again from the beginning.
	
	//Resets the data:
	CB_GEM.data.level = level;
	CB_GEM.data.player.movementsLevel = 0;
	if (resetAllMovements) { CB_GEM.data.player.movementsTotal = 0; }
	
	//Selects the corresponding level in the level selector:
	var levelSelector = CB_Elements.id("level_selector");
	if (levelSelector !== null)
	{
		levelSelector.value = levelSelector.selectedIndex = level;
		if (levelSelector.options && levelSelector.options[level]) { levelSelector.options[level].selected = true; }
		
		//Blurs the level selector (just in case it was selected):
		if (typeof(levelSelector.blur) === "function")
		{
			CB_console("Blurring level selector...");
			levelSelector.blur();
		}
	}
	
	//Loads the new map:
	CB_GEM.graphicSpritesSceneObject.getById("map_group").getById("map_current").src = CB_Arrays.copy(LEVELS[level]); //Using a copy of the array as this one will be modified by the game when elements move.
	
	//Finds and updates the position of the player:
	updatePlayerPosition(LEVELS[level]);
	
	//Resets and stores the data of the current map status as the first step (movement):
	CB_GEM.data.steps.pointer = 0;
	CB_GEM.data.steps.data = [];
	
	//Stores the data of the current position(to be able to undo it later):
	stepStore();
	
	//Updates all visual elements according to the screen size:
	resizeElements(CB_GEM.graphicSpritesSceneObject);

	//Shows the information for the first time:
	updateInfo(CB_GEM.graphicSpritesSceneObject);
	
	//Plays the song corresponding to the level:
	playMusic(_songTitles[level % _songTitles.length]);
}


//Restarts a level:
function restartLevel()
{
	CB_console("Restarting level " + CB_GEM.data.level + "...");
	loadLevel(CB_GEM.data.level);
}


//Updates the information shown:
function updateInfo(graphicSpritesSceneObject)
{
	graphicSpritesSceneObject.getById("info").get(0).src =
		"Level: " + CB_GEM.data.level + "\n" +
		"Movements:\n" +
			" Current level: " + CB_GEM.data.player.movementsLevel + "\n" +
			" Total: " + CB_GEM.data.player.movementsTotal +
		(!CB_Screen.isLandscape() ? "\n\nLandscape screen recommended!" : "") +
		(
			CB_GEM_DEBUG_MESSAGES ?
				"\n\nPlayer coordinates: " + CB_GEM.data.player.x + "," + CB_GEM.data.player.y + " (previous: " + CB_GEM.data.player.xPrevious + "," + CB_GEM.data.player.yPrevious + ")" +
				"\nSteps stored (length): " + CB_GEM.data.steps.data.length + " (pointer: " + CB_GEM.data.steps.pointer + ")"
			: ""
		);
}


//Resizes all visual elements according to the screen size:
var _ELEMENTS_WIDTH = 40; //It will be updated automatically according to the screen size.
var _ELEMENTS_HEIGHT = 40; //It will be updated automatically according to the screen size.
function resizeElements(graphicSpritesSceneObject)
{
	if (graphicSpritesSceneObject instanceof CB_GraphicSpritesScene)
	{
		//Resizes the current map which is being displayed according to the new screen size:
		var mapCurrent = graphicSpritesSceneObject.getById("map_group").getById("map_current").src;
		if (CB_isArray(mapCurrent))
		{
			_ELEMENTS_HEIGHT = CB_Screen.getWindowHeight() / mapCurrent.length;
			var maxWidthFound = 1;
			for (var x = 0; x < mapCurrent.length; x++)
			{
				if (mapCurrent.length && mapCurrent[x].length > maxWidthFound) { maxWidthFound = mapCurrent[x].length; }
			}
			_ELEMENTS_WIDTH = CB_Screen.getWindowWidth() / maxWidthFound;
			_ELEMENTS_WIDTH = _ELEMENTS_HEIGHT = Math.min(_ELEMENTS_WIDTH, _ELEMENTS_HEIGHT);
			graphicSpritesSceneObject.getById("map_group").getById("map_current").left = (CB_Screen.getWindowWidth() - _ELEMENTS_WIDTH * maxWidthFound) / 2;
			graphicSpritesSceneObject.getById("map_group").getById("map_current").top = (CB_Screen.getWindowHeight() - _ELEMENTS_HEIGHT * mapCurrent.length) / 2;
		}
		
		//Resizes the FPS and the information text:
		var fontSize = parseInt(Math.min(CB_Screen.getWindowWidth(), CB_Screen.getWindowHeight()) * 0.07) + "px";
		CB_GEM.graphicSpritesSceneObject.getById("fps_group").getById("fps").data.fontSize = parseInt(fontSize) / 1.5 + "px";
		CB_GEM.graphicSpritesSceneObject.getById("info").get(0).top = parseInt(fontSize) / 2;
		CB_GEM.graphicSpritesSceneObject.getById("info").get(0).data.fontSize = parseInt(fontSize) / 2.5 + "px";
	}

	//Resizes the toolbar and its icons:
	var toolbar = CB_Elements.id("toolbar");
	var toolbarIconMargin = parseInt(Math.min(CB_Screen.getWindowWidth(), CB_Screen.getWindowHeight()) * 0.08) + "px";
	if (toolbar !== null)
	{
		toolbar.style.right = toolbarIconMargin;
		toolbar.style.top = toolbarIconMargin;
	}
	var toolbarIconsIDs = [ "button_undo", "button_redo", "button_restart", "button_fullscreen", "level_selector" ]; //Identifiers of the toolbar icons.
	var toolbarIconElement = null;
	var toolbarIconWidthAndHeight = parseInt(Math.min(CB_Screen.getWindowWidth(), CB_Screen.getWindowHeight()) * 0.12) + "px";
	for (var x = toolbarIconsIDs.length - 1; x >= 0; x--)
	{
		toolbarIconElement = CB_Elements.id(toolbarIconsIDs[x]);
		if (toolbarIconElement !== null)
		{
			
			toolbarIconElement.style.width = toolbarIconWidthAndHeight;
			toolbarIconElement.style.height = toolbarIconElement.style.lineHeight = toolbarIconWidthAndHeight;
			
			if (toolbarIconElement.id === "level_selector")
			{
				toolbarIconElement.style.fontSize = toolbarIconElement.style.lineHeight = parseInt(toolbarIconWidthAndHeight) / 4 + "px";
			}
		}
	}
	
	//Resizes the screen controls:
	var screenControlsToggler = CB_Elements.id("controls_toggler");
	if (screenControlsToggler !== null)
	{
		screenControlsToggler.style.right = "0px";
		screenControlsToggler.style.bottom = toolbarIconMargin;
		screenControlsToggler.style.width = (parseInt(toolbarIconWidthAndHeight) / 2) + "px";
		screenControlsToggler.style.height = screenControlsToggler.style.lineHeight = (parseInt(toolbarIconWidthAndHeight) / 2) + "px";
		screenControlsToggler.style.fontSize = parseInt(toolbarIconWidthAndHeight) / 4 + "px";
	}
	var screenControls = CB_Elements.id("controls");
	if (screenControls !== null)
	{
		screenControls.style.right = toolbarIconMargin;
		screenControls.style.bottom = toolbarIconMargin;
	}
	var screenButtonsIDs = [ "screen_button_up", "screen_button_down", "screen_button_left", "screen_button_right" ]; //Identifiers of the screen buttons.
	var buttonElement = null;
	for (var x = screenButtonsIDs.length - 1; x >= 0; x--)
	{
		buttonElement = CB_Elements.id(screenButtonsIDs[x]);
		if (buttonElement !== null)
		{
			buttonElement.style.width = toolbarIconWidthAndHeight;
			buttonElement.style.height = buttonElement.style.lineHeight = toolbarIconWidthAndHeight;
		}
	}
	
	//Resizes the font of the start button:
	var startButton = CB_Elements.id("start_button");
	if (startButton !== null) { startButton.style.fontSize = parseInt(toolbarIconWidthAndHeight) / 4 + "px"; }
}


//Input management (some controllers can also fire keyboard events):
var _inputProcessedLastTime = 0;
var _playerIgnoreInputMs = 180; //Number of milliseconds that the input will be ignored after the player has been moved (to avoid moving or processing the input too fast).
function manageInput(action)
{
	//If not enough time has been elapsed since the last movement, exits (to avoid moving or processing the input too fast):
	if (CB_Device.getTiming() < _inputProcessedLastTime + _playerIgnoreInputMs) { return; }

	//If the game has not started:
	if (!CB_GEM.data.gameStarted)
	{
		//If return, space or a button (button 1, 2 or 3) or axis from any gamepad is pressed, starts the game:
		if (CB_Keyboard.isKeyDown(CB_Keyboard.keys.ENTER) || CB_Keyboard.isKeyDown(CB_Keyboard.keys.SPACEBAR) || CB_Controllers.isButtonDown([1, 2, 3]) || CB_Controllers.getAxesDown().length > 0 || CB_Controllers.getAxesDown("", -1).length > 0)
		{
			if (!CB_GEM.data.musicEnabled || CB_GEM.data.musicLoaded && CB_GEM.data.musicChecked) { gameStart(CB_GEM.graphicSpritesSceneObject); }
			else if (CB_GEM.data.musicLoaded) { checkMusic(); }
			else { prepareMusic(); }
			
			_inputProcessedLastTime = CB_Device.getTiming(); //As we have processed the input, updates the time with the new one (to avoid moving or processing the input too fast).
			
			return;
		}
	}
	//...otherwise, if the game has started, manages the input to move the player (if possible):
	else
	{
		var actionPerformed = false;
		
		
		//After pressing the 'C' key or a specific gamepad button, shows/hides the screen controls:
		if (action === "TOGGLE_SCREEN_CONTROLS" || CB_Keyboard.isKeyDown(CB_Keyboard.keys.C) || CB_Controllers.isButtonDown(10))
		{
			screenControlsToggle();
			actionPerformed = true;
		}
		//...otherwise, after pressing the ESC key or a specific gamepad button, ends the game:
		else if (action === "ABORT" || CB_Keyboard.isKeyDown(CB_Keyboard.keys.ESC) || CB_Controllers.isButtonDown(9))
		{
			gameEnd("Game aborted");
			actionPerformed = true;
		}
		//...otherwise, if we want to go to the previous level, goes there:
		else if (action === "PREVIOUS_LEVEL" || typeof(action) === "undefined" && (CB_Keyboard.isKeyDown([CB_Keyboard.keys.O]) || CB_Controllers.isButtonDown(4) || CB_Controllers.isButtonDown(7)))
		{
			loadLevel(CB_GEM.data.level > 0 ? CB_GEM.data.level - 1 : 0);
			actionPerformed = true;
		}
		//...otherwise, if we want to go to the next level, goes there:
		else if (action === "NEXT_LEVEL" || typeof(action) === "undefined" && (CB_Keyboard.isKeyDown([CB_Keyboard.keys.P]) || CB_Controllers.isButtonDown(5) || CB_Controllers.isButtonDown(6)))
		{
			loadLevel(CB_GEM.data.level < LEVELS.length -1 ? CB_GEM.data.level + 1 : LEVELS.length - 1); //It will not cycle (when reaches last level, will not go to the first one).
			actionPerformed = true;
		}
		//...otherwise, if we want to restart the level, restarts it:
		else if (action === "RESTART" || typeof(action) === "undefined" && (CB_Keyboard.isKeyDown([CB_Keyboard.keys.R, CB_Keyboard.keys.F9]) || CB_Controllers.isButtonDown(3)))
		{
			restartLevel();
			actionPerformed = true;
		}
		//...otherwise, if we want to undo a step, undoes it (if possible):
		else if (action === "STEP_UNDO" || typeof(action) === "undefined" && (CB_Keyboard.isKeyDown([CB_Keyboard.keys.Z, CB_Keyboard.keys.U, CB_Keyboard.keys.F2]) || CB_Controllers.isButtonDown(1)))
		{
			stepUndo();
			actionPerformed = true;
		}
		//...otherwise, if we want to repeat a step, repeats it (if possible):
		else if (action === "STEP_REDO" || typeof(action) === "undefined" && (CB_Keyboard.isKeyDown([CB_Keyboard.keys.Y, CB_Keyboard.keys.N, CB_Keyboard.keys.F4]) || CB_Controllers.isButtonDown(2)))
		{
			stepRedo();
			actionPerformed = true;
		}
		//...otherwise, if we want to toggle full screen, we try it:
		//NOTE: some browsers will fail to enable full screen mode if it is not requested through a user-driven event (as "onClick", "onTouchStart", etc.).
		else if (action === "FULL_SCREEN_TOGGLE" || typeof(action) === "undefined" && (CB_Keyboard.isKeyDown([CB_Keyboard.keys.F]) || CB_Controllers.isButtonDown(8)))
		{
			fullScreenToggle();
			actionPerformed = true;
		}
		//...otherwise, if we want to focus the level selector, we do it:
		else if (action === "FOCUS_LEVEL_SELECTOR" || typeof(action) === "undefined" && (CB_Keyboard.isKeyDown([CB_Keyboard.keys.L, CB_Keyboard.keys.J, CB_Keyboard.keys.ENTER]) || CB_Controllers.isButtonDown(0)))
		{
			var levelSelector = CB_Elements.id("level_selector");
			if (levelSelector !== null && typeof(levelSelector.focus) === "function")
			{
				CB_console("Focusing level selector...");
				levelSelector.focus();
				actionPerformed = true;
			}
		}
		
		//If an action has performed already, just exits:
		if (actionPerformed)
		{
			_inputProcessedLastTime = CB_Device.getTiming(); //As we have processed the input, updates the time with the new one (to avoid moving or processing the input too fast).
			return;
		}
		
		//Manages player movement:
		var mapCurrent = CB_GEM.graphicSpritesSceneObject.getById("map_group").getById("map_current").src;

		//Position where the player will be moved to (if possible):
		var xDestiny = CB_GEM.data.player.x;
		var yDestiny = CB_GEM.data.player.y;
		
		//Position where the piece would be moved to (in the case that there was one piece or a hole with a piece inside in the destiny):
		var xDestinyPiece = xDestiny;
		var yDestinyPiece = yDestiny;
		
		//Up:
		if (action === "UP" || CB_Keyboard.isKeyDown([CB_Keyboard.keys.UP, CB_Keyboard.keys.W]) || CB_Controllers.isAxisDown(1, "", -1))
		{
			if (CB_GEM.data.player.y > 0)
			{
				yDestiny = CB_GEM.data.player.y - 1;
				if (yDestiny > 1) { yDestinyPiece = yDestiny - 1; }
				action = "UP";
			}
		}
		//Down:
		else if (action === "DOWN" || CB_Keyboard.isKeyDown([CB_Keyboard.keys.DOWN, CB_Keyboard.keys.S]) || CB_Controllers.isAxisDown(1))
		{
			if (CB_GEM.data.player.y < mapCurrent.length - 1)
			{
				yDestiny = CB_GEM.data.player.y + 1;
				if (yDestiny < mapCurrent.length - 1) { yDestinyPiece = yDestiny + 1; }
				action = "DOWN";
			}
		}
		//Left:
		else if (action === "LEFT" || CB_Keyboard.isKeyDown([CB_Keyboard.keys.LEFT, CB_Keyboard.keys.A]) || CB_Controllers.isAxisDown(0, "", -1))
		{
			if (CB_GEM.data.player.x > 0)
			{
				xDestiny = CB_GEM.data.player.x - 1;
				if (xDestiny > 0) { xDestinyPiece = xDestiny - 1; }
				action = "LEFT";
			}
		}
		//Right:
		else if (action === "RIGHT" || CB_Keyboard.isKeyDown([CB_Keyboard.keys.RIGHT, CB_Keyboard.keys.D]) || CB_Controllers.isAxisDown(0))
		{
			if (CB_GEM.data.player.x < mapCurrent[CB_GEM.data.player.y].length - 1)
			{
				xDestiny = CB_GEM.data.player.x + 1;
				if (xDestiny < mapCurrent[CB_GEM.data.player.y].length - 1) { xDestinyPiece = xDestiny + 1; }
				action = "RIGHT";
			}
		}

		//If the destiny position is different from the current one (we want to move the player):
		if (xDestiny !== CB_GEM.data.player.x || yDestiny !== CB_GEM.data.player.y)
		{
			//Checks whether it is possible to move the player or not:
			var playerCanMove = false;
			var destinyHasPieceToMove = false;
			var cellDestiny = mapCurrent[yDestiny][xDestiny];
			switch (cellDestiny)
			{
				//If the destiny has a blank space (nothing) or an empty hole, the player can be moved:
				case " ": case "-":
					playerCanMove = true;
				break;
				//...otherwise, if the destiny has a piece or a hole with a piece inside:
				case "$": case "+":
					//If there is a blank space, the player can be moved:
					if ((xDestinyPiece !== CB_GEM.data.player.x || yDestinyPiece !== CB_GEM.data.player.y) && (mapCurrent[yDestinyPiece][xDestinyPiece] === " " || mapCurrent[yDestinyPiece][xDestinyPiece] === "-"))
					{
						playerCanMove = true;
						destinyHasPieceToMove = true;
					}
				break;
			}

			//If possible, moves the player:
			if (playerCanMove)
			{
				//If there is a piece to move, also moves it:
				if (destinyHasPieceToMove)
				{
					mapCurrent[yDestinyPiece][xDestinyPiece] = mapCurrent[yDestinyPiece][xDestinyPiece] === "-" ? "+" : "$"; //Has in mind whether there was an empty hole or a blank space in the destiny of the piece to move.
					
					//Reproduces the corresponding sound, depending on whether a hole was filled or not:
					if (mapCurrent[yDestinyPiece][xDestinyPiece] === "+") { playSoundFx("hole_filled"); }
					else { playSoundFx("piece_moving"); }
				}
				mapCurrent[CB_GEM.data.player.y][CB_GEM.data.player.x] = mapCurrent[CB_GEM.data.player.y][CB_GEM.data.player.x] === "@" ? " " : "-"; //Has in mind whether there was an empty hole or not behind the player before moving.
				mapCurrent[yDestiny][xDestiny] = mapCurrent[yDestiny][xDestiny] === "-" || mapCurrent[yDestiny][xDestiny] === "+" ? "*" : "@"; //Has in mind whether there is an empty hole or not in the new position.
				CB_GEM.data.player.x = xDestiny;
				CB_GEM.data.player.y = yDestiny;
				_inputProcessedLastTime = CB_Device.getTiming(); //As we have processed the input, updates the time with the new one (to avoid moving or processing the input too fast).
				
				//Changes the sprite of the player (in the 'CB_GraphicSpritesScene' object being used by the current map):
				CB_REM._MAP_ELEMENTS_CACHE["map_current"].CB_GraphicSpritesSceneObject.getById("player_sprites").setPointer(CB_GEM.graphicSpritesSceneObject.getById("player_sprites").getById("player_" + action.toLowerCase() + "_1_sprite").position);
				
				//Increases the movement counters:
				CB_GEM.data.player.movementsLevel++;
				CB_GEM.data.player.movementsTotal++;
				
				//Stores the data of the step (movement) which has been performed (to be able to undo/redo it later):
				stepStore();
			}
			//...otherwise, if it is not possible to move:
			else
			{
				if (CB_GEM.data.vibrationEnabled) { CB_Device.Vibration.start(100); } //Makes the device vibrate, if desired.
				playSoundFx("cannot_move"); //Reproduces the corresponding sound.
			}
		}
	}
}


//Stores a step (movement) data:
function stepStore()
{
	CB_console("Saving movement (step) data for #" + CB_GEM.data.steps.pointer + "...");
	
	//Stores the data of the step (movement) which is being performed (to be able to undo/redo later):
	CB_GEM.data.steps.data = CB_GEM.data.steps.data.slice(0, CB_GEM.data.steps.pointer); //Removes any possible further steps stored.
	CB_GEM.data.steps.data[CB_GEM.data.steps.pointer] =
	{
		map: CB_Arrays.copy(CB_GEM.graphicSpritesSceneObject.getById("map_group").getById("map_current").src),
		player:
		{
			x: CB_GEM.data.player.x,
			y: CB_GEM.data.player.y,
			xPrevious: CB_GEM.data.player.xPrevious,
			yPrevious: CB_GEM.data.player.yPrevious
		}
	};
	
	CB_GEM.data.steps.pointer = CB_GEM.data.steps.data.length;
	CB_console("Movement (step) data pointer set to " + CB_GEM.data.steps.pointer);
}


//Undoes a step (movement):
function stepUndo()
{
	CB_console("Trying to undo last step (movement)...");
	
	if (CB_GEM.data.steps.pointer <= 1) { CB_console("No more steps (movements) to undo!"); return; }

	//Loads the data of the previous step:
	var dataLoaded = stepLoadData(CB_GEM.data.steps.pointer - 2);
	
	//If the data was loaded, decreases the step (movement) pointer:
	if (dataLoaded)
	{
		//Decreases the movement counters:
		CB_GEM.data.player.movementsLevel--;
		CB_GEM.data.player.movementsTotal--;
		
		//Decreases the step (movement) pointer:
		CB_GEM.data.steps.pointer--;
		
		CB_console("Movement (step) data pointer set to " + CB_GEM.data.steps.pointer);
	}
	else { CB_console("It was not be possible to load the data for #" + (CB_GEM.data.steps.pointer - 2) + "."); }
}


//Redoes a step (movement):
function stepRedo()
{
	CB_console("Trying to redo last step (movement)...");
	
	if (CB_GEM.data.steps.pointer >= CB_GEM.data.steps.data.length) { CB_console("No more steps (movements) to redo!"); return; }
	
	//Loads the data of the current pointer:
	var dataLoaded = stepLoadData(CB_GEM.data.steps.pointer);
	
	//If the data was loaded, increases the step (movement) pointer:
	if (dataLoaded)
	{
		//Increases the movement counters:
		CB_GEM.data.player.movementsLevel++;
		CB_GEM.data.player.movementsTotal++;

		//Increases the step (movement) pointer:
		CB_GEM.data.steps.pointer++;
		
		CB_console("Movement (step) data pointer set to " + CB_GEM.data.steps.pointer);
	}
	else { CB_console("It was not be possible to load the data for #" + CB_GEM.data.steps.pointer + "."); }
}


//Loads the step (movement) data desired:
function stepLoadData(pointer)
{
	if (typeof(pointer) === "undefined" || pointer === null) { pointer = CB_GEM.data.steps.pointer; }
	
	CB_console("Trying to load data from step #" + pointer + "...");
	
	var stepData = CB_GEM.data.steps.data[pointer];
	//If there is no data, exits:
	if (!stepData) { CB_console("Data from step #" + pointer + " not found!"); return false; }
	//...otherwise, if there is a whole map stored, restores it and exits:
	else if (CB_isArray(stepData.map) && stepData.player)
	{
		CB_console("Restoring whole map for step #" + pointer + "...");
		CB_GEM.graphicSpritesSceneObject.getById("map_group").getById("map_current").src = CB_Arrays.copy(stepData.map);
		CB_console("Restoring coordinates: " + stepData.player.x + "," + stepData.player.y + " (previous: " + stepData.player.xPrevious + "," + stepData.player.yPrevious + ")...");
		CB_GEM.data.player.x = stepData.player.x;
		CB_GEM.data.player.y = stepData.player.y;
		CB_GEM.data.player.xPrevious = stepData.player.xPrevious;
		CB_GEM.data.player.yPrevious = stepData.player.yPrevious;
		return true;
	}
	
	return false;
}


//Finds and updates the position of the player in the given map:
function updatePlayerPosition(mapArray)
{
	CB_GEM.data.player.x = CB_GEM.data.player.xPrevious = 0;
	CB_GEM.data.player.y = CB_GEM.data.player.yPrevious = 0;
	
	var positionFound = false;
	
	if (CB_isArray(mapArray))
	{
		for (var y = mapArray.length - 1; y >= 0; y--)
		{
			if (CB_isArray(mapArray[y]))
			{
				for (var x = mapArray[y].length - 1; x >= 0; x--)
				{
					//Player found:
					if (mapArray[y][x] === "@" || mapArray[y][x] === "*")
					{
						CB_GEM.data.player.x = x;
						CB_GEM.data.player.y = y;
						positionFound = true;
						break;
					}
				}
			}
			if (positionFound) { break; }
		}
	}
	
	return positionFound;
}


//Skips music loader (to play silent mode):
function skipLoadingMusic()
{
	CB_console("Skipping loading music...");
	CB_GEM.data.musicEnabled = false;
	CB_Elements.hideById("music_loader_checker"); //Hides the music loader.
	CB_Elements.showById("start_button"); //Shows the start button.
}


//Prepares sound effects:
var _sfx = null; //Global object to play the sounds.
var _prepareSoundFxExecuted = false;
function prepareSoundFx(forceReload)
{
	if (!forceReload && _prepareSoundFxExecuted) { return; }

	_prepareSoundFxExecuted = true;

	CB_console("Preparing sound FX" + (forceReload ? " (forcing reload)" : "") + "...");
	
	var jsfxObject = CB_Speaker.getJsfxObject(); //Gets the 'jsfx' object.
	if (jsfxObject !== null)
	{
		//Defines the sound effects:
		var library =
		{
			"start":
				jsfx.Preset.Coin,
			"cannot_move":
				{ "Volume": { "Sustain": 0.05, "Decay": 0.2, "Punch": 1, "Master": 0.25 } },
			"piece_moving":
				{
					"Generator": { "Func": "noise", "A": 0.89, "B": 1 },
					"Volume": { "Sustain": 0.15, "Decay": 0.051, "Punch": 0.11, "Master": 0.23, "Attack": 0.241 }
				},
			"hole_filled":
				{
					"Frequency": { "Start": 1239 },
					"Generator": { "Func": "saw" },
					"Phaser": { "Offset": 0.56, "Sweep": -0.92 },
					"Volume": { "Master": 0.35, "Sustain": 0, "Decay": 0.321 }
				}
		};

		//Loads the sound effects:
		_sfx = CB_AudioDetector.isAPISupported("WAAPI") ? jsfxObject.Live(library) : jsfxObject.Sounds(library); //Uses AudioContext (Web Audio API) if available.
	}
}


//Plays the desired sound effect (by its identifier):
function playSoundFx(id)
{
	if (!CB_GEM.data.soundEnabled) { return; }
	else if (!_sfx || typeof(_sfx[id]) !== "function")
	{
		CB_console("Sound FX '" + id + "' cannot be played! An user-driven event might be needed to be fired before being able to play sounds.");
		prepareSoundFx(true); //Forces reloading sounds.
		if (!_sfx || typeof(_sfx[id]) !== "function") { return; }
	}

	CB_console("Playing sound FX: " + id);

	//Note: at least the first time, it is recommended to do it through a user-driven event (as "onClick", "onTouchStart", etc.) in order to maximize compatibility (as some clients could block sounds otherwise).
	_sfx[id]();
}


//Prepares background music:
var _audioFileSpritesPool = null; //Global 'CB_AudioFileSpritesPool' object to play the music.
var _songTitles = []; //Array to keep the title of all the loaded songs.
var _prepareMusicExecuted = false;
function prepareMusic()
{
	if (!CB_GEM.data.musicEnabled) { return; }
	else if (_prepareMusicExecuted) { return; }
	_prepareMusicExecuted = true;
	
	CB_console("Preparing music...");
	
	CB_Elements.hideById("button_load_check_music"); //Hides the music loader button.
	
	//Defines the audios in different audio files (providing different formats and paths):
	//NOTE: CrossBrowdy will choose the best one(s) for the current client automatically.
	var currentURL = location.href;
	currentURL = currentURL.substring(0, currentURL.lastIndexOf("/") !== -1 ? currentURL.lastIndexOf("/") : currentURL.length) + "/";
	var audioURIs =
	{
		//NOTE: not using data URIs to keep the example simpler.
		"black_lark-first_contact" :
		{
			"audio/mpeg" :
			[
				currentURL + "audio/black_lark-first_contact-compressed.mp3", //Absolute path.
				"audio/black_lark-first_contact-compressed.mp3" //Relative path.
			],
			"audio/ogg" :
			[
				currentURL + "audio/black_lark-first_contact-compressed.ogg", //Absolute path.
				"audio/black_lark-first_contact-compressed.ogg" //Relative path.
			],
			"audio/mp4" :
			[
				currentURL + "audio/black_lark-first_contact-compressed.m4a", //Absolute path.
				"audio/black_lark-first_contact-compressed.m4a" //Relative path.
			],
			"audio/wav" :
			[
				currentURL + "audio/black_lark-first_contact-compressed.wav", //Absolute path.
				"audio/black_lark-first_contact-compressed.wav" //Relative path.
			]
		},
		"smokefishe-sorry_for_lying" :
		{
			"audio/mpeg" :
			[
				currentURL + "audio/smokefishe-sorry_for_lying-compressed.mp3", //Absolute path.
				"audio/smokefishe-sorry_for_lying-compressed.mp3" //Relative path.
			],
			"audio/ogg" :
			[
				currentURL + "audio/smokefishe-sorry_for_lying-compressed.ogg", //Absolute path.
				"audio/smokefishe-sorry_for_lying-compressed.ogg" //Relative path.
			],
			"audio/mp4" :
			[
				currentURL + "audio/smokefishe-sorry_for_lying-compressed.m4a", //Absolute path.
				"audio/smokefishe-sorry_for_lying-compressed.m4a" //Relative path.
			],
			"audio/wav" :
			[
				currentURL + "audio/smokefishe-sorry_for_lying-compressed.wav", //Absolute path.
				"audio/smokefishe-sorry_for_lying-compressed.wav" //Relative path.
			]
		},
		"weary_eyes-invisible_hand" :
		{
			"audio/mpeg" :
			[
				currentURL + "audio/weary_eyes-invisible_hand-compressed.mp3", //Absolute path.
				"audio/weary_eyes-invisible_hand-compressed.mp3" //Relative path.
			],
			"audio/ogg" :
			[
				currentURL + "audio/weary_eyes-invisible_hand-compressed.ogg", //Absolute path.
				"audio/weary_eyes-invisible_hand-compressed.ogg" //Relative path.
			],
			"audio/mp4" :
			[
				currentURL + "audio/weary_eyes-invisible_hand-compressed.m4a", //Absolute path.
				"audio/weary_eyes-invisible_hand-compressed.m4a" //Relative path.
			],
			"audio/wav" :
			[
				currentURL + "audio/weary_eyes-invisible_hand-compressed.wav", //Absolute path.
				"audio/weary_eyes-invisible_hand-compressed.wav" //Relative path.
			]
		}
	};

	//Defines the sprites information:
	/*	NOTE:
		If "startAt" is not provided, it will use the value of 0 (zero) which means that it will start from the beginning.
		If "stopAt" is not provided (not recommended), it will use the whole duration of the file (which means until it reaches its end).
		Due to some possible problems between clients with different audio APIs calculating the duration of an audio file, it is recommended to always set the "stopAt" property even when we want it to stop at the end of the audio.
	*/
	var audioSprites =
	{
		//Sprite group identifiers (case-sensitive):
		"black_lark-first_contact" :
		{
			//Sprite identifiers (case-sensitive), specifying where they start and where they stop:
			"ALL" :
			{
				"startAt" : 0,
				"stopAt" : null //Until the end. Note that the recommended way is to always provide the quantity in milliseconds as explained above.
			}
		},
		"smokefishe-sorry_for_lying" :
		{
			"ALL" :
			{
				"startAt" : 0,
				"stopAt" : null //Until the end. Note that the recommended way is to always provide the quantity in milliseconds as explained above.
			}
		},
		"weary_eyes-invisible_hand" :
		{
			"ALL" :
			{
				"startAt" : 0,
				"stopAt" : null //Until the end. Note that the recommended way is to always provide the quantity in milliseconds as explained above.
			}
		}
	};

	//Defines the function to call when an audio file sprites object has any error:
	var onErrorSpritesGroup = function(error)
	{
		CB_console("[CB_AudioFileSprites] Audio file sprites object (" + this.id + ") failed: " + error);
	};

	//Defines the function to call when an audio file sprites object is created or expanding:
	var onCreateSpritesGroup = function(audioFileObjectsToCheck)
	{
		CB_console("[CB_AudioFileSprites] Audio file sprites object (CB_AudioFileSprites) with ID " + this.id + " (status: " + this.getStatusString() + ") created or expanding! CB_AudioFile objects that still need to be checked: " + audioFileObjectsToCheck);
		if (CB_Arrays.indexOf(_songTitles, this.id) === -1) { _songTitles[_songTitles.length] = this.id; } //Adds the song to the songs array (if it did not exist yet).
		this.onLoad = null; //Prevents to execute this function again (otherwise, it could be executed again after the object grows automatically to create more 'CB_AudioFile' objects).
	};

	//Defines the function to call when an audio file sprites pool object has any error:
	var onError = function(error)
	{
		CB_console("[CB_AudioFileSpritesPool] Audio file sprites pool object failed: " + error);
		
		//Lets continue anyway:
		skipLoadingMusic();
	};

	//Defines the function to call when the audio file sprites pool object is created:
	var onCreate = function(audioFileObjectsToCheck)
	{
		CB_console("[CB_AudioFileSpritesPool] Audio file sprites pool object with ID " + this.id + " (status: " + this.getStatusString() + ") created! CB_AudioFile objects that still need to be checked: " + audioFileObjectsToCheck);
		if (audioFileObjectsToCheck > 0)
		{
			CB_console("[CB_AudioFileSpritesPool] The '_audioFileSpritesPool.checkPlayingAll' method can be called now, to check all the CB_AudioFile objects.");
			CB_GEM.data.musicLoaded = true;
			showMusicChecker(); //Shows the music checker.
		}
		this.onLoad = null; //Prevents to execute this function again (otherwise, it could be executed again after the object grows automatically to create more 'CB_AudioFile' objects).
	};

	//Defines the data for the audio file sprites pool object with all possible options:
	var audioFileSpritesPoolData =
	{
		//Identifier for the audio file sprites pool object:
		id: "songs", //Optional. Will be stored in '_audioFileSpritesPool.id'.

		//Sprites groups (each will create a CB_AudioFileSprites object internally):
		"spritesGroups" :
		{
			//Sprites group "black_lark-first_contact" (it will be used as its ID) which will create a CB_AudioFileSprites object internally:
			"black_lark-first_contact" : //This object has the same format that uses the '_audioFileSpritesPool.insertSpritesGroup' method (indeed, it is called internally).
			{
				//Defines the same audio but in different audio files (providing different formats, paths and data URIs):
				"URIs" : audioURIs["black_lark-first_contact"],

				//Defines the sprites information:
				"sprites" : audioSprites["black_lark-first_contact"],

				//Sets a function to call when the audio file sprites object is created successfully:
				onLoad: onCreateSpritesGroup, //Optional. Will be stored in '_audioFileSpritesPool.audioFileSprites["black_lark-first_contact"].onLoad'.

				//Sets a function to call when an error happens with the audio file sprites object:
				onError: onErrorSpritesGroup //Optional. Will be stored in '_audioFileSpritesPool.audioFileSprites["black_lark-first_contact"].onError'.
			},

			//Sprites group "smokefishe-sorry_for_lying" (it will be used as its ID) which will create a CB_AudioFileSprites object internally:
			"smokefishe-sorry_for_lying" : //This object has the same format that uses the '_audioFileSpritesPool.insertSpritesGroup' method (indeed, it is called internally).
			{
				//Defines the same audio but in different audio files (providing different formats, paths and data URIs):
				"URIs" : audioURIs["smokefishe-sorry_for_lying"],

				//Defines the sprites information:
				"sprites" : audioSprites["smokefishe-sorry_for_lying"],

				//Sets a function to call when the audio file sprites object is created successfully:
				onLoad: onCreateSpritesGroup, //Optional. Will be stored in '_audioFileSpritesPool.audioFileSprites["smokefishe-sorry_for_lying"].onLoad'.

				//Sets a function to call when an error happens with the audio file sprites object:
				onError: onErrorSpritesGroup //Optional. Will be stored in '_audioFileSpritesPool.audioFileSprites["smokefishe-sorry_for_lying"].onError'.
			},
			
			//Sprites group "weary_eyes-invisible_hand" (it will be used as its ID) which will create a CB_AudioFileSprites object internally:
			"weary_eyes-invisible_hand" : //This object has the same format that uses the '_audioFileSpritesPool.insertSpritesGroup' method (indeed, it is called internally).
			{
				//Defines the same audio but in different audio files (providing different formats, paths and data URIs):
				"URIs" : audioURIs["weary_eyes-invisible_hand"],

				//Defines the sprites information:
				"sprites" : audioSprites["weary_eyes-invisible_hand"],

				//Sets a function to call when the audio file sprites object is created successfully:
				onLoad: onCreateSpritesGroup, //Optional. Will be stored in '_audioFileSpritesPool.audioFileSprites["weary_eyes-invisible_hand"].onLoad'.

				//Sets a function to call when an error happens with the audio file sprites object:
				onError: onErrorSpritesGroup //Optional. Will be stored in '_audioFileSpritesPool.audioFileSprites["weary_eyes-invisible_hand"].onError'.
			}
		},

		/* General options for the audio file sprites pool object (can be overridden when they are specified in the options of a sprites group): */

		//Defines whether we want to check all CB_AudioFile objects automatically or manually (we will need to call the 'checkPlayingAll' method):
		checkManually: true, //Optional. Default: CB_AudioFileCache.checkManually_DEFAULT. Set to undefined or null to use the default one. Will be stored in '_audioFileSpritesPool.checkManually'.

		//Sets a function to call when the audio file sprites pool object is created successfully:
		onLoad: onCreate, //Optional but recommended. Will be stored in '_audioFileSpritesPool.onLoad'.

		//Sets a function to call when an error happens with the audio file sprites pool object:
		onError: onError, //Optional but recommended. Will be stored in '_audioFileSpritesPool.onError'.
		
		//As only one sound/sprite (a song) will be played at once, we do not need to cache automatically at all. We can save resources this way:
		
		//Minimum CB_AudioFile objects that will be needed internally:
		minimumAudioFiles: 1, //Optional. Default: CB_AudioFileCache.minimumAudioFiles_DEFAULT. Set to undefined or null to use the default one. Will be stored in '_audioFileSpritesPool.minimumAudioFiles'.

		//Maximum CB_AudioFile objects that will be created internally:
		maximumAudioFiles: 1, //Optional. Default: CB_AudioFileCache.maximumAudioFiles_DEFAULT. Set to undefined to use the default one. Set to null to have no maximum. Will be stored in '_audioFileSpritesPool.maximumAudioFiles'.

		//Minimum free CB_AudioFile objects that will be needed internally. One CB_AudioFile object is free when it is not being played.
		minimumAudioFilesFree: 0, //Optional. Default: parseInt(_audioFileSpritesPool.minimumAudioFiles * 0.25 + 0.5). Set to undefined or null to use the default one. Will be stored in '_audioFileSpritesPool.minimumAudioFilesFree'.

		//Defines the number of new CB_AudioFile objects to create automatically when they are needed:
		newAudioFilesWhenNeeded: 0 //Optional. Default: Math.min(parseInt(_audioFileSpritesPool.minimumAudioFiles * 0.1 + 0.5), 1). Set to undefined or null to use the default one. Will be stored in '_audioFileSpritesPool.newAudioFilesWhenNeeded'.
	};

	//Creates the audio file sprites pool object:
	//NOTE: it is recommended to do it through a user-driven event (as "onClick", "onTouchStart", etc.) in order to maximize compatibility (as some clients could block sounds otherwise).
	_audioFileSpritesPool = new CB_AudioFileSpritesPool(audioFileSpritesPoolData);

	//Checks the status constantly and shows the progress (optional):
	var lastProgress = null, currentProgress = null;
	var lastStatus = null, currentStatus = null;
	var checkLoadingContinue = true;
	var checkLoading = function()
	{
		//Shows the progress (if there were any changes):
		currentProgress = _audioFileSpritesPool.getProgress();
		if (currentProgress !== lastProgress)
		{
			CB_console("[CB_AudioFileSpritesPool] Progress: " + currentProgress);
			CB_Elements.insertContentById("music_progress", "Please, wait. Music loading/checking progress: " + CB_numberFormat(currentProgress, 2, true) + "%"); //Shows the music loading progress.
			lastProgress = currentProgress;
		}

		//Shows the status (if there were any changes):
		//NOTE: it would also be possible to use the '_audioFileSpritesPool.getStatusString' method which returns a string with the current status.
		currentStatus = _audioFileSpritesPool.getStatus();
		if (currentStatus !== lastStatus)
		{
			if (currentStatus === CB_AudioFileSpritesPool.UNLOADED) { CB_console("[CB_AudioFileSpritesPool] Unloaded"); }
			else if (currentStatus === CB_AudioFileSpritesPool.ABORTED) { CB_console("[CB_AudioFileSpritesPool] Aborted!"); checkLoadingContinue = false; }
			else if (currentStatus === CB_AudioFileSpritesPool.FAILED) { CB_console("[CB_AudioFileSpritesPool] Failed!"); checkLoadingContinue = false; }
			else if (currentStatus === CB_AudioFileSpritesPool.LOADING) { CB_console("[CB_AudioFileSpritesPool] Loading..."); }
			else if (currentStatus === CB_AudioFileSpritesPool.UNCHECKED) { CB_console("[CB_AudioFileSpritesPool] Unchecked! The '_audioFileSpritesPool.checkPlayingAll' method needs to be called."); }
			else if (currentStatus === CB_AudioFileSpritesPool.CHECKING) { CB_console("[CB_AudioFileSpritesPool] Checking..."); }
			else if (currentStatus === CB_AudioFileSpritesPool.LOADED) { CB_console("[CB_AudioFileSpritesPool] Loaded! Now you can use the audio file sprites pool object freely."); checkLoadingContinue = false; }
			lastStatus = currentStatus;
		}

		if (checkLoadingContinue) { checkLoadingInterval = setTimeout(checkLoading, 1); }
	};
	var checkLoadingInterval = setTimeout(checkLoading, 1);
}


//Shows the music checker:
var _showMusicCheckerCalled = false; //To prevent showing the checker again.
function showMusicChecker()
{
	if (!CB_GEM.data.musicEnabled) { return; }
	else if (_showMusicCheckerCalled) { return; }
	_showMusicCheckerCalled = true;
	CB_Elements.insertContentById("music_progress", ""); //Empties the progress shown.
	CB_Elements.insertContentById("button_load_check_music", "Step 2:<br />Check music");
	CB_Events.removeByName(CB_Elements.id("button_load_check_music"), "click"); //Removes the previous event handler from the button.
	CB_Events.on(CB_Elements.id("button_load_check_music"), "click", checkMusic); //Attaches the event to the button to check the music.	
	CB_Elements.showById("button_load_check_music"); //Shows the music checker button.
}


//Checks the music:
function checkMusic()
{
	if (!CB_GEM.data.musicEnabled) { return; }
	else if (!(_audioFileSpritesPool instanceof CB_AudioFileSpritesPool)) { CB_console("[CB_AudioFileSpritesPool] Music cannot be checked because '_audioFileSpritesPool' is not a 'CB_AudioFileSpritesPool' object!"); return; }
	
	CB_console("[CB_AudioFileSpritesPool] Checking music (status: " + _audioFileSpritesPool.getStatusString() + ")...");
	CB_Elements.hideById("button_load_check_music"); //Hides the music checker button.
	
	//If the "checkManually" option was set to true, we need to check all the CB_AudioFile objects manually (by calling their 'checkPlaying' method):
	_audioFileSpritesPool.checkPlayingAll
	(
		//callbackOk. Optional but recommended:
		function(performedActions, uncheckedObjects)
		{
			CB_console("[CB_AudioFileSpritesPool] Audio file sprites pool object checked successfully!");
			CB_console("[CB_AudioFileSpritesPool] Performed actions (number of CB_AudioFile objects that can be played): " + performedActions);
			CB_console("[CB_AudioFileSpritesPool] Unchecked CB_AudioFile objects before calling this method: " + uncheckedObjects);
			CB_GEM.data.musicChecked = true;
			CB_Elements.hideById("music_loader_checker"); //Hides the music checker.
			CB_Elements.showById("start_button"); //Shows the start button.
		},
		//callbackError. Optional but recommended:
		function(errors, performedActions, uncheckedObjects)
		{
			CB_console("[CB_AudioFileSpritesPool] Audio file sprites pool object failed to be checked!");
			for (var spritesGroupID in errors)
			{
				CB_console("[CB_AudioFileSpritesPool] " + spritesGroupID + " => " + errors[spritesGroupID].error);
				CB_console("[CB_AudioFileSpritesPool] * Performed actions (number of CB_AudioFile objects that can be played): " + errors[spritesGroupID].checked);
				CB_console("[CB_AudioFileSpritesPool] * Unchecked CB_AudioFile objects before calling this method: " + errors[spritesGroupID].needed);
			}
			CB_console("[CB_AudioFileSpritesPool] Total performed actions (number of CB_AudioFile objects that can be played): " + performedActions);
			CB_console("[CB_AudioFileSpritesPool] Total unchecked CB_AudioFile objects before calling this method: " + uncheckedObjects);
			
			//Lets continue anyway:
			skipLoadingMusic();
		}
	);	
}


//Plays the desired song:
/*
	NOTE:
		Music downloaded from https://icons8.com/music/tag/atmospheric (modified to be exported to different audio formats and compressed using Audacity (https://www.audacityteam.org/download/):
			"First contact" by Black Lark.
			"Invisible hand" by Weary Eyes.
			"Sorry for lying" by Smokefishe.
*/
function playMusic(id)
{
	if (!CB_GEM.data.musicEnabled) { return; }
	else if (!(_audioFileSpritesPool instanceof CB_AudioFileSpritesPool)) { CB_console("[CB_AudioFileSpritesPool] Music cannot be played because '_audioFileSpritesPool' is not a 'CB_AudioFileSpritesPool' object!"); return; }
	
	//Stops any possible song playing currently:
	stopMusic();

	//Gets the internal CB_AudioFileSprites object that belongs to the desired sprites group (gets the desired song):
	var audioFileSpritesGroup = _audioFileSpritesPool.getSpritesGroup(id); //Returns null if not found.

	if (audioFileSpritesGroup !== null)
	{
		CB_console("[CB_AudioFileSpritesPool] Trying to play whole sprite whose ID is '" + id + "'...");
		
		//Plays the sprite desired ("ALL" which corresponds to the whole song):
		audioFileSpritesGroup.playSprite("ALL", true, undefined, undefined, undefined, function() { CB_console("[CB_AudioFileSpritesPool] Sprite whose ID is '" + id + "' started playing."); }); //Also loops.
	}
	else { CB_console("[CB_AudioFileSpritesPool] The 'audioFileSpritesGroup' for '" + id + "' is null. Music cannot be played."); }
}


//Stops any song:
function stopMusic()
{
	if (!(_audioFileSpritesPool instanceof CB_AudioFileSpritesPool)) { CB_console("[CB_AudioFileSpritesPool] Music cannot be stopped because 'audioFileSpritesPool' is not a 'CB_AudioFileSpritesPool' object!"); return; }
	
	//Stops any possible song playing currently:
	_audioFileSpritesPool.stopAll();
}


//Toggles full screen mode:
//NOTE: some browsers will fail to enable full screen mode if it is not requested through a user-driven event (as "onClick", "onTouchStart", etc.).
function fullScreenToggle()
{
	CB_console("Toggling full screen mode...");
	//If it is using full screen mode already, disables it:
	if (CB_Screen.isFullScreen())
	{
		CB_console("Full screen mode detected. Trying to restore normal mode...");
		CB_Screen.setFullScreen(false); //Uses the Fullscreen API and fallbacks to other methods internally, including NW.js, Electron ones, when not available.
	}
	//...otherwise, requests full screen mode:
	else
	{
		CB_console("Normal mode detected. Trying to enable full screen mode...");
		CB_Screen.setFullScreen(true, undefined, true); //Allows reloading into another (bigger) window (for legacy clients).
	}
}


//Toggles screen controls (make them show or hide):
function screenControlsToggle()
{
	CB_console("Toggling screen controls...");
	CB_Elements.showHideById
	(
		"controls", //element.
		undefined, //displayValue.
		true, //checkValues.
		false, //computed.
		undefined, //onToggleDisplay. Calls the function after showing/hiding the element.
		function(element, displayValue) //onShow. Calls the function after showing the element.
		{
			CB_console("Controls shown!");
			CB_Elements.setClassById("controls_toggler", "");
		},
		function(element, displayValue) //onHide. Calls the function after hiding the element.
		{
			CB_console("Controls hidden!");
			CB_Elements.setClassById("controls_toggler", "controls_hidden");
		}
	);
}


//Makes a DOM element non-draggable, non-selectable, etc.:
function makeElementSolid(element)
{
	if (element !== null)
	{
		element.style.draggable = false;
		element.style.touchAction = "none";
		CB_Elements.contextMenuDisable(element);
		CB_Elements.preventSelection(element);
	}
	return element;
}

Additional files used (inside the "img" folder): bottle.gif, cup_empty.gif, cup_filled.gif, player_down_1.gif, player_down_2.gif, player_left_1.gif, player_left_2.gif, player_right_1.gif, player_right_2.gif, player_up_1.gif, player_up_2.gif and stone.gif.

Additional files used (inside the "audio" folder) which belong to music downloaded from here (modified to be exported to different audio formats and compressed using Audacity):

"First contact" by Black Lark: black_lark-first_contact-compressed.m4a, black_lark-first_contact-compressed.mp3, black_lark-first_contact-compressed.ogg and black_lark-first_contact-compressed.wav.

"Invisible hand" by Weary Eyes: smokefishe-sorry_for_lying-compressed.m4a, smokefishe-sorry_for_lying-compressed.mp3, smokefishe-sorry_for_lying-compressed.ogg and smokefishe-sorry_for_lying-compressed.wav.

"Sorry for lying" by Smokefishe: weary_eyes-invisible_hand-compressed.m4a, weary_eyes-invisible_hand-compressed.mp3, weary_eyes-invisible_hand-compressed.ogg and weary_eyes-invisible_hand-compressed.wav.

Try this example

You can check the Guides & Tutorials category as well as the API documentation in the case you need more information.

All the examples together can be downloaded here.

Go back to Guides & Tutorials

Try this example












Share